Adds the specified image to the user’s Camera Roll album.
SDKs
- iOS 2.0+
- Mac Catalyst 13.0+
Framework
- UIKit
Declaration
func UIImageWriteToSavedPhotosAlbum(_ image: UIImage, _ completionTarget: Any?, _ completionSelector: Selector?, _ contextInfo: UnsafeParameters
imageThe image to write to the Camera Roll album.
completionTargetOptionally, the object whose selector should be called after the image has been written to the Camera Roll album.
completionSelectorThe method selector of the
completionobject to call. This optional method should conform to the following signature:Target - (void)image:(UIImage *)image didFinishSavingWithError:(NSError *)error contextInfo:(void *)contextInfo;contextInfoAn optional pointer to any context-specific data that you want passed to the completion selector.
Discussion
When used with an image picker controller, you would typically call this function within your image delegate method implementation.
The use of the completion, completion, and context parameters is optional and necessary only if you want to be notified asynchronously when the function finishes writing the image to the user’s Camera Roll or Saved Photos album. If you do not want to be notified, pass nil for these parameters.
When used on an iOS device without a camera, this method adds the image to the Saved Photos album rather than to the Camera Roll album.