サポートされているオペレーション

このセクションでは、Cloud CDN 画像最適化でサポートされているオペレーションの一覧を示します。 この表には、オペレーション、構文、属性、説明、例などのパラメータが含まれており、imop クエリの作成に役立ちます。

Cloud CDN 画像最適化は、サイズ変更、切り抜き、スケーリングなど、画像を変換できる一連のオペレーションをサポートしています。各オペレーションには、独自の構文、サポートされている属性、制約があります。

このページでは、Cloud CDN 画像最適化でサポートされているオペレーションの一覧と、imop クエリの作成に役立つ例を示します。

オペレーション 構文と例 属性 説明

Resize

?imop=Resize,width=<resized_width>,height=<resized_height>

https://www.example.com/image.jpg?imop=Resize,width=250,height=125
  • width 型: 整数（範囲: 1 ～ 8192）
  • height 型: 整数（範囲: 1 ～ 8192）

最大 width * height は 6,710 万ピクセル（67,108,864 ピクセル）を超えられません。

  • スケーリング（省略可）型: 列挙型、値: proportional、stretch。
    		•

    このオペレーションでは、幅と高さの両方のパラメータを指定した場合、アスペクト比は保持されません。いずれかのディメンションを省略すると、 Cloud CDN 画像最適化はアスペクト比を維持するために他方を計算します。

    デフォルトでは、画像最適化は厳密な縮小のみの戦略を適用します。scaling=stretch パラメータを指定するとアップスケールが可能になりますが、サイズ パラメータを 1 つだけ指定した場合、システムはこれを許可しません。

    Scale

    ?imop=Scale,ratio=<scale_ratio>

    https://www.example.com/image.jpg?imop=Scale,ratio=0.5

    		 ratio
    • 型: 浮動小数点数（小数点以下 2 桁に制限）
    • 制約: 0 < value

    このオペレーションは、特定の係数で画像をスケーリングし、 縮小のみを適用します。Resize オペレーションと Crop オペレーションとは相互に排他的です。

    1 つのリクエスト内で Scale オペレーションを Resize または Crop オペレーションとともに含めると、 システムはエラーを返します。

    Crop

    ?imop=Crop,shape=<shape>,left=<left>,right=<right>,top=<top&lgt;,bottom=<bottom>,snap_to_x=<snap_x>,snap_to_y=<snap_y>

    https://www.example.com/image.jpg?imop=Crop,shape=rectangle,left=0.5,snap_to_x=512

    		 shape
    • 型: 文字列（rectangle、circle）
    • デフォルト: rectangle
    • 依存関係: crop パラメータとともに使用する必要があります。無効な値を指定すると、HTTP 400 が返されます。
    left、right、top、 bottom
    • 型: 浮動小数点数
    • 範囲: 0.0 ～ 1.0、小数点以下 3 桁まで
    • デフォルト: 0.0、1.0、0.0、1.0
    snap_to_x, snap_to_y
    • 型: 整数
    • 範囲: 0 以上
    • デフォルト: 0
    • 制約: left、right、top、bottom のいずれか 1 つ以上を含める必要があります。

    このオペレーションは、リージョン マーカーに基づいて画像を切り抜きます。shape パラメータに無効な値を指定すると、システムは HTTP 400 Bad Request を返します。

    切り抜き座標は、指定された snap_to_x または snap_to_y 値の最も近い倍数に自動整列されます。

    Canvas

    ?imop=Canvas,width=<canvas_width>,height=<canva_height>,background_color=<color>,gravity=<gravity>

    https://www.example.com/image.jpg?imop=Canvas,width=250,height=125,background_color=FFF,gravity=center

    		 width、 height
    • 型: 整数
    • 範囲: 1 ～ 8192
    • 最大幅 x 高さの合計は 67,108,864 ピクセルを超えられません。
    gravity
    • 型: 文字列
    • 値: center、left、right、top、bottom、top_left、top_right、bottom_left、 bottom_right
    • デフォルト: center
    background_color
    • 型: 文字列
    • 形式: 3 桁、4 桁、または 6 桁の 16 進数コード
    • デフォルト: 000000（黒）。

    このオペレーションは、指定した ディメンションと色の背景レイアウトを追加して画像を強化します。gravity パラメータは、この背景キャンバス上の内部画像の配置を決定します。

    Rotate

    ?imop=Rotate,degrees=<rotate_degrees>

    https://www.example.com/image.jpg?imop=Rotate,degrees=90

    		 degrees
    • 型: 整数
    • 使用できる値: 90、180、270。

    このオペレーションは、ターゲット画像を時計回りに回転させます。

    Mirror

    ?imop=Mirror,flip=<flip>

    https://www.example.com/image.jpg?imop=Mirror,flip=h

    		 flip
    • 型: 文字列
    • 使用できる値: h（水平）、v（垂直）、hv（水平と垂直）。

    このオペレーションは、画像を水平方向、垂直方向、またはその両方で反転させます。

    Compress

    ?imop=Compress,strength=<value>

    https://www.example.com/image.jpg?imop=Compress,strength=medium

    		 strength
    • 型: 文字列
    • 使用できる値: very_weak、weak、medium、strong、very_strong。
    • 制約: jpeg、avif、webp でのみサポートされます。この範囲外の値は HTTP 400 を返します。

    このオペレーションは、ターゲット画像の品質を低下させることで画像を圧縮します。 strength パラメータを使用すると、アクティブな画像圧縮レベルを制御できます。

    Convert

    ?imop=Convert,format=<format>

    https://www.example.com/image.jpg?imop=Convert,format=webp

    		 format
    • 型: 文字列。
    • 使用できる値: jpeg、png、webp、avif、gif
    • 制約: 他のリストにない値を使用すると、処理エラーが発生します。

    このオペレーションは、画像の最終的な配信形式を変更します。ブラウザの受信 ACCEPT ヘッダー仕様との処理競合が発生した場合、システムは HTTP 406 Not Acceptable エラーを返します。

    Metadata

    ?imop=Metadata,preserve=<preserve>

    https://www.example.com/image.jpg?imop=Metadata,preserve=none

    		 preserve
    • 型: 文字列
    • 使用できる値: none、copyright、max
    • デフォルト: copyright

    このオペレーションは、実行中に画像メタデータ プロパティがどのように処理されるかを制御します。

    none: すべてのメタデータ プロパティを削除します。

    max: 変換に適用される EXIF の向きとカラー プロファイルを除くすべてのフィールドを保持します

    。

    copyright: Author、Copyright、Caption フィールドのみを保持します。

    Tone

    ?imop=tone,brightness=<brightness>,contrast=<contrast_level>, saturation=<saturation>

    https://www.example.com/image.jpg?imop=tone,brightness=50,contrast=50,saturation=50
    • brightness
      • 型: 整数
      • 範囲: -100 ～ 100
    • contrast
      • 型: 整数
      • 範囲: -100 ～ 100
    • saturation
      • 型: 整数
      • 範囲: -100 ～ 100

    このオペレーションは、画像の brightness, contrast, and saturation レベルを動的に変更します。特定のパラメータを省略するか、0 に設定すると、 システムはその属性を変更しません。彩度を -100 に設定すると、グレースケール変換が強制されます。

    Sharpen

    ?imop=Sharpen,strength=<sharpness>

    https://www.example.com/image.jpg?imop=Sharpen,strength=50

    		 strength
    • 型: 整数
    • 範囲: 0 ～ 100

    このオペレーションは、画像の鮮明度を高めます。

    Blur

    ?imop=Blur,strength=<blur_size>

    https://www.example.com/image.jpg?imop=Blur,strength=50

    		 strength
    • 型: 整数
    • 範囲: 0 ～ 100

    このオペレーションは、画像全体にローカライズされたぼかしフィルタを適用します。

    Freeze

    ?imop=freeze,frame=<frame>

    https://www.example.com/image.gif?imop=freeze,frame=0

    		 frame
    • 型: 整数
    • 範囲: 0 ～ 100。

    このオペレーションは、アニメーション画像シーケンスから単一の静止フレームを抽出します。GIF アニメーションなど。frame パラメータは、 抽出する正確なフレーム インデックスを指定します。

    次のステップ