Herror ::disp_color (
    Hobject ColorImage,
    const HTuple &WindowHandle
)
void HImage::DispColor (
    const HTuple &WindowHandle
) const

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 -> Hobject: HImage
Color image to display.

WindowHandle (input_control)
window -> HTuple.long
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 H_MSG_TRUE. Otherwise an exception handling is raised.


Possible Predecessors

::open_window, ::set_rgb, ::set_lut, ::set_hsi


Alternatives

::disp_channel, ::disp_obj


See also

::disp_image, ::open_window, ::open_textwindow, ::reset_obj_db, ::set_lut, ::draw_lut, ::dump_window


Module

System



Copyright © 1996-2002 MVTec Software GmbH