Apertus.ElphelVision User Guide - Revision history

Flavio at 17:26, 24 April 2012

2012-04-24T17:26:20Z

Flavio at 17:25, 24 April 2012

2012-04-24T17:25:49Z

← Older revision		Revision as of 17:25, 24 April 2012
Line 1:		Line 1:
	== Requirements ==		== Requirements ==

	*JAVA JRE		*JAVA JRE
Line 5:		Line 5:
	*(Gstreamer) <- still experimental		*(Gstreamer) <- still experimental

	== Download ==		== Download ==

	Nightly Builds as well as a release history can be downloaded from sourceforge:		Nightly Builds as well as a release history can be downloaded from sourceforge:
Line 21:		Line 21:
	<br>		<br>

	== Starting ElphelVision ==		== Starting ElphelVision ==

	By default we provide startup scripts for Linux, Mac and Windows.		By default we provide startup scripts for Linux, Mac and Windows.
Line 31:		Line 31:
	It is recommended to run ElphelVision from the commandline and not through a GUI to get error messages, debug output, etc.		It is recommended to run ElphelVision from the commandline and not through a GUI to get error messages, debug output, etc.

	== Startup Parameters ==		== Startup Parameters ==

	Example:		Example:
Line 61:		Line 61:
	3 - everything		3 - everything

	<br>		<br>

			== Common Problems ==

			Once you run ElphelVision, there are some known problems that may happen. Here you can see their description and their solution.<br>

			<br>

	== ~~Common Problems~~ ==		==== There is a black screen covering the streaming.<br> ====

	~~Once~~ you ~~run~~ ElphelVision, there are ~~some known problems that may happen~~. ~~Here~~ you ~~can~~ see ~~their description and their solution.~~<br>		The first one is that you are able to open ElphelVision and connect to the camera, but a black screen shows up and you are not able to see what's being streamed by the camera. You will notice there is a live histogram below and that there are two Java instances (windows) running. You are also able to view a stream coming from the camera using MPlayer or VLC. This is what you might see:<br>

	<br>		<br>

	~~==== There is a black screen covering the streaming~~.~~<br> ====~~		[[Image:ElphelVision.png\|563x330px\|ElphelVision.png]]

	The first one is that you are able to open ElphelVision and connect to the camera, but a black screen shows up and you are not able to see what's being streamed by the camera. You will notice there is a live histogram below and that there are two Java instances (windows) running. You are also able to view a stream coming from the camera using MPlayer or VLC. This is what you might see:<br>		<br>

	~~[[Image:ElphelVision.png\|563x330px]]~~
	~~<pre>If you look at the terminal, in the first lines of the output there may be something like this:~~

	=====================================================		==== If you look at the terminal, in the first lines of the output there may be something like this:<br> ====
			<pre>=====================================================
	ElphelVision - Apertus Viewfinder Software		ElphelVision - Apertus Viewfinder Software
	http://www.apertus.org		http://www.apertus.org
