View source for Swap

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

Swaps chroma channels in [[YUV]] clips.
__TOC__

<!-- ==== Syntax and Parameters ==== -->
<div style="max-width:62em" >

{{FuncDefH4|SwapUV}}
{{FuncDef
|SwapUV(clip ''clip'')
}}

:Swaps ''U'' and ''V'' (chroma) channels. Corrects certain decoding errors &ndash; faces blue instead of red, etc.


{{FuncDefH4|UToY, VToY}}
{{Func2Def
|UToY(clip ''clip'')
|VToY(clip ''clip'')
}}

:Copies ''U'' or ''V'' chroma plane to the ''Y'' luma plane. 
:All color (chroma) information is removed, so the image is now greyscale. 
:Depending on the color format, the image resolution can be changed &ndash; i.e.,
:with a [[YV24]] source, '''UToY''' is the same width and height as {{FuncArg|clip}}, but
:with a [[YV12]] source, '''UToY''' is half {{FuncArg|clip}}'s width and height.


{{FuncDefH4|UToY8, VToY8}}
{{Func2Def
|UToY8(clip ''clip'')
|VToY8(clip ''clip'')
}}

:Shorthand for '''UToY.'''[[ConvertToY8]] and '''VToY.'''[[ConvertToY8]], but faster.

 
{{FuncDefH4|YToUV}}
{{FuncDef
|YToUV(clip ''clipU'', clip ''clipV'' [, clip ''clipY'' [, clip ''clipA'' ] ] )
}}

:Copies the ''Y'' (luma channel) of {{FuncArg|clipU}} to the ''U'' channel of the output clip and the ''Y'' (luma channel) of {{FuncArg|clipV}} to the ''V'' channel of the output clip. 
:If {{FuncArg|clipY}} is given, copies the ''Y'' (luma channel) of {{FuncArg|clipY}} to the ''Y'' channel of the output clip.
:{{AvsPluscon}} And if {{FuncArg|clipA}} is given too, copies the ''Y'' (luma channel) of {{FuncArg|clipA}} to the ''A'' channel of the output clip.
:Depending on the color format, the image resolution can be changed.
</div>


==== See Also ====
*Show [[RGB]] channels with [[ShowAlpha|ShowAlpha/Red/Green/Blue]].
*{{AvsPluscon}} [[Extract]] for {{Deep_color}} support.


==== Examples ====
<div style="max-width:62em" >
* Blur the U chroma channel
<div {{BoxWidthIndent|32|2}} >
 video = [[ColorBars]](512, 512).[[ConvertToYV12]]
 u_chroma = '''UToY'''(video).[[Blur]](1.5)
 '''YToUV'''(u_chroma, video.'''VToY''')
 [[MergeLuma]](video)
</div>

* Show ''U'' and ''V'' channels stacked for illustration purposes. 
** Note that with a [[YV12]] source (like the one below), the ''U'' and ''V'' images will be half the size of the original.
** In the ''U'' and ''V'' images, gray will be at 128{{D}} and saturated colors will appear brighter or darker. 
{{HalfBreak}}
:[[File:SwapEx-Sintel9150.jpg]]
<div {{BoxWidthIndent|32|2}} >
 [[StackVertical]](
 \  [[Subtitle]]("YV12 original", align=2),
 \  [[StackHorizontal]](
 \       '''UtoY'''.Subtitle("UtoY", align=2), 
 \       '''VtoY'''.Subtitle("VtoY", align=2)
 \  )
 \ )
</div>
</div>


==== Changes ====
{| border="1"
|-
| v2.60
| Added UToY8, VToY8.
|- 
| v2.60
| Added new color formats [[Y8]], [[YV411]], [[YV16]] and [[YV24]].
|}

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