Sensory Effect Simulator (SESim)
--------------------------------
SESim 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/)


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

Linux + Windows:
VLC needs to be installed

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

To work with SESim simply select a video and a SEM description from you local machine and press
"Initialize". Now figures should be loaded and the content is prepared. After clicking on "Start"
the simulation will start and one can see all available effects and their settings throughout the
video playback.


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.