すべてのプロダクト
Search
ドキュメントセンター

Object Storage Service:角丸長方形

最終更新日:Mar 21, 2026

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

Source image

例 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
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
Cropped image with rounded corners, 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****************