Convert - Revision history

Pinterf: Update ConvertToXXXX, 3.7.3 change log, mention param1,param2,param3, Add YUVA versions, PC601,PC709 related additions, link to avs+ docs

2024-12-19T12:04:31Z

Update ConvertToXXXX, 3.7.3 change log, mention param1,param2,param3, Add YUVA versions, PC601,PC709 related additions, link to avs+ docs

Show changes

Pinterf: /* Changelog */ Frame prop _ChromaLocation

2021-12-09T14:00:25Z

Changelog: Frame prop _ChromaLocation

← Older revision		Revision as of 16:00, 9 December 2021
Line 430:		Line 430:
	\|-		\|-
	\| v3.7.1		\| v3.7.1
	\| Added ChromaOutPlacement to 4:2:2 related functions<br>Added new matrix constants, optional new syntax<br>Added new chroma location constants		\| Added ChromaOutPlacement to 4:2:2 related functions<br>Added new matrix constants, optional new syntax<br>Added new chroma location constants<br>Added _ChromaLocation frame property
	\|-		\|-
	\| v2.60		\| v2.60

Pinterf: /* Frame properties */ Add content

2021-12-09T13:59:35Z

Frame properties: Add content

@@ Line 365: / Line 365: @@
 ==== Notes ====
 <div style="max-width:62em" >
-===== Frame properties =====
+===== Frame properties {{AvsPluscon}} =====
 ===== Conversion paths =====

Pinterf: /* Notes */ Add section Frame properties

2021-12-09T13:51:21Z

Notes: Add section Frame properties

← Older revision		Revision as of 15:51, 9 December 2021
Line 365:		Line 365:
	==== Notes ====		==== Notes ====
	<div style="max-width:62em" >		<div style="max-width:62em" >
			===== Frame properties =====

	===== Conversion paths =====		===== Conversion paths =====

Line 387:		Line 389:
	:[[Color_conversions\|'''[This page]''']] covers the color conversions in more detail.		:[[Color_conversions\|'''[This page]''']] covers the color conversions in more detail.
	</div>		</div>


	==== Changelog ====		==== Changelog ====

Pinterf: /* Parameter Details */ Fix rec601 mapping as new-old matrix

2021-12-09T13:48:55Z

Parameter Details: Fix rec601 mapping as new-old matrix

← Older revision		Revision as of 15:48, 9 December 2021
Line 306:		Line 306:

	: For memo and the similar new string		: For memo and the similar new string
	:* "rec601" same as "~~170m~~:l"		:* "rec601" same as "470bg:l"
	:* "rec709" "709:l"		:* "rec709" "709:l"
	:* "pc.601" and "pc601" "~~170m~~:f"		:* "pc.601" and "pc601" "470bg:f"
	:* "pc.709" and "pc709" "709:f"		:* "pc.709" and "pc709" "709:f"
	:* "average" - kept for compatibility, really it has no standard _Matrix equivalent		:* "average" - kept for compatibility, really it has no standard _Matrix equivalent

Pinterf: /* Changelog */ fix table format for recent commit

2021-12-09T13:45:57Z

Changelog: fix table format for recent commit

← Older revision		Revision as of 15:45, 9 December 2021
Line 394:		Line 394:
	\|-		\|-
	\| v3.7.1		\| v3.7.1
	\| Added ChromaOutPlacement to 4:2:2 related functions		\| Added ChromaOutPlacement to 4:2:2 related functions<br>Added new matrix constants, optional new syntax<br>Added new chroma location constants
	\| Added new matrix constants, optional new syntax
	\| Added new chroma location constants
	\|-		\|-
	\| v2.60		\| v2.60

Pinterf: /* Changelog */ 3.7.1 additions

2021-12-09T13:44:18Z

Changelog: 3.7.1 additions

