access_channel

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

Access a channel of a multichannel image.

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 `->` Hobject: HImage
Multichannel image.

`Image` (output_object)	singlechannelimage `->` Hobject : HImage*
One channel of MultiChannelImage.

`Channel` (input_control)	channel `->` HTuple.long
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

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

Possible Predecessors

::count_channels

Possible Successors

::disp_image

Alternatives

::decompose2, ::decompose3, ::decompose4, ::decompose5

See also

::count_channels

Module

Image / region / XLD management