access_channelaccess_channelAccessChannelAccessChannel (Operator)

Name

access_channelaccess_channelAccessChannelAccessChannel — Access a channel of a multi-channel image.

Signature

access_channel(MultiChannelImage : Image : 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

Supports objects on compute devices.
Multithreading type: reentrant (runs in parallel with non-exclusive operators).
Multithreading scope: global (may be called from any thread).
Processed without parallelization.

Parameters

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

Multi-channel image.

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

One channel of MultiChannelImage.

ChannelChannelChannelChannelchannel (input_control) channel → (integer)

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

Module

Foundation

Operators