You are here: Start » FIL.NET » Function Reference » Image » Image Thresholding » FIL.ThresholdImage_Color
Transforms each pixel value to maximum or minimum depending on the distance from a given color.
Namespace: | FilNet |
---|---|
Assembly: | FIL.NET.dll |
Syntax
C++
C#
public static void ThresholdImage_Color ( FilNet.Image inImage, NullableRef<FilNet.Region> inRoi, FilNet.Pixel inRgbColor, float inChromaAmount, float inMaxDifference, float inFuzziness, FilNet.Image outMonoImage )
Parameters
Name | Type | Range | Default | Description | |
---|---|---|---|---|---|
inImage | FilNet.Image | Input image. | |||
inRoi | FilNet.NullableRef<FilNet.Region> | Region of interest. Default value: ftl::NIL. | |||
inRgbColor | FilNet.Pixel | Color to compare the image to. | |||
inChromaAmount | float | <0.0f, 1.0f> | 0.7f | Proportion of chromatic information in distance computation. Default value: 0.7f. | |
inMaxDifference | float | <0.0f, INF> | 5.0f | Maximum difference between image pixel and model color. Default value: 5.0f. | |
inFuzziness | float | <0.0f, INF> | 0.0f | A tolerance for computed difference that results in intermediate output values. Default value: 0.0f. | |
outMonoImage | FilNet.Image |
Examples
Hardware Acceleration
This operation is optimized for SSE2 technology for pixels of types: 1xUINT8 (for inFuzziness = 0), 3xUINT8 (for inFuzziness = 0).
This operation is optimized for NEON technology for pixels of types: 1xUINT8 (for inFuzziness = 0), 3xUINT8 (for inFuzziness = 0).
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 | Region exceeds an input image in ThresholdImage_Color. |
DomainError | Not supported inImage pixel format in ThresholdImage_Color. Supported formats: 1xUInt8, 2xUInt8, 3xUInt8, 4xUInt8. |