ClassesClasses | | Operators

access_channelaccess_channelAccessChannelAccessChannel (Operator)

Name

access_channelaccess_channelAccessChannelAccessChannel — Access a channel of a multi-channel 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)

void AccessChannel(const HObject& MultiChannelImage, HObject* Image, const HTuple& Channel)

HImage HImage::AccessChannel(Hlong Channel) const

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

HImage HImage.AccessChannel(int channel)

Description

The operator access_channelaccess_channelAccessChannelAccessChannelAccessChannel accesses a channel of the (multi-channel) 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_channelsCountChannelsCountChannelsCountChannels.

Execution Information

Parameters

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

Multi-channel image.

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

One channel of MultiChannelImage.

ChannelChannelChannelChannelchannel (input_control)  channel HTupleHTupleHtuple (integer) (int / long) (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");   /* read color image */
access_channel(Color,&Red,1);  /* extract red channel */
disp_image(Red,WindowHandle);

Possible Predecessors

count_channelscount_channelsCountChannelsCountChannelsCountChannels

Possible Successors

disp_imagedisp_imageDispImageDispImageDispImage

Alternatives

decompose2decompose2Decompose2Decompose2Decompose2, decompose3decompose3Decompose3Decompose3Decompose3, decompose4decompose4Decompose4Decompose4Decompose4, decompose5decompose5Decompose5Decompose5Decompose5

See also

count_channelscount_channelsCountChannelsCountChannelsCountChannels

Module

Foundation


ClassesClasses | | Operators