Type Method


Initializes a portrait effects matte instance from auxiliary image information in an image file.


+ (instancetype)portraitEffectsMatteFromDictionaryRepresentation:(NSDictionary *)imageSourceAuxDataInfoDictionary error:(NSError * _Nullable *)outError;



A dictionary of information related to primitive portrait effects matte; obtained from CGImageSourceCopyAuxiliaryDataInfoAtIndex.


When using the Image IO Framework's CGImageSourceRef API to read from a HEIF or JPEG file containing a portrait effects matte, you can create an AVPortraitEffectsMatte object from the result of CGImageSourceCopyAuxiliaryDataInfoAtIndex. This function returns a CFDictionaryRef of primitive map information.

See Also

Creating a Portrait Effects Matte

Configuring Camera Capture to Collect a Portrait Effects Matte

Prepare your app to capture a portrait effects matte when taking photos.

- portraitEffectsMatteByApplyingExifOrientation:

Returns a derivative portrait effects matte after applying the specified EXIF orientation.

- portraitEffectsMatteByReplacingPortraitEffectsMatteWithPixelBuffer:error:

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

Beta Software

This documentation contains preliminary information about an API or technology in development. This information is subject to change, and software implemented according to this documentation should be tested with final operating system software.

Learn more about using Apple's beta software