You are here: Start » Filter Reference » Image Thresholding » ThresholdToRegion_RGB
Creates a region containing image pixels which belongs to the specified range for each individual pixel component.
Name | Type | Range | Description | |
---|---|---|---|---|
inRgbImage | Image | Input image, usually in the RGB color space | ||
inRoi | Region* | Region of interest | ||
inMinRed | Integer* | 0 - 255 | Minimum for the first pixel component, usually Red (Auto = -INF) | |
inMaxRed | Integer* | 0 - 255 | Maximum for the first pixel component, usually Red (Auto = +INF) | |
inMinGreen | Integer* | 0 - 255 | Minimum for the second pixel component, usually Green (Auto = -INF) | |
inMaxGreen | Integer* | 0 - 255 | Maximum for the second pixel component, usually Green (Auto = +INF) | |
inMinBlue | Integer* | 0 - 255 | Minimum for the third pixel component, usually Blue (Auto = -INF) | |
inMaxBlue | Integer* | 0 - 255 | Maximum for the third pixel component, usually Blue (Auto = +INF) | |
outRegion | Region | Output region |
Only the following inRgbImage pixel formats are supported: 3xuint8
Applications
Description
The operation is a cousin of ThresholdImage_RGB yet it computes a region instead of an image. The three-channel inRgbImage is considered to be encoded using RGB color representation. The resulting region contains only those pixels of the input image, which meets all of the following conditions:
- Intensity of the "red" channel is in range (inMinRed, inMaxRed).
- Intensity of the "green" channel is in range (inMinGreen, inMaxGreen).
- Intensity of the "blue" channel is in range (inMinBlue, inMaxBlue).
If any of the parameters inMinRed, inMinGreen, inMinBlue is not set, it is assumed to be -infinity.
If any of the parameters inMaxRed, inMaxGreen, inMaxBlue is not set, it is assumed to be infinity.
Examples
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 here: Error Handling
Error type | Description |
---|---|
DomainError | Not a 3-channel and 8-bit image in ThresholdToRegion_RGB. |
Complexity Level
This filter is available on Advanced Complexity Level.
Filter Group
This filters is member of ThresholdToRegion filter group.