You are here: Start » Filter Reference » Image Thresholding » ThresholdImage_RGB
ThresholdImage_RGB
Transforms each pixel value to minimum or maximum depending on whether it 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) |
|
inFuzziness | Real | 0.0 -  |
Tolerance for the ranges that results in intermediate output values |
 |
outMonoImage | Image | ||
Only the following inRgbImage pixel formats are supported: 3xuint8
Applications
Description
The operation transforms each pixel of three-channel inRgbImage to the maximum or minimum level thus creating binary image. The input image is considered to be encoded using RGB color representation.
- Pixels meeting all of the following conditions are transformed to the maximum level:
- 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).
- Other pixels are transformed to the maximum level.
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.
Parameter inFuzziness (set to 0 by default) allows to perform fuzzy thresholding which linearly interpolates those pixel values that differ by at most inFuzziness from the border channel intensities; thus creating smooth transition between minimum and maximum values in the resulting image.
Examples
 |
 |
ThresholdImage_RGB performed on the sample image with inMinRed = 120.0, inMaxGreen = 100.0, inMaxBlue = 100.0, inFuzziness = 0.0.
|
 |
ThresholdImage_RGB performed on the sample image with inMinRed = 120.0, inMaxGreen = 100.0, inMaxBlue = 100.0, inFuzziness = 10.0.
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 ThresholdImage_RGB. |
Complexity Level
This filter is available on Advanced Complexity Level.
Filter Group
This filters is member of ThresholdImage filter group.
