Gamma Correction Filter

Filter

RIF_IMAGE_FILTER_GAMMA_CORRECTION

Description

Gamma encoding of images is used to optimize the usage of bits when encoding an image, or bandwidth used to transport an image, by taking advantage of the non-linear manner in which humans perceive light and color. Can be defined as
V_out = V_in^1/γ. Gamma correction should be used as the final stage of postprocessing for output to the low dynamic range (LDR) device or saving to an LDR image file.

Parameters

Parameter	Type	Input/Output	Description
gamma	float	input	The gamma value. A gamma value γ < 1 is sometimes called an encoding gamma, and the process of encoding with this compressive power-law nonlinearity is called gamma compression. Conversely, a gamma value γ > 1 is called a decoding gamma and the application of the expansive power-law nonlinearity is called gamma expansion. Value range is [0, 5], default value is 1.

Usage Example

rif_image_filter filter = nullptr;
rifContextCreateImageFilter(context, RIF_IMAGE_FILTER_GAMMA_CORRECTION, &filter);
rifImageFilterSetParameter1f(filter, "gamma", 0.1f);
rifCommandQueueAttachImageFilter(queue, filter, inputImage, outputImage);
rifContextExecuteCommandQueue(context, queue, nullptr, nullptr, nullptr);