set_hsi — Define output colors (HSI-coded).
set_hsi sets the region output color(s)/grayvalue(s) for the valid window. Colors are passed as Hue, Saturation, and Intensity. Transformation from HSI to RGB is done with:
Selected colors are used until the next call of set_color,set_pixel, set_rgb or set_gray. Colors are relevant to windows, i.e. only the colors of the valid window can be set. Region output colors are used by operatores like disp_region, disp_line, disp_rectangle1, disp_rectangle2, disp_arrow, etc. It is also used by operators with gray value output in certain output modes (e.g. '3d_plot_lines','histogram', 'contourline', etc. See set_paint).
The colors are internally stored as RGB triples. Some HSI triples can not be represented by a valid RGB triple (i.e. in the range 0..255). In this case the nearest color which can be represented is used instead.
Hue for region output.
Default value: 30
Typical range of values: 0 ≤ Hue ≤ 255
Restriction: 0 <= Hue && Hue <= 255
Saturation for region output.
Default value: 255
Typical range of values: 0 ≤ Saturation ≤ 255
Restriction: 0 <= Saturation && Saturation <= 255
Intensity for region output.
Default value: 84
Typical range of values: 0 ≤ Intensity ≤ 255
Restriction: 0 <= Intensity && Intensity <= 255
set_hsi returns 2 (H_MSG_TRUE) if the window is valid and the output colors are displayable. Otherwise an exception is raised.
get_hsi, get_pixel, trans_from_rgb, trans_to_rgb, disp_region