<!--
{
  "availability" : [
    "iOS: 10.0.0 -",
    "iPadOS: 10.0.0 -",
    "macCatalyst: 13.0.0 -",
    "macOS: 10.13.0 -",
    "tvOS: 10.0.0 -",
    "visionOS: 1.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "MetalPerformanceShaders",
  "identifier" : "/documentation/MetalPerformanceShaders/MPSCNNPoolingAverage",
  "metadataVersion" : "0.1.0",
  "role" : "Class",
  "symbol" : {
    "kind" : "Class",
    "modules" : [
      "Metal Performance Shaders"
    ],
    "preciseIdentifier" : "c:objc(cs)MPSCNNPoolingAverage"
  },
  "title" : "MPSCNNPoolingAverage"
}
-->

# MPSCNNPoolingAverage

An average pooling filter.

```
class MPSCNNPoolingAverage
```

## Overview

For each pixel in an image, the filter returns the average value of the pixels in the filter region defined by `kernelWidth` `x` `kernelHeight`.

When the value of the [`edgeMode`](/documentation/MetalPerformanceShaders/MPSCNNKernel/edgeMode) property is set to [`MPSImageEdgeMode.clamp`](/documentation/MetalPerformanceShaders/MPSImageEdgeMode/clamp), the filtering window is shrunk to remain within the source image borders. For pixels close to the image borders, the filtering window will be smaller in order to fit inside the source image and less values will be used to compute the average value. In case the filtering window is entirely outside the source image border, the output value will be `0`.

## Topics

### Initializers

[`init(coder:device:)`](/documentation/MetalPerformanceShaders/MPSCNNPoolingAverage/init(coder:device:))

Initializes an average pooling filter.

[`init(device:kernelWidth:kernelHeight:strideInPixelsX:strideInPixelsY:)`](/documentation/MetalPerformanceShaders/MPSCNNPoolingAverage/init(device:kernelWidth:kernelHeight:strideInPixelsX:strideInPixelsY:))

Initializes an average pooling filter.

### Instance Properties

[`zeroPadSizeX`](/documentation/MetalPerformanceShaders/MPSCNNPoolingAverage/zeroPadSizeX)

[`zeroPadSizeY`](/documentation/MetalPerformanceShaders/MPSCNNPoolingAverage/zeroPadSizeY)


---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)