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

← Older revision		Revision as of 20:42, 17 September 2022
Line 42:		Line 42:

	==== Add/Remove Alpha Plane ====		==== Add/Remove Alpha Plane ====

			<div {{BlueBox2\|40\|0\|3px solid purple}} >
			{{AvsPlusFullname}}<br>
			Up-to-date documentation: [https://avisynthplus.readthedocs.io/en/latest/avisynthdoc/corefilters/mask.html#addalphaplane https://avisynthplus.readthedocs.io]
			</div>


	Adds or removes the RGB or YUV alpha plane.<br>		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 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.		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)}}		{{FuncDef\|RemoveAlphaPlane(clip)}}

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

← Older revision		Revision as of 16:17, 5 March 2018
Line 44:		Line 44:
	Adds or removes the RGB or YUV alpha plane.<br>		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 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>
			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, int ''mask'' ] )}} <br>
	{{FuncDef\|RemoveAlphaPlane(clip)}}		{{FuncDef\|RemoveAlphaPlane(clip)}}

Line 53:		Line 56:

	:{{Par2\|mask\|clip\|}}		:{{Par2\|mask\|clip\|}}
	::If supplied, the alpha plane from {{FuncArg\|mask}} is copied to the resulting clip.		::alpha source clip

			::If supplied, and the clip is greyscale - IsY() is true - it is copied to the resulting clip.
			::If supplied, and the clip has alpha plane (such as RGBAP8 or RGB64) the alpha plane from {{FuncArg\|mask}} is copied to the resulting clip.

			or

			:{{Par2\|mask\|float\|}}
			::pixel value.
			or
			:{{Par2\|mask\|integer\|}}
			::pixel value
			::If the numeric-type {{FuncArg\|mask}} parameter is supplied, it will be used as filler value of the resulting alpha plane. No bit depth scaling happens, parameter value is used as-is.
	</div>		</div>

Raffriff42: tweak appearance

2017-04-23T21:32:56Z

tweak appearance

← Older revision		Revision as of 23:32, 23 April 2017
Line 41:		Line 41:
	::If supplied, output {{FuncArg\|pixel_type}} will match that of {{FuncArg\|sample_clip}}.		::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>
			If an alpha plane was not present, calling '''RemoveAlphaPlane''' does nothing.

			{{FuncDef\|AddAlphaPlane(clip, clip ''mask'' ] )}} <br>
	{{FuncDef\|RemoveAlphaPlane(clip)}}		{{FuncDef\|RemoveAlphaPlane(clip)}}

	~~:{{Par2\|\|clip\|}}~~
	~~::Source clip.~~

	~~==== AddAlphaPlane ====~~
	~~Adds an opaque RGB or YUV alpha plane, or copies the alpha from a {{FuncArg\|mask}} clip.<br>~~
	~~If an alpha plane was present, it is replaced.~~

	~~{{FuncDef\|AddAlphaPlane(clip, clip ''mask'' ] )}}~~

	:{{Par2\|\|clip\|}}		:{{Par2\|\|clip\|}}

Raffriff42: typo

2017-04-23T21:18:48Z

typo

← Older revision		Revision as of 23:18, 23 April 2017
Line 46:		Line 46:

	{{FuncDef\|RemoveAlphaPlane(clip)}}		{{FuncDef\|RemoveAlphaPlane(clip)}}

			:{{Par2\|\|clip\|}}
			::Source clip.

	==== AddAlphaPlane ====		==== AddAlphaPlane ====
Line 54:		Line 57:

	:{{Par2\|\|clip\|}}		:{{Par2\|\|clip\|}}
	::Source clip~~(s)~~.		::Source clip.

	:{{Par2\|mask\|clip\|}}		:{{Par2\|mask\|clip\|}}

Raffriff42: add RemoveAlphaPlane, AddAlphaPlane

2017-04-23T10:36:41Z

add RemoveAlphaPlane, AddAlphaPlane

@@ 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;" >

Raffriff42: typo

2017-04-21T18:55:12Z

typo

← Older revision		Revision as of 20:55, 21 April 2017
Line 1:		Line 1:
	<div style="max-width:~~62em~~; min-width:42em;" >		<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}}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.
	</div>		</div>

Raffriff42: tweak appearance

2017-04-21T18:52:23Z

tweak appearance

← Older revision		Revision as of 20:52, 21 April 2017
Line 1:		Line 1:
			<div style="max-width:62em; 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}}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.
			</div>


Line 5:		Line 7:

	==== Syntax and Parameters ====		==== Syntax and Parameters ====
	<div style="max-width:62em" >		<div style="max-width:62em; min-width:42em;" >
	{{FuncDef\|CombinePlanes(clip, <br>		{{FuncDef\|CombinePlanes(clip, <br>
	[string ''planes'', string ''source_planes'', string ''pixel_type'', clip ''sample_clip'' ] )}}		[string ''planes'', string ''source_planes'', string ''pixel_type'', clip ''sample_clip'' ] )}}
Line 39:		Line 41:
	</div>		</div>
	==== Examples ====		==== Examples ====
	<div style="max-width:62em" >		<div style="max-width:62em; min-width:42em;" >
	<div {{BoxWidthIndent\|54\|2}} >		<div {{BoxWidthIndent\|54\|2}} >
	#combine greyscale clips into YUVA clip		#combine greyscale clips into YUVA clip

Raffriff42: add infobox

2017-04-21T16:43:31Z

add infobox

← Older revision		Revision as of 18:43, 21 April 2017
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__		__TOC__

Line 39:		Line 40:
	==== Examples ====		==== Examples ====
	<div style="max-width:62em" >		<div style="max-width:62em" >
	<div {{BoxWidthIndent\|64\|2}} >		<div {{BoxWidthIndent\|54\|2}} >
	#combine greyscale clips into YUVA clip		#combine greyscale clips into YUVA clip
	U8 = source.UToY8()		U8 = source.UToY8()
Line 49:		Line 50:
	</div>		</div>

	<div {{BoxWidthIndent\|64\|2}} >		<div {{BoxWidthIndent\|54\|2}} >
	# Copy planes between planar RGB(A) and YUV(A) without any conversion		# Copy planes between planar RGB(A) and YUV(A) without any conversion
	# yuv 4:4:4 <-> planar rgb		# yuv 4:4:4 <-> planar rgb
Line 60:		Line 61:
	</div>		</div>

	<div {{BoxWidthIndent\|64\|2}} >		<div {{BoxWidthIndent\|54\|2}} >
	#create a black and white planar RGB clip using Y channel		#create a black and white planar RGB clip using Y channel
	#source is a YUV clip		#source is a YUV clip
Line 67:		Line 68:
	</div>		</div>

	<div {{BoxWidthIndent\|64\|2}} >		<div {{BoxWidthIndent\|54\|2}} >
	#copy luma from one clip, U and V from another		#copy luma from one clip, U and V from another
	#source is the template		#source is the template

Raffriff42: typo

2017-04-21T14:55:01Z

typo

← Older revision		Revision as of 16:55, 21 April 2017
Line 3:		Line 3:
	__TOC__		__TOC__

	=== Syntax and Parameters ===		==== Syntax and Parameters ====
	<div style="max-width:62em" >		<div style="max-width:62em" >
	{{FuncDef\|CombinePlanes(clip, <br>		{{FuncDef\|CombinePlanes(clip, <br>

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]]