Back to Aurora Vision Library website

You are here: Start » Function Reference » Image » Image Conversions » SplitChannels_OrNil

SplitChannels_OrNil


Header: AVL.h
Namespace: avl
Module: FoundationLite

Creates several monochromatic images from individual channels of the input image and sets Nil for channels that are not present.

Syntax

C++
C#
 
void avl::SplitChannels_OrNil
(
	const avl::Image& inImage,
	atl::Optional<atl::Conditional<avl::Image>&> outMonoImage1 = atl::NIL,
	atl::Optional<atl::Conditional<avl::Image>&> outMonoImage2 = atl::NIL,
	atl::Optional<atl::Conditional<avl::Image>&> outMonoImage3 = atl::NIL,
	atl::Optional<atl::Conditional<avl::Image>&> outMonoImage4 = atl::NIL
)

Parameters

Name Type Default Description
Input value inImage const Image& Input image
Output value outMonoImage1 Optional<Conditional<Image>&> NIL Image of the first channel
Output value outMonoImage2 Optional<Conditional<Image>&> NIL Image of the second channel (if exists)
Output value outMonoImage3 Optional<Conditional<Image>&> NIL Image of the third channel (if exists)
Output value outMonoImage4 Optional<Conditional<Image>&> NIL Image of the fourth channel (if exists)

Optional Outputs

The computation of following outputs can be switched off by passing value atl::NIL to these parameters: outMonoImage1, outMonoImage2, outMonoImage3, outMonoImage4.

Read more about Optional Outputs.

Description

The operation extracts the color channels of inImage as separate monochromatic images. Outputs corresponding to non-existing channels of an image are set to Nil.

Hardware Acceleration

This operation supports automatic parallelization for multicore and multiprocessor systems.

See Also

  • SelectChannel – Creates an image from a single channel of the input image.
  • MergeChannels – Creates a multichannel image from several monochromatic ones.
  • SplitChannels – Creates several monochromatic images from individual channels of the input image.