access_channelaccess_channelAccessChannelAccessChannelaccess_channel (Operator)

Name

access_channelaccess_channelAccessChannelAccessChannelaccess_channel — 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)

def access_channel(multi_channel_image: HObject, channel: int) -> HObject

Description

The operator access_channelaccess_channelAccessChannelAccessChannelAccessChannelaccess_channel 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_channelsCountChannelsCountChannelsCountChannelscount_channels.

Execution Information

Parameters

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

Multi-channel image.

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

One channel of MultiChannelImage.

ChannelChannelChannelChannelchannelchannel (input_control)  channel HTupleintHTupleHtuple (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 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_channelsCountChannelsCountChannelsCountChannelscount_channels

Possible Successors

disp_imagedisp_imageDispImageDispImageDispImagedisp_image

Alternatives

decompose2decompose2Decompose2Decompose2Decompose2decompose2, decompose3decompose3Decompose3Decompose3Decompose3decompose3, decompose4decompose4Decompose4Decompose4Decompose4decompose4, decompose5decompose5Decompose5Decompose5Decompose5decompose5

See also

count_channelscount_channelsCountChannelsCountChannelsCountChannelscount_channels

Module

Foundation