---
title: MPSImageThresholdBinaryInverse
framework: metalperformanceshaders
role: symbol
role_heading: Class
path: metalperformanceshaders/mpsimagethresholdbinaryinverse
---

# MPSImageThresholdBinaryInverse

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

## Declaration

```swift
class MPSImageThresholdBinaryInverse
```

## Overview

Overview An MPSImageThresholdBinaryInverse function 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. The following listing shows the threshold binary inverse function. Listing 1. Threshold binary inverse function destinationPixelValue = sourcePixelValue > thresholdValue ? 0 : maximumValue

## Topics

### Initializers

- [init(coder:device:)](metalperformanceshaders/mpsimagethresholdbinaryinverse/init(coder:device:).md)

### Methods

- [init(device:thresholdValue:maximumValue:linearGrayColorTransform:)](metalperformanceshaders/mpsimagethresholdbinaryinverse/init(device:thresholdvalue:maximumvalue:lineargraycolortransform:).md)

### Properties

- [thresholdValue](metalperformanceshaders/mpsimagethresholdbinaryinverse/thresholdvalue.md)
- [maximumValue](metalperformanceshaders/mpsimagethresholdbinaryinverse/maximumvalue.md)
- [transform](metalperformanceshaders/mpsimagethresholdbinaryinverse/transform.md)

## Relationships

### Inherits From

- [MPSUnaryImageKernel](metalperformanceshaders/mpsunaryimagekernel.md)

### Conforms To

- [CVarArg](swift/cvararg.md)
- [CustomDebugStringConvertible](swift/customdebugstringconvertible.md)
- [CustomStringConvertible](swift/customstringconvertible.md)
- [Equatable](swift/equatable.md)
- [Hashable](swift/hashable.md)
- [NSCoding](foundation/nscoding.md)
- [NSCopying](foundation/nscopying.md)
- [NSObjectProtocol](objectivec/nsobjectprotocol.md)
- [NSSecureCoding](foundation/nssecurecoding.md)

## See Also

### Image Threshold Filters

- [MPSImageThresholdBinary](metalperformanceshaders/mpsimagethresholdbinary.md)
- [MPSImageThresholdToZero](metalperformanceshaders/mpsimagethresholdtozero.md)
- [MPSImageThresholdToZeroInverse](metalperformanceshaders/mpsimagethresholdtozeroinverse.md)
- [MPSImageThresholdTruncate](metalperformanceshaders/mpsimagethresholdtruncate.md)