mergeHLS

mergeHLS ( integer Hue, integer Lum, integer Sat, integer Output )

Use this function to merge the Hue, Luminance and Saturation components of a color image into an RGB image. If at least one of the component images is of the high-bit depth, the components will merge into a 48-bit RGB image, otherwise a 24-bit RGB image will be created.

Parameters

Hue, Lum, Sat

Integers between 0 and 116 specifying the frame numbers of the Hue, Luminance and Saturation component images respectively. A value of 0 represents the DMA memory buffer of the video device. Values in the range of 100-116 correspond to hidden frames.

Output

An integer between 1 and 116 specifying the frame number of the output RGB image. Values in the range of 100-116 correspond to hidden frames.

Error flags

ERR_OK

The flag set if successful.

ERR_FAILED

The flag set if failed.

Example

This set of statements increases the saturation of an RGB image by splitting it into the HLS components, offsetting all the pixels in the Saturation component by a value of +64 and then merging the components back into an RGB image.

H=101

L=102

S=103

Off=64

setCurDir("samples")

loadIm (1,"sample14.iwd")

splitHLS (1, H, L, S)

offsetIm (S, S, Off, 1)

mergeHLS (H, L, S, 2)

Remark

For more information on the HLS color space see setColorSpace.