CombinePlanes - Revision history

Reel.Deal: /* Add/Remove Alpha Plane */ add link to avs+ documentation

2022-09-17T18:42:23Z

‎Add/Remove Alpha Plane: add link to avs+ documentation

Pinterf: /* Add/Remove Alpha Plane */ AddAlphaPlane mask source as single greyscale clip or a number

2018-03-05T14:17:09Z

‎Add/Remove Alpha Plane: AddAlphaPlane mask source as single greyscale clip or a number

Raffriff42: tweak appearance

2017-04-23T21:32:56Z

tweak appearance

Raffriff42: typo

2017-04-23T21:18:48Z

typo

Raffriff42: add RemoveAlphaPlane, AddAlphaPlane

2017-04-23T10:36:41Z

add RemoveAlphaPlane, AddAlphaPlane

Raffriff42: typo

2017-04-21T18:55:12Z

typo

Raffriff42: tweak appearance

2017-04-21T18:52:23Z

tweak appearance

Raffriff42: add infobox

2017-04-21T16:43:31Z

add infobox

Raffriff42: typo

2017-04-21T14:55:01Z

typo

Raffriff42: Avisynthplus - new filter

2017-04-21T14:47:30Z

Avisynthplus - new filter

New page

Combines planes of source clip(s) into a target clip. Similar to ShufflePlanes in Vapoursynth.<br>
Performs the functionality of [[SwapUV]], [[YToUV]], [[MergeChroma]], [[MergeRGB]] and more.
__TOC__

=== Syntax and Parameters ===
<div style="max-width:62em" >
{{FuncDef|CombinePlanes(clip, <br>
      [string ''planes'', string ''source_planes'', string ''pixel_type'', clip ''sample_clip'' ] )}}

{{FuncDef|CombinePlanes(clip, clip, <br>
      [string ''planes'', string ''source_planes'', string ''pixel_type'', clip ''sample_clip'' ] )}}

{{FuncDef|CombinePlanes(clip, clip, clip, <br>
      [string ''planes'', string ''source_planes'', string ''pixel_type'', clip ''sample_clip'' ] )}}

{{FuncDef|CombinePlanes(clip, clip, clip, clip, <br>
      [string ''planes'', string ''source_planes'', string ''pixel_type'', clip ''sample_clip'' ] )}}

:{{Par2||clip|}}
::Source clip(s). At least one is required. Up to four clips are accepted.
::Each clip defines a color plane in the output, as defined by the {{FuncArg|planes}} and {{FuncArg|source_planes}} arguments.
::If the clip count is less than the given planes defined, then the last available clip is used as a source for all later planes.

:{{Par2|planes|string|""}}
::The target plane order (e.g. "YVU", "YYY", "RGB"); missing target planes will be undefined in the target.

:{{Par2|source_planes|string|"YUVA" or "RGBA"}}
::The source plane order, defaulting to "YUVA" or "RGBA" depending on the video format.

::Source clips can even be mixed from greyscale, YUV, YUVA or planar RGB(A) — the only rule being that the relevant source plane character should match with the clip format, respectively.

:{{Par2|pixel_type|string|}}
::Set color format of the returned clip. Supports all [[Avisynthplus_color_formats|AVS+ color formats]].

:{{Par2|sample_clip|clip|}}
::If supplied, output {{FuncArg|pixel_type}} will match that of {{FuncArg|sample_clip}}.

</div>
==== Examples ====
<div style="max-width:62em" >
<div {{BoxWidthIndent|64|2}} >
#combine greyscale clips into YUVA clip
U8 = source.UToY8()
V8 = source.VToY8()
Y8 = source.ConvertToY()
A8 = source.AddAlphaPlane(128).AToY8()
CombinePlanes(Y8, U8, V8, A8, planes="YUVA", source_planes="YYYY",
\ sample_clip=source) #pixel_type="YUV444P8"
</div>

<div {{BoxWidthIndent|64|2}} >
# Copy planes between planar RGB(A) and YUV(A) without any conversion
# yuv 4:4:4 <-> planar rgb
source = last.ConvertBits(32) # 4:4:4
cast_to_planarrgb = CombinePlanes(source, planes="RGB", source_planes="YUV",
\ pixel_type="RGBPS")
# get back a clip identical with "source"
cast_to_yuv = CombinePlanes(cast_to_planarrgb, planes="YUV", source_planes="RGB",
\ pixel_type="YUV444PS")
</div>

<div {{BoxWidthIndent|64|2}} >
#create a black and white planar RGB clip using Y channel
#source is a YUV clip
grey = CombinePlanes(source, planes="RGB", source_planes="YYY",
\ pixel_type="RGBP8")
</div>

<div {{BoxWidthIndent|64|2}} >
#copy luma from one clip, U and V from another
#source is the template
#sourceY is a Y or YUV clip
#sourceUV is a YUV clip
grey = CombinePlanes(sourceY, sourceUV, planes="YUV",
\ source_planes="YUV", sample_clip = source)
</div>

==== Changes ====
{|border=1 cellspacing=1 cellpadding=4
|-
| 20161110
| first added
|}
</div>

[[Category:Internal_filters]]
[[Category:Levels_and_Chroma_filters]]
[[Category:Avisynthplus]]

