-This piece of software is based on the software and descriptions mentioned below -
-
-
-(re)Written by: Igor / Atmo (aka André Weber) - WeberAndre@gmx.de
- Matthiaz
- MacGyver2k
-
-if you need to contact one of us - come to www.vdr-portal.de
-
-http://www.vdr-portal.de/board/thread.php?threadid=59294 -- Description and Development of the Windows Software
-http://www.vdr-portal.de/board/thread.php?threadid=48574 -- Description and Development of the Hardware part
-
-=====================================================
-Info for Users on Vista or Windows 7 with active UAC!
-=====================================================
-for the first launch do it as Administrator with the following command line
-
-AtmoWinA.exe /register
-
-to create the required registry entries for the COM Objects, without
-these registry entries - the DirectShow Filter and also the VLC Plugin
-will not work.
-If anything went fine you should see the message "COM Server registered Ok!".
-
-See the file COPYING.txt for license information.
-
-
-VideoLAN / VLC
----------------
-
-In order to use this Programm with the VLC-Media-Player properly copy the "AtmoCtrlLib.dll" into the same Location where the vlc.exe is. E.G.: "D:\Programme\VLC".
-
-NEWER Versions of VideoLAN 1.1.x and higher, don't need a own copy of the "AtmoCtrlLib.dll" in the vlc.exe folder,
-if the complete filename of the AtmoWin*.exe is given. (Atmo Filter will try to load the DLL from there)
-
-Then open VLC and navigate to "Extras" / "Settings" or Press "Ctrl" + "p".
-Check that the radiobutton in the lower part of the dialogbox called "Show settings" -> "all" is checked.
-Now open the Register "Video" and click on "Filter". There you have to select the checkbox "AtmoLight-Filter".
-Afterwards you expand the Tree "Filter" in the Listbox on the left side. By selecting the entry "AtmoLight" you gain more settings.
-The most important are right these one at the beginning:
-
-VideoLAN 1.0.x
-==============
-"Use build in AtmoLight driver":
-Using this Property means VLC will control the Hardware with its built in driver.
-(no need for the extra AtmoWin software driver)
-
-VideoLAN 1.1.x
-==============
-You have the following choices for "Devicetype" instead of the old settings
-"AtmoWin Software" - is only available on Windows and works like the old way useing the external AtmoWin*.exe Software package, with the AtmoCtrlLib.dll.
-"Classic AtmoLight" - is the same as the former "use build in AtmoLight driver"
-"Quattro AtmoLight" - allows to use up to four serial connected class AtmoLight devices, as one logical device
-"DMX" - allows to control a simple serial DMX devices for AtmoLight effects
-"MoMoLight" - is a another kind of hardware supporting 2 oder 3 channels.
-(see bottom of this file - for more infos about the devices.)
-
-VideonLAN 1.0.x
-===============
-"Serial Device / Port":
-The COM-Port you are using for the hardware. E.G.: COM6 (This setting must be done if you are using the Property
-"use build in AtmoLight driver" )
-
-VideonLAN 1.1.x
-===============
-"Serial Device / Port":
-The COM-Port you are using for the hardware. E.G.: COM6 (This setting must be done if you are using a device
-other than "AtmoWin Software")
-in the case of the device "Quattro AtmoLight" you may specify up to four ports/devices seperated by
-, or ; for example if you are useing two physical devices write
-COM6;COM7 or on linux /dev/ttyUSB1;/dev/ttyUSB2
-
-VideoLAN 1.0.x
-==============
-"Filename of AtmoWinA.exe":
-The Path and the Name of the executable. E.G.:
-'D:\atmoWin_0.45\AtmoWinA.exe' (Using this setting expects that you have copied "AtmoCtrlLib.dll" to the Path where VLC.exe is like described before)
-
-VideoLAN 1.1.x
-==============
-"Filename of AtmoWinA.exe":
-The Path and the Name of the executable. E.G.:
-'D:\atmoWin_0.45\AtmoWinA.exe'
-in the same path where the .exe resides the "AtmoCtrlLib.dll" should be there. or you may need to place
-a copy of this ".dll" into the vlc.exe folder - like in VideoLAN 1.0.x
-
-Afterwards you should apply those settings by pressing the button "Save".
-
-
-
-
-VideoLAN 1.1.x - new options and settings
-=========================================
-Zone Layout for the build-in Atmo
-=================================
-This is the most important change I think - because the number of analyzed zones isn't
-longer fixed to 4 or 5 - it allows to define the physical layout of your lights arround
-the screen.
-"Number of zones on top" -- how many light sources are place on top of the screen
- (number of columns in which the screen should be tiled)
-
-"Number of zones on bottom" -- how many light sources are place on bottom of the screen
- (number of columns in which the screen should be tiled)
-
-"Zones on left / right side" -- how many light sources are place on right/left of the screen
- (number of rows in which the screen should be tiled)
- its assumed that the number on right and left is equal.
-
-"[] Calculate a average zone" -- define a color pair depending on the complete screen content
-
-This settings tiles the screen into a number of zones - which get analyzed by atmoLight to
-determine a most used color for these areas - each zone has a number starting from zero.
-The zones are usualy numbered in clock-wise order starting at the top/left of the screen.
-
-Example 1: classic Atmo with 4 channels
----------------------------------------
-"Number of zones on top" = 1
-"Number of zones on bottom" = 1
-"Zones on left / right side" = 1
-"[] Calculate a average zone" = false/0 not checked.
-
-will produce this zone layout
- -----------
- | Zone 0 |
----------------------
-| | | |
-| Z | | Z |
-| o | | o |
-| n | | n |
-| e | | e |
-| | | |
-| 3 | | 1 |
----------------- ----
- | Zone 2 |
- -----------
-
-
-Example 2: classic Atmo with 4 channels
----------------------------------------
-"Number of zones on top" = 2
-"Number of zones on bottom" = 0
-"Zones on left / right side" = 1
-"[] Calculate a average zone" = false/0 not checked.
-
- ----------- -----------
- | Zone 0 | | Zone 1 |
----------------------------------
-| | | |
-| Z | | Z |
-| o | | o |
-| n | | n |
-| e | | e |
-| | | |
-| 3 | | 2 |
------ -----
-
-Example 3: classic Atmo with 4 channels
----------------------------------------
-"Number of zones on top" = 1
-"Number of zones on bottom" = 0
-"Zones on left / right side" = 1
-"[X] Calculate a average zone" = true/1 checked.
-
- -----------
- | Zone 0 |
----------------------
-| | -------- | |
-| Z | | Z | | Z |
-| o | | o | | o |
-| n | | n | | n |
-| e | | e | | e |
-| | | 3 | | |
-| 2 | -------- | 1 |
------ -----
-Zone 3 - usualy calcuates the most used color of the full screen / picture / frame
-not only at the border of the picture.
-
-"The average zone" is allways the last in the sequence of numbers.
-
-
-
-the weightning gradients for these zones are auto calculated
-from 100% .. 0% starting from the edge.
-
-thats also the cause why the parameters Channel assignment changed,
-the classic comboboxes are still there for devices with 4 channels ot less,
-but for newer devices the "Channel / Zone assignment" should be used which
-is defined by a , or ; separated list of "AtmoLight channel numbers" if you
-want to hide a calcuated zone from output - you can assign channel -1 to
-do this.
-for classic AtmoLight with "Example 1" you may write this:
--1;3;2;1;0
-AtmoLight Channel 0: gets no zone assigned (-1)
-AtmoLight Channel 1: gets zone 3 (left)
-AtmoLight Channel 2: gets zone 2 (bottom)
-AtmoLight Channel 3: gets zone 1 (right)
-AtmoLight Channel 4: gets zone 0 (top)
-
-
-Also the settings for Gradient images change for the new devices, its no longer
-sufficient to speficy only 5 image name - because the number of zones is no longer
-fixed to five.
-So its prefered to set a path ("Gradient Bitmap searchpath"), where files
-like "zone_0.bmp" "zone_1.bmp" etc. exists. (with the same rules as defined for
-the old zone bitmaps.)
---> I think in most cases its no longer required to use this option,
-to change the zone layout - for most cases its sufficient to change
-"Zone Layout for the build-in Atmo" to get the same effect?
-
-Live Set of parameters for Buildin AtmoLight
-============================================
-durring playback with the buildin driver you can now change some settings
-of the filter without stopping / starting your movie - just open the
-"extras" --> "Effects and Filters" --> [Video effects] --> [AtmoLight]
-- move the sliders or change the calcuation mode, or enable/disable
-the debug grid - just in time.
-
-
-new Debugging Option
-====================
-[] Mark analyzed pixels - puts a grid of the used pixels on each frame
-to see from which locations/positions the colors are extracted.
-
-DMX Options
------------
-like the group says only for the DMX device
-"Count of AtmoLight Channels" - defines how many RGB Channels should be simulated
-with this DMX device (each RGB channel needs three DMX channels!)
-
-"DMX adress for each channel" - defines the DMX Startadress for each AtmoLight
-channel as "," or ";" separated list. (starting with 0 up to 252) it is assumed
-that the f.e. of the DMX-AtmoLight channel starts at DMX-Channel 5 - that
-DMX-Channel 5: is red
-DMX-Channel 6: is green
-DMX-Channel 7: is blue!
-
-MoMoLight options
------------------
-"Count of channels" - defines the devicetype and serial protocol
-3: - means 3 channels hardware
-4: - means 4 channels hardware
-(its required to set the correct number of channels to get this device working,
- because the serial protocol isn't the same!)
-
-
-
-VideoLan Options and Devices - the buildin version of AtmoLight supports a subset of the
-devices that AtmoWin supports.
-
-- AtmoWin Software - means do not use the VLC buildin video processing - just forward
- the basic preprocessed data to the launched AtmoWinA.exe controlling your hardware.
-
-- Classic AtmoLight - means the classic hardware from www.vdr-portal.de - with up to 5 channels.
-
-- Quattro AtmoLight - is nothing else as that you have connected up to 4 "classic AtmoLight" devices
- to your computer creating a up 16 channel Atmo Light - each devices needs its own serial port.
- you have to write the ports seperated by , or ; to [Serial Port/device] f.e. COM3,COM4,COM5 or on
- Linux /dev/ttyUSB01,/dev/ttyUSB02,/dev/ttyUSB03
-
-- DMX - stands for a simple DMX controller which can control up to 255 DMX devices (lights)
- - f.e. you may have a look here:
- * http://www.dzionsko.de/elektronic/index.htm
- * http://www.ulrichradig.de/ (search for dmx on his page)
-
-- MoMoLight - is a serial device, with 3 or 4 channels - doing nearly the same like
- Classic AtmoLight - just another protocol to control the hardware.
- http://lx.divxstation.com/article.asp?aId=151
- http://www.the-boss.dk/pages/momolight.htm
-
-- Fnordlicht - is a serial device with up to four channels
- http://github.com/fd0/fnordlicht/raw/master/doc/PROTOCOL
- http://github.com/fd0/fnordlicht/
-
-
-
-
-Original Readme - of the Linux Version - from where some code was used
-to do the color calculations ...
-
-######################################################################
-Original Readme and Authors of the Linux VDR Plugin!
-######################################################################
-
-Written by: Eike Edener <vdr@edener.de>
-Project's homepage: www.edener.de
-Latest version available at: www.edener.de
-See the file COPYING for license information.
-----------------------------------------------------------------------
-
-for detailed informations visit the VDR-Wiki:
-http://www.vdr-wiki.de/wiki/index.php/Atmo-plugin
-
-Development:
-http://www.vdr-portal.de/board/thread.php?threadid=48574
-
-Known bugs:
-n/a
-
-----------------------------------------------------------------------
+This piece of software is based on the software and descriptions mentioned below -\r
+\r
+\r
+(re)Written by: Igor / Atmo (aka André Weber) - WeberAndre@gmx.de\r
+ Matthiaz \r
+ MacGyver2k\r
+\r
+if you need to contact one of us - come to www.vdr-portal.de \r
+\r
+http://www.vdr-portal.de/board/thread.php?threadid=59294 -- Description and Development of the Windows Software\r
+http://www.vdr-portal.de/board/thread.php?threadid=48574 -- Description and Development of the Hardware part\r
+\r
+=====================================================\r
+Info for Users on Vista or Windows 7 with active UAC!\r
+=====================================================\r
+for the first launch do it as Administrator with the following command line \r
+\r
+AtmoWinA.exe /register \r
+\r
+to create the required registry entries for the COM Objects, without\r
+these registry entries - the DirectShow Filter and also the VLC Plugin\r
+will not work.\r
+If anything went fine you should see the message "COM Server registered Ok!".\r
+\r
+See the file COPYING.txt for license information.\r
+\r
+\r
+VideoLAN / VLC\r
+---------------\r
+\r
+In order to use this Programm with the VLC-Media-Player properly copy the "AtmoCtrlLib.dll" into the same Location where the vlc.exe is. E.G.: "D:\Programme\VLC". \r
+\r
+NEWER Versions of VideoLAN 1.1.x and higher, don't need a own copy of the "AtmoCtrlLib.dll" in the vlc.exe folder,\r
+if the complete filename of the AtmoWin*.exe is given. (Atmo Filter will try to load the DLL from there)\r
+\r
+Then open VLC and navigate to "Extras" / "Settings" or Press "Ctrl" + "p".\r
+Check that the radiobutton in the lower part of the dialogbox called "Show settings" -> "all" is checked.\r
+Now open the Register "Video" and click on "Filter". There you have to select the checkbox "AtmoLight-Filter".\r
+Afterwards you expand the Tree "Filter" in the Listbox on the left side. By selecting the entry "AtmoLight" you gain more settings.\r
+The most important are right these one at the beginning:\r
+\r
+VideoLAN 1.0.x \r
+==============\r
+"Use build in AtmoLight driver": \r
+Using this Property means VLC will control the Hardware with its built in driver. \r
+(no need for the extra AtmoWin software driver) \r
+\r
+VideoLAN 1.1.x \r
+==============\r
+You have the following choices for "Devicetype" instead of the old settings\r
+"AtmoWin Software" - is only available on Windows and works like the old way useing the external AtmoWin*.exe Software package, with the AtmoCtrlLib.dll.\r
+"Classic AtmoLight" - is the same as the former "use build in AtmoLight driver" \r
+"Quattro AtmoLight" - allows to use up to four serial connected class AtmoLight devices, as one logical device\r
+"DMX" - allows to control a simple serial DMX devices for AtmoLight effects\r
+"MoMoLight" - is a another kind of hardware supporting 2 oder 3 channels.\r
+(see bottom of this file - for more infos about the devices.)\r
+\r
+VideonLAN 1.0.x\r
+===============\r
+"Serial Device / Port":\r
+The COM-Port you are using for the hardware. E.G.: COM6 (This setting must be done if you are using the Property \r
+"use build in AtmoLight driver" )\r
+\r
+VideonLAN 1.1.x\r
+===============\r
+"Serial Device / Port":\r
+The COM-Port you are using for the hardware. E.G.: COM6 (This setting must be done if you are using a device\r
+other than "AtmoWin Software") \r
+in the case of the device "Quattro AtmoLight" you may specify up to four ports/devices seperated by\r
+, or ; for example if you are useing two physical devices write\r
+COM6;COM7 or on linux /dev/ttyUSB1;/dev/ttyUSB2\r
+\r
+VideoLAN 1.0.x\r
+==============\r
+"Filename of AtmoWinA.exe":\r
+The Path and the Name of the executable. E.G.:\r
+'D:\atmoWin_0.45\AtmoWinA.exe' (Using this setting expects that you have copied "AtmoCtrlLib.dll" to the Path where VLC.exe is like described before)\r
+\r
+VideoLAN 1.1.x\r
+==============\r
+"Filename of AtmoWinA.exe":\r
+The Path and the Name of the executable. E.G.:\r
+'D:\atmoWin_0.45\AtmoWinA.exe' \r
+in the same path where the .exe resides the "AtmoCtrlLib.dll" should be there. or you may need to place\r
+a copy of this ".dll" into the vlc.exe folder - like in VideoLAN 1.0.x\r
+\r
+Afterwards you should apply those settings by pressing the button "Save".\r
+\r
+\r
+\r
+\r
+VideoLAN 1.1.x - new options and settings\r
+=========================================\r
+Zone Layout for the build-in Atmo\r
+=================================\r
+This is the most important change I think - because the number of analyzed zones isn't\r
+longer fixed to 4 or 5 - it allows to define the physical layout of your lights arround\r
+the screen.\r
+"Number of zones on top" -- how many light sources are place on top of the screen\r
+ (number of columns in which the screen should be tiled)\r
+\r
+"Number of zones on bottom" -- how many light sources are place on bottom of the screen\r
+ (number of columns in which the screen should be tiled)\r
+\r
+"Zones on left / right side" -- how many light sources are place on right/left of the screen\r
+ (number of rows in which the screen should be tiled)\r
+ its assumed that the number on right and left is equal.\r
+\r
+"[] Calculate a average zone" -- define a color pair depending on the complete screen content\r
+\r
+This settings tiles the screen into a number of zones - which get analyzed by atmoLight to\r
+determine a most used color for these areas - each zone has a number starting from zero.\r
+The zones are usualy numbered in clock-wise order starting at the top/left of the screen.\r
+\r
+Example 1: classic Atmo with 4 channels\r
+---------------------------------------\r
+"Number of zones on top" = 1\r
+"Number of zones on bottom" = 1\r
+"Zones on left / right side" = 1\r
+"[] Calculate a average zone" = false/0 not checked.\r
+\r
+will produce this zone layout\r
+ ----------- \r
+ | Zone 0 | \r
+---------------------\r
+| | | | \r
+| Z | | Z | \r
+| o | | o |\r
+| n | | n |\r
+| e | | e | \r
+| | | | \r
+| 3 | | 1 | \r
+---------------- ----\r
+ | Zone 2 |\r
+ -----------\r
+\r
+\r
+Example 2: classic Atmo with 4 channels\r
+---------------------------------------\r
+"Number of zones on top" = 2\r
+"Number of zones on bottom" = 0\r
+"Zones on left / right side" = 1\r
+"[] Calculate a average zone" = false/0 not checked.\r
+\r
+ ----------- -----------\r
+ | Zone 0 | | Zone 1 |\r
+---------------------------------\r
+| | | | \r
+| Z | | Z | \r
+| o | | o |\r
+| n | | n |\r
+| e | | e | \r
+| | | | \r
+| 3 | | 2 | \r
+----- -----\r
+\r
+Example 3: classic Atmo with 4 channels\r
+---------------------------------------\r
+"Number of zones on top" = 1\r
+"Number of zones on bottom" = 0\r
+"Zones on left / right side" = 1\r
+"[X] Calculate a average zone" = true/1 checked.\r
+ \r
+ ----------- \r
+ | Zone 0 | \r
+---------------------\r
+| | -------- | | \r
+| Z | | Z | | Z | \r
+| o | | o | | o |\r
+| n | | n | | n |\r
+| e | | e | | e | \r
+| | | 3 | | | \r
+| 2 | -------- | 1 | \r
+----- -----\r
+Zone 3 - usualy calcuates the most used color of the full screen / picture / frame\r
+not only at the border of the picture.\r
+\r
+"The average zone" is allways the last in the sequence of numbers.\r
+\r
+\r
+ \r
+the weightning gradients for these zones are auto calculated\r
+from 100% .. 0% starting from the edge.\r
+\r
+thats also the cause why the parameters Channel assignment changed,\r
+the classic comboboxes are still there for devices with 4 channels ot less,\r
+but for newer devices the "Channel / Zone assignment" should be used which\r
+is defined by a , or ; separated list of "AtmoLight channel numbers" if you\r
+want to hide a calcuated zone from output - you can assign channel -1 to\r
+do this. \r
+for classic AtmoLight with "Example 1" you may write this:\r
+-1;3;2;1;0 \r
+AtmoLight Channel 0: gets no zone assigned (-1)\r
+AtmoLight Channel 1: gets zone 3 (left)\r
+AtmoLight Channel 2: gets zone 2 (bottom)\r
+AtmoLight Channel 3: gets zone 1 (right)\r
+AtmoLight Channel 4: gets zone 0 (top)\r
+\r
+\r
+Also the settings for Gradient images change for the new devices, its no longer\r
+sufficient to speficy only 5 image name - because the number of zones is no longer\r
+fixed to five.\r
+So its prefered to set a path ("Gradient Bitmap searchpath"), where files \r
+like "zone_0.bmp" "zone_1.bmp" etc. exists. (with the same rules as defined for \r
+the old zone bitmaps.)\r
+--> I think in most cases its no longer required to use this option,\r
+to change the zone layout - for most cases its sufficient to change \r
+"Zone Layout for the build-in Atmo" to get the same effect?\r
+\r
+Live Set of parameters for Buildin AtmoLight\r
+============================================\r
+durring playback with the buildin driver you can now change some settings\r
+of the filter without stopping / starting your movie - just open the\r
+"extras" --> "Effects and Filters" --> [Video effects] --> [AtmoLight]\r
+- move the sliders or change the calcuation mode, or enable/disable\r
+the debug grid - just in time.\r
+\r
+\r
+new Debugging Option\r
+====================\r
+[] Mark analyzed pixels - puts a grid of the used pixels on each frame\r
+to see from which locations/positions the colors are extracted.\r
+\r
+DMX Options\r
+-----------\r
+like the group says only for the DMX device\r
+"Count of AtmoLight Channels" - defines how many RGB Channels should be simulated\r
+with this DMX device (each RGB channel needs three DMX channels!)\r
+\r
+"DMX adress for each channel" - defines the DMX Startadress for each AtmoLight\r
+channel as "," or ";" separated list. (starting with 0 up to 252) it is assumed\r
+that the f.e. of the DMX-AtmoLight channel starts at DMX-Channel 5 - that\r
+DMX-Channel 5: is red\r
+DMX-Channel 6: is green\r
+DMX-Channel 7: is blue!\r
+\r
+MoMoLight options\r
+-----------------\r
+"Count of channels" - defines the devicetype and serial protocol \r
+3: - means 3 channels hardware\r
+4: - means 4 channels hardware\r
+(its required to set the correct number of channels to get this device working,\r
+ because the serial protocol isn't the same!)\r
+\r
+\r
+\r
+VideoLan Options and Devices - the buildin version of AtmoLight supports a subset of the\r
+devices that AtmoWin supports.\r
+\r
+- AtmoWin Software - means do not use the VLC buildin video processing - just forward\r
+ the basic preprocessed data to the launched AtmoWinA.exe controlling your hardware.\r
+\r
+- Classic AtmoLight - means the classic hardware from www.vdr-portal.de - with up to 5 channels. \r
+\r
+- Quattro AtmoLight - is nothing else as that you have connected up to 4 "classic AtmoLight" devices\r
+ to your computer creating a up 16 channel Atmo Light - each devices needs its own serial port.\r
+ you have to write the ports seperated by , or ; to [Serial Port/device] f.e. COM3,COM4,COM5 or on \r
+ Linux /dev/ttyUSB01,/dev/ttyUSB02,/dev/ttyUSB03\r
+\r
+- DMX - stands for a simple DMX controller which can control up to 255 DMX devices (lights)\r
+ - f.e. you may have a look here: \r
+ * http://www.dzionsko.de/elektronic/index.htm\r
+ * http://www.ulrichradig.de/ (search for dmx on his page)\r
+ \r
+- MoMoLight - is a serial device, with 3 or 4 channels - doing nearly the same like\r
+ Classic AtmoLight - just another protocol to control the hardware.\r
+ http://lx.divxstation.com/article.asp?aId=151\r
+ http://www.the-boss.dk/pages/momolight.htm\r
+\r
+\r
+\r
+\r
+\r
+Original Readme - of the Linux Version - from where some code was used\r
+to do the color calculations ...\r
+\r
+######################################################################\r
+Original Readme and Authors of the Linux VDR Plugin!\r
+######################################################################\r
+\r
+Written by: Eike Edener <vdr@edener.de>\r
+Project's homepage: www.edener.de\r
+Latest version available at: www.edener.de\r
+See the file COPYING for license information.\r
+----------------------------------------------------------------------\r
+\r
+for detailed informations visit the VDR-Wiki:\r
+http://www.vdr-wiki.de/wiki/index.php/Atmo-plugin\r
+\r
+Development:\r
+http://www.vdr-portal.de/board/thread.php?threadid=48574\r
+\r
+Known bugs:\r
+n/a\r
+\r
+----------------------------------------------------------------------\r
projects / vlc / blobdiff