Copy

Replaces channels in the B input with channels from the A input. You can use a mask channel to indicate which input is used for each pixel or whether both inputs should be mixed for some pixels.

Using the mix slider, you can use this node as a dissolve. You can also create this node by pressing K on the Node Graph.

See also Shuffle.

Inputs and Controls

Connection Type

Connection Name

Function

Input

A

The image that contains a channel to copy to input B.

B

The image that contains a channel to replace with a channel from the A input.

mask

An optional image to use as a mask. By default, the A input is used where the mask is white, the B input where the mask is black, and a blend between the inputs where the mask is gray.

At first, the mask input appears as triangle on the right side of the node, but when you drag it, it turns into an arrow labeled mask. If you cannot see the mask input, ensure that the mask control is disabled or set to none.

Control (UI)

Knob (Scripting)

Default Value

Function

Copy Tab

Copy channel

N/A

enabled

Enables the associated channel to the right. Disabling this checkbox is the same as setting the channel to none.

from0

rgba.alpha

A channel to copy from input A.

to

N/A

enabled

Enables the associated channel to the right. Disabling this checkbox is the same as setting the channel to none.

to0

rgba.alpha

The channel that the above Copy channel replaces in input B.

Copy channel

N/A

enabled

Enables the associated channel to the right. Disabling this checkbox is the same as setting the channel to none.

from1

rgba.alpha

Another channel to copy from input A.

to

N/A

enabled

Enables the associated channel to the right. Disabling this checkbox is the same as setting the channel to none.

to1

rgba.alpha

The channel that the above Copy channel replaces in input B.

Copy channel

N/A

enabled

Enables the associated channel to the right. Disabling this checkbox is the same as setting the channel to none.

from2

rgba.alpha

Another channel to copy from input A.

to

N/A

enabled

Enables the associated channel to the right. Disabling this checkbox is the same as setting the channel to none.

to2

rgba.alpha

The channel that the above Copy channel replaces in input B.

Copy channel

N/A

enabled

Enables the associated channel to the right. Disabling this checkbox is the same as setting the channel to none.

from3

rgba.alpha

Another channel to copy from input A.

to

N/A

enabled

Enables the associated channel to the right. Disabling this checkbox is the same as setting the channel to none.

to3

rgba.alpha

The channel that the above Copy channel replaces in input B.

Layer Copy

channels

none

Copies all the selected channels from A to B, if they exist in A. If they don’t exist in A, the channels from B are used unchanged.

This allows you to easily copy multiple channels from A to B. For example, setting this to all copies all the channels that exist in A.

If you set this to something other than all or none, you can use the checkboxes on the right to select individual channels.

Set BBox to

bbox

union

How to output the bounding box:

union - combine the two bounding boxes.

B side - use the bounding box from input B. Any data from the A input that’s outside this box is clipped.

A side - use the bounding box from input A. Any data from the B input that’s outside this box is clipped.

metadata from

metainput

B

Sets the source of the metadata passed down the node tree:

B - only input B metadata is preserved.

A - only input A metadata is preserved.

All - both input A and B metadata is preserved.

range from

rangeinput

B

Sets the output frame range passed down the node tree:

B - only frames from input B are output.

A - only frames from input A are output.

All - both input A and B frames are output.

mask

N/A

disabled

Enables the associated mask channel to the right. Disabling this checkbox is the same as setting the channel to none.

maskChannelInput

none

The channel to use as a mask. By default, the A input is used where the mask is white, the B input where the mask is black, and a blend between the inputs where the mask is gray.

inject

inject

disabled

Copies the mask input to the predefined mask.a channel. Injecting the mask allows you to use the same mask further downstream.

invert

invert_mask

disabled

Inverts the use of the mask channel so that the B input is used where the mask is white and the A input where the mask is black.

fringe

fringe

disabled

When enabled, only apply the effect to the edge of the mask.

When disabled, the effect is applied to the entire mask.

(un)premult by

N/A

disabled

Enables the associated channel to the right. Disabling this checkbox is the same as setting the channel to none.

unpremult

none

The image is divided by this channel before being processed, and multiplied again afterwards.

If you are using premultiplied input images, you may want to check (un)premult by and select rgba.alpha here. This will simulate doing the copy before the premultiplication was done. It is the same as adding an Unpremult node before this node and a Premult node after, but allows you to work faster if you’re only using one Copy node.

If you are using unpremultiplied input images, you should leave this set to none.

invert

invert_unpremult

disabled

Inverts the use of the (un)premultiply channel.

mix

mix

1

Dissolves between the original B input at 0 and the full copy effect at 1.