circleパラメーターを使用して、Object Storage Service (OSS) に保存されているイメージを円に切り抜くことができます。 このトピックでは、画像を円にトリミングするためのパラメーターと例について説明します。
パラメーター
操作名: サークル
次の表に、イメージを円にトリミングするときに設定できるパラメーターを示します。
パラメーター | 説明 | 有効値 |
r | 円の半径。 | 1から4096 |
使用上の注意
- 画像の最終フォーマット (PNG、WebP、またはBMPなど) がアルファチャネルをサポートしている場合、円の外側の画像の領域は透明になります。 画像の最終フォーマットがJPGの場合、画像の円の外側の領域は白になります。 処理した画像をPNG形式で保存することを推奨します。
- rの値がソース画像の短辺の半分より大きい場合、rの値=(ソース画像の短辺-1)/2。 ターゲットイメージの高さと幅=r x 2 + 1の値。
例
オブジェクトURL、OSS SDK、またはAPI操作を使用して、イメージの処理に使用されるIMGパラメーターを設定できます。 この例では、オブジェクトURLが使用されます。 オブジェクトURLを使用して、パブリック読み取りイメージに対してのみIMGパラメーターを設定できます。 プライベートイメージのIMGパラメーターを設定する場合は、OSS SDKまたはAPI操作を使用します。 詳細については、「IMG実装モード」をご参照ください。
次の例では、中国 (杭州) リージョンのoss-console-img-demo-cn-hangzhouという名前のバケット内のイメージがソースイメージとして使用されています。 次のURLを使用して、インターネット経由で画像にアクセスできます。
- ソース画像をトリミングして半径100ピクセルの円を取得し、処理した画像をJPG形式で保存します。 円の外側の画像の領域は白になります。
次のURLは、画像を処理するために使用されhttps://oss-console-img-demo-cn-hangzhou.oss-cn-hangzhou.aliyuncs.com/example.jpg?x-oss-process=image/circle,r_100。
- ソース画像をトリミングして半径100ピクセルの円を取得し、処理した画像をPNG形式で保存します。 円の外側の画像の領域は透明になる。
次のURLは、画像を処理するために使用されhttps://oss-console-img-demo-cn-hangzhou.oss-cn-hangzhou.aliyuncs.com/example.jpg?x-oss-process=image/circle,r_100/format,png。