MaskTools2/Mt motion

Revision as of 15:52, 23 November 2013

Back to MaskTools2

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")

thY1 int = 10

thY2 int = 10

Range: 0 - 255

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.

thC1 int = 10

thC2 int = 10

Range: 0 - 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.

thT int = 10

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.

sc_value int = 0

Range: 0 - 255

Y int = 3

U int = 1

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.

chroma string = ""

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.
• "copy second" : set u = v = 4.
• "copy third" : set u = v = 5.
• "xxx", where xxx is a number : set u = v = -xxx.

offX int = 0

offY int = 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.

w int = -1

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.

Back to MaskTools2