PxrRemap

PxrRemap

Adjusts an input image by darkening or lightening it's mid-tones, highlights, and dark areas. The colors that are remapped to a ligher or darker color depend on the specified bias and gain values.

Input Parameters

Input Color

The input color that will be remapped with the specified bias and gain.

RIB: color inputRGB
Default: 0.0 0.0 0.0

Input Range

Input Min

The lower range of the input. This will be linearly mapped to 0.0 before applying the bias and gain.

RIB: float inputMin
Default: 0.0

Input Max

The upper range of the input. This will be linearly mapped to 1.0 before applying the bias and gain.

RIB: float inputMax
Default: 1.0

Clamp Input

If enabled, inputs less than inputMin or greater than inputMax will be clamped before applying the bias and gain. Clamping is performed on each color component independently. If disabled this may produce excessive results.

RIB: int clampInput
Default: 1

Remap

Bias

Adjusts the mid-tones in the inputRGB color. This is a normalized gamma correction factor. Values greater than 0.5 lighten the mid-tones in the inputRGB color, and values less than 0.5 make the mid-tones darker.

images/pxrRemap/pxrRemapBias.0.png

bias = 0

images/pxrRemap/pxrRemapBias.25.png

bias = .25

images/pxrRemap/pxrRemapBias.5.png

bias = .5

images/pxrRemap/pxrRemapBias.75.png

bias = .75

images/pxrRemap/pxrRemapBias1.png

bias = 1

RIB: color bias
Default: 0.5 0.5 0.5

Gain

Lightens or darkens the highlights and dark areas from the inputRGB color. Gain is used to favor dark areas when it is less than 0.5, and it favors light areas when the gain is greater than 0.5.

images/pxrRemap/pxrRemapGain0.png

gain = 0

images/pxrRemap/pxrRemapGain.25.png

gain = .25

images/pxrRemap/pxrRemapBias.5.png

gain = .5

images/pxrRemap/pxrRemapGain.75.png

gain = .75

images/pxrRemap/pxrRemapGain1.png

gain = 1

RIB: color gain
Default: 0.5 0.5 0.5

Output Range

Output Min

The lower range of the output. Values will be linearly mapped from 0.0 to this after applying the bias and gain.

RIB: float outputMin
Default: 0.0

Output Max

The upper range of the output. Values will be linearly mapped from 1.0 to this after applying the bias and gain.

RIB: float outputMax
Default: 1.0

Clamp Output

If enabled, the final outputs will be clamped to the 0.0 to 1.0 range. This clamping is performed on each color component independently.

RIB: int clampOutput
Default: 1

Output Parameters

resultRGB

The remapped color result.

resultR

The R channel from the resultRGB output.

resultG

The G channel from the resultRGB output.

resultB

The B channel from the resultRGB output.