當您需要加速加載時間、節省存儲空間、減少帶寬費用或者以合適的尺寸呈現圖片時,需要進行圖片縮放。OSS支持通過圖片縮放參數,調整Bucket內存儲的圖片大小。本文介紹對象存儲OSS圖片處理中的圖片縮放功能參數及示例。
注意事項
原圖限制
圖片格式只能是:JPG、PNG、BMP、GIF、WebP、TIFF、HEIC。
重要GIF格式的圖片只支持指定寬高縮小,不支持按百分比縮小(按百分比縮小的情況下,動態圖會變成靜態圖)。
GIF格式的圖片不支持放大。
原圖大小不能超過20 MB。如果您需要調整原圖大小限制,請在配額中心申請。
說明僅圖片縮放參數支持調整原圖大小限制,其他圖片處理參數不支持調整原圖大小限制。
寬或高不能超過30,000 px,且總像素不能超過2.5億 px。
動態圖片(例如GIF圖片)的像素計算方式為
寬*高*圖片幀數
;非動態圖片(例如PNG圖片)的像素計算方式為寬*高
。
縮放圖限制
寬或高不能超過16,384 px,且總像素不能超過16,777,216 px。
縮放優先級
如果圖片處理URL中同時指定按寬高縮放和等比縮放參數,則只執行指定寬高縮放。
縮放時只指定寬度或者高度
等比縮放時,會按比例縮放圖片。例如原圖為200 px*100 px,將高縮放為100 px,則寬縮放為50 px。
固定寬高縮放時,會將原圖寬高按照指定值進行縮放。例如原圖為200 px*100 px,將高縮放為100 px,則寬也縮放為100 px。
目標縮放圖比原圖尺寸大時,默認返回原圖。您可以增加
limit_0
參數放大圖片。例如,https://oss-console-img-demo-cn-hangzhou.oss-cn-hangzhou.aliyuncs.com/example.jpg?x-oss-process=image/resize,w_500,limit_0
。
參數說明
操作名稱:resize
指定寬高縮放
參數說明
名稱
是否必選
描述
取值范圍
m
是
指定縮放的模式。
lfit(默認值):等比縮放,縮放圖限制為指定w與h的矩形內的最大圖片。
mfit:等比縮放,縮放圖為延伸出指定w與h的矩形框外的最小圖片。
fill:將原圖等比縮放為延伸出指定w與h的矩形框外的最小圖片,然后將超出的部分進行居中裁剪。
pad:將原圖縮放為指定w與h的矩形內的最大圖片,然后使用指定顏色居中填充空白部分。
fixed:固定寬高,強制縮放。
關于不同模式的使用示例,請參見表格下方使用示例。
重要當縮放模式指定為lfit或mfit時,如果等比為小數,則四舍五入保留整數。
當縮放模式指定為m模式下的任意值,且為目標縮放圖的寬度w或目標縮放圖的高度h指定了值,則目標縮放圖的最長邊l或目標縮放圖的最短邊s的取值不生效。
w
否
指定目標縮放圖的寬度。
[1,16384]
h
否
指定目標縮放圖的高度。
[1,16384]
l
是
指定目標縮放圖的最長邊。
說明如果是l或者s僅指定一個,代表按照原圖對應長邊(l)或者短邊(s)縮放,另一邊按比例縮放(即根據指定的寬高,按照比例計算出來另外一邊),此時m參數無效。
如果l和s同時使用, 代表按照長寬比例縮放,m參數生效,默認的縮放方式為lfit。
[1,16384]
s
是
指定目標縮放圖的最短邊。
說明如果是l或者s僅指定一個,代表按照原圖對應長邊(l)或者短邊(s)縮放,另一邊按比例縮放(即根據指定的寬高,按照比例計算出來另外一邊),此時m參數無效。
如果l和s同時使用, 代表按照長寬比例縮放,m參數生效,默認的縮放方式為lfit。
[1,16384]
limit
否
當目標圖片分辨率大于原圖分辨率時,是否進行縮放。
1(默認值):返回按照原圖分辨率轉換的圖片(可能和原圖的體積不一樣)。
0:按指定參數進行縮放。
說明GIF格式的圖片只支持縮小,不支持放大。
color
是(僅當
m為pad
時)當縮放模式選擇為pad(縮放填充)時,可以設置填充的顏色。
RGB顏色值,例如:000000表示黑色,FFFFFF表示白色。
默認值:FFFFFF(白色)
使用示例
原圖大小為200 px*100 px,縮放參數為w=150 px,h=80 px。則不同的縮略模式,得到的縮放圖如下:
lfit
等比縮放:要求縮放圖的w/h等于原圖的w/h。所以,若w=150 px,則h=75 px;若h=80 px,則w=160 px。
限制在指定w與h的矩形內的最大圖片:即縮放圖的w*h不能大于150 px*80 px。
通過以上條件得出縮略圖大小為150 px*75 px。
mfit
等比縮放:要求縮放圖的w/h等于原圖的w/h。所以,若w=150 px,則h=75 px;若h=80 px,則w=160 px。
延伸出指定w與h的矩形框外的最小圖片:即縮放圖必須是大于150 px*80 px的一個最小矩形。
通過以上條件得出縮放圖的大小為160 px*80 px。
fill
fill參數會先將圖片等比縮放為延伸出指定w與h的矩形框外的最小圖片,之后按照固定寬高進行裁剪。即先將原圖縮放為160 px*80 px,之后將w居中裁剪為150 px,得到大小為150 px*80 px的縮放圖。
pad
pad參數會先將圖片等比縮放為限制在指定w與h的矩形內的最大圖片,之后按照固定寬高進行填充。即先將原圖縮放為150 px*75 px,之后將h居中填充到80 px,得到大小為150 px*80 px的縮放圖。
fixed
fixed參數會將圖片按照固定寬高進行縮放,若寬高與原圖寬高比例不同,則會導致圖片變形。
按百分比縮放
名稱 | 是否必選 | 描述 | 取值范圍 |
p | 是 | 按百分比縮放圖片。 | [1,1000] 小于100為縮小,大于100為放大。 |
操作方式
對公共讀或者公共讀寫的圖片進行縮放
您可以通過在文件URL中直接添加圖片處理的方式,對公共讀或者公共讀寫的圖片進行縮放。
本文示例使用的Bucket為杭州地域名為oss-console-img-demo-cn-hangzhou的Bucket,原圖大小為400 px*300 px,原圖外網訪問地址為:
等比縮放
按寬高縮放
需求及處理參數如下:
圖片縮放為高100 px:
resize,h_100
縮放模式為lfit:
m_lfit
處理后,原圖從400 px*300 px等比縮放為133 px*100 px的圖片。
按長邊縮放
需求及處理參數為:圖片縮放為長邊100 px,即
resize,l_100
處理后,原圖從400 px*300 px等比縮放為100 px*75 px的圖片。
固定寬高縮放
需求及處理參數如下:
將原圖縮放成寬高100 px:
resize,h_100,w_100
縮放模式fixed:
m_fixed
處理后,原圖從400 px*300 px固定縮放為100 px*100 px的圖片,圖片出現變形。
固定寬高,自動裁剪
需求及處理參數如下:
將原圖縮放成寬高100 px:
resize,h_100,w_100
縮放模式fill:
m_fill
處理后,原圖從400 px*300 px縮放為133 px*100 px,然后居中裁剪為100px,得到大小為100 px*100 px的縮放圖。
固定寬高,縮放填充
需求及處理參數如下:
將原圖縮放成寬高100 px:
resize,h_100,w_100
縮放模式pad:
m_pad
說明m_pad參數不支持原圖為PNG的4顏色通道的圖片。
以紅色填充:
color_FF0000
處理后,原圖從400 px*300 px縮放為100 px*75 px,然后將h居中填充到100px,得到大小為100 px*100 px的縮放圖,同時填充紅色。
按比例縮放
需求及處理參數如下:
將原圖縮放50%:
resize,p_50
處理后,原圖從400 px*300 px等比縮放為200 px*150 px,縮放為原來的50%。
對私有圖片進行縮放
您可以通過阿里云SDK以及REST API對私有圖片進行縮放。
使用阿里云SDK
以下僅列舉常見SDK縮放圖片的代碼示例。如需使用其他SDK縮放圖片的代碼示例,請參見SDK簡介。
Java
要求使用3.17.4及以上版本的Java SDK。
import com.aliyun.oss.*;
import com.aliyun.oss.common.auth.*;
import com.aliyun.oss.common.comm.SignVersion;
import com.aliyun.oss.model.GetObjectRequest;
import java.io.File;
public class Demo {
public static void main(String[] args) throws Throwable {
// Endpoint以華東1(杭州)為例,其它Region請按實際情況填寫。
String endpoint = "https://oss-cn-hangzhou.aliyuncs.com";
// 填寫Endpoint對應的Region信息,例如cn-hangzhou。
String region = "cn-hangzhou";
// 從環境變量中獲取訪問憑證。運行本代碼示例之前,請確保已設置環境變量OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
EnvironmentVariableCredentialsProvider credentialsProvider = CredentialsProviderFactory.newEnvironmentVariableCredentialsProvider();
// 填寫Bucket名稱,例如examplebucket。
String bucketName = "examplebucket";
// 填寫Object完整路徑。Object完整路徑中不能包含Bucket名稱。
String objectName = "src.jpg";
// 填寫本地文件的完整路徑,例如D:\\localpath\\example-new.jpg。如果指定的本地文件存在會覆蓋,不存在則新建。
String pathName = "D:\\dest.jpg";
// 創建OSSClient實例。
ClientBuilderConfiguration clientBuilderConfiguration = new ClientBuilderConfiguration();
clientBuilderConfiguration.setSignatureVersion(SignVersion.V4);
OSS ossClient = OSSClientBuilder.create()
.endpoint(endpoint)
.credentialsProvider(credentialsProvider)
.clientConfiguration(clientBuilderConfiguration)
.region(region)
.build();
try {
// 將圖片縮放為固定寬高100 px°。
String image = "image/resize,m_fixed,w_100,h_100";
GetObjectRequest request = new GetObjectRequest(bucketName, objectName);
request.setProcess(image);
// 將處理后的圖片命名為example-new.jpg并保存到本地。
// 如果未指定本地路徑只填寫了文件名稱(例如example-new.jpg),則文件默認保存到示例程序所屬項目對應本地路徑中。
ossClient.getObject(request, new File("D:\\dest.jpg"));
} catch (OSSException oe) {
System.out.println("Caught an OSSException, which means your request made it to OSS, "
+ "but was rejected with an error response for some reason.");
System.out.println("Error Message:" + oe.getErrorMessage());
System.out.println("Error Code:" + oe.getErrorCode());
System.out.println("Request ID:" + oe.getRequestId());
System.out.println("Host ID:" + oe.getHostId());
} catch (ClientException ce) {
System.out.println("Caught an ClientException, which means the client encountered "
+ "a serious internal problem while trying to communicate with OSS, "
+ "such as not being able to access the network.");
System.out.println("Error Message:" + ce.getMessage());
} finally {
if (ossClient != null) {
ossClient.shutdown();
}
}
}
}
PHP
要求使用PHP SDK 2.7.0及以上版本。
<?php
if (is_file(__DIR__ . '/../autoload.php')) {
require_once __DIR__ . '/../autoload.php';
}
if (is_file(__DIR__ . '/../vendor/autoload.php')) {
require_once __DIR__ . '/../vendor/autoload.php';
}
use OSS\Credentials\EnvironmentVariableCredentialsProvider;
use OSS\OssClient;
// 從環境變量中獲取訪問憑證。運行本代碼示例之前,請確保已設置環境變量OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
$provider = new EnvironmentVariableCredentialsProvider();
// yourEndpoint填寫Bucket所在地域對應的Endpoint。以華東1(杭州)為例,Endpoint填寫為https://oss-cn-hangzhou.aliyuncs.com。
$endpoint = "https://oss-cn-hangzhou.aliyuncs.com";
// 填寫Bucket名稱,例如examplebucket。
$bucket= "examplebucket";
// 填寫Object完整路徑,例如exampledir/exampleobject.jpg。Object完整路徑中不能包含Bucket名稱。
$object = "src.jpg";
// 填寫本地文件的完整路徑,例如D:\\localpath\\example-new.jpg。如果指定的本地文件存在會覆蓋,不存在則新建。
// 如果未指定本地路徑只填寫了本地文件名稱(例如example-new.jpg),則文件默認保存到示例程序所屬項目對應本地路徑中。
$download_file = "D:\\dest.jpg";
$config = array(
"provider" => $provider,
"endpoint" => $endpoint,
"signatureVersion" => OssClient::OSS_SIGNATURE_VERSION_V4,
// 填寫阿里云通用Region ID。
"region" => "cn-hangzhou"
);
$ossClient = new OssClient($config);
// 將圖片縮放為固定寬高100 px。
$image = "image/resize,m_fixed,w_100,h_100";
$options = array(
OssClient::OSS_FILE_DOWNLOAD => $download_file,
OssClient::OSS_PROCESS => $image);
// 將處理后的圖片保存到本地。
$ossClient->getObject($bucket, $object, $options);
Python
要求使用Python SDK 2.18.4及以上版本。
# -*- coding: utf-8 -*-
import oss2
from oss2.credentials import EnvironmentVariableCredentialsProvider
# 從環境變量中獲取訪問憑證。運行本代碼示例之前,請確保已設置環境變量OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
auth = oss2.ProviderAuthV4(EnvironmentVariableCredentialsProvider())
# yourEndpoint填寫Bucket所在地域對應的Endpoint。以華東1(杭州)為例,Endpoint填寫為https://oss-cn-hangzhou.aliyuncs.com。
## 填寫Bucket所在地域對應的Endpoint。以華東1(杭州)為例,Endpoint填寫為https://oss-cn-hangzhou.aliyuncs.com。
endpoint = 'https://oss-cn-hangzhou.aliyuncs.com'
# 填寫阿里云通用Region ID。
region = 'cn-hangzhou'
bucket = oss2.Bucket(auth, endpoint, 'examplebucket', region=region)
# 指定原圖名稱。如果圖片不在Bucket根目錄,需攜帶圖片完整路徑,例如exampledir/example.jpg。
key = 'src.jpg'
# 指定處理后的圖片名稱。
new_pic = 'D:\\dest.jpg'
# 將圖片縮放為固定寬高100 px。
image = 'image/resize,m_fixed,w_100,h_100'
bucket.get_object_to_file(key, new_pic, process=image)
Go
要求使用Go SDK 3.0.2及以上版本。
package main
import (
"fmt"
"os"
"github.com/aliyun/aliyun-oss-go-sdk/oss"
)
func HandleError(err error) {
fmt.Println("Error:", err)
os.Exit(-1)
}
func main() {
// 從環境變量中獲取訪問憑證。運行本代碼示例之前,請確保已設置環境變量OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
provider, err := oss.NewEnvironmentVariableCredentialsProvider()
if err != nil {
fmt.Println("Error:", err)
os.Exit(-1)
}
// 創建OSSClient實例。
// yourEndpoint填寫Bucket對應的Endpoint,以華東1(杭州)為例,填寫為https://oss-cn-hangzhou.aliyuncs.com。其它Region請按實際情況填寫。
client, err := oss.New("https://oss-cn-hangzhou.aliyuncs.com", "", "", oss.SetCredentialsProvider(&provider), oss.AuthVersion(oss.AuthV4), oss.Region("cn-hangzhou"))
if err != nil {
HandleError(err)
}
// 指定原圖所在的Bucket名稱,例如examplebucket。
bucketName := "examplebucket"
bucket, err := client.Bucket(bucketName)
if err != nil {
HandleError(err)
}
// 指定原圖名稱。如果圖片不在Bucket根目錄,需攜帶圖片完整路徑,例如exampledir/example.jpg。
sourceImageName := "src.jpg"
// 指定處理后的圖片名稱。
targetImageName := "D://dest.jpg"
// 將圖片縮放為固定寬高100 px。
image := "image/resize,m_fixed,w_100,h_100"
err = bucket.GetObjectToFile(sourceImageName, targetImageName, oss.Process(image))
if err != nil {
HandleError(err)
}
}
使用REST API
如果您的程序自定義要求較高,您可以直接發起REST API請求。直接發起REST API請求需要手動編寫代碼計算簽名。更多信息,請參見GetObject。
您可以通過在GetObject接口中添加圖片縮放參數的方式來處理圖片。
GET /oss.jpg?x-oss-process=image/resize,w_100 HTTP/1.1
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Date: Fri, 28 Oct 2022 06:40:10 GMT
Authorization: OSS qn6q**************:77Dv****************
常見問題
壓縮后的圖片讀寫權限為私有,如何正常訪問?
必須對圖片文件URL完成簽名操作后才能正常訪問。具體操作,請參見上傳Object后如何獲取訪問URL。
發送圖片壓縮請求是否計費?
發送圖片壓縮請求會產生請求費用。更多信息,請參見請求費用。
圖片壓縮是否產生圖片處理費用?
圖片壓縮會產生圖片處理費用,按處理的原圖實際大小計費。
請求縮放后的圖片產生的流量是按照原圖還是縮放后的圖片計算?
請求縮放后的圖片產生的流量費用按照縮放后的流量計算。例如原圖為20 MB,縮放后大小為2 MB,圖片產生的流量按照2 MB計算。
按寬高放大圖片不生效怎么辦?
按寬高放大圖片時,需要設置limit參數為0,否則放大不生效。
例如:以下圖片中,將圖片高由原來的300 px放大為500 px。