Operator Reference

HALCON Operator Reference / Graphics / Output
ClassesClasses | | Operators

disp_channelT_disp_channelDispChannelDispChanneldisp_channel (Operator)

disp_channelT_disp_channelDispChannelDispChanneldisp_channel — Displays images with several channels.

Signature

disp_channel(MultichannelImage : : WindowHandle, Channel : )

Herror T_disp_channel(const Hobject MultichannelImage, const Htuple WindowHandle, const Htuple Channel)

void DispChannel(const HObject& MultichannelImage, const HTuple& WindowHandle, const HTuple& Channel)

void HImage::DispChannel(const HWindow& WindowHandle, const HTuple& Channel) const

void HImage::DispChannel(const HWindow& WindowHandle, Hlong Channel) const

void HWindow::DispChannel(const HImage& MultichannelImage, const HTuple& Channel) const

void HWindow::DispChannel(const HImage& MultichannelImage, Hlong Channel) const

static void HOperatorSet.DispChannel(HObject multichannelImage, HTuple windowHandle, HTuple channel)

void HImage.DispChannel(HWindow windowHandle, HTuple channel)

void HImage.DispChannel(HWindow windowHandle, int channel)

void HWindow.DispChannel(HImage multichannelImage, HTuple channel)

void HWindow.DispChannel(HImage multichannelImage, int channel)

def disp_channel(multichannel_image: HObject, window_handle: HHandle, channel: MaybeSequence[int]) -> None

Description

disp_channeldisp_channelDispChannelDispChanneldisp_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 ChannelChannelChannelchannelchannel 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_imagedisp_imageDispImageDispImagedisp_image.

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

MultichannelImageMultichannelImageMultichannelImagemultichannelImagemultichannel_image (input_object)  (multichannel-)image(-array) → objectHImageHObjectHObjectHobject (byte / direction / cyclic / int1 / int2 / uint2 / int4 / int8 / real / complex / vector_field)

Multichannel images to be displayed.

WindowHandleWindowHandleWindowHandlewindowHandlewindow_handle (input_control)  window → HWindow, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Window handle.

ChannelChannelChannelchannelchannel (input_control)  integer(-array) → HTupleMaybeSequence[int]HTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Number of channel or the numbers of the RGB-channels

Default: 1

Suggested values: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10

Example (HDevelop)

read_image(Image,'patras')
count_channels (Image, Channels)
for I := 1 to Channels by 1
    disp_channel (Image, WindowHandle, I)
endfor

Result

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

Possible Predecessors

open_windowopen_windowOpenWindowOpenWindowopen_window, set_rgbset_rgbSetRgbSetRgbset_rgb, set_lutset_lutSetLutSetLutset_lut, set_hsiset_hsiSetHsiSetHsiset_hsi

Alternatives

disp_imagedisp_imageDispImageDispImagedisp_image, disp_colordisp_colorDispColorDispColordisp_color

See also

open_windowopen_windowOpenWindowOpenWindowopen_window, reset_obj_dbreset_obj_dbResetObjDbResetObjDbreset_obj_db, set_lutset_lutSetLutSetLutset_lut, dump_windowdump_windowDumpWindowDumpWindowdump_window

Module

Foundation

ClassesClasses | | Operators