op_colorize

Last update: 2023-08-22
  • Created for:
  • Developer
    User

Colorize image. Colorizes the image data while preserving shadows and highlights.

op_colorize= *color*[,off|norm[, *contrast*]]

color

Replacement RGB color.

off

Disable automatic brightness compensation.

norm

Enable automatic brightness compensation (default).

contrast

Contrast range (real 0..100); set to 0 to preserve the input contrast.

The second argument specifies whether the brightness of the source image should be adjusted before colorizing. Specify off to disable the automatic brightness compensation or norm to adjust the brightness automatically so that the median value is at 50% intensity.

Set the contrast value to 0 to preserve the contrast range of the input image, or specify a desired contrast range with a value greater than 0. A value of 100 maximizes the contrast. Typical values might be between 30 and 70.

In addition to the built-in brightness and contrast adjustments, op_brightness= and op_contrast= may be used to further fine-tune the colorizing effect.

NOTE

The colorizing algorithm uses only the luminance information in the image data. This conversion to grayscale is simple and not color-managed. op_colorize always outputs RGB data, even if the input is grayscale or CMYK.

Properties

Layer command. Applies to the current layer or to the composite image if layer=comp. Ignored by effect layers.

color must be an RGB value; gray or CMYK color values are not supported.

The contrast value is ignored if brightness compensation is turned off.

color is assumed to exist in the working color space corresponding to the pixel type of color. color is converted accurately if the layer image has a different pixel type at the time of merge.

CMYK images are converted to RGB before the operation is applied.

Default

None, for no colorization. The second and third arguments default to norm,0, for automatic brightness compensation and no contrast change.

Example

Adjust brightness and contrast dynamically before colorizing an image layer:

&op_brightness=-15&op_contrast=22&op_colorize=a0b0c0&

Use automatic brightness and contrast adjustment instead:

&op_colorize=a0b0c0,norm,50&

See also

color, op_brightness=, op_contrast=, Color Management

On this page