disp_color🔗
Short description🔗
disp_color — Displays a color (RGB) image
Signature🔗
disp_color( image ColorImage, window WindowHandle )
Description🔗
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.
Execution information🔗
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🔗
ColorImage (input_object) multichannel-image → object (byte / direction / cyclic / int1 / int2 / uint2 / int4 / int8 / real / complex / vector_field)
Color image to display.
WindowHandle (input_control) window → (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_color returns 2 (H_MSG_TRUE). Otherwise an
exception is raised.
Combinations with other operators🔗
Module🔗
Foundation