You are here: Start » AVL.NET » Function Reference » Image » Image Thresholding » AVL.ThresholdToRegion_RGB
Creates a region containing image pixels which belongs to the specified range for each individual pixel component.
Namespace: | AvlNet |
---|---|
Assembly: | AVL.NET.dll |
Syntax
public static void ThresholdToRegion_RGB ( AvlNet.Image inRgbImage, int? inMinRed, int? inMaxRed, int? inMinGreen, int? inMaxGreen, int? inMinBlue, int? inMaxBlue, int? inMinAlpha, int? inMaxAlpha, AvlNet.Region outRegion )
Parameters
Name | Type | Range | Default | Description | |
---|---|---|---|---|---|
inRgbImage | AvlNet.Image | Input image, usually in the RGB color space. | |||
inMinRed | int? | <0, 255> | 128 | Minimum for the first pixel component, usually Red (Auto = -INF). Default value: 128. | |
inMaxRed | int? | <0, 255> | Maximum for the first pixel component, usually Red (Auto = +INF). Default value: atl::NIL. | ||
inMinGreen | int? | <0, 255> | 128 | Minimum for the second pixel component, usually Green (Auto = -INF). Default value: 128. | |
inMaxGreen | int? | <0, 255> | Maximum for the second pixel component, usually Green (Auto = +INF). Default value: atl::NIL. | ||
inMinBlue | int? | <0, 255> | 128 | Minimum for the third pixel component, usually Blue (Auto = -INF). Default value: 128. | |
inMaxBlue | int? | <0, 255> | Maximum for the third pixel component, usually Blue (Auto = +INF). Default value: atl::NIL. | ||
inMinAlpha | int? | <0, 255> | Minimum for the fourth pixel component, usually Blue (Auto = -INF). Default value: atl::NIL. | ||
inMaxAlpha | int? | <0, 255> | Maximum for the fourth pixel component, usually Blue (Auto = +INF). Default value: atl::NIL. | ||
outRegion | AvlNet.Region | Output region. |
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 is optimized for SSE41 technology for pixels of type: UINT8.
This operation is optimized for NEON technology for pixels of type: UINT8.
This operation supports automatic parallelization for multicore and multiprocessor systems.
Hardware acceleration settings may be manipulated with Settings class.
Errors
List of possible exceptions:
Error type | Description |
---|---|
DomainError | Not an 8-bit image in ThresholdToRegion_RGB. |
DomainError | Region exceeds an input image in ThresholdToRegion_RGB. |
DomainError | Unsupported image depth in ThresholdToRegion_RGB. |
DomainError | Not supported inRgbImage pixel format in ThresholdToRegion_RGB. Supported formats: 3xUInt8, 4xUInt8. |