Apertus.ElphelVision User Guide

From ElphelWiki
Revision as of 15:23, 19 April 2012 by Flavio (talk | contribs) (Moved "setting permissions" of ElphelVision.sh to here)
Jump to: navigation, search

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/

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

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

This is basically a file that runs:

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

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