Start » Filter Reference » Image » Image Conversions » ConvertToMultichannel

ConvertToMultichannel


Module: FoundationLite

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

Name Type Range Description
Input value
inMonoImage Image
Input value
inRoi Region* Range of pixels to be processed
Input value
inNewDepth Integer 1 - 4
Output value
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 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.

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 Not a monochromatic input in ConvertToMultichannel.
DomainError Region exceeds an input image in ConvertToMultichannel.

Complexity Level

This filter is available on Basic Complexity Level.