rounded-corners 操作は、OSS に保存されているイメージの角を丸めます。
パラメーター
操作名: rounded-corners
| パラメーター | 説明 | 有効値 |
|---|---|---|
r | 角の半径 (ピクセル) | 1–4096 |
注意事項
出力形式による背景の動作: alpha チャンネルをサポートする形式 (PNG、WebP、BMP) では、角丸の外側の領域が透明としてレンダリングされます。JPG では白としてレンダリングされます。透明な角を得るには、イメージを PNG 形式で保存します。
半径の上限: 指定された半径がソースイメージの最大内接円を超える場合、OSS は代わりに内接円の半径 (最短辺の半分に相当) を使用します。
GIF はサポートされていません:
rounded-corners操作は GIF イメージには適用できません。
公開読み取りまたは公開読み書きイメージの角丸化
イメージ URL に x-oss-process クエリパラメーターを追加します。
次の例では、ソースイメージを使用します。
https://oss-console-img-demo-cn-hangzhou.oss-cn-hangzhou.aliyuncs.com/example.jpg

例 1: 30 ピクセルの半径で角を丸める
パラメーター:
角の半径:
rounded-corners,r_30出力形式:
format,jpg(ソースイメージがすでに JPG の場合は省略)
https://oss-console-img-demo-cn-hangzhou.oss-cn-hangzhou.aliyuncs.com/example.jpg?x-oss-process=image/rounded-corners,r_30
例 2: イメージの切り抜き、角丸化、PNG 形式での保存
パラメーター:
デフォルトの開始位置から 100×100 ピクセルに切り抜き:
crop,w_100,h_100角の半径:
rounded-corners,r_10出力形式:
format,png
https://oss-console-img-demo-cn-hangzhou.oss-cn-hangzhou.aliyuncs.com/example.jpg?x-oss-process=image/crop,w_100,h_100/rounded-corners,r_10/format,png
非公開イメージの角丸化
非公開イメージを処理するには、OSS SDK または RESTful API を使用します。
OSS SDK の使用
以下のすべての例では、x-oss-process パラメーターを使用して image/rounded-corners,r_30 を適用し、結果をローカルファイルに保存します。
他の言語の SDK については、「概要」をご参照ください。
Python
OSS SDK for Python V2.18.4 以降が必要です。
# -*- coding: utf-8 -*-
import oss2
from oss2.credentials import EnvironmentVariableCredentialsProvider
# 環境変数 OSS_ACCESS_KEY_ID および OSS_ACCESS_KEY_SECRET から認証情報を読み取ります。
auth = oss2.ProviderAuthV4(EnvironmentVariableCredentialsProvider())
endpoint = 'https://oss-cn-hangzhou.aliyuncs.com'
region = 'cn-hangzhou'
bucket = oss2.Bucket(auth, endpoint, 'examplebucket', region=region)
key = 'example.jpg'
new_pic = 'D:\\dest.jpg'
# 30 ピクセルの半径で角丸化を適用します。
image = 'image/rounded-corners,r_30'
bucket.get_object_to_file(key, new_pic, process=image)Java
OSS SDK for Java V3.17.4 以降が必要です。
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 {
// バケットが配置されているリージョンのエンドポイントを指定します。
String endpoint = "https://oss-cn-hangzhou.aliyuncs.com";
String region = "cn-hangzhou";
// 環境変数 OSS_ACCESS_KEY_ID および OSS_ACCESS_KEY_SECRET から認証情報を読み取ります。
EnvironmentVariableCredentialsProvider credentialsProvider = CredentialsProviderFactory.newEnvironmentVariableCredentialsProvider();
String bucketName = "examplebucket";
String objectName = "example.jpg";
// 処理されたイメージを保存するローカルパス。
String pathName = "D:\\dest.jpg";
ClientBuilderConfiguration clientBuilderConfiguration = new ClientBuilderConfiguration();
clientBuilderConfiguration.setSignatureVersion(SignVersion.V4);
OSS ossClient = OSSClientBuilder.create()
.endpoint(endpoint)
.credentialsProvider(credentialsProvider)
.clientConfiguration(clientBuilderConfiguration)
.region(region)
.build();
try {
// 30 ピクセルの半径で角丸化を適用します。
String image = "image/rounded-corners,r_30";
GetObjectRequest request = new GetObjectRequest(bucketName, objectName);
request.setProcess(image);
ossClient.getObject(request, new File(pathName));
} catch (OSSException oe) {
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("Error Message:" + ce.getMessage());
} finally {
if (ossClient != null) {
ossClient.shutdown();
}
}
}
}Go
OSS SDK for Go V3.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 {
HandleError(err)
}
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, err := client.Bucket("examplebucket")
if err != nil {
HandleError(err)
}
sourceImageName := "example.jpg"
targetImageName := "D://dest.jpg"
// 30 ピクセルの半径で角丸化を適用します。
image := "image/rounded-corners,r_30"
err = bucket.GetObjectToFile(sourceImageName, targetImageName, oss.Process(image))
if err != nil {
HandleError(err)
}
}PHP
OSS SDK for PHP V2.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();
$endpoint = "https://oss-cn-hangzhou.aliyuncs.com";
$bucket = "examplebucket";
$object = "example.jpg";
$download_file = "D:\\dest.jpg";
$config = array(
"provider" => $provider,
"endpoint" => $endpoint,
"signatureVersion" => OssClient::OSS_SIGNATURE_VERSION_V4,
"region" => "cn-hangzhou"
);
$ossClient = new OssClient($config);
// 30 ピクセルの半径で角丸化を適用します。
$image = "image/rounded-corners,r_30";
$options = array(
OssClient::OSS_FILE_DOWNLOAD => $download_file,
OssClient::OSS_PROCESS => $image
);
$ossClient->getObject($bucket, $object, $options);RESTful API の使用
GetObject リクエストに x-oss-process クエリパラメーターを追加します。
GET /oss.jpg?x-oss-process=image/rounded-corners,r_30 HTTP/1.1
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Date: Fri, 28 Oct 2022 06:40:10 GMT
Authorization: OSS qn6q**************:77Dv****************