You are here: Start » AVL.NET » 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, NullableRef<AvlNet.Region> inRoi, int? inMinRed, int? inMaxRed, int? inMinGreen, int? inMaxGreen, int? inMinBlue, int? inMaxBlue, AvlNet.Region outRegion )
Parameters
Name | Type | Range | Default | Description | |
---|---|---|---|---|---|
inRgbImage | AvlNet.Image | Input image, usually in the RGB color space. | |||
inRoi | AvlNet.NullableRef<AvlNet.Region> | Region of interest. Default value: atl::NIL. | |||
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. | ||
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 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 a 3-channel and 8-bit image in ThresholdToRegion_RGB. |