You are here: Reference Guide > Color Nodes > ColorMatrix

ColorMatrix

ColorMatrix multiplies the rgb colors by an arbitrary 3x3 matrix. This is useful for transforming color spaces.

Inputs and Controls

Connection Type	Connection Name	Function
Input	unnamed	The image sequence to receive the color correction.
mask	An optional image to use as a mask. By default, the color correction is limited to the non-black areas of the mask. 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.

Connection Type

Connection Name

Function

Input

unnamed

The image sequence to receive the color correction.

mask

An optional image to use as a mask. By default, the color correction is limited to the non-black areas of the mask.

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
ColorMatrix Tab
channels	channels	rgb	The color correction is only applied to these channels. You can use the checkboxes on the right to select individual channels.
matrix	matrix	0	The color matrix to apply to the input image. The output values of each primary color channel are calculated based on the input values from all three channels (red, green, and blue). For example, if you enter 0.5, 1, and 2 on the first row of the matrix, the input red value is multiplied by 0.5, the input green value by 1, and the input blue value by 2. These are then added together to produce the output red value. The output green and blue values are not affected by the first row of the matrix. You can get the values for the matrix from the Colorspace node’s color matrix output control, for example. Ctrl/Cmd + drag the Animation menu to copy the whole matrix at once.
invert	invert	disabled	When enabled, the inverse of the matrix is used.
mask	N/A	0	Enables the associated mask channel to the right. Disabling this checkbox is the same as setting the channel to none.
mask	maskChannelInput	none	The channel to use as a mask. By default, the color correction is limited to the non-black areas of this channel.
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 color correction is limited to the non-white areas of the mask.
fringe	fringe	disabled	Blurs the edges of the 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.
(un)premult by	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 color correction 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 color correct 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 image at 0 and the full effect at 1.