---
title: "replacingPortraitEffectsMatte(with:)"
framework: avfoundation
role: symbol
role_heading: Instance Method
path: "avfoundation/avportraiteffectsmatte/replacingportraiteffectsmatte(with:)"
---

# replacingPortraitEffectsMatte(with:)

Returns a portrait effects matte by wrapping the replacement pixel buffer.

## Declaration

```swift
func replacingPortraitEffectsMatte(with pixelBuffer: CVPixelBuffer) throws -> Self
```

## Parameters

- `pixelBuffer`: A pixel buffer containing a portrait effects matte image, represented as doc://com.apple.documentation/documentation/CoreVideo/kCVPixelFormatType_OneComponent8 with doc://com.apple.documentation/documentation/CoreVideo/kCVImageBufferColorPrimaries_ITU_R_709_2 color primaries and a doc://com.apple.documentation/documentation/CoreVideo/kCVImageBufferTransferFunction_Linear transfer function.

## See Also

### Creating a Portrait Effects matte

- [Configuring camera capture to collect a Portrait Effects matte](avfoundation/configuring-camera-capture-to-collect-a-portrait-effects-matte.md)
- [init(fromDictionaryRepresentation:)](avfoundation/avportraiteffectsmatte/init(fromdictionaryrepresentation:).md)
- [applyingExifOrientation(_:)](avfoundation/avportraiteffectsmatte/applyingexiforientation(_:).md)