Herror ::disp_channel (
    Hobject MultichannelImage,
    const HTuple &WindowHandle,
    const HTuple &Channel
)
void HImage::DispChannel (
    const HTuple &WindowHandle,
    const HTuple &Channel
) const
void HImageArray::DispChannel (
    const HTuple &WindowHandle,
    const HTuple &Channel
) const

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) -> Hobject: HImage(Array)
Multichannel images to be displayed.

WindowHandle (input_control)
window -> HTuple.long
Window identifier.

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


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

System



Copyright © 1996-2002 MVTec Software GmbH