Sensory Effect Media Player (SEMP) v0.12
----------------------------------------
(c) 2009 - 2012 Markus Waltl (Alpen-Adria-Universitt Klagenfurt)

The Sensory Effect Media Player (SEMP) is a media player which provides the possibility to play
videos accompanied by additional effects (i.e., wind, light, vibration and scent). The player is
in an early version and it can sometimes occur that it crashes. The description of sensory effects
is based on the MPEG-V: Media Context and Control standard defined by MPEG. For further information
about the standard please visit http://selab.itec.aau.at, http://wg11.sc29.org/mpeg-v/ or http://www.metaverse1.org/

NOTE:
The Sensory Effect Media Player (SEMP) is not a commercial product and should mainly be 
used in research or for testing.



REQUIREMENTS:
-------------
* Windows XP or higher
* Codec Pack (e.g., K-lite codec pack) (http://www.codecguide.com/)
* fast computer (for 544p, at least 2GHz are recommendet)
* amBX system (optional, but else no sensory effects are shown)
* DaleAir Vortex Active (optional, but else not scent effects)



LICENSE
-------
SEMP is free software: you can redistribute it and/or modify
it under the terms of the GNU Lesser General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

SEMP is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU Lesser General Public License for more details.

You should have received a copy of the GNU Lesser General Public License
along with SEMP. If not, see <http://www.gnu.org/licenses/>.



INSTALLATION
------------
Simply run the application and select a video for playback. If you want to have sensory effects you need to
run the application from the command line with the "-s" parameter and specifying a Sensory Effect Metadata description.

We plan to implement a SEM selection at the program start so please stay with this solution.

Note: if you have a scent device (i.e., Active Vortex) you need to update the "scentconfig.dat" file with
the scents which you have in the device. The current "scentconfig.dat" is filled with example data. Please only
change the scent names and leave the numbering as they are.



PLAYER CONTROLS:
----------------
Please not that parameters with [SE] tag can only be used if there is an amBX system and/or Vortex Activ available.
Furthermore, this is also only available if SEMP is compiled with these features

+	:	Volume up
-	:	Volume down
M	:	Mute
ESC	:	Exit player
->	:	Five seconds forward
<-	:	Five seconds backward
SHIFT+->:	60 seconds forward
SHIFT+<-:	60 seconds backward
CTRL+->	:	Increase playback rate
CTRL+<-	:	Decrease playback rate
SPACE	:	Pause video (current sensory effects are still playing!)
O	:	On-Screen-Display (OSD)
1 - 5	:	Voting from 1 (bad) to 5 (good)
E	:	Disable/Enable all effects during playback (until next effects are played) [SE]
H	:	Help window


START PARAMETERS:
-----------------
Please not that parameters with [SE] tag can only be used if there is an amBX system and/or Vortex Activ available.
Furthermore, this is also only available if SEMP is compiled with these features

-M <media>    	:	Video file to play
-V 0-100     	:	Initial volume in percent (0 = mute)
-D		:	Activate debugging, log of directshow graph, graph file and other logs will be generated
-S <sem>	:	Load sensory effect metadata description [SE]
-H		:	Only show help window and exit application
-B <path>	:	Write bitmaps retrieved by ISampleGrabber to the given path
-AC		:	Activate auto color calculation [SE]
-L <log-file>	:	Log file into which the voting results are written
-OSD 0-2	:	Disable/Enable OSD (0 = Disable OSD, 1 = Normal OSD, 2 = Voting OSD)
-Monitor x	: 	Display application on monitor x
-NOMMX		:	Disables MMX-SIMD support for color calculation [SE]
-DFT		:	Disable default fade time (30ms) for light effects [SE]
-SC             :   File representing the scent config (if not default will be used) [SE]


CONTACT
-------
For problems please visit our web site:

http://selab.itec.aau.at

and submit a ticket (if there is not already one)
