get_hsi ( : : : Hue, Saturation, Intensity )

Queries the HSI coding of the current color.

get_hsi returns the output color resp. greyvalues for the active window, described in Hue, Saturation and Intensity. get_hsi corresponds to the procedure get_pixel but returns the entries of the color lookup table instead of its indices. The values returned by get_hsi can be set with set_hsi.


Attention

The values returned by get_hsi may be inaccurate due to rounding errors. They don't necessarily match the values set with set_hsi exactly (colors are stored in RGB internally).


Parameters

Hue (output_control)
integer-array -> integer
hue (color value) of the current color.

Saturation (output_control)
integer-array -> integer
Saturation of the current color.

Intensity (output_control)
integer-array -> integer
Intensity of the current color.


Result

get_hsi returns TRUE, if a window is active. Otherwise an exception is raised.


Possible Successors

set_hsi, set_rgb, disp_image


See also

set_hsi, set_color, set_rgb, trans_to_rgb, trans_from_rgb



Copyright © 1996-1997 MVTec Software GmbH