disp_channel ( MultichannelImage : : WindowHandle, Channel : )

Displays images with several channels.

disp_channel displays an image in the output window. It is possible to display several images with one call. In this case the images are displayed one after another. If the definition domains of the images overlap only the last image is visible. The parameter Channel defines the number of the channel that is displayed. For RGB-images the three color channels have to be used within a tuple parameter. For more information see disp_image.


Parameters

MultichannelImage (input_object)
image(-array) -> object : byte / direction / cyclic / int1 / int2 / uint2 / int4 / real / complex / dvf
Multichannel images to be displayed.

WindowHandle (input_control)
window -> integer
Window identifier.

Channel (input_control)
integer(-array) -> integer
Number of channel or the numbers of the RGB-channels
Default value: 1
List of values: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10


Example
   /* Tranformation from rgb to gray  */
read_image(Image,'patras') 
disp_color(Image,WindowHandle) 
rgb1_to_gray(Image,GrayImage) 
disp_image(GrayImage,WindowHandle).

Result

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


Parallelization Information

disp_channel is reentrant, local, and processed without parallelization.


Possible Predecessors

open_window, set_rgb, set_lut, set_hsi


Alternatives

disp_image, disp_color


See also

open_window, open_textwindow, reset_obj_db, set_lut, draw_lut, dump_window


Module

Foundation



Copyright © 1996-2008 MVTec Software GmbH