PHImageRequestOptions

• 父类：NSObject

能够影响通过图片管理器获得的资源的静态图像的一组选项。

内容

1. 安排一个图像请求

@property (nonatomic, assign, getter=isSynchronous) BOOL synchronous;

是否同步处理一个图像请求。默认是NO。
如果为NO，- (PHImageRequestID)requestImageForAsset:(PHAsset *)asset targetSize:(CGSize)targetSize contentMode:(PHImageContentMode)contentMode options:(PHImageRequestOptions *)options resultHandler:(void (^)(UIImage *result, NSDictionary *info))resultHandler;方法会立刻返回返回值。根据deliveryMode属性，Photos可能在这个方法返回返回值之前调用你的resultHandler回调，也有可能在更晚的时间，或者二者同时发生。
如果为YES，- (PHImageRequestID)requestImageForAsset:(PHAsset *)asset targetSize:(CGSize)targetSize contentMode:(PHImageContentMode)contentMode options:(PHImageRequestOptions *)options resultHandler:(void (^)(UIImage *result, NSDictionary *info))resultHandler;方法会阻塞调用的线程，直到图片数据准备好或发生错误。Photos只会调用你的resultHandler一次。

注意
只在后台线程中执行同步请求。

2. 给定图片请求选项

@property (nonatomic, assign) PHImageRequestOptionsVersion version;

请求的图片版本。
使用这个属性请求图片的不带编辑的版本，或者请求一个高质量的原始数据（例如，一个RAW文件）。

PHImageRequestOptionsVersion

typedef NS_ENUM(NSInteger, PHImageRequestOptionsVersion) {
    PHImageRequestOptionsVersionCurrent = 0, // 图片的最新版本（包括所有编辑版本）
    PHImageRequestOptionsVersionUnadjusted, // 原版，无任何调整编辑
    PHImageRequestOptionsVersionOriginal // 原始的高保真的版本
} PHOTOS_ENUM_AVAILABLE_IOS_TVOS(8_0, 10_0);

@property (nonatomic, assign) PHImageRequestOptionsDeliveryMode deliveryMode;

请求的图像质量和交付优先级。
使用这个属性将告诉Photos要快速提供图像（可能牺牲图像质量）、提供高质量图像（可能牺牲速度）、或者自动选择。

PHImageRequestOptionsDeliveryMode

typedef NS_ENUM(NSInteger, PHImageRequestOptionsDeliveryMode) {
    PHImageRequestOptionsDeliveryModeOpportunistic = 0, // 为了平衡图像质量和响应速度，Photos会提供一个或多个结果
    PHImageRequestOptionsDeliveryModeHighQualityFormat = 1, // 只提供最高质量的图像，无论它需要多少时间加载
    PHImageRequestOptionsDeliveryModeFastFormat = 2 // 最快速的得到一个图像结果，可能会牺牲图像质量。
} PHOTOS_ENUM_AVAILABLE_IOS_TVOS(8_0, 10_0);

@property (nonatomic, assign) PHImageRequestOptionsResizeMode resizeMode;

如何调整所请求的图像大小。
使用此属性可选择在请求图像数据时将图像与目标大小如何适应。

PHImageRequestOptionsResizeMode

typedef NS_ENUM(NSInteger, PHImageRequestOptionsResizeMode) {
    PHImageRequestOptionsResizeModeNone = 0, // 不做任何调整
    PHImageRequestOptionsResizeModeFast, // 最快速的调整图像大小，有可能比给定大小略大
    PHImageRequestOptionsResizeModeExact, // 保证与给定大小相等。如果使用normalizedCropRect属性，则必须指定为该模式。
} PHOTOS_ENUM_AVAILABLE_IOS_TVOS(8_0, 10_0);

@property (nonatomic, assign) CGRect normalizedCropRect;

是否对原始图像进行裁剪。
如果要裁减图像，请在坐标空间内指定要裁减的长方形。在坐标系内，{0.0,0.0}点在图像的左上角，{1.0,1.0}点在图像的右下角。
这个属性默认值为CGRectZero，代表着不裁剪。
如果你指定了裁剪的矩形，那么你必须对resizeMode属性设置为PHImageRequestOptionsResizeModeExact。

3.从iCloud中获取图像

@property (nonatomic, assign, getter=isNetworkAccessAllowed) BOOL networkAccessAllowed;

Photos是否可以从iCloud中下载图像。默认为NO。
如果设置为YES，并且请求的图像不保存在本地设备上，Photos会从iCloud上下载图像。想要获取下载进度，使用progressHandler属性，Photos会定期调用这个回调属性返回下载进度。如果设置为NO，并且请求的图像不保存在本地设备上，在回调返回的info字典中的PHImageResultIsInCloudKey对应的值会标识出这个图像不可用。

@property (nonatomic, copy, nullable) PHAssetImageProgressHandler progressHandler;

下载图像时，定期会返回下载进度。
如果请求的图像不保存在本地设备上，并且networkAccessAllowed设置允许从iCloud上下载图像，Photos会调用这个属性定期会返回下载进度，并且允许你取消下载。