HALCON Reference Manual 10.0.2
Table of Contents / Image / Channel ClassesClassesClasses | | | Operators

access_channelaccess_channelaccess_channelAccessChannelAccessChannel (Operator)

Name

access_channelaccess_channelaccess_channelAccessChannelAccessChannel — Access a channel of a multichannel image.

Signature

access_channel(MultiChannelImage : Image : Channel : )

Herror access_channel(const Hobject MultiChannelImage, Hobject* Image, const Hlong Channel)

Herror T_access_channel(const Hobject MultiChannelImage, Hobject* Image, const Htuple Channel)

Herror access_channel(Hobject MultiChannelImage, Hobject* Image, const HTuple& Channel)

HImage HImage::AccessChannel(const HTuple& Channel) const

void HOperatorSetX.AccessChannel(
[in] IHUntypedObjectX* MultiChannelImage, [out] IHUntypedObjectX** Image, [in] VARIANT Channel)

IHImageX* HImageX.AccessChannel([in] Hlong Channel)

static void HOperatorSet.AccessChannel(HObject multiChannelImage, out HObject image, HTuple channel)

HImage HImage.AccessChannel(int channel)

Description

The operator access_channelaccess_channelaccess_channelAccessChannelAccessChannel accesses a channel of the (multichannel) input image. The result is a one-channel image. The definition domain of the input is adopted. The channels are numbered from 1 to n. The number of channels can be determined via the operator count_channelscount_channelscount_channelsCountChannelsCountChannels.

Parallelization

Parameters

MultiChannelImageMultiChannelImageMultiChannelImageMultiChannelImagemultiChannelImage (input_object)  multichannel-image → objectHImageHImageHImageXHobject (byte / direction / cyclic / int1 / int2 / uint2 / int4 / int8 / real / complex / vector_field)

Multichannel image.

ImageImageImageImageimage (output_object)  singlechannelimage → objectHImageHImageHImageXHobject * (byte / direction / cyclic / int1 / int2 / uint2 / int4 / int8 / real / complex / vector_field)

One channel of MultiChannelImage.

ChannelChannelChannelChannelchannel (input_control)  channel → HTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong)

Index of channel to be accessed.

Default value: 1

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

Typical range of values: 1 ≤ Channel Channel Channel Channel channel

Example (C)

read_image(&Color,"patras");   /* Farbbild einlesen */
access_channel(Color,&Red,1); /* Rotkanal extrahieren */
disp_image(Red,WindowHandle);

Possible Predecessors

count_channelscount_channelscount_channelsCountChannelsCountChannels

Possible Successors

disp_imagedisp_imagedisp_imageDispImageDispImage

Alternatives

decompose2decompose2decompose2Decompose2Decompose2, decompose3decompose3decompose3Decompose3Decompose3, decompose4decompose4decompose4Decompose4Decompose4, decompose5decompose5decompose5Decompose5Decompose5

See also

count_channelscount_channelscount_channelsCountChannelsCountChannels

Module

Foundation

Table of Contents / Image / Channel ClassesClassesClasses | | | Operators
HALCON Reference Manual 10.0.2 Copyright © 1996-2011 MVTec Software GmbH