<!--
{
  "availability" : [
    "iOS: 12.0.0 -",
    "iPadOS: 12.0.0 -",
    "macCatalyst: 14.0.0 -",
    "tvOS: 17.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "AVFoundation",
  "identifier" : "/documentation/AVFoundation/AVCapturePhotoFileDataRepresentationCustomizer/replacementPortraitEffectsMatte(for:)",
  "metadataVersion" : "0.1.0",
  "role" : "Instance Method",
  "symbol" : {
    "kind" : "Instance Method",
    "modules" : [
      "AVFoundation"
    ],
    "preciseIdentifier" : "c:objc(pl)AVCapturePhotoFileDataRepresentationCustomizer(im)replacementPortraitEffectsMatteForPhoto:"
  },
  "title" : "replacementPortraitEffectsMatte(for:)"
}
-->

# replacementPortraitEffectsMatte(for:)

A callback in which you can provide a replacement portrait effects matte, or strip the existing portrait effects matte from the file.

```
optional func replacementPortraitEffectsMatte(for photo: AVCapturePhoto) -> AVPortraitEffectsMatte?
```

## Parameters

`photo`

The calling instance of [`AVCapturePhoto`](/documentation/AVFoundation/AVCapturePhoto) whose file metadata you’re modifying.

## Return Value

An instance of [`AVPortraitEffectsMatte`](/documentation/AVFoundation/AVPortraitEffectsMatte).  To preserve the existing portrait effects matte, return `photo.portraitEffectsMatte`. To strip the existing portrait effects matte, return `nil`.  To replace the portrait effects matte, provide a replacement [`AVPortraitEffectsMatte`](/documentation/AVFoundation/AVPortraitEffectsMatte) instance.

## Discussion

This callback is optional. If your delegate doesn’t implement this callback, the existing metadata in the in-memory [`AVCapturePhoto`](/documentation/AVFoundation/AVCapturePhoto) container is written directly to the file data representation.

---

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)