MaskTools2/Mt invert: Difference between revisions

From Avisynth wiki
Jump to navigationJump to search
m category
Line 8: Line 8:
:Inverts the values of the pixels. This function is equivalent to mt_lut("255 x -"), but faster.  
:Inverts the values of the pixels. This function is equivalent to mt_lut("255 x -"), but faster.  
<br>
<br>
== Syntax and Parameters ==
== [[Script variables|Syntax and Parameters]] ==
:{{Template:FuncDef|mt_invert(clip, int "Y", int "U", int"V", string "chroma", int "offX", int "offY", int "w" int "h")}}
:{{Template:FuncDef|mt_invert (clip, int "Y", int "U", int"V", string "chroma", int "offX", int "offY", int "w" int "h")}}
<br>
<br>
::{{Par|Y|int|3}}
::{{Par2| |clip| }}
::{{Par|U|int|1}}
:::Input clip.
::{{Par|V|int|1}}
::::These three values describe the actual processing mode that is to be used on each plane / channel. Here is how the modes are coded :
:::::*x = -255...0 : all the pixels of the plane will be set to -x.
:::::*x = 1 : the plane will not be processed. That means the content of the plane after the filter is pure garbage.
:::::*x = 2 : the plane of the first input clip will be copied.
:::::*x = 3 : the plane will be processed with the processing the filter is designed to do.
:::::*x = 4 (when applicable) : the plane of the second input clip will be copied.
:::::*x = 5 (when applicable) : the plane of the third input clip will be copied.
<br>
<br>
::{{Par|chroma|string|""}}
::{{Par2|Y|int|3}}
::::When defined, the value contained in this string will overwrite the u & v processing modes.
::{{Par2|U|int|1}}
::::This is a nice addition proposed by mg262 that makes the filter more user friendly. Allowed values for chroma are:
::{{Par2|V|int|1}}
:::::*"process" : set u = v = 3.
:::These three values describe the actual processing mode that is to be used on each plane / channel. Here is how the modes are coded :
:::::*"copy" or "copy first" : set u = v = 2.
::::*x = -255...0 : all the pixels of the plane will be set to -x.
:::::*"copy second" : set u = v = 4.
::::*x = 1 : the plane will not be processed. That means the content of the plane after the filter is pure garbage.
:::::*"copy third" : set u = v = 5.
::::*x = 2 : the plane of the first input clip will be copied.
:::::*"xxx", where xxx is a number : set u = v = -xxx.
::::*x = 3 : the plane will be processed with the processing the filter is designed to do.
<br>
<br>
::{{Par|offX|int|0}}
::{{Par2|chroma|string|""}}
::{{Par|offY|int|0}}
:::When defined, the value contained in this string will overwrite the u & v processing modes.
::::"offx" and offy are the top left coordinates of the box where the actual processing shall occur. Everything outside that box will be garbage.
:::This is a nice addition proposed by mg262 that makes the filter more user friendly. Allowed values for chroma are:
::::*"process" : set u = v = 3.
::::*"copy" or "copy first" : set u = v = 2.
::::*"xxx", where xxx is a number : set u = v = -xxx.
<br>
<br>
::{{Par|w|int|-1}}
::{{Par2|offX|int|0}}
::{{Par|h|int|-1}}
::{{Par2|offY|int|0}}
::::w and h are the width and height of the processed box. -1 means that the box extends to the lower right corner of the video. That also means that default settings are meant to process the whole picture.
:::"offX" and "offY" are the top left coordinates of the box where the actual processing shall occur. Everything outside that box will be garbage.
<br>
::{{Par2|w|int|-1}}
::{{Par2|h|int|-1}}
:::w and h are the width and height of the processed box. -1 means that the box extends to the lower right corner of the video. That also means that default settings are meant to process the whole picture.
<br>
== [[Examples]] ==
mt.invert with default settings:
<br>
<br>
<br>
<br>

Revision as of 20:51, 12 October 2014


Back to MaskTools2



Description

Inverts the values of the pixels. This function is equivalent to mt_lut("255 x -"), but faster.


mt_invert (clip, int "Y", int "U", int"V", string "chroma", int "offX", int "offY", int "w" int "h")


clip   =
Input clip.


int  Y = 3
int  U = 1
int  V = 1
These three values describe the actual processing mode that is to be used on each plane / channel. Here is how the modes are coded :
  • x = -255...0 : all the pixels of the plane will be set to -x.
  • x = 1 : the plane will not be processed. That means the content of the plane after the filter is pure garbage.
  • x = 2 : the plane of the first input clip will be copied.
  • x = 3 : the plane will be processed with the processing the filter is designed to do.


string  chroma = ""
When defined, the value contained in this string will overwrite the u & v processing modes.
This is a nice addition proposed by mg262 that makes the filter more user friendly. Allowed values for chroma are:
  • "process" : set u = v = 3.
  • "copy" or "copy first" : set u = v = 2.
  • "xxx", where xxx is a number : set u = v = -xxx.


int  offX = 0
int  offY = 0
"offX" and "offY" are the top left coordinates of the box where the actual processing shall occur. Everything outside that box will be garbage.


int  w = -1
int  h = -1
w and h are the width and height of the processed box. -1 means that the box extends to the lower right corner of the video. That also means that default settings are meant to process the whole picture.


mt.invert with default settings:


Back to MaskTools2