Difference between revisions of "Documentation:Modules/bluescreen"

From VideoLAN Wiki
Jump to navigation Jump to search
m (Repair external link × 2, +sc, expand, misc.)
 
(9 intermediate revisions by 5 users not shown)
Line 1: Line 1:
{{Module|name=bluescreen|type=Video filter|first_version=0.9.0|description=change the video's alpha channel}}
+
{{Mosaic framework}}
 +
{{Module|name=bluescreen|type=Video filter|first_version=0.9.0|description=Change the video's alpha channel|sc=bluescreen}}
  
This filter can be used in the mosaic framework to set a video's alpha channel (or transparency) based on a pixel's color. This is also known as green screen or chroma key blending and can be used to create effects like on most weather channels.
+
This filter can be used in the mosaic framework to set a video's alpha channel (or transparency) based on a pixel's color. This is also known as [[wikipedia:green screen|green screen]] or chroma key blending and can be used to create effects like on most weather channels.
  
 +
== Options ==
 
{{Option
 
{{Option
 
|name=bluescreen-u
 
|name=bluescreen-u
 
|value=integer
 
|value=integer
 +
|min=0
 +
|max=255
 
|default=120
 
|default=120
|description=U chroma component (0 to 255)
+
|description=U chroma component.
 
}}
 
}}
 
 
{{Option
 
{{Option
 
|name=bluescreen-v
 
|name=bluescreen-v
 
|value=integer
 
|value=integer
 +
|min=0
 +
|max=255
 
|default=90
 
|default=90
|description=V chroma component (0 to 255)
+
|description=V chroma component.
 
}}
 
}}
 
 
{{Option
 
{{Option
 
|name=bluescreen-ut
 
|name=bluescreen-ut
 
|value=integer
 
|value=integer
 +
|min=0
 +
|max=255
 
|default=17
 
|default=17
|description=U chroma component threshold (0 to 255)
+
|description=Tolerance of the bluescreen blender on color variations for the U plane. A value between 10 and 20 seems sensible.
 
}}
 
}}
 
 
{{Option
 
{{Option
 
|name=bluescreen-vt
 
|name=bluescreen-vt
 
|value=integer
 
|value=integer
 +
|min=0
 +
|max=255
 
|default=17
 
|default=17
|description=V chroma component threshold (0 to 255)
+
|description=Tolerance of the bluescreen blender on color variations for the V plane. A value between 10 and 20 seems sensible.
 
}}
 
}}
  
Example use:
+
== Example ==
  % '''vlc -I telnet --color -vvv --vlm-conf mosaic.vlm --mosaic-keep-picture \'''
+
  % '''vlc -vvv --vlm-conf mosaic.vlm --mosaic-keep-picture --sub-filter mosaic'''
  '''--no-audio --sub-filter mosaic'''
 
  
 
And the vlm config:
 
And the vlm config:
Line 39: Line 45:
 
  new channel0 broadcast enabled
 
  new channel0 broadcast enabled
 
  setup channel0 input rushfondvert.avi
 
  setup channel0 input rushfondvert.avi
  setup channel0 output #duplicate{dst=mosaic-bridge{id=0,height=270,width=360,vfilter=bluescreen},select=video}
+
  setup channel0 output #duplicate{dst=mosaic-bridge{chroma=YUVA,vfilter=bluescreen},select=video}
 
    
 
    
 
  new background broadcast enabled
 
  new background broadcast enabled
Line 47: Line 53:
 
  control channel0 play
 
  control channel0 play
  
Have a look at http://people.videolan.org/~dionoea/bluescreen2.mpg for an example of the VLC bluescreen filter. The overlay video is http://people.videolan.org/~dionoea/rushfondvert.avi and features someone with a mask in front of a green background. The bluescreen module's default values are adjusted to remove the background from this video. For other videos you should use your favorite color editing tool to find out the appropriate U and V values.
+
Have a look at [https://web.archive.org/web/20060819104251/http://people.videolan.org/~dionoea/bluescreen2.mpg people.videolan.org/~dionoea/bluescreen2.mpg (archived)] for an example of the VLC bluescreen filter. The overlay video is [https://web.archive.org/web/20061205222657/http://people.videolan.org/~dionoea/rushfondvert.avi rushfondvert.avi (archived)] and features someone with a mask in front of a green background. The bluescreen module's default values are adjusted to remove the background from this video. For other videos you should use your favorite color editing tool to find out the appropriate U and V values.
 +
 
 +
== Another example ==
 +
Tested with VLC 2.0.0
 +
 
 +
new channel0 broadcast enabled
 +
setup channel0 input rushfondvert.avi
 +
setup channel0 output #duplicate{dst=mosaic-bridge{height=270,width=360,chroma=YUVA,vfilter=bluescreen},select=video}:display
 +
 +
new background broadcast enabled
 +
setup background input file:///mire.jpg
 +
 +
control background play
 +
control channel0 play
 +
 
 +
== Source code ==
 +
* {{VLCSourceFile|modules/video_filter/bluescreen.c}}
 +
 
 +
== See also ==
 +
* [[YUV]]
  
See also:
+
{{Documentation footer}}
* [[Documentation:Modules/mosaic]]
 
* [[Documentation:Modules/mosaic-bridge]]
 
* http://en.wikipedia.org/wiki/YUV
 

Latest revision as of 08:15, 31 May 2019

Mosaic framework (How-To)
Modules: mosaic (mosaic-bridgebridge-inbridge-out) • alphamaskbluescreen
Module: bluescreen
Type Video filter
First VLC version 0.9.0
Last VLC version -
Operating system(s) all
Description Change the video's alpha channel
Shortcut(s) bluescreen

This filter can be used in the mosaic framework to set a video's alpha channel (or transparency) based on a pixel's color. This is also known as green screen or chroma key blending and can be used to create effects like on most weather channels.

Options

  • bluescreen-u <integer [0 .. 255]> : U chroma component. default value: 120
  • bluescreen-v <integer [0 .. 255]> : V chroma component. default value: 90
  • bluescreen-ut <integer [0 .. 255]> : Tolerance of the bluescreen blender on color variations for the U plane. A value between 10 and 20 seems sensible. default value: 17
  • bluescreen-vt <integer [0 .. 255]> : Tolerance of the bluescreen blender on color variations for the V plane. A value between 10 and 20 seems sensible. default value: 17

Example

% vlc -vvv --vlm-conf mosaic.vlm --mosaic-keep-picture --sub-filter mosaic

And the vlm config:

new channel0 broadcast enabled
setup channel0 input rushfondvert.avi
setup channel0 output #duplicate{dst=mosaic-bridge{chroma=YUVA,vfilter=bluescreen},select=video}
 
new background broadcast enabled
setup background input redefined-nintendo.mpg
control background play
 
control channel0 play

Have a look at people.videolan.org/~dionoea/bluescreen2.mpg (archived) for an example of the VLC bluescreen filter. The overlay video is rushfondvert.avi (archived) and features someone with a mask in front of a green background. The bluescreen module's default values are adjusted to remove the background from this video. For other videos you should use your favorite color editing tool to find out the appropriate U and V values.

Another example

Tested with VLC 2.0.0

new channel0 broadcast enabled
setup channel0 input rushfondvert.avi
setup channel0 output #duplicate{dst=mosaic-bridge{height=270,width=360,chroma=YUVA,vfilter=bluescreen},select=video}:display

new background broadcast enabled
setup background input file:///mire.jpg

control background play
control channel0 play

Source code

See also

This page is part of official VLC media player Documentation (User GuideStreaming HowToHacker GuideModules)
Please read the Documentation Editing Guidelines before you edit the documentation
Permission is granted to copy, distribute and/or modify this document under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.