disp_colorT_disp_colorDispColorDispColor (Operator)

Name

disp_colorT_disp_colorDispColorDispColor — Displays a color (RGB) image

Signature

disp_color(ColorImage : : WindowHandle : )

Herror T_disp_color(const Hobject ColorImage, const Htuple WindowHandle)

void DispColor(const HObject& ColorImage, const HTuple& WindowHandle)

void HImage::DispColor(const HWindow& WindowHandle) const

void HWindow::DispColor(const HImage& ColorImage) const

static void HOperatorSet.DispColor(HObject colorImage, HTuple windowHandle)

void HImage.DispColor(HWindow windowHandle)

void HWindow.DispColor(HImage colorImage)

Description

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

Attention

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

Execution Information

Parameters

ColorImageColorImageColorImageColorImagecolorImage (input_object)  multichannel-image objectHImageHImageHobject (byte / direction / cyclic / int1 / int2 / uint2 / int4 / int8 / real / complex / vector_field)

Color image to display.

WindowHandleWindowHandleWindowHandleWindowHandlewindowHandle (input_control)  window HWindow, HTupleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Window handle.

Example (C)

/* 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_colordisp_colorDispColorDispColorDispColor returns 2 (H_MSG_TRUE). Otherwise an exception is raised.

Possible Predecessors

open_windowopen_windowOpenWindowOpenWindowOpenWindow, set_rgbset_rgbSetRgbSetRgbSetRgb, set_lutset_lutSetLutSetLutSetLut, set_hsiset_hsiSetHsiSetHsiSetHsi

Alternatives

disp_channeldisp_channelDispChannelDispChannelDispChannel, disp_objdisp_objDispObjDispObjDispObj

See also

disp_imagedisp_imageDispImageDispImageDispImage, open_windowopen_windowOpenWindowOpenWindowOpenWindow, reset_obj_dbreset_obj_dbResetObjDbResetObjDbResetObjDb, set_lutset_lutSetLutSetLutSetLut, dump_windowdump_windowDumpWindowDumpWindowDumpWindow

Module

Foundation