@@ Line 42: / Line 42: @@
 ==== Add/Remove Alpha Plane ====
 Adds or removes the RGB or YUV alpha plane.<br>
 If an alpha plane was present, calling '''AddAlphaPlane''' replaces it.<br>
@@ Line 47: / Line 54: @@
 Although RGB24, RGB32, RGB48 and RGB64 are not planar colorspaces, the alpha is handled for them as well.
-{{FuncDef|AddAlphaPlane(clip, clip ''mask'' ] )}} <br>
+{{FuncDef|AddAlphaPlane(clip, clip ''mask'' )}} <br>
-{{FuncDef|AddAlphaPlane(clip, float ''mask'' ] )}} <br>
+{{FuncDef|AddAlphaPlane(clip, float ''mask'')}} <br>
-{{FuncDef|AddAlphaPlane(clip, int ''mask'' ] )}} <br>
+{{FuncDef|AddAlphaPlane(clip, int ''mask'')}} <br>
 {{FuncDef|RemoveAlphaPlane(clip)}}

@@ Line 44: / Line 44: @@
 Adds or removes the RGB or YUV alpha plane.<br>
 If an alpha plane was present, calling '''AddAlphaPlane''' replaces it.<br>
-If an alpha plane was not present, calling '''RemoveAlphaPlane''' does nothing.
+If an alpha plane was not present, calling '''RemoveAlphaPlane''' does nothing.<br>
 {{FuncDef|AddAlphaPlane(clip, clip ''mask'' ] )}} <br>
 {{FuncDef|RemoveAlphaPlane(clip)}}
@@ Line 53: / Line 56: @@
 :{{Par2|mask|clip|}}
-::If supplied, the alpha plane from {{FuncArg|mask}} is copied to the resulting clip.
+::alpha source clip
 </div>

@@ Line 41: / Line 41: @@
 ::If supplied, output {{FuncArg|pixel_type}} will match that of {{FuncArg|sample_clip}}.
-==== RemoveAlphaPlane ====
+==== Add/Remove Alpha Plane ====
-Removes the RGB or YUV alpha plane.<br>
+Adds or removes the RGB or YUV alpha plane.<br>
-If no alpha plane was present, nothing is changed.
+If an alpha plane was present, calling '''AddAlphaPlane''' replaces it.<br>
 {{FuncDef|RemoveAlphaPlane(clip)}}
 :{{Par2||clip|}}

@@ Line 46: / Line 46: @@
 {{FuncDef|RemoveAlphaPlane(clip)}}
 ==== AddAlphaPlane ====
@@ Line 54: / Line 57: @@
 :{{Par2||clip|}}
-::Source clip(s).
+::Source clip.
 :{{Par2|mask|clip|}}

@@ Line 1: / Line 1: @@
 <div style="max-width:82em; min-width:42em;" >
-{{AvsPlusFilter}}Combines planes of source clip(s) into a target clip. Similar to ShufflePlanes in Vapoursynth. Performs the functionality of [[SwapUV]], [[YToUV]], [[MergeChroma]], [[MergeRGB]] and more.
+{{AvsPlusFilter}}
 </div>
 __TOC__
 <div style="max-width:62em; min-width:42em;" >
 {{FuncDef|CombinePlanes(clip, <br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp; [string ''planes'', string ''source_planes'', string ''pixel_type'', clip ''sample_clip'' ] )}}
@@ Line 39: / Line 41: @@
 ::If supplied, output {{FuncArg|pixel_type}} will match that of {{FuncArg|sample_clip}}.
 </div>
 ==== Examples ====
 <div style="max-width:62em; min-width:42em;" >

@@ Line 1: / Line 1: @@
-Combines planes of source clip(s) into a target clip. Similar to ShufflePlanes in Vapoursynth.<br>
+{{AvsPlusFilter}}Combines planes of source clip(s) into a target clip. Similar to ShufflePlanes in Vapoursynth. Performs the functionality of [[SwapUV]], [[YToUV]], [[MergeChroma]], [[MergeRGB]] and more.
 Performs the functionality of [[SwapUV]], [[YToUV]], [[MergeChroma]], [[MergeRGB]] and more.
 __TOC__
@@ Line 39: / Line 40: @@
 ==== Examples ====
 <div style="max-width:62em" >
-<div {{BoxWidthIndent|64|2}} >
+<div {{BoxWidthIndent|54|2}} >
   #combine greyscale clips into YUVA clip
   U8 = source.UToY8()
@@ Line 49: / Line 50: @@
 </div>
-<div {{BoxWidthIndent|64|2}} >
+<div {{BoxWidthIndent|54|2}} >
   # Copy planes between planar RGB(A) and YUV(A) without any conversion
   # yuv 4:4:4 <-> planar rgb
@@ Line 60: / Line 61: @@
 </div>
-<div {{BoxWidthIndent|64|2}} >
+<div {{BoxWidthIndent|54|2}} >
   #create a black and white planar RGB clip using Y channel
   #source is a YUV clip
@@ Line 67: / Line 68: @@
 </div>
-<div {{BoxWidthIndent|64|2}} >
+<div {{BoxWidthIndent|54|2}} >
   #copy luma from one clip, U and V from another
   #source is the template

@@ Line 3: / Line 3: @@
 __TOC__
-=== Syntax and Parameters ===
+==== Syntax and Parameters ====
 <div style="max-width:62em" >
 {{FuncDef|CombinePlanes(clip, <br>