MaskTools2/Mt motion

Revision as of 13:29, 27 October 2014

Description

Creates motion masks.

Syntax and Parameters

mt_motion (clip, int "thY1", int "thY2", int "thC1", int "thC2", int "thT", int "sc_value", int "Y", int "U", int"V", string "chroma", int "offX", int "offY", int "w" int "h")

clip =

Input clip.

int thY1 = 10

int thY2 = 10

Luma thresholds; thY1 is the low threshold and thY2 the high threshold. Under thY1, the pixel is set to zero, over thY2, to 255, and in between, left untouched.

Range: 0 to 255

int thC1 = 10

int thC2 = 10

Chroma thresholds; thC1 is the low threshold and thC2 the high threshold. Under thC1, the pixel is set to zero, over thC2, to 255, and in between, left untouched.

Range: 0 to 255

int thT = 10

thT decides whether the frame is a scene change or not. The mask is made blank if a scene change is detected, else, the mask is computed.

Range: 0 to 255

int sc_value = 0

Range: 0 to 255

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 and 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.

Examples

mt_motion with default settings:

AviSource("blah.avi")
mt_motion(thY1=10, thY2=10, thC1=10, thC2=10, thT=10, sc_value=0, Y=3, U=1, V=1, chroma="", offX=0, offY=0, w=-1, h=-1)

Back to MaskTools2 ←

@@ Line 1: / Line 1: @@
-[[Category:Plugin_Filters]]
-[[Category:Masking]]
------------------------------------------------
-'''Back to [[MaskTools2#Filters|MaskTools2]] &larr;'''
------------------------------------------------
-<br>
 == Description ==
-:Creates motion masks.
+Creates motion masks.
 <br>
-== Syntax and Parameters ==
+<br>
+== [[Script variables|Syntax and Parameters]] ==
 :{{Template:FuncDef|mt_motion (clip, int "thY1", int "thY2", int "thC1", int "thC2", int "thT", int "sc_value", int "Y", int "U", int"V", string "chroma", int "offX", int "offY", int "w" int "h")}}
 <br>
-::{{Par|thY1|int|10}}
+::{{Par2| |clip| }}
-::{{Par|thY2|int|10}}
+:::Input clip.
-:::Range: 0 - 255
+<br>
-::::Luma thresholds.
+::{{Par2|thY1|int|10}}
-:::::thY1 is the low threshold and thY2 the high threshold. Under thY1, the pixel is set to zero, over thY2, to 255, and in between, left untouched.
+::{{Par2|thY2|int|10}}
+:::Luma thresholds; {{Template:FuncDef3|thY1}} is the low threshold and thY2 the high threshold. Under {{Template:FuncDef3|thY1}}, the pixel is set to zero, over {{Template:FuncDef3|thY2}}, to 255, and in between, left untouched.
+:::Range: 0 to 255
+<br>
+::{{Par2|thC1|int|10}}
+::{{Par2|thC2|int|10}}
+:::Chroma thresholds; {{Template:FuncDef3|thC1}} is the low threshold and {{Template:FuncDef3|thC2}} the high threshold. Under {{Template:FuncDef3|thC1}}, the pixel is set to zero, over {{Template:FuncDef3|thC2}}, to 255, and in between, left untouched.
+:::Range: 0 to 255
 <br>
-::{{Par|thC1|int|10}}
+::{{Par2|thT|int|10}}
-::{{Par|thC2|int|10}}
+:::{{Template:FuncDef3|thT}} decides whether the frame is a scene change or not. The mask is made blank if a scene change is detected, else, the mask is computed.
-:::Range: 0 - 255
+:::Range: 0 to 255
-::::Chroma thresholds.
-:::::thC1 is the low threshold and thC2 the high threshold. Under thC1, the pixel is set to zero, over thC2, to 255, and in between, left untouched.
 <br>
-::{{Par|thT|int|10}}
+::{{Par2|sc_value|int|0}}
-:::Range: 0 - 255
+:::
-::::thT decides whether the frame is a scene change or not. The mask is made blank if a scene change is detected, else, the mask is computed.
+:::Range: 0 to 255
 <br>
-::{{Par|sc_value|int|0}}
+::{{Par2|Y|int|3}}
-:::Range: 0 - 255
+::{{Par2|U|int|1}}
-::::
+::{{Par2|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.
 <br>
-::{{Par|Y|int|3}}
+::{{Par2|chroma|string|""}}
-::{{Par|U|int|1}}
+:::When defined, the value contained in this string will overwrite the {{Template:FuncDef3|U}} and {{Template:FuncDef3|V}} processing modes.
-::{{Par|V|int|1}}
+:::This is a nice addition proposed by mg262 that makes the filter more user friendly. Allowed values for chroma are:
-::::These three values describe the actual processing mode that is to be used on each plane / channel. Here is how the modes are coded :
+::::*"process" : set u = v = 3.
-:::::*x = -255...0 : all the pixels of the plane will be set to -x.
+::::*"copy" or "copy first" : set u = v = 2.
-:::::*x = 1 : the plane will not be processed. That means the content of the plane after the filter is pure garbage.
+::::*"xxx", where xxx is a number : set u = v = -xxx.
-:::::*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>
-::{{Par|chroma|string|""}}
+::{{Par2|offX|int|0}}
-::::When defined, the value contained in this string will overwrite the u & v processing modes.
+::{{Par2|offY|int|0}}
-::::This is a nice addition proposed by mg262 that makes the filter more user friendly. Allowed values for chroma are:
+:::{{Template:FuncDef3|offX}} and {{Template:FuncDef3|offY}} are the top left coordinates of the box where the actual processing shall occur. Everything outside that box will be garbage.
-:::::*"process" : set u = v = 3.
-:::::*"copy" or "copy first" : set u = v = 2.
-:::::*"copy second" : set u = v = 4.
-:::::*"copy third" : set u = v = 5.
-:::::*"xxx", where xxx is a number : set u = v = -xxx.
 <br>
-::{{Par|offX|int|0}}
+::{{Par2|w|int|-1}}
-::{{Par|offY|int|0}}
+::{{Par2|h|int|-1}}
-::::"offx" and offy are the top left coordinates of the box where the actual processing shall occur. Everything outside that box will be garbage.
+:::{{Template:FuncDef3|w}} and {{Template:FuncDef3|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>
-::{{Par|w|int|-1}}
+== Examples ==
-::{{Par|h|int|-1}}
+mt_motion with default settings:
-::::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.
+ [[AviSource]]("blah.avi")
+ mt_motion(thY1=10, thY2=10, thC1=10, thC2=10, thT=10, sc_value=0, Y=3, U=1, V=1, chroma="", offX=0, offY=0, w=-1, h=-1)
 <br>
 <br>

MaskTools2/Mt motion

Revision as of 13:29, 27 October 2014

Description

Syntax and Parameters

Examples

Views

Personal tools

Navigation

community

in other languages

Search

Tools