git.sesse.net Git - kdenlive/blob - effects/frei0r_lightgraffiti.xml

   1 <!DOCTYPE kpartgui>
   2 <effect tag="frei0r.lightgraffiti" id="frei0r.lightgraffiti">
   3         <name>Light Graffiti</name>
   4         <description>Light Graffiti effect.
   5         <full><![CDATA[This effect allows to do Light Painting (i.e. painting with light sources on a photo by keeping the shutter
   6         opened for a while), but for video.]]></full></description>
   7         <author>Simon A. Eugster (Granjow)</author>
   8         <parameter type="constant" name="sensitivity" default="100" min="0" max="500" factor="100">
   9             <name>Sensitivity</name>
  10             <comment><![CDATA[Light sensitivity.<br/>
  11             For slowly moving light source try to use a higher sensitivity to obtain smoother results.]]></comment>
  12         </parameter>
  13         <parameter type="constant" name="thresholdBrightness" default="450" min="0" max="765" factor="1">
  14             <name>Brightness Threshold</name>
  15             <comment><![CDATA[Determines how bright (<code>R+G+B</code>) a light source needs to be in order to be recognized as light source.<br/>
  16             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>
  17         </parameter>
  18         <parameter type="constant" name="thresholdDifference" default="80" min="0" max="255" factor="1">
  19             <name>Difference Threshold</name>
  20             <comment><![CDATA[Similar to the brightness threshold, but for the brightness difference (<code>max(dR, dG, dB)</code>) <em>relative to the calculated background.</em><br/>
  21             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>
  22         </parameter>
  23         <parameter type="constant" name="thresholdDiffSum" default="0" min="0" max="765" factor="1">
  24             <name>Difference Sum Threshold</name>
  25             <comment><![CDATA[Threshold for the differences summed up (<code>dR + dG + dB</code>).<br/>
  26             Raising this value might, in some cases, avoid that some light objects lit by the light source are added to the light mask.]]></comment>
  27         </parameter>
  28         <parameter type="constant" name="dim" default="0" min="0" max="255" factor="255">
  29             <name>Dimming</name>
  30             <comment>Dims the light mask. Lights will leave a fainting trail if it is set to a value > 0.</comment>
  31         </parameter>
  32         <parameter type="constant" name="backgroundWeight" default="0" min="0" max="100" factor="100">
  33             <name>Background Weight</name>
  34             <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>
  35         </parameter>
  36         <parameter type="constant" name="longAlpha" default="0" min="0" max="256" factor="256">
  37                 <name>α</name>
  38                 <comment><![CDATA[Determines how the effect tries to adapt to background changes. <br/>
  39                 If the background does not change, then try to use 0 (requires the first frame to represent background only, without your light sources).]]></comment>
  40         </parameter>
  41         <parameter type="bool" name="statsBrightness" default="0">
  42             <name>Show brightness statistics</name>
  43         </parameter>
  44         <parameter type="bool" name="statsDifference" default="0">
  45             <name>Show background difference statistics</name>
  46         </parameter>
  47         <parameter type="bool" name="transparentBackground" default="0">
  48             <name>Transparent Background</name>
  49         </parameter>
  50         <parameter type="bool" name="reset" default="0">
  51             <name>Reset the mask</name>
  52         </parameter>
  53 </effect>