本文档提供关于基础图片处理的相关的 API 概览以及 SDK 示例代码。
服务 | 功能 | 说明 |
---|---|---|
基础图片处理服务 | 缩放 | 等比缩放、设定目标宽高缩放等多种方式 |
裁剪 | 普通裁剪、缩放裁剪、内切圆、人脸智能裁剪 | |
旋转 | 自适应旋转、普通旋转 | |
格式转换 | 格式转换、GIF 格式优化、渐进显示 | |
质量变换 | 针对 JPG 和 WEBP 图片进行质量变换 | |
高斯模糊 | 对图片进行模糊处理 | |
锐化 | 对图片进行锐化处理 | |
添加水印 | 图片水印、文字水印 | |
获取图片信息 | 基本信息、EXIF 信息、主色调 | |
去除元信息 | 包括 EXIF 信息 | |
快速缩略模板 | 快速实现图片格式转换、缩略、剪裁等功能,生成缩略图 |
下面示例展示了如何在上传图片时自动实现图片处理。
图片上传完成后,COS 会存储原始图片和已处理过的图片。后续用户可以通过普通的下载请求获取处理结果。
const filePath = "temp-file-to-upload" // 本地文件路径
cos.putObject({
Bucket: 'examplebucket-1250000000',
Region: 'COS_REGION',
Key: 'exampleobject',
Body: fs.createReadStream(filePath), // 上传文件对象
onProgress: function(progressData) {
console.log(JSON.stringify(progressData));
},
Headers: {
// 通过 imageMogr2 接口使用图片缩放功能:指定图片宽度为 200,宽度等比压缩
'Pic-Operations': '{"is_pic_info": 1, "rules": [{"fileid": "desample_photo.jpg", "rule": "imageMogr2/thumbnail/200x/"}]}'
},
}, function(err, data) {
console.log(err || data);
});
下面示例展示了如何在对已存储在 COS 的图片进行相应处理操作,并将结果存入到 COS。
cos.request({
Bucket: config.Bucket,
Region: config.Region,
Key: 'exampleobject',
Method: 'POST',
Action: 'image_process',
Headers: {
// 通过 imageMogr2 接口使用图片缩放功能:指定图片宽度为 200,宽度等比压缩
'Pic-Operations': '{"is_pic_info": 1, "rules": [{"fileid": "desample_photo.jpg", "rule": "imageMogr2/thumbnail/200x/"}]}'
},
}, function (err, data) {
console.log(err || data);
});
下面示例展示了如何在下载图片时实现图片处理。
cos.getObject({
Bucket: 'examplebucket-1250000000',
Region: 'COS_REGION',
Key: 'exampleobject',
QueryString: `imageMogr2/thumbnail/200x/`,
}, function (err, data) {
console.log(err || data);
fs.writeFileSync('filepath', data.Body); // 将图片内容保存本地
});
// 生成带图片处理参数的文件签名 URL,过期时间设置为 30 分钟。
var url1 = cos.getObjectUrl({
Bucket: 'examplebucket-1250000000',
Region: 'COS_REGION',
Key: 'exampleobject',
Query: {
`imageMogr2/thumbnail/200x/`: ''
},
Expires: 1800,
Sign: true,
}, function (err, data) {
if(data){
console.log(data.Url);
}
});
// 生成带图片处理参数的文件 URL,不带签名。
var url2 = cos.getObjectUrl({
Bucket: 'examplebucket-1250000000',
Region: 'COS_REGION',
Key: 'exampleobject',
Query: {
`imageMogr2/thumbnail/200x/`: ''
},
Sign: false,
}, function (err, data) {
if(data){
console.log(data.Url);
}
});
本页内容是否解决了您的问题?