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.