You are here: Start » FIL.NET » FIL.ThresholdImage_RGB
FIL.ThresholdImage_RGB
Transforms each pixel value to minimum or maximum depending on whether it belongs to the specified range for each individual pixel component.
| Namespace: | FilNet |
|---|---|
| Assembly: | FIL.NET.dll |
Syntax
public static void ThresholdImage_RGB ( FilNet.Image inRgbImage, float inFuzziness, FilNet.Image outMonoImage )
Parameters
| Name | Type | Range | Default | Description | |
|---|---|---|---|---|---|
 | inRgbImage | FilNet.Image | Input image, usually in the RGB color space. | ||
| inFuzziness | float | <0.0f, INF> | Tolerance for the ranges that results in intermediate output values. | |
 | outMonoImage | FilNet.Image |
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.
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 ThresholdImage_RGB. |
