Class

MPSImageThresholdBinary

A filter that returns a specified value for each pixel with a value greater than a specified threshold or 0 otherwise.

Declaration

@interface MPSImageThresholdBinary : MPSUnaryImageKernel

Overview

An MPSImageThresholdBinary filter converts a single channel image to a binary image. If the input image is not a single channel image, the function first converts the input image into a single channel luminance image using the linear gray color transform, and then it applies the threshold.

Listing 1 shows the threshold binary function.

Listing 1

Threshold binary function

destinationPixelValue = sourcePixelValue > thresholdValue ? maximumValue : 0

Topics

Properties

thresholdValue

The threshold value used to initialize the threshold filter.

maximumValue

The maximum value used to initialize the threshold filter.

transform

The color transform used to initialize the threshold filter.

Relationships

Inherits From

See Also

Image Threshold Filters

MPSImageThresholdBinaryInverse

A filter that returns 0 for each pixel with a value greater than a specified threshold or a specified value otherwise.

MPSImageThresholdToZero

A filter that returns the original value for each pixel with a value greater than a specified threshold or 0 otherwise.

MPSImageThresholdToZeroInverse

A filter that returns 0 for each pixel with a value greater than a specified threshold or the original value otherwise.

MPSImageThresholdTruncate

A filter that clamps the return value to an upper specified value.