A filter that computes the histogram of an image.


Typically, you use an MPSImageHistogram filter to calculate an image's histogram that is passed to a subsequent filter such as MPSImageHistogramEqualization or MPSImageHistogramSpecification.

Listing 1 shows how you can create a histogram filter to calculate the histogram of the MTLTexture, sourceTexture. The filter is passed an instance of MPSImageHistogramInfo that specifies information to compute the histogram for the channels of an image. After encoding, histogramInfoBuffer contains the histogram information and can be used for further operations such as equalization or specification.

Listing 1

Creating a histogram filter

var histogramInfo = MPSImageHistogramInfo(
    numberOfHistogramEntries: 256,
    histogramForAlpha: false,
    minPixelValue: vector_float4(0,0,0,0),
    maxPixelValue: vector_float4(1,1,1,1))
let calculation = MPSImageHistogram(device: device,
                                    histogramInfo: &histogramInfo)
     let bufferLength = calculation.histogramSize(forSourceFormat: sourceTexture.pixelFormat)let histogramInfoBuffer = device.makeBuffer(length: bufferLength, 
                                            options: [.storageModePrivate])
calculation.encode(to: commandBuffer,
                   sourceTexture: sourceTexture,
                   histogram: histogramInfoBuffer,
                   histogramOffset: 0)



func encode(to: MTLCommandBuffer, sourceTexture: MTLTexture, histogram: MTLBuffer, histogramOffset: Int)

Encodes the filter to a command buffer using a compute command encoder.

func histogramSize(forSourceFormat: MTLPixelFormat)

The amount of space the histogram will take up in the output buffer.


var clipRectSource: MTLRegion

The source rectangle to use when reading data.

var zeroHistogram: Bool

Determines whether to zero-initialize the histogram results.

var histogramInfo: MPSImageHistogramInfo

A structure describing the histogram content.


Inherits From