Sensory Effect Video Annotation (SEVino)
----------------------------------------
SEVino is available under GPLv3 or later see gpl-3.0.txt and README.LICENSE

Requirements
------------
JDK 1.6 Update 17 or higher
VideoLan Player (VLC) 1.1.0 or higher (can be found under www.videolan.org)
Apache Ant (can be found under http://ant.apache.org/)
FFmpeg

Install
-------
Use Ant to compile SEVino: "ant"

Linux + Windows:
VLC needs to be installed

Linux:
additionally ffmpeg needs to be installed

Windows:
no ffmpeg is needed as SEVino provides a precompiled ffmpeg.exe in 3rd/tools

Run
---
Use Ant to run: "ant run"

To work with SEVino simply load a video. After SEVino has generated the shots and initialized the interface
one has to start the video once so that all components are activated. Now one can start to annotate the video
via the lower part of SEVino. For annotating, e.g., a wind effect simply click on the start point in the
corresponding effect bar and drag the mouse (with pressed mouse button) to the end point. After you let go
of the mouse button a window will appear where you can enter desired parameters (e.g., intensity range: 0 100).
When you finished annotating the video simply click on generate and select a location and filename for the 
generated SEM description.


Issues
------
Q: I get the following expection:
   Exception in thread "main" java.lang.UnsatisfiedLinkError: Unable to load library 'libvlc'.

A: Try to point the program to your VLC directory by using -Dvlcpath="<path>/<to>/<VLC>". If this does not work check
   the version of your Java. If it is a 64-bit Java and your VLC is 32-bit it will also throw the above exception.
   If you have the second problem then you can only try to use a 32-bit Java version or look for a 64-bit VLC version!

Q: Does not find a javac compiler when running ant

A: Point your JAVA_HOME path to your JDK installation. Either with set JAVA_HOME=xxx (windows) or export JAVA_HOME=xxx (linux)

Q: I get the following exception when I play a video under Linux:
   Exception in thread "AWT-EventQueue-0" java.lang.UnsatisfiedLinkError: libjawt.so: cannot open shared object file: No such file or directory
   
A: If you receive this error you most likely are using Java 7. In this version the procedure of finding and loading shared files has changed.
   For resolving this issue just do the following:
   
   "export LD_LIBRARY_PATH=/path/to/your/jre/architecture (e.g., /opt/java/jre/lib/i386 or /opt/java/jre/lib/amd64)"
   
   afterwards, run the program and it should work again.