1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
|
This is a "post plugin" for xine based media players.
Written by: Andreas Auras (yak54@gmx.net)
See the file COPYING for license information.
Many ideas and algorithm for this plugin had been derived from the fantastic
Atmolight-plugin for the Video Disk Recorder (VDR) that was developed by
Eike Edener.
Description:
------------
The "atmo" post plugin analyze the video picture and generates
output data for so called "atmolight" controllers.
For detailed informations about "atmolight" visit the VDR-Wiki:
http://www.vdr-wiki.de/wiki/index.php/Atmo-plugin
http://www.vdr-wiki.de/wiki/index.php/DF10CH
This project is hosted at:
http://projects.vdr-developer.org/projects/show/xine-lib-atmolight
!!!NOTE!!!!
Currently this plugin supports only grabbing of video from VDPAU
enabled devices!
Requirements:
-------------
xine-lib-vdpau or xine-lib-1.2 with vdpau support
Both version must have the vdpau extension patches version v15 or greater from here:
http://www.vdr-portal.de/board/thread.php?threadid=86804
For compiling the plugin the xine-lib and libusb-1.0 development
files have to be installed. On debian based systems these are
packages libxine-dev and libusb-1.0-0-dev.
Compiling and installation:
---------------------------
make
make install
Configuration:
--------------
Load this plugin as a post plugin in your xine based media player.
For the VDR xineliboutput player or xine-ui player add a command line option like this:
--post=atmo:driver=classic,driver_param=/dev/ttyS0,top=1,bottom=1,left=1,right=1,center=1
When using DF10CH controller(s):
--post atmo:driver=df10ch
Parameters understood by this plugin:
-------------------------------------
The plugin stores the actual parameter setting in the xinelib config file
under the key 'post.atmo.parameters'.
Plugin parameters specified at the command line are mandatory and always
override the parameters stored in the xinelib config file at startup time.
You should specify all 'static' parameters like output driver or section layout
at the command line.
Parameters that you wish to trim while player is running should not be specified within the
command line. Player's like xine-ui have GUI support for changing plugin parameters
(press <alt><shift>p to show the post processing panel).
Changes of Parameters marked with * will be immediately applied while player is running.
The other parameters will be applied after a stream close/open sequence (this happens already
when switching a channel within VDR).
Parameter Default Description
driver none Selects output driver. Currently supported are:
file Write output data to file. Usefull for
testing and debuging.
classic Send output data to serial port. Used
Protokoll is for "classic" Atmolight
2 channel controller. See:
http://www.vdr-wiki.de/wiki/index.php/Atmo-plugin
df4ch Send output data to serial port. Used
Protokoll is for my own designed 4 channel
controller.
df10ch Send output data via libusb to my own designed
DF10CH 10ch Controller(s).
driver_param Parameter for output driver:
file: File name of output file. If not specified
"xine_atmo_data.out" is used.
classic, df4ch:
Path of serial device e.g. /dev/ttyS0
For users with usb-to-serial converters the
device could be specified as a regular expression
that is looked up in /proc/tty/driver/usbserial to
evaluate the /dev/ttyUSB device. The parameter must
start with "usb:" followed by the regular expression
e.g.: usb:pl2303.*usb-.*-[^6]
df10ch:
All connected controllers are scanned automatically. No
parameter required here.
top
bottom
left
right
center
top_left
top_right
bottom_left
bottom_right 0 Number of RGB channel groups per Area.
For top, bottom, left and right area more then one group could be
specified. This will be usefull when "next generation" controllers
like DF10CH are available. See the "aurora" project at:
http://www.vdr-portal.de/board/thread.php?threadid=71741&hilight=aurora
Valid values: 0 ... 25 for top, bottom, left, right
Valid values: 0 ... 1 for center, top_left, top_right, bottom_left, bottom_right
NOTE!!!: Starting from plugin version 0.3 for "classic" controllers you must define one
group for area top, bottom, left, right and center as plugin parameter!!!
For DF10CH controller you do not have to specify these parameters here because they are read
from the controller configuration data. Use the DF10CH setup program to configure your
desired layout.
analyze_rate * 40 Rate of frame grabbing and video analysis. Unit milliseconds.
Valid values: 10 ... 500
analyze_size * 1 Size of analyze window. The window width is calculated by (analyze_size+1)*64 pixel.
The window height is calcuated aspect correct according to the grabbed video
window size. So a analyze size of 1 for a 16:9 video will give us a 128x72 pixel
analyze window.
Valid values: 0 ... 3
For DF10CH controller you do not have to specify this parameter here because it is read
from the controller configuration data. Use the DF10CH setup program to configure your
desired analyze size.
overscan * 30 Ignored overscan border of grabbed video frame.
Unit is percentage of 1000. e.g. 30 -> 3%
Valid values: 0 ... 200
For DF10CH controller you do not have to specify this parameter here because it is read
from the controller configuration data. Use the DF10CH setup program to configure your
desired overscan.
edge_weighting * 60 Power of edge weighting.
Value is divided by 10 e.g. 80 -> power of 8
Valid values 10 ... 200
For DF10CH controller you do not have to specify this parameter here because it is read
from the controller configuration data. Use the DF10CH setup program to configure your
desired edge weighting.
darkness_limit * 1 Minimum brightness of pixel. Value's below are interpreted as black pixel.
Used to detect and skip "black borders" in video.
Valid values are 0 ... 100
hue_win_size * 3 Windowing size for HUE. Valid values 0 ... 5
sat_win_size * 3 Windowing size for saturation. Valid values 0 ... 5
hue_treshold * 93 Threshold limit for change of color.
Unit percentage of 100. Valid values 1 ... 100
filter * combined Select's smoothness filter. Currently there are two filters
supported: percentage and combined.
Valid values: off, percentage, combined
filter_smoothness * 50 Controls filter smoothness of percentage filter.
Unit percentage of 100. Valid values 1 ... 100
filter_length * 500 Controls filter length of combined filter.
Unit milliseconds. Valid values 300 ... 5000
filter_threshold * 40 Controls filter threshold of combined filter.
Unit percentage of 100. Valid values 1 ... 100
brightness * 100 Controls brightness of generated color values.
Unit percentage of 100. Valid values 50 ... 300
Note: When using DF10CH controller(s) it is better to use the white calibration or
common brightness feature of the DF10CH setup program instead of this
parameter because you will lose lesser or no PWM resolution.
wc_red
wc_green
wc_blue * 255 White calibration values for red, green and blue channel.
Valid values 0 ... 255.
Note: When using DF10CH controller(s) it is better to use the white calibration
feature of the DF10CH setup program instead of this parameter because you will
lose lesser PWM resolution.
gamma * 0 Gamma correction factor for red, green and blue channel.
Value is divided by 10 e.g. 25 -> gamma 2.5
Valid values 0 ... 50. 0 means no gamma correction
Note: When using DF10CH controller(s) it is better to use the gamma calibration
feature of the DF10CH setup program instead of this parameter because you will
lose no PWM resolution.
start_delay * 250 Delay after stream start before first output is send [ms].
Valid values 0 ... 5000.
enabled * 1 Enable/Disable output of color values to atmolight controller.
Additional patches located in subdirectory 'patches':
-----------------------------------------------------
xine-ui-atmolight-switch.patch
This is a patch for the xine-ui player that extends the player with a 'AtmolightEnable' command
to switch the Atmolight on/off.
The command can be bound to keyboard or LIRC keys but it is not supported by the remote interface.
xineliboutput-atmolight-switch.patch
This is a patch for the xineliboutput player that extends the player with a 'Atmolight' command
to switch the Atmolight on/off.
Send remote command "Atmolight" for toggling on/off, "Atmolight 0" for switching off or "Atmolight 1"
for switching on.
Also pressing keyboard key 'a' or sending LIRC command 'Atmolight' toggels the Atmolight.
|
