access_channel (Operator)

Name

access_channel — Access a channel of a multichannel image.

Synopsis

access_channel(MultiChannelImage : Image : Channel : )

Description

The operator access_channel 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_channels.

Parameters

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

Image (output_object)	singlechannelimage → object (byte / direction / cyclic / int1 / int2 / uint2 / int4 / int8 / real / complex / vector_field)
One channel of MultiChannelImage.

Channel (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

Example (Syntax: C)

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

Parallelization Information

access_channel is reentrant and processed without parallelization.

Possible Predecessors

count_channels

Possible Successors

disp_image

Alternatives

decompose2, decompose3, decompose4, decompose5

See also

count_channels

Module

Foundation