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

ConvertToMultichannel

Creates a multichannel image from a monochromatic one by replicating its channel.

Syntax

void avl::ConvertToMultichannel
(
	const avl::Image& inMonoImage,
	atl::Optional<const avl::Region&> inRoi,
	int inNewDepth,
	avl::Image& outImage
)

void ConvertToMultichannel
(
	Image inMonoImage,
	Region? inRoi,
	int inNewDepth,
	out Image outImage
)

Parameters

Name	Type	Range	Default	Description
inMonoImage	const Image&
inRoi	Optional<const Region&>		NIL	Range of pixels to be processed
inNewDepth	int	1 - 4	3
outImage	Image&			Output image

Description

The operation computes multichannel image equivalent to monochromatic inMonoImage. The number of channels in the resulting image is determined by the inNewDepth parameter. Each of the channels in outImage will be equal to the only channel of the inMonoImage.

Note that the operation does not alter the appearance of the image in the IDE.

Hardware Acceleration

This operation supports automatic parallelization for multicore and multiprocessor systems.

Errors

Error type	Description
DomainError	Not a monochromatic input in ConvertToMultichannel.