Instance Property

canHandleAdjustmentData

A block to be called when Photos needs to determine whether your app can continue previous edits made to an asset.

Declaration

@property(nonatomic, copy, nonnull) BOOL (^canHandleAdjustmentData)(PHAdjustmentData *adjustmentData);

Discussion

When an asset is edited, Photos stores a PHAdjustmentData object provided by the app or extension that edited the asset. This object provides all information necessary to reconstruct the edited asset using the original asset data. When your app requests to edit an asset, Photos calls this block to inquire whether your app can handle the asset’s past adjustments.

The block takes the following parameter:

adjustmentData

A PHAdjustmentData object you can use to determine whether your app can work with past edits made to the asset. Typically, you make this decision based on the adjustment data’s formatIdentifier and formatVersion properties.

If your block returns YES, Photos provides the original asset data for editing. Your app uses the adjustment data to alter, add to, or reapply previous edits. (For example, an adjustment data may describe filters applied to a photo. Your app reapplies those filters and allows the user to change filter parameters, add new filters, or remove filters.)

If your block returns NO, Photos provides the most recent asset data—the rendered output of all previous edits—for editing.