2 <effect tag="frei0r.lightgraffiti" id="frei0r.lightgraffiti">
3 <name>Light Graffiti</name>
4 <description>Light Graffiti effect.</description>
5 <author>Simon A. Eugster (Granjow)</author>
6 <parameter type="constant" name="longAlpha" default="0" min="0" max="256" factor="256">
8 <comment>Determines how the effect tries to adapt to background changes. <br/>
9 If the background does not change, then try to use 0 (requires the first frame to represent background only, without your light sources).</comment>
11 <parameter type="constant" name="lightOpacity" default="60" min="0" max="100" factor="100">
13 <comment>Basic opacity for a light source.<br/>
14 For slowly moving light source try to use a lower opacity value to obtain smoother results.</comment>
16 <parameter type="constant" name="opacitySmoothing" default="30" min="1" max="100" factor="10">
17 <name>Smoothing</name>
18 <comment>Smoothing of the light map according to the light source. <br/>
19 A value of 1 results in absolutely smooth transitions from background to light source, but might result in too weak lights. The maximum value gives sharper edges and stronger lights.</comment>
21 <parameter type="constant" name="backgroundWeight" default="0" min="0" max="100" factor="100">
22 <name>Background Weight</name>
23 <comment>Strength of the (calculated) background image. Setting it to 100 paints the light mask directly over the background, without any person in the image if the video starts with a «clean» background image.</comment>
25 <parameter type="constant" name="thresholdBrightness" default="450" min="0" max="765" factor="1">
26 <name>Brightness Threshold</name>
27 <comment>Determines how bright (<code>R+G+B</code>) a light source needs to be in order to be recognized as light source.<br/>
28 Increasing this threshold requires brighter light sources (i.e. more white or less color, respectively) but prevents some «false alarms» where semi-bright parts, e.g. hands where colors can change quite a lot compared to the background, are incorrectly recognized as light source.</comment>
30 <parameter type="constant" name="thresholdDifference" default="80" min="0" max="255" factor="1">
31 <name>Difference Threshold</name>
32 <comment>Similar to the brightness threshold, but for the brightness difference (<code>max(dR, dG, dB)</code>) <em>relative to the calculated background.</em><br/>
33 Increasing this threshold makes it harder for light sources to be accepted on bright backgrounds, but decreases the danger of noise counting as light source.</comment>
35 <parameter type="constant" name="thresholdDiffSum" default="0" min="0" max="765" factor="1">
36 <name>Difference Sum Threshold</name>
37 <comment>Threshold for the differences summed up (<code>dR + dG + dB</code>).<br/>
38 Raising this value might, in some cases, avoid that some light objects lit by the light source are added to the light mask.</comment>
40 <parameter type="constant" name="dim" default="0" min="0" max="255" factor="255">
42 <comment>Dims the light mask. Lights will leave a fainting trail if it is set to a value > 0.</comment>