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会调用这个属性定期会返回下载进度,并且允许你取消下载。

推荐阅读更多精彩内容

  • 父类:NSObject 提供获取或生成预览缩略图和全尺寸图片,或者视频数据的方法。 一、概述 使用这些方法来获取全...
    Shmily落墨阅读 8,109评论 5 6
  • 原创文章,作者:瓶子大人 转载公众号或使用,请事先联系作者。 ——写给小杰的成长日记 小杰: 今天是六一儿童节,此...
    瓶子大人阅读 220评论 4 5
  • 第三章 两个异性朋友之间究竟能因为什么事情而突然变得尴尬,这是小一最近非常苦恼的问题,不知从何时起,小一和...
    帅气的宝阅读 89评论 0 1
  • 今天是4月1号,和往常没有什么不一样。 尤其是对我。 这一天有让人觉得无语的事,也有遗憾,也有照着自己想法进行的事...
    霓衣风马阅读 58评论 0 0