← Older revision		Revision as of 15:44, 9 December 2021
Line 392:		Line 392:
	<div style="max-width:62em" >		<div style="max-width:62em" >
	{\| border="1"		{\| border="1"
			\|-
			\| v3.7.1
			\| Added ChromaOutPlacement to 4:2:2 related functions
			\| Added new matrix constants, optional new syntax
			\| Added new chroma location constants
	\|-		\|-
	\| v2.60		\| v2.60

Pinterf: /* Parameter Details */ matrix and ChromaOutPlacement changes

2021-12-09T13:42:36Z

Parameter Details: matrix and ChromaOutPlacement changes

← Older revision		Revision as of 15:42, 9 December 2021
Line 274:		Line 274:
	:*"Rec709"  : Uses Rec.709 (HD) coefficients; scale full range RGB ↔ TV range YUV.		:*"Rec709"  : Uses Rec.709 (HD) coefficients; scale full range RGB ↔ TV range YUV.
	:*"Rec2020" : Uses Rec.2020 (UHD) coefficients; scale full range RGB ↔ TV range YUV. {{AvsPluscon}}		:*"Rec2020" : Uses Rec.2020 (UHD) coefficients; scale full range RGB ↔ TV range YUV. {{AvsPluscon}}
			:*"PC.2020" : Uses Rec.2020 (UHD) coefficients; keep range unchanged. {{AvsPluscon}}
	:*"PC.601"  : Uses Rec.601 coefficients; keep range unchanged.		:*"PC.601"  : Uses Rec.601 coefficients; keep range unchanged.
	:*"PC.709"  : Uses Rec.709 (HD) coefficients; keep range unchanged.		:*"PC.709"  : Uses Rec.709 (HD) coefficients; keep range unchanged.
	:*"Average"  : Uses averaged coefficients (the luma becomes the average of the RGB channels); keep range unchanged.		:*"Average"  : Uses averaged coefficients (the luma becomes the average of the RGB channels); keep range unchanged.

			{{AvsPluscon}}
			:New syntax: more matrix string constants with separate full/limited range markers
			:"matrixname:full_or_limited" where
			:"matrixname" can be (internal _Matrix integer constant in parenthesys)
			::* "rgb" (0 - AVS_MATRIX_RGB)
			::* "709" (1 - AVS_MATRIX_BT709)
			::* "unspec" (2 - AVS_MATRIX_UNSPECIFIED)
			::* "170m" (6 - AVS_MATRIX_ST170_M)
			::* "240m" (7 - AVS_MATRIX_ST240_M)
			::* "470bg" (5 - AVS_MATRIX_BT470_BG)
			::* "601" (5 - AVS_MATRIX_BT470_BG)
			::* "fcc" (4 - AVS_MATRIX_BT470_M)
			::* "bt470m" (4 - AVS_MATRIX_BT470_M)
			::* "ycgco" (8 - AVS_MATRIX_YCGCO not supported)
			::* "2020ncl" (9 - AVS_MATRIX_BT2020_NCL)
			::* "2020" (9 - AVS_MATRIX_BT2020_NCL)
			::* "2020cl" (10 - AVS_MATRIX_BT2020_CL same as 2020ncl)
			::* "chromacl" (13 - AVS_MATRIX_CHROMATICITY_DERIVED_CL not supported)
			::* "chromancl" (12 - AVS_MATRIX_CHROMATICITY_DERIVED_NCL not supported)
			::* "ictcp" (14 - AVS_MATRIX_ICTCP not supported)

			:: The above "matrix" parameters can be followed by a "full" or "f" and "limited" or "l" or "auto" marker after a ":"<p>e.g. "709:f" means the same as the old "PC.709"</p>
			:: When there is no limited-ness marker, or is set to "auto" then value of _ColorRange frame property is used

			: Note: old-style "matrix" parameters are kept, their name indicate the full/limited

			: For memo and the similar new string
			:* "rec601" same as "170m:l"
			:* "rec709" "709:l"
			:* "pc.601" and "pc601" "170m:f"
			:* "pc.709" and "pc709" "709:f"
			:* "average" - kept for compatibility, really it has no standard _Matrix equivalent
			:* "rec2020" "2020cl:l"
			:* "pc.2020" and "pc2020" "2020cl:f"



	{{HiddenH5\|Interlaced}}		{{HiddenH5\|Interlaced}}
Line 296:		Line 334:
	{{Par2\|ChromaInPlacement\|string\|"MPEG2"}}		{{Par2\|ChromaInPlacement\|string\|"MPEG2"}}
	{{Par2\|ChromaOutPlacement\|string\|"MPEG2"}}		{{Par2\|ChromaOutPlacement\|string\|"MPEG2"}}
	:{{FuncArg\|ChromaInPlacement}} determines the chroma placement in the clip when converting ''from'' YV12.		:{{FuncArg\|ChromaInPlacement}} determines the chroma placement in the clip when converting ''from'' YV12 (4:2:0) or YV16 (4:2:2) {{AvsPluscon}}.
	:{{FuncArg\|ChromaOutPlacement}} determines the chroma placement in the clip when converting ''to'' YV12.		:{{FuncArg\|ChromaOutPlacement}} determines the chroma placement in the clip when converting ''to'' YV12 (4:2:0) or YV16 (4:2:2) {{AvsPluscon}}.
	:The placement can be one of these strings:		:The placement can be one of these strings:
	:{\|class="wikitable" width="600"		:{\|class="wikitable" width="600"
	\|-		\|-
	\|"MPEG2"		\|"MPEG2"  ( {{AvsPluscon}} synonyms: "left")
	\|Subsampling used in MPEG-2 4:2:''x'' and most other formats. Chroma samples are located on the left pixel column of the group (default).		\|Subsampling used in MPEG-2 4:2:''x'' and most other formats. Chroma samples are located on the left pixel column of the group (default).
	\|-		\|-
	\|"MPEG1"		\|"MPEG1" ( {{AvsPluscon}} synonyms: "jpeg", "center")
	\|Subsampling used in MPEG-1 4:2:0. Chroma samples are located on the center of each group of 4 pixels.		\|Subsampling used in MPEG-1 4:2:0. Chroma samples are located on the center of each group of 4 pixels.
	\|-		\|-
	\|"DV"		\|"DV"
	\| Like MPEG-2, but U and V channels are “co-sited” vertically: V on the top row, and U on the bottom row. For 4:1:1, chroma is located on the leftmost column.		\| Like MPEG-2, but U and V channels are “co-sited” vertically: V on the top row, and U on the bottom row. For 4:1:1, chroma is located on the leftmost column.
			\|-
			\|"top_left"  {{AvsPluscon}}
			\|Subsampling used in UHD 4:2:0. Chroma samples are located on the top left pixel column of the group .
			\|-
			\|"bottom_left"  {{AvsPluscon}}
			\|4:2:0 only
			\|-
			\|"bottom"  {{AvsPluscon}}
			\|4:2:0 only
			\|-
	\|}		\|}

Line 314:		Line 362:
	{{Par2\|chromaresample\|string\|"bicubic"}}		{{Par2\|chromaresample\|string\|"bicubic"}}
	:Determines which chroma resampler is used in the conversion. Only used when the chroma resolutions of the source and target are different. All AviSynth [[Resize\|resizers]] are allowed ("point", "bilinear", "bicubic", "lanczos", "lanczos4", "blackman", "spline16", "spline36", "spline64", "gauss" and "sinc"). Default is "bicubic".		:Determines which chroma resampler is used in the conversion. Only used when the chroma resolutions of the source and target are different. All AviSynth [[Resize\|resizers]] are allowed ("point", "bilinear", "bicubic", "lanczos", "lanczos4", "blackman", "spline16", "spline36", "spline64", "gauss" and "sinc"). Default is "bicubic".
	~~</div>~~

	==== Notes ====		==== Notes ====

Pinterf: /* Syntax and Parameters */ Add ChromaOutPlacement in YUV422

2021-12-09T13:20:21Z

Syntax and Parameters: Add ChromaOutPlacement in YUV422

← Older revision		Revision as of 15:20, 9 December 2021
Line 219:		Line 219:
	\|ConvertToYV16(clip [, bool ''interlaced'', string ''matrix'', <br>		\|ConvertToYV16(clip [, bool ''interlaced'', string ''matrix'', <br>
	string ''ChromaInPlacement'', <br>		string ''ChromaInPlacement'', <br>
	string ''chromaresample''] )		string ''chromaresample'', <br>
			string ''ChromaOutPlacement'' {{AvsPluscon}} ] )
	}} <br>		}} <br>
	{{FuncDef		{{FuncDef
Line 229:		Line 230:
	\|ConvertToYUV422(clip, [ string ''matrix'', bool ''interlaced'', <br>		\|ConvertToYUV422(clip, [ string ''matrix'', bool ''interlaced'', <br>
	string ''ChromaInPlacement'', <br>		string ''ChromaInPlacement'', <br>
	string ''chromaresample'' ] ) {{AvsPluscon}}		string ''chromaresample'', <br>
			string ''ChromaOutPlacement''] ) {{AvsPluscon}}
	}}		}}

