You are here: Start » Function Reference » Image Thresholding » ThresholdToRegion_RGB
ThresholdToRegion_RGB
Creates a region containing image pixels which belongs to the specified range for each individual pixel component.
Header: | AVL.h |
---|
Syntax
void avl::ThresholdToRegion_RGB ( const avl::Image& inRgbImage, atl::Optional<const avl::Region&> inRoi, atl::Optional<int> inMinRed, atl::Optional<int> inMaxRed, atl::Optional<int> inMinGreen, atl::Optional<int> inMaxGreen, atl::Optional<int> inMinBlue, atl::Optional<int> inMaxBlue, avl::Region& outRegion )
Parameters
Name | Type | Range | Default | Description | |
---|---|---|---|---|---|
inRgbImage | const Image& | Input image, usually in the RGB color space | |||
inRoi | Optional<const Region&> | NIL | Region of interest | ||
inMinRed | Optional<int> | 0 - 255 | 128 | Minimum for the first pixel component, usually Red (Auto = -INF) | |
inMaxRed | Optional<int> | 0 - 255 | NIL | Maximum for the first pixel component, usually Red (Auto = +INF) | |
inMinGreen | Optional<int> | 0 - 255 | 128 | Minimum for the second pixel component, usually Green (Auto = -INF) | |
inMaxGreen | Optional<int> | 0 - 255 | NIL | Maximum for the second pixel component, usually Green (Auto = +INF) | |
inMinBlue | Optional<int> | 0 - 255 | 128 | Minimum for the third pixel component, usually Blue (Auto = -INF) | |
inMaxBlue | Optional<int> | 0 - 255 | NIL | Maximum for the third pixel component, usually Blue (Auto = +INF) | |
outRegion | Region& | Output region |
Requirements
For input inRgbImage only pixel formats are supported: 3xuint8.
Read more about pixel formats in Image documentation.
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
Error type | Description |
---|---|
DomainError | Not a 3-channel and 8-bit image in ThresholdToRegion_RGB. |
See Also
- ThresholdImage_RGB – Transforms each pixel value to minimum or maximum depending on whether it belongs to the specified range for each individual pixel component.