View source for Convert

<div style="max-width:62em" >
Convert between any of the color formats that AviSynth supports:
:{| class="wikitable"
|-
! Version&nbsp;
! Color format&nbsp;
! Image format&nbsp;
! Bit depth&nbsp;
! Sample ratio&nbsp;
!style="text-align:left"| &nbsp;Description
|- 
| 
| '''[[RGB24]]'''
| [[Interleaved|interleaved]]
| 8
| 4:4:4
| (full chroma)
|- 
|
| '''[[RGB32]]'''
| interleaved
| 8
| 4:4:4:4
| (full chroma + alpha)
|- 
|style="text-align:center"| {{AvsPluscon}}
| '''[[Avisynthplus_color_formats|RGB48]]'''
| interleaved
| 16
| 4:4:4
| (full chroma)
|- 
|style="text-align:center"| {{AvsPluscon}}
| '''[[Avisynthplus_color_formats|RGB64]]'''
| interleaved
| 16
| 4:4:4:4
| (full chroma + alpha)
|- 
|style="text-align:center"| {{AvsPluscon}}
| '''[[Avisynthplus_color_formats|RGBPxx]]'''
| [[Planar|planar]]
| 8-16, 32 *&nbsp;
| 4:4:4
| (full chroma)
|- 
|style="text-align:center"| {{AvsPluscon}}
| '''[[Avisynthplus_color_formats|RGBAPxx]]'''
| [[Planar|planar]]
| 8-16, 32 *&nbsp;
| 4:4:4:4
| (full chroma + alpha)
|- 
|style="text-align:center"| v2.6
| '''[[YV24]]'''
| planar
| 8
| 4:4:4
| (full chroma)
|- 
|style="text-align:center"| {{AvsPluscon}}
| '''[[Avisynthplus_color_formats|YUV444Pxx]]'''
| planar
| 8-16, 32 *&nbsp;
| 4:4:4
| (full chroma)
|- 
|style="text-align:center"| {{AvsPluscon}}
| '''[[Avisynthplus_color_formats|YUVA444Pxx]]'''
| planar
| 8-16, 32 *&nbsp;
| 4:4:4:4 
| (full chroma + alpha)
|- 
|style="text-align:center"| v2.6
| '''[[YV16]]'''
| planar
| 8
| 4:2:2
| (chroma shared between 2 pixels)
|- 
|style="text-align:center"| {{AvsPluscon}}
| '''[[Avisynthplus_color_formats|YUV422Pxx]]'''
| planar
| 8-16, 32 *&nbsp;
| 4:2:2
| (chroma shared between 2 pixels)
|- 
|style="text-align:center"| {{AvsPluscon}}
| '''[[Avisynthplus_color_formats|YUVA422Pxx]]'''
| planar
| 8-16, 32 *&nbsp;
| 4:2:2:4
| (chroma shared between 2 pixels + alpha)
|- 
|
| '''[[YUY2]]'''
| interleaved
| 8
| 4:2:2
| (chroma shared between 2 pixels)
|- 
|
| '''[[YV12]]'''
| planar
| 8
| 4:2:0
| (chroma shared between 2x2 pixels)&nbsp;
|- 
|style="text-align:center"| {{AvsPluscon}}
| '''[[Avisynthplus_color_formats|YUV420Pxx]]'''
| planar
| 8-16, 32 *&nbsp;
| 4:2:0
| (chroma shared between 2x2 pixels)&nbsp;
|- 
|style="text-align:center"| {{AvsPluscon}}
| '''[[Avisynthplus_color_formats|YUVA420Pxx]]'''
| planar
| 8-16, 32 *&nbsp;
| 4:2:0:4
| (chroma shared between 2x2 pixels + alpha)&nbsp;
|- 
|style="text-align:center"| v2.6
| '''[[YV411]]'''
| planar
| 8
| 4:1:1
| (chroma shared between 4 pixels)
|- 
|style="text-align:center"| v2.6
| '''[[Y8]]''' 
| (both)
| 8
| 4:0:0
| (no chroma)
|- 
|style="text-align:center"| {{AvsPluscon}}
| '''[[Avisynthplus_color_formats|Y10..Y32]]''' 
| (both)
| 10-16, 32 *&nbsp;
| 4:0:0
| (no chroma)
|- 
!colspan="6" style="text-align:left; font-weight:normal;"|&nbsp; '''*''' 8-16 = ''8,10,12,14,16 bit integer;'' &nbsp; 32 = ''32 bit float''
|}


When the target format is the same as the source format, the original clip will be returned unchanged, except for the case of '''ConvertToYV12''' where the {{FuncArg|ChromaInPlacement}} and {{FuncArg|ChromaOutPlacement}} parameters are different.

