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