Start » Filter Reference » Image » Image Conversions » AddChannels
Basic| Module: | FoundationLite |
|---|
Creates a monochromatic image by summing the values of the input image channels.
| Name | Type | Description | |
|---|---|---|---|
 |
inImage | Image | Input image |
|
inRoi | Region* | Range of pixels to be processed |
 |
outImage | Image | output mono image |
Description
This operation sums values of the given inImage image channels to obtain a monochromatic image.
Examples
 |
|
|
Image with one channel on the input of the filter (on the left) doesn't affect the image - see the image on the right. |
|
 |
|
|
Input RGB image (on the left) converted to single-channel image (on the right) with pixel values obtained from summing values of input image channels. For example, if a pixel from input image in each R, G and B channel has values {255, 0, 0}, corresponding pixel in the output image will have value {255} (because 255 + 0 + 0 = 255). |
|
Hardware Acceleration
This operation is optimized for AVX2 technology for pixels of types: 2xUINT8, 3xUINT8, 4xUINT8, 2xUINT16, 3xUINT16, 4xUINT16.
This operation is optimized for SSSE3 technology for pixels of types: 2xUINT8, 3xUINT8, 4xUINT8, 2xUINT16, 3xUINT16, 4xUINT16.
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 | Region exceeds an input image in AddChannels. |
Complexity Level
This filter is available on Basic Complexity Level.
See Also
- AddChannels_Saturation – Creates a monochromatic image by summing the values of the input image channels with saturation.
- AverageChannels – Creates a monochromatic image by averaging the input image channels.
- AverageChannels_Weighted – Creates a monochromatic image from weighted averages of the input image channels.