图像智能裁剪

最近更新时间:2024-05-17 16:46:51

我的收藏

简介

本文档提供关于图像智能裁剪的相关 API 概览以及 SDK 示例代码。
API
操作描述
腾讯云数据万象通过 AIImageCrop 接口对图像进行智能裁剪,支持持久化、云上处理及下载时处理。

SDK API 参考

SDK 所有接口的具体参数与方法说明,请参考 SDK API

图像智能裁剪

功能说明

腾讯云数据万象通过 AIImageCrop 接口对图像进行智能裁剪,支持持久化、云上处理及下载时处理。
说明:
COS iOS SDK 版本需要大于等于 v6.2.9。

示例代码

Objective-C
QCloudAIImageCropRequest * request = [QCloudAIImageCropRequest new];
request.bucket = @"sample-1250000000";
request.regionName = @"COS_REGIONNAME";
// 设置:ObjectKey;
request.ObjectKey = @"";
// 数据万象处理能力,智能裁剪固定为AIImageCrop;是否必传:true;
request.ciProcess = @"AIImageCrop";
// 您可以通过填写 detect-url 处理任意公网可访问的图片链接。不填写 detect-url 时,后台会默认处理 ObjectKey ,填写了 detect-url 时,后台会处理 detect-url 链接,无需再填写 ObjectKey detect-url 示例:http://www.example.com/abc.jpg ,需要进行 UrlEncode,处理后为http%25253A%25252F%25252Fwww.example.com%25252Fabc.jpg;是否必传:false;
request.detectUrl = @"";
// 需要裁剪区域的宽度,与height共同组成所需裁剪的图片宽高比例;输入数字请大于0、小于图片宽度的像素值;是否必传:true;
request.width = 0;
// 需要裁剪区域的高度,与width共同组成所需裁剪的图片宽高比例;输入数字请大于0、小于图片高度的像素值;width : height建议取值在[1, 2.5]之间,超过这个范围可能会影响效果;是否必传:true;
request.height = 0;
// 是否严格按照 width 和 height 的值进行输出。取值为0时,宽高比例(width : height)会简化为最简分数,即如果width输入10、height输入20,会简化为1:2;取值为1时,输出图片的宽度等于width,高度等于height;默认值为0;是否必传:false;
request.fixed = 0;
// 当此参数为1时,针对文件过大等导致处理失败的场景,会直接返回原图而不报错;是否必传:false;
request.ignoreError = 0;

[request setFinishBlock:^(id outputObject, NSError *error) {
// 无响应体
}];
[[QCloudCOSXMLService defaultCOSXML] AIImageCrop:request];

注意:
更多完整示例,请前往 GitHub 查看。
Swift
let request : QCloudAIImageCropRequest = QCloudAIImageCropRequest();
// 设置:objectKey;
request.objectKey = "objectKey";
request.bucket = "sample-1250000000";
request.regionName = "COS_REGIONNAME";
// 数据万象处理能力,智能裁剪固定为AIImageCrop;是否必传:true;
request.ciProcess = "AIImageCrop";
// 您可以通过填写 detect-url 处理任意公网可访问的图片链接。不填写 detect-url 时,后台会默认处理 ObjectKey ,填写了 detect-url 时,后台会处理 detect-url 链接,无需再填写 ObjectKey detect-url 示例:http://www.example.com/abc.jpg ,需要进行 UrlEncode,处理后为http%25253A%25252F%25252Fwww.example.com%25252Fabc.jpg;是否必传:false;
request.detectUrl = @"";
// 需要裁剪区域的宽度,与height共同组成所需裁剪的图片宽高比例;输入数字请大于0、小于图片宽度的像素值;是否必传:true;
request.width = 0;
// 需要裁剪区域的高度,与width共同组成所需裁剪的图片宽高比例;输入数字请大于0、小于图片高度的像素值;width : height建议取值在[1, 2.5]之间,超过这个范围可能会影响效果;是否必传:true;
request.height = 0;
// 是否严格按照 width 和 height 的值进行输出。取值为0时,宽高比例(width : height)会简化为最简分数,即如果width输入10、height输入20,会简化为1:2;取值为1时,输出图片的宽度等于width,高度等于height;默认值为0;是否必传:false;
request.fixed = 0;
// 当此参数为1时,针对文件过大等导致处理失败的场景,会直接返回原图而不报错;是否必传:false;
request.ignoreError = 0;

request.finishBlock = { result, error in
// 无响应体
};
QCloudCOSXMLService.defaultCOSXML().aiImageCrop(request);

注意:
更多完整示例,请前往 GitHub 查看。