disp_colorT_disp_colorDispColorDispColordisp_color (Operator)
Name
disp_colorT_disp_colorDispColorDispColordisp_color
— Displays a color (RGB) image
Signature
Description
disp_colordisp_colorDispColorDispColorDispColordisp_color
displays the three channels of a color image in the
output window. The channels are ordered in the sequence (red,green,blue).
disp_colordisp_colorDispColorDispColorDispColordisp_color
can be simulated by disp_channeldisp_channelDispChannelDispChannelDispChanneldisp_channel
.
Attention
Due to the restricted number of available colors the color appearance is
usually different from the original.
Execution Information
- Multithreading type: reentrant (runs in parallel with non-exclusive operators).
- Multithreading scope: global (may be called from any thread).
- Processed without parallelization.
Parameters
ColorImageColorImageColorImageColorImagecolorImagecolor_image
(input_object) multichannel-image →
objectHImageHObjectHImageHobject (byte / direction / cyclic / int1 / int2 / uint2 / int4 / int8 / real / complex / vector_field)
Color image to display.
WindowHandleWindowHandleWindowHandleWindowHandlewindowHandlewindow_handle
(input_control) window →
HWindow, HTupleHHandleHTupleHtuple (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_colorDispColorDispColorDispColordisp_color
returns 2 (H_MSG_TRUE). Otherwise an
exception is raised.
Possible Predecessors
open_windowopen_windowOpenWindowOpenWindowOpenWindowopen_window
,
set_rgbset_rgbSetRgbSetRgbSetRgbset_rgb
,
set_lutset_lutSetLutSetLutSetLutset_lut
,
set_hsiset_hsiSetHsiSetHsiSetHsiset_hsi
Alternatives
disp_channeldisp_channelDispChannelDispChannelDispChanneldisp_channel
,
disp_objdisp_objDispObjDispObjDispObjdisp_obj
See also
disp_imagedisp_imageDispImageDispImageDispImagedisp_image
,
open_windowopen_windowOpenWindowOpenWindowOpenWindowopen_window
,
reset_obj_dbreset_obj_dbResetObjDbResetObjDbResetObjDbreset_obj_db
,
set_lutset_lutSetLutSetLutSetLutset_lut
,
dump_windowdump_windowDumpWindowDumpWindowDumpWindowdump_window
Module
Foundation