图像智能裁剪

最近更新时间:2024-08-01 14:39:41

我的收藏

简介

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

SDK API 参考

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

图像智能裁剪

功能说明

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

示例代码

// 存储桶名称,格式为 BucketName-APPID
String bucket = "examplebucket-1250000000";
AIImageCropRequest request = new AIImageCropRequest(bucket);
request.objectKey = "folder/document.jpg";
request.detectUrl = "http://www.example.com/abc.jpg";// 设置您可以通过填写 detect-url 处理任意公网可访问的图片链接。不填写 detect-url 时,后台会默认处理 ObjectKey ,填写了 detect-url 时,后台会处理 detect-url 链接,无需再填写 ObjectKey detect-url 示例:http://www.example.com/abc.jpg
request.width = 10;// 设置需要裁剪区域的宽度,与height共同组成所需裁剪的图片宽高比例;输入数字请大于0、小于图片宽度的像素值
request.height = 6;// 设置需要裁剪区域的高度,与width共同组成所需裁剪的图片宽高比例;输入数字请大于0、小于图片高度的像素值;width : height建议取值在[1, 2.5]之间,超过这个范围可能会影响效果
request.fixed = 0;// 设置是否严格按照 width 和 height 的值进行输出。取值为0时,宽高比例(width : height)会简化为最简分数,即如果width输入10、height输入20,会简化为1:2;取值为1时,输出图片的宽度等于width,高度等于height;默认值为0
request.ignoreError = 1;// 设置当此参数为1时,针对文件过大等导致处理失败的场景,会直接返回原图而不报错
// 设置结果文件保存路径
request.saveLocalPath = "保存到本地的路径";

cosXmlService.aiImageCropAsync(request, new CosXmlResultListener() {
@Override
public void onSuccess(CosXmlRequest request, CosXmlResult cosResult) {
// result 图像智能裁剪的结果
// 详细字段请查看api文档或者SDK源码
GetObjectResult result = (GetObjectResult) cosResult;

}
@Override
public void onFail(CosXmlRequest request, CosXmlClientException clientException, CosXmlServiceException serviceException) {
if (clientException != null) {
clientException.printStackTrace();
} else {
serviceException.printStackTrace();
}
}
});

说明:
更多完整示例,请前往 GitHub 查看。