You are here: Start » AVL.NET » Function Reference » Image » Image Conversions » AVL.ConvertToMultichannel

AVL.ConvertToMultichannel

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

Namespace:AvlNet
Assembly:AVL.NET.dll

Syntax

C++
C#
 
public static void ConvertToMultichannel
(
	AvlNet.Image inMonoImage,
	NullableRef<AvlNet.Region> inRoi,
	int inNewDepth,
	AvlNet.Image outImage
)

Parameters

Name Type Range Default Description
inMonoImageAvlNet.Image
inRoiAvlNet.NullableRef<AvlNet.Region>Range of pixels to be processed. Default value: atl::NIL.
inNewDepthint<1, 4>3Default value: 3.
outImageAvlNet.ImageOutput 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 is optimized for SSSE3 technology for pixels of types: 3xUINT8, 3xSINT8, 3xUINT16, 3xSINT16, 3xSINT32, 3xREAL.

This operation is optimized for NEON technology for pixels of types: 3xUINT8, 3xSINT8, 3xUINT16, 3xSINT16, 3xSINT32, 3xREAL.

This operation supports automatic parallelization for multicore and multiprocessor systems.

Hardware acceleration settings may be manipulated with Settings class.

Errors

List of possible exceptions:

Error type Description
DomainError Not a monochromatic input in ConvertToMultichannel.
DomainError Region exceeds an input image in ConvertToMultichannel.

Function Overrides

See also