数据万象
有奖捉虫：办公协同&微信生态&物联网文档专题 HOT
文档中心 > 数据万象 > SDK 文档 > 图片处理 iOS SDK > 图片基础处理 > 快速入门

快速入门

最近更新时间：2023-05-17 10:47:13

我的收藏

本页目录：

简介

数据万象的图片基础处理操作，分别有图片缩放、剪裁、旋转、格式转换、质量变换、高斯模糊、锐化、水印、获取图片主题色等。 将每一个操作封装为一个 CITransform，而且支持各个基础操作可以组合使用，并将组合好的操作集合构建出可以直接进行网络请求的 URL。
模块
功能
CloudInfinite
该模块包含数据万象的基础图片处理操作，并支持各个操作能够相互组合，构建 URL 进行网络请求。
Loader
使用 CIImageLoadRequest 实例，请求网络图片并返回图片 data 数据。
SDWebImage-CloudInfinite
依赖于 SDWebImage、CloudInfinite 模块，提供了数据万象基础图片处理功能。

步骤1：安装 SDK

使用 Cocoapods 集成

1. 在您工程 Podfile 文件中添加模块：
 pod 'CloudInfinite'
2. 在终端执行安装命令：
 pod install

步骤2：开始使用

导入头文件

Objective-C
#import <CloudInfinite.h>
swift 在桥接文件中加入（项目名称-Bridging-Header）。
#import <CloudInfinite.h>

构建 CIImageLoadRequest 实例

1. 在使用 CloudInfinite 构建具有数据万象功能的图片 URL 时，首先需要实例化 CloudInfinite 类。
Objective-C
CloudInfinite * cloudInfinite = [CloudInfinite new];
swift
let cloudInfinite = CloudInfinite();
2. 实例化图片转换类 CITransformation，并设置相关操作，这里以 TPG 为例。更多功能请参见 基础图片处理。
Objective-C
CITransformation * transform = [CITransformation new];
[transform setFormatWith:CIImageTypeTPG options:CILoadTypeUrlFooter];
swift
let transform = CITransformation();
transform.setFormatWith(CIImageFormat.typeTPG, options: CILoadTypeEnum.urlFooter);
3. 使用 CloudInfinite 实例构建具有数据万象功能的图片 URL。
同步方式构建
Objective-C
CIImageLoadRequest * imageloadRequest = [cloudInfinite requestWithBaseUrl:@"图片链接" transform:transform];
// 图片url
NSURL * imageURL = imageloadRequest.url;
// header参数
NSString * heaer = imageloadRequest.header;
swift
let imageloadRequest = cloudInfinite.request(withBaseUrl: "图片链接", transform: transform);
// 图片url
let imageURL = imageloadRequest.url;
// header参数
let heaer = imageloadRequest.header;
异步方式构建
Objective-C
[cloudInfinite requestWithBaseUrl:@"图片链接" transform:transform request:^(CIImageLoadRequest * _Nonnull request) {
    // 图片url
    request.url;
    // header参数
    request.header;
}];
swift
cloudInfinite.request(withBaseUrl: "", transform: transform) { (request) in
    // 图片url
    request.url;
    // header 参数
    request.header;
};
说明：
仅在进行图片格式转换并且 options 设置为 loadtypeacceptheader 时，CIImageLoadRequest 的 header 参数为有效值。
在使用自定义 loader 请求图片时，如果需要使用到 header，则 header 需要拼接为如下：
NSDictionary * header = @{@"accept":[NSString stringWithFormat:@"image/%@",request.header]};

步骤3：加载图片

构建成功 CIImageLoadRequest 实例后，使用 CloudInfinite/Loader 模块进行图片加载。集成 CloudInfinite/Loader 模块，如下所示：
pod 'CloudInfinite/Loader'

请求图片 Data 数据

请求图片 NSData 数据，适用于请求 TPG 图片（需集成 TPG 解码模块）或者需要对图片二进制数据进行额外处理的图片。 Objective-C
// request 为上一步构建成功的 CIImageLoadRequest 实例；
[[CIImageLoader shareLoader] loadData:request loadComplete:^(NSData * _Nullable data, NSError * _Nullable error) {
    // data：请求到的图片 data 数据；
}];
swift
// request 为上一步构建成功的 CIImageLoadRequest 实例；
CIImageLoader.share().loadData(request) { (data, error) in
    // data：请求到的图片 data 数据；
};

加载普通图片

Objective-C
// 传入图片控件 imageView 以及 构建成功的 CIImageLoadRequest 实例；
[[CIImageLoader shareLoader]display:imageView loadRequest:request placeHolder:nil loadComplete:^(NSData * _Nullable data, NSError * _Nullable error) {
        // data：请求到的图片 data 数据；
}];
swift
// 传入图片控件 imageView 以及 构建成功的 CIImageLoadRequest 实例；
CIImageLoader.share().display(imageView, loadRequest: request, placeHolder: nil) { (data, error) in
        // data：请求到的图片 data 数据；
};

中国站