Line 254:		Line 256:
	\|ConvertToYV411(clip [, bool ''interlaced'', string ''matrix'', <br>		\|ConvertToYV411(clip [, bool ''interlaced'', string ''matrix'', <br>
	string ''ChromaInPlacement'', <br>		string ''ChromaInPlacement'', <br>
	string ''chromaresample''] )		string ''chromaresample''] )
	}}		}}

Line 263:		Line 265:
	{{FuncDef		{{FuncDef
	\|ConvertToY(clip, [ string ''matrix'' ] ) {{AvsPluscon}}		\|ConvertToY(clip, [ string ''matrix'' ] ) {{AvsPluscon}}
	}}		}}

	==== Parameter Details ====		==== Parameter Details ====

Pinterf: Converts: mention ConvertBits to have full-limited conversion

2021-12-09T13:12:50Z

Converts: mention ConvertBits to have full-limited conversion

← Older revision		Revision as of 15:12, 9 December 2021
Line 157:		Line 157:
	Use '''ConvertBackToYUY2''' to convert ''back'' to YUY2 with minimal color-blurring when you have previously applied a YUY2→RGB conversion.		Use '''ConvertBackToYUY2''' to convert ''back'' to YUY2 with minimal color-blurring when you have previously applied a YUY2→RGB conversion.

	{{AvsPluscon}} See also [[ConvertBits]] to convert between bit depths.		{{AvsPluscon}} See also [[ConvertBits]] to convert between bit depths and/or between full-limited range.
	</div>		</div>