Class

MPSImageThresholdBinary

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

Declaration

class 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

var thresholdValue: Float

The threshold value used to initialize the threshold filter.

var maximumValue: Float

The maximum value used to initialize the threshold filter.

var transform: UnsafePointer<Float>

The color transform used to initialize the threshold filter.

Relationships

Inherits From

Conforms To

See Also

Image Threshold Filters

class MPSImageThresholdBinaryInverse

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

class MPSImageThresholdToZero

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

class MPSImageThresholdToZeroInverse

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

class MPSImageThresholdTruncate

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

Beta Software

This documentation contains preliminary information about an API or technology in development. This information is subject to change, and software implemented according to this documentation should be tested with final operating system software.

Learn more about using Apple's beta software