Start » Filter Reference » Image » Image Conversions » SelectChannel

SelectChannel

Basic

Module: FoundationLite

Creates an image from a single channel of the input image.

Name Type Range Description
Input value
 inImage Image Input image
Input value
 inRoi Region* Range of pixels to be processed
Input value
 inChannelIndex Integer 0 - 3
Output value
 outImage Image Output image

Description

The operation extracts the selected color channel of inImage.

Examples

Description of usage of this filter can be found in examples and tutorial: Image Modification Using the HMI.

An example image used as inImage.

The resulting outImage when inChannelIndex = 0.

The resulting outImage when inChannelIndex = 1.

The resulting outImage when inChannelIndex = 2.

Hardware Acceleration

This operation supports automatic parallelization for multicore and multiprocessor systems.

Errors

This filter can throw an exception to report error. Read how to deal with errors in Error Handling.

List of possible exceptions:

Error type Description
DomainError Channel index out of range in SelectChannel.
DomainError Region exceeds an input image in SelectChannel.

Complexity Level

This filter is available on Basic Complexity Level.

See Also

  • SplitChannels – Creates several monochromatic images from individual channels of the input image.