splitHLS
Top  Previous  Next

splitHLS ( integer Input, integer Hue, integer Lum, integer Sat )

Use this function to split a color image into the Hue, Luminance and Saturation component images. A 48-bit RGB image will be split into 16-bit grayscale components; image of any other type will be split into 8-bit grayscale components.

Parameters
 
Input  
 
An integer between 0 and 116 specifying the input image frame number. A value of 0 represents the DMA memory buffer of the video device. Values in the range of 100-116 correspond to hidden frames.  
 
Hue, Lum, Sat  
 
Integer between 1 and 116 specifying the output frame numbers for the Hue, Luminance and Saturation components respectively. 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.