Mask
compositing node
Masks out an area of an image.
Uses a plane from the second input to mask out an area of the first input. The mask may be applied to any planes and their components.
A mask is applied to an image by multiplying the image by the mask. The mask may also be inverted or scaled (brightened or dimmed).
This operation is useful for removing or isolating image elements.
Parameters
Mask
|
Effect Amount |
If no mask is present, this blends the output with the input by a constant amount (0 = all input, 1 = all output). If a mask is present, this amount multiplies the mask. |
|
Mask Plane |
Selects the mask plane to use as a mask from the mask input A mask can be a component of a plane or an entire plane. If a vector plane is supplied as a mask, its components are multiplied by the images' components. Scalar Mask ('A', 'C.r')
C.r = I.r * M C.g = I.g * M C.b = I.b * MVector Mask ('C') C.r = I.r * M.r C.g = I.g * M.g C.b = I.b * M.b |
|
Invert Mask |
Inverts the mask so that all fully 'masked' portions become unmasked. This saves you from inserting an Invert COP. |
Scope
|
Plane Scope |
Specifies the scope for both the RGB components of Color, Alpha, and other planes. The (C)RGBA mask only affects Color components and Alpha. 'C' will toggle all the RGB components. For planes other than Color and Alpha, the plane name (plus component, if applicable) should be specified in the string field. The pulldown menu can be used to select planes or components present in this node. A plane is specified by its name. A component is specified by both its plane and component name. The '*' wildcard may be used to scope all extra planes. Any number of planes or components can be specified, separated by spaces. Examples: P N.x N.y P N Pz |
Frame Scope
|
Frame Scope |
Allows scoping of specific frames in the frame range. This is in addition to the plane scope (so a plane at a certain frame must be both plane scoped and frame scoped to be modified).
|
||||||||||||
|
Frame Range |
For Inside/Outside range, this parameter specifies the subrange of the sequence to scope (or unscope). This can be edited in Timeline viewer mode ( Ctrl + 2 in viewer). |
||||||||||||
|
Frame Dropoff |
For Inside/Outside Range, this parameter specifies certain number of frames before and after to slowly ramp up to scoped. The operation will be blended with its input to 'ease in' or 'ease out' the scoping effect over a number of frames. This can be edited in Timeline viewer mode ( Ctrl + 2 in viewer). |
||||||||||||
|
Non-scoped Effect |
For unscoped frames, this sets the blend factor between the input and modified images. Normally this is zero (use the input image). By setting this to a non-zero value, you can make unscoped frames be 'slightly' unscoped. The value can vary between 0 (unscoped) and 1 (scoped). |
||||||||||||
|
Frame List |
The frame list for 'Specific Frames'. Frame numbers should be separated by spaces. |
||||||||||||
|
Automatically Adjust for Length Changes |
If the sequence range changes, enabling this parameter will adjust the subrange and frame dropoff lengths to fit the new range. |
Inputs
|
Image to Mask |
The image that the mask is applied to. |
|
Mask Input |
The input that the mask is chosen from. |
Local variables
|
L |
Sequence length |
|
S |
Start of sequence |
|
E |
End of sequence |
|
IL |
Input sequence length |
|
SR |
Sequence frame rate |
|
NP |
Number of planes in sequence |
|
W,H |
Width and height of image |
|
I |
Image index (0 at start frame) |
|
IT |
Image time (0 at start frame) |
|
AI |
Current plane array index |
|
PI |
Current plane index |
|
PC |
Num of channels in current plane |
|
CXRES |
Composite Project X resolution |
|
CYRES |
Composite Project Y resolution |
|
CPIXA |
Composite Project pixel aspect ratio |
|
CDEPTH |
Composite Project raster depth |
|
CBP |
Composite Project black point |
|
CWP |
Composite Project white point |