<!-- div {{NotaBeneWidthIndent|56|2}} -->
{{BlueBox}}
There is no unique way of [[Color_conversions|converting]] YUV to RGB or vice-versa. There are different ''conversion matrices'' in use; the two most common ones are available in AviSynth, namely ''Rec.601'' and ''Rec.709'', plus some others. The following should be correct in ''most'' cases (see [[Colorimetry#How_can_I_see_if_the_correct_standard_is_used_upon_playback.3F|'''here''']] for more)
*Rec.601 should be used when your source is standard definition (usually defined as smaller than [[Wikipedia:720p|720p]]):
:<code>ConvertToRGB(clip)</code> (using default "Rec601")
*Rec.709 should be used when your source is DVD or HDTV:
:<code>ConvertToRGB(clip, matrix="Rec709")</code>
*The special-purpose matrices ''PC.601'' and ''PC.709'' keep the ''range'' unchanged, 
:instead of converting between 0-255<sub>8</sub>&nbsp;RGB and 16<sub>8</sub>-235<sub>8</sub>&nbsp;YUV, as is the normal practice.
*The special-purpose matrix ''AVERAGE'' is used for (rarely found) sources with ''unweighted'' luma, 
:where ''Y'' = (R + G + B) / 3.
{{End_BlueBox}}

Note '''ConvertToRGB''' always converts to [[RGB32]] – unless your source is RGB24, in which case no conversion is done. If you need 24-bit RGB for some reason, use '''ConvertToRGB24''' explicitly.

Use '''ConvertBackToYUY2''' to convert ''back'' to YUY2 with minimal color-blurring when you have previously applied a YUY2&rarr;RGB conversion.

{{AvsPluscon}} See also [[ConvertBits]] to convert between bit depths.
</div>

__TOC__

==== Syntax and Parameters ====
<div style="max-width:62em" >
===== ''RGB interleaved'' =====
{{FuncDef
|ConvertToRGB(clip [, string ''matrix'', bool ''interlaced'',   <br> 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;string ''ChromaInPlacement'',  <br> 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;string ''chromaresample''] ) 
}}<br>
{{FuncDef
|ConvertToRGB24(clip [, string ''matrix'', bool ''interlaced'',   <br> 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;string ''ChromaInPlacement'',  <br> 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;string ''chromaresample''] )
}}<br>
{{FuncDef
|ConvertToRGB32(clip [, string ''matrix'', bool ''interlaced'',   <br> 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;string ''ChromaInPlacement'',  <br> 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;string ''chromaresample''] )
}} <br>
{{FuncDef
|ConvertToRGB48(clip, [ string ''matrix'', bool ''interlaced'',   <br> 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;string ''ChromaInPlacement'', <br> 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; string ''chromaresample'' ] ) {{AvsPluscon}} 
}} <br>
{{FuncDef
|ConvertToRGB64(clip, [ string ''matrix'', bool ''interlaced'',   <br> 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;string ''ChromaInPlacement'',  <br> 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;string ''chromaresample'' ] ) {{AvsPluscon}} 
}}

===== ''RGB planar'' =====
{{FuncDef
|ConvertToPlanarRGB(clip, [ string ''matrix'', bool ''interlaced'',   <br> 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;string ''ChromaInPlacement'',  <br> 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;string ''chromaresample'' ] ) {{AvsPluscon}} 
}} <br>
{{FuncDef
|ConvertToPlanarRGBA(clip, [ string ''matrix'', bool ''interlaced'',   <br> 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;string ''ChromaInPlacement'',  <br> 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;string ''chromaresample'' ] ) {{AvsPluscon}} 
}}

===== ''YUV444'' =====
{{FuncDef
|ConvertToYV24(clip [, bool ''interlaced'', string ''matrix'',   <br> 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;string ''ChromaInPlacement'',  <br> 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;string ''chromaresample''] )
}}<br>
{{FuncDef
|ConvertToYUV444(clip, [ string ''matrix'', bool ''interlaced'',   <br> 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;string ''ChromaInPlacement'',  <br> 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;string ''chromaresample'' ] ) {{AvsPluscon}} 
}} <br>

===== ''YUV422'' =====
{{FuncDef
|ConvertToYV16(clip [, bool ''interlaced'', string ''matrix'',   <br> 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;string ''ChromaInPlacement'',  <br> 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;string ''chromaresample''] )
}} <br>
{{FuncDef
|ConvertToYUV422(clip, [ string ''matrix'', bool ''interlaced'',  <br> 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;string ''ChromaInPlacement'',   <br> 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;string ''chromaresample'' ] ) {{AvsPluscon}} 
}}<br>
{{FuncDef
|ConvertToYUY2(clip [, bool ''interlaced'', string ''matrix'',   <br> 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;string ''ChromaInPlacement'',  <br> 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;string ''chromaresample''] )
}}

{{FuncDef
|ConvertBackToYUY2(clip [, string ''matrix'' ] )
}}

===== ''YUV420'' =====
{{FuncDef
|ConvertToYV12(clip [, bool ''interlaced'', string ''matrix'',   <br> 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;string ''ChromaInPlacement'',  <br> 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;string ''chromaresample'',   <br> 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;string ''ChromaOutPlacement''] )
}} <br>
{{FuncDef
|ConvertToYUV420(clip, [ string ''matrix'', bool ''interlaced'',   <br> 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;string ''ChromaInPlacement'',  <br> 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;string ''chromaresample'',   <br> 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;string ''ChromaOutPlacement'' ] ) {{AvsPluscon}} 
}}

===== ''YUV411'' =====
{{FuncDef
|ConvertToYV411(clip [, bool ''interlaced'', string ''matrix'',   <br> 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;string ''ChromaInPlacement'',  <br> 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;string ''chromaresample''] )
}}

===== ''Y-only'' =====
{{FuncDef
|ConvertToY8(clip [, string ''matrix''] )
}}<br>
{{FuncDef
|ConvertToY(clip, [ string ''matrix'' ] ) {{AvsPluscon}} 
}} 

==== Parameter Details ====
{{HiddenH5|Matrix}}
{{Par2|matrix|string|"Rec601"}}
:Controls the colour coefficients and scaling factors used in RGB&harr;YUV conversions.
:*"Rec601"&nbsp; : Uses Rec.601 coefficients; scale full range [0..255<sub>8</sub>] RGB &harr; TV range [16<sub>8</sub>..235<sub>8</sub>] YUV.
:*"Rec709"&nbsp; : Uses Rec.709 (HD) coefficients; scale full range RGB &harr; TV range YUV.
:*"Rec2020" : Uses Rec.2020 (UHD) coefficients; scale full range RGB &harr; TV range YUV. {{AvsPluscon}}
:*"PC.601"&nbsp; : Uses Rec.601 coefficients; keep range unchanged.
:*"PC.709"&nbsp; : Uses Rec.709 (HD) coefficients; keep range unchanged.
:*"Average"&nbsp; : Uses averaged coefficients (the luma becomes the average of the RGB channels); keep range unchanged.

{{HiddenH5|Interlaced}}
{{Par2|interlaced|bool|false}}
:If true, it is assumed that {{FuncArg|clip}} is interlaced; by default, it is assumed to be progressive. 
:This option is needed because for example, the following (assuming clip is interlaced YV12): 
<div {{BoxWidthIndent|28|2}} >
 [[SeparateFields]](clip)
 ConvertToYUY2
 [[Weave]]
</div>
:...is upsampled incorrectly. Instead it is better to use:
<div {{BoxWidthIndent|28|2}} >
 ConvertToYUY2(clip, interlaced=true)
</div>
:Note, {{FuncArg|interlaced}}=true has an effect only on YV12&harr;YUY2 or YV12&harr;RGB conversions. More about that can be found [[Interlaced fieldbased|'''here''']].

{{HiddenH5|Chroma placement}}
{{Par2|ChromaInPlacement|string|"MPEG2"}}
{{Par2|ChromaOutPlacement|string|"MPEG2"}}
:{{FuncArg|ChromaInPlacement}} determines the chroma placement in the clip when converting ''from'' YV12.
:{{FuncArg|ChromaOutPlacement}} determines the chroma placement in the clip when converting ''to'' YV12.
:The placement can be one of these strings:
:{|class="wikitable" width="600"
|-
|"MPEG2"&nbsp;
|Subsampling used in MPEG-2 4:2:''x'' and most other formats. Chroma samples are located on the left pixel column of the group&nbsp;(default). 
|-
|"MPEG1"
|Subsampling used in MPEG-1 4:2:0. Chroma samples are located on the center of each group of 4 pixels.
|-
|"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.
|}

{{HiddenH5|Chroma resample}}
{{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".
</div>

==== Notes ====
<div style="max-width:62em" >
===== Conversion paths =====

:In v2.60 the following conversion paths occur:
:* YUV planar &rarr; RGB via YV24
:* YUV planar &rarr; YUY2 via YV16 
::(except for YV12 and chroma options listed above not explicitly set; in that case there is a direct conversion from YV12 to YUY2)
:* RGB &rarr; YUV planar via YV24
:* YUY2 &rarr; YUV planar via YV16 
::(except for YV12 and chroma options listed above not explicitly set; in that case there is a direct conversion from YUY2 to YV12)

: The chroma options {{FuncArg|chromaresample}}, {{FuncArg|ChromaInPlacement}} and {{FuncArg|ChromaOutPlacement}} are only used in the 'planar conversion' part of the conversion path.

:Suppose you have a YUY2 clip for example and you convert it to YV24. The YUY2 will be converted to YV16 first without applying the chroma options. Then YV16 will be converted to YV24 while applying {{FuncArg|chromaresample}}. Since YV12 is not involved, {{FuncArg|ChromaInPlacement}} and {{FuncArg|ChromaOutPlacement}} won't be used.

===== Sampling =====

:[[Sampling|'''[This page]''']] covers the sampling methods and color formats in more detail.

===== Color conversions =====

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


==== Changelog ====
<div style="max-width:62em" >
{| border="1"
|- 
| v2.60
| Added ConvertToY8, ConvertToYV411, ConvertToYV16, ConvertToYV24, ChromaInPlacement, ChromaOutPlacement, chromaresample, matrix="AVERAGE".
|- 
| v2.50
| Added ConvertToYV12.
|}
</div>


[[Category:Internal filters]]
[[Category:Colourspace_Conversion]]