Line 87:		Line 91:
	[14:38:47.882] WARNING: OpacityControl is not supported by current Graphics Environment		[14:38:47.882] WARNING: OpacityControl is not supported by current Graphics Environment
	[14:38:47.882] LOG:PERPIXEL_TRANSPARENT is supported by current Graphics Environment		[14:38:47.882] LOG:PERPIXEL_TRANSPARENT is supported by current Graphics Environment
			</pre>
			There is a warning there saying that "OpacityControl" is not supported. This basically means the driver for your graphics card doesn't support this function. You can solve this issue updating your drivers. If you can't update your drivers, then you will have to close the second Java instance (window) to remove it from the front of everything else. This will be uncomfortable, however, because this window will show up again whenever you change any of ElphelVision's settings.

			<br>

			==== You have a live histogram but there is no streaming.<br> ====

			This problem is somewhat similar to the above, except that you cannot see the streaming coming from the camera, even though the live histogram detects any changes in ambient light. You are also sure this is not the black screen mentioned above, it's just the streaming that is not showing up.<br>

			By taking a look at the output coming from the terminal you've ran ElphelVision, there should be an error somewhat similar to this:<br>
			<pre>[08:35:22.930] LOG: Starting VLC Video
			[0x9d18f30] live555 demux error: Failed to connect with rtsp://192.168.1.9:554
			[0x97551d0] main input error: open of `rtsp://192.168.1.9:554' failed
			[0x97551d0] main input error: A entrada não pode ser aberta
			[0x97551d0] main input error: O VLC não é capaz de abrir o MRL 'rtsp://192.168.1.9:554'. Verifique o registro de erros para maiores detalhes.
			</pre>
			After a while, there should be also this output in your terminal:<br>
			<pre>[0x8481d70] main input error: ES_OUT_RESET_PCR called
			[0x8496870] live555 demux error: no data received in 10s, aborting
	</pre>		</pre>
	~~There is a warning there saying that "OpacityControl"~~ is not ~~supported~~. ~~This basically means~~ the ~~driver for your graphics card doesn't support this function~~. ~~You can solve~~ this ~~issue updating your drivers. If~~ you ~~can't update your drivers, then you will~~ have ~~to close the second Java instance~~ (~~window~~) to ~~remove it from~~ the ~~front of everything else~~. ~~This will be uncomfortable, however~~, because ~~this window will~~ show up ~~again whenever you change any of ElphelVision's settings~~.		This is actually not an ElphelVision's error. You are having general problems with getting the streaming from the camera. The fix to this problem is that you probably have a package missing and these programs (MPlayer, VLC) are not being able to decode the stream properly. Try installing a package called "gecko-mediaplayer". If you have "totem-mozilla", uninstall it because otherwise your system may try to use it instead of gecko. Now the stream should show up.
			<br>

Flavio at 16:57, 24 April 2012

2012-04-24T16:57:51Z

← Older revision		Revision as of 16:57, 24 April 2012
Line 1:		Line 1:
	==Requirements==		== Requirements ==

	* JAVA JRE		*JAVA JRE
	* VLC		*VLC
	* (Gstreamer) <- still experimental		*(Gstreamer) <- still experimental

	==Download==		== Download ==

	Nightly Builds as well as a release history can be downloaded from sourceforge:		Nightly Builds as well as a release history can be downloaded from sourceforge:

	http://elphel.svn.sourceforge.net/viewvc/elphel/Apertus/ElphelVision/Java%20App/release/		http://elphel.svn.sourceforge.net/viewvc/elphel/Apertus/ElphelVision/Java%20App/release/

	== Setting Permissions and Running ==		== Setting Permissions and Running ==

	Inside the folder you just downloaded, change the permissions of the ElphelVision.sh to enable execution.		Inside the folder you just downloaded, change the permissions of the ElphelVision.sh to enable execution.
Line 19:		Line 19:
	./ElphelVision.sh		./ElphelVision.sh

			<br>

	==Starting ElphelVision==		== Starting ElphelVision ==
	By default we provide startup scripts for Linux, Mac and Windows.
			By default we provide startup scripts for Linux, Mac and Windows.

			This is basically a file that runs:

	~~This is basically a file that runs:~~

	java -jar -Xmx256m ElphelVision-dist.jar --debuglevel 3		java -jar -Xmx256m ElphelVision-dist.jar --debuglevel 3

	It is recommended to run ElphelVision from the commandline and not through a GUI to get error messages, debug output, etc.		It is recommended to run ElphelVision from the commandline and not through a GUI to get error messages, debug output, etc.

			== Startup Parameters ==

			Example:

	~~==Startup Parameters==~~
	~~Example:~~
	ElphelVision-dist.jar --debuglevel 3		ElphelVision-dist.jar --debuglevel 3

	The following arguments are available:		The following arguments are available:

	--help		--help
	Displays the list of available startup parameters
			Displays the list of available startup parameters

	--no-camera		--no-camera
	This is useful for running the software without a camera. It will disable all network communication. That way the software just pretends do interact with a camera. For demo purposes or if you want to develop GUI elements without needing a camera.
			This is useful for running the software without a camera. It will disable all network communication. That way the software just pretends do interact with a camera. For demo purposes or if you want to develop GUI elements without needing a camera.

	--debuglevel N		--debuglevel N
	~~Controls the amount of log and error messages you see in the console~~

	Possible values for N:		Controls the amount of log and error messages you see in the console

			Possible values for N:

			0 - none

			1 - only errors

			2 - errors and warnings (default)

			3 - everything

			<br>

			== Common Problems ==

			Once you run ElphelVision, there are some known problems that may happen. Here you can see their description and their solution.<br>

			<br>

			==== There is a black screen covering the streaming.<br> ====

	~~0 - none~~		The first one is that you are able to open ElphelVision and connect to the camera, but a black screen shows up and you are not able to see what's being streamed by the camera. You will notice there is a live histogram below and that there are two Java instances (windows) running. You are also able to view a stream coming from the camera using MPlayer or VLC. This is what you might see:<br>

	~~1 - only errors~~		[[Image:ElphelVision.png\|563x330px]]
			<pre>If you look at the terminal, in the first lines of the output there may be something like this:

	2 - ~~errors and warnings (default)~~		=====================================================
			ElphelVision - Apertus Viewfinder Software
			http://www.apertus.org
			Version: 0.57
			=====================================================

	3 - everything		[14:38:47.853] LOG: Looking for default.style
			[14:38:47.876] LOG: default.style found - Styles Loaded
			[14:38:47.882] LOG: Translucency is supported by current Graphics Environment
			[14:38:47.882] WARNING: OpacityControl is not supported by current Graphics Environment
			[14:38:47.882] LOG:PERPIXEL_TRANSPARENT is supported by current Graphics Environment
			</pre>
			There is a warning there saying that "OpacityControl" is not supported. This basically means the driver for your graphics card doesn't support this function. You can solve this issue updating your drivers. If you can't update your drivers, then you will have to close the second Java instance (window) to remove it from the front of everything else. This will be uncomfortable, however, because this window will show up again whenever you change any of ElphelVision's settings.

Flavio: Moved "setting permissions" of ElphelVision.sh to here

2012-04-19T23:23:13Z

Moved "setting permissions" of ElphelVision.sh to here

← Older revision		Revision as of 23:23, 19 April 2012
Line 10:		Line 10:

	http://elphel.svn.sourceforge.net/viewvc/elphel/Apertus/ElphelVision/Java%20App/release/		http://elphel.svn.sourceforge.net/viewvc/elphel/Apertus/ElphelVision/Java%20App/release/

			== Setting Permissions and Running ==

			Inside the folder you just downloaded, change the permissions of the ElphelVision.sh to enable execution.

			Open a terminal and run

			./ElphelVision.sh


	==Starting ElphelVision==		==Starting ElphelVision==

OneArtPlease at 19:10, 15 June 2011

2011-06-15T19:10:48Z

← Older revision		Revision as of 19:10, 15 June 2011
Line 12:		Line 12:

	==Starting ElphelVision==		==Starting ElphelVision==
	By default we provide startup ~~script~~ for Linux, Mac and Windows.		By default we provide startup scripts for Linux, Mac and Windows.

	This is basically a file that runs:		This is basically a file that runs:

	java -jar -Xmx256m ElphelVision-dist.jar --debuglevel 3		java -jar -Xmx256m ElphelVision-dist.jar --debuglevel 3

			It is recommended to run ElphelVision from the commandline and not through a GUI to get error messages, debug output, etc.

	==Startup Parameters==		==Startup Parameters==

OneArtPlease: Created page with "==Requirements== * JAVA JRE * VLC * (Gstreamer) <- still experimental ==Download== Nightly Builds as well as a release history can be downloaded from sourceforge: http://elph..."

2011-06-15T19:09:22Z

Created page with "==Requirements== * JAVA JRE * VLC * (Gstreamer) <- still experimental ==Download== Nightly Builds as well as a release history can be downloaded from sourceforge: http://elph..."

New page

==Requirements==

* JAVA JRE
* VLC
* (Gstreamer) <- still experimental

==Download==

Nightly Builds as well as a release history can be downloaded from sourceforge:

http://elphel.svn.sourceforge.net/viewvc/elphel/Apertus/ElphelVision/Java%20App/release/

==Starting ElphelVision==
By default we provide startup script for Linux, Mac and Windows.

This is basically a file that runs:

java -jar -Xmx256m ElphelVision-dist.jar --debuglevel 3

==Startup Parameters==
Example:
ElphelVision-dist.jar --debuglevel 3

The following arguments are available:

--help
Displays the list of available startup parameters

--no-camera
This is useful for running the software without a camera. It will disable all network communication. That way the software just pretends do interact with a camera. For demo purposes or if you want to develop GUI elements without needing a camera.

--debuglevel N
Controls the amount of log and error messages you see in the console

Possible values for N:

0 - none

1 - only errors

2 - errors and warnings (default)

3 - everything

← Older revision		Revision as of 17:26, 24 April 2012
Line 73:		Line 73:
	The first one is that you are able to open ElphelVision and connect to the camera, but a black screen shows up and you are not able to see what's being streamed by the camera. You will notice there is a live histogram below and that there are two Java instances (windows) running. You are also able to view a stream coming from the camera using MPlayer or VLC. This is what you might see:<br>		The first one is that you are able to open ElphelVision and connect to the camera, but a black screen shows up and you are not able to see what's being streamed by the camera. You will notice there is a live histogram below and that there are two Java instances (windows) running. You are also able to view a stream coming from the camera using MPlayer or VLC. This is what you might see:<br>

	<br>		<br>

	[[Image:ElphelVision.png\|563x330px\|ElphelVision.png]]		[[Image:ElphelVision.png\|563x330px\|ElphelVision.png]]

	<br>		<br>

	~~====~~ If you look at the terminal, in the first lines of the output there may be something like this:<br> ~~====~~		If you look at the terminal, in the first lines of the output there may be something like this:<br>
	<pre>=====================================================		<pre>=====================================================
	ElphelVision - Apertus Viewfinder Software		ElphelVision - Apertus Viewfinder Software
Line 94:		Line 94:
	There is a warning there saying that "OpacityControl" is not supported. This basically means the driver for your graphics card doesn't support this function. You can solve this issue updating your drivers. If you can't update your drivers, then you will have to close the second Java instance (window) to remove it from the front of everything else. This will be uncomfortable, however, because this window will show up again whenever you change any of ElphelVision's settings.		There is a warning there saying that "OpacityControl" is not supported. This basically means the driver for your graphics card doesn't support this function. You can solve this issue updating your drivers. If you can't update your drivers, then you will have to close the second Java instance (window) to remove it from the front of everything else. This will be uncomfortable, however, because this window will show up again whenever you change any of ElphelVision's settings.

	<br>		<br>

	==== You have a live histogram but there is no streaming.<br> ====		==== You have a live histogram but there is no streaming.<br> ====

	This problem is somewhat similar to the above, except that you cannot see the streaming coming from the camera, even though the live histogram detects any changes in ambient light. You are also sure this is not the black screen mentioned above, it's just the streaming that is not showing up.<br>		This problem is somewhat similar to the above, except that you cannot see the streaming coming from the camera, even though the live histogram detects any changes in ambient light. You are also sure this is not the black screen mentioned above, it's just the streaming that is not showing up.<br>

	By taking a look at the output coming from the terminal you've ran ElphelVision, there should be an error somewhat similar to this:<br>		By taking a look at the output coming from the terminal you've ran ElphelVision, there should be an error somewhat similar to this:<br>
	<pre>[08:35:22.930] LOG: Starting VLC Video		<pre>[08:35:22.930] LOG: Starting VLC Video
	[0x9d18f30] live555 demux error: Failed to connect with rtsp://192.168.1.9:554		[0x9d18f30] live555 demux error: Failed to connect with rtsp://192.168.1.9:554
Line 106:		Line 106:
	[0x97551d0] main input error: A entrada não pode ser aberta		[0x97551d0] main input error: A entrada não pode ser aberta
	[0x97551d0] main input error: O VLC não é capaz de abrir o MRL 'rtsp://192.168.1.9:554'. Verifique o registro de erros para maiores detalhes.		[0x97551d0] main input error: O VLC não é capaz de abrir o MRL 'rtsp://192.168.1.9:554'. Verifique o registro de erros para maiores detalhes.
	</pre>		</pre>
	After a while, there should be also this output in your terminal:<br>		After a while, there should be also this output in your terminal:<br>
	<pre>[0x8481d70] main input error: ES_OUT_RESET_PCR called		<pre>[0x8481d70] main input error: ES_OUT_RESET_PCR called
	[0x8496870] live555 demux error: no data received in 10s, aborting		[0x8496870] live555 demux error: no data received in 10s, aborting
	</pre>		</pre>
	This is actually not an ElphelVision's error. You are having general problems with getting the streaming from the camera. The fix to this problem is that you probably have a package missing and these programs (MPlayer, VLC) are not being able to decode the stream properly. Try installing a package called "gecko-mediaplayer". If you have "totem-mozilla", uninstall it because otherwise your system may try to use it instead of gecko. Now the stream should show up.		This is actually not an ElphelVision's error. You are having general problems with getting the streaming from the camera. The fix to this problem is that you probably have a package missing and these programs (MPlayer, VLC) are not being able to decode the stream properly. Try installing a package called "gecko-mediaplayer". If you have "totem-mozilla", uninstall it because otherwise your system may try to use it instead of gecko. Now the stream should show up. <br>
	<br>