Start » Filter Reference » Image » Image Conversions » MergeChannels
Basic| Module: | FoundationLite |
|---|
Creates a multichannel image from several monochromatic ones.
| Name | Type | Description | |
|---|---|---|---|
 |
inMonoImage1 | Image | An image that becomes the first channel |
|
inMonoImage2 | Image | An image that becomes the second channel |
|
inMonoImage3 | Image* | An image that becomes the third channel |
|
inMonoImage4 | Image* | An image that becomes the fourth channel |
 |
outImage | Image | Output image |
Requirements
For input inMonoImage1 only pixel formats are supported: 1⨯uint8, 1⨯int8, 1⨯uint16, 1⨯int16, 1⨯int32, 1⨯real.
For input inMonoImage2 only pixel formats are supported: 1⨯uint8, 1⨯int8, 1⨯uint16, 1⨯int16, 1⨯int32, 1⨯real.
Read more about pixel formats in Image documentation.
Description
The operation combines the given monochromatic images to obtain a color image, each of its channels equal to the only channel of the corresponding input image.
Examples
 An example image used as inMonoImage1. |
 An example image used as inMonoImage2. |
 An example image used as inMonoImage3. |
 The resulting outImage. |
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 | Image sizes are not equal in MergeChannels. |
| DomainError | Input image is not monochromatic in MergeChannels. |
| DomainError | Pixel types of the input images are not the same in MergeChannels. |
| DomainError | Not supported inMonoImage1 pixel format in MergeChannels. Supported formats: 1xUInt8, 1xInt8, 1xUInt16, 1xInt16, 1xInt32, 1xReal. |
| DomainError | Not supported inMonoImage2 pixel format in MergeChannels. Supported formats: 1xUInt8, 1xInt8, 1xUInt16, 1xInt16, 1xInt32, 1xReal. |
Complexity Level
This filter is available on Basic Complexity Level.
See Also
- SplitChannels – Creates several monochromatic images from individual channels of the input image.