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

Object Storage Service:カスタム作物

最終更新日:Feb 23, 2024

webページやレイアウト要件に合わせてObject Storage Service (OSS) に保存されている画像のサイズを変更する場合は、カスタムクロップ機能を使用して、必要なサイズに画像をトリミングできます。

シナリオ

  • Webページのデザインと制作: webページのレイアウトをデザインするときは、アバター、背景画像、製品の表示など、webページの要素に合わせて画像を特定のサイズにトリミングする必要がある場合があります。

  • ソーシャルメディアに必要なカスタム画像サイズ: さまざまなソーシャルメディアプラットフォームでは、サムネイル、投稿できる画像、ストーリー画像など、アップロードする画像のサイズ要件が異なります。 最適な表示パフォーマンスを実現するには、推奨サイズに基づいてソース画像をトリミングする必要があります。

  • モバイルアプリ開発: 特定の仕様に基づいて、アプリ内のアイコン、スタートアップページ、埋め込み画像などの画像をトリミングして、さまざまな解像度と画面サイズのデバイスで画像が期待どおりに表示されるようにする必要があります。

  • 画像データベース管理: ライブラリやアーカイブなど、多数の画像リソースを持つ機関のソートとアーカイブの要件を満たすには、画像を事前設定されたサイズにトリミングする必要があります。

パラメーター

アクション: crop

下表に、各パラメーターを説明します。

パラメーター

説明

値の範囲

w

トリミングする幅。

[0, イメージ幅]

デフォルト値: 最大値。

h

あなたがトリミングしたい高さ。

[0, イメージの高さ]

デフォルト値: 最大値。

x

トリミングする領域のX座標。 デフォルト値は、画像の左上隅のX座標です。

[0, 画像バインド]

y

トリミングするエリアのY座標。 デフォルト値は、画像の左上隅のY座標です。

[0, 画像バインド]

g

3x3グリッドでトリミングするエリアの位置。 画像は3x3のグリッドにあります。 グリッドには9つのタイルがあります。

  • nw: 左上

  • 北: アッパーミドル

  • ne: 右上

  • west: 中央左

  • センター: センター

  • 東: ミドル右

  • sw: 左下

  • 南: 下ミドル

  • se: 右下

各タイルの位置を計算する方法の詳細については、次の表をご参照ください。

次の表に、3x3グリッド内の各タイルの位置を計算する方法を示します。 srcWはソースイメージの幅を指定し、srcHはソースイメージの高さを指定します。

タイル

計算方法

nw

0, 0

srcW/2 - w/2, 0

ne

srcW - w, 0

西

0、srcH/2 - h/2

center

srcW/2 - w/2、srcH/2 - h/2

srcW - w、srcH/2 - h/2

sw

0、srcH - h

サース

srcW/2 - w/2、srcH - h

se

srcW - w、srcH - h

使用上の注意

  • 指定された開始X座標とY座標がソースイメージの開始X座標とY座標を超える場合、BadRequestエラーコードとアドバンスカットの位置はイメージ外になります。 エラーメッセージが返されます。

  • 開始点から指定された幅と高さがソースイメージの幅と高さを超える場合、ソースイメージは境界までトリミングされます。

  • オブジェクトURL、OSS SDK、またはAPI操作を使用して、イメージの処理に使用されるイメージ処理 (IMG) パラメーターを設定できます。 このトピックでは、オブジェクトURLを使用します。 オブジェクトURLを使用して、パブリック読み書きイメージに対してのみIMGパラメーターを設定できます。 プライベートイメージのIMGパラメーターを設定する場合は、OSS SDKを使用するか、API操作を呼び出します。 詳細については、「IMG実装モード」をご参照ください。

次の例では、中国 (杭州) リージョンのoss-console-img-demo-cn-hangzhou-3azという名前のバケット内のイメージがソースイメージとして使用されています。 次のURLを使用して、インターネット経由で画像にアクセスできます。