disp_color

disp_color ( ColorImage : : WindowHandle : )

Displays a color (RGB) image

disp_color displays the three channels of a color image in the output window. The channels are ordered in the sequence (red,green,blue). disp_color can be simulated by disp_channel.

Attention

Due to the restricted number of available colors the color appearance is usually different from the original.

Parameters

`ColorImage` (input_object)	image `->` object : byte / direction / cyclic / int1 / int2 / uint2 / int4 / real / complex / dvf
Color image to display.

`WindowHandle` (input_control)	window `->` integer
Window identifier.

Example

/* disp_color(ColorImage) is identical to: */
Herror my_disp_color(Hobject ColorImage, Htuple *WindowHandle) {
  Htuple  Tupel;
  create_tuple(&Tupel,3);
  set_i(Tupel,1,0);
  set_i(Tupel,2,1);
  set_i(Tupel,3,2);
  T_disp_channel(ColorImage,*WindowHandle,Tupel);
  destroy_tuple(Tupel);
}

Result

If the used image contains valid values and a correct output mode is set, disp_color returns 2 (H_MSG_TRUE). Otherwise an exception handling is raised.

Parallelization Information

disp_color is reentrant, local, and processed without parallelization.

Possible Predecessors

open_window, set_rgb, set_lut, set_hsi

Alternatives

disp_channel, disp_obj

Module

System