access_channel ( MultiChannelImage : Image : Channel : )

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 -> object : byte / direction / cyclic / int1 / int2 / uint2 / int4 / real / complex / vector_field
Multichannel image.

Image (output_object)
singlechannelimage -> object : byte / direction / cyclic / int1 / int2 / uint2 / int4 / 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


Up: Image/Channel    Top: HALCON Operators
Copyright © 1996-2008 MVTec Software GmbH