マスク画像
Imgix Videoの有効化
Imgix Videoパラメータを有効にするには、fm をビデオ出力フォーマット（mp4、hls、または dash）に設定してください。
mask は、画像の場合と同じように静止フレームを形で切り抜きます。形の外側は、アルファを持つ出力では透明になり、不透明な出力では mask-bg の色になります。動画フレームからの円形アバター、角丸のポスター、画像マスクによるカスタム形状といった一般的な用途をカバーします。
?fm=png&mask=ellipse # 円形の静止画
?fm=png&mask=corners&corner-radius=40 # 角丸
?fm=png&mask=poly6 # 六角形
?fm=png&mask=shape.png # カスタム画像マスクマスクは静止フレームにのみ適用されます
動画、アニメーション、スプライトシートにマスクは描画されません。mask を機能させるには、fm=png、jpg、webp、avif、jxl、またはサムネイルなどの静止画出力をリクエストしてください。
出力フォーマットの選択
マスクが透明部分を生成できるのは、png、webp、avif、jxl などアルファをサポートする出力のみです。jpg のような不透明な出力では、マスクの外側は mask-bg で塗りつぶされ、デフォルトは白です。
auto=compress を指定するとマスクした静止画は不透明のままになります
auto=compress を指定し、fm を明示しない場合、マスクした静止画は透明を保つために PNG に切り替わるのではなく、mask-bg の上に JPEG のまま残ります。これは Rendering API が画像に対して行う動作と異なります。透明が必要な場合は fm を明示的に指定してください。
合成のタイミング
マスクは fit=fill の帯を含む静止画全体を覆います。グラデーションとフェードの後、ウォーターマークとテキストの前に適用されるため、マークやテキストがマスクで切り取られることはありません。テキストのカット (txt-blend-mode) はマスク適用後のフレームを切り抜きます。
dpr はピクセル単位の半径とフェザーをスケールします。波形とプログレスバーはマスクされた領域の上に描画されます。
エッジのフェザー
mask=ellipse または mask=corners とともにベアの fade を指定すると、フレーム端をフェードさせる代わりにマスクのエッジを内側に向かってぼかします。ぼかしは短い辺の半分を超えず、1 ピクセル未満の値はハードエッジになります。各辺個別のフェードパラメータはこれまでどおりフレーム端をフェードさせます。動画出力では、ベアの fade はマスクに属するため何も描画されません。動画では各辺個別のパラメータ (fade-left、fade-right、fade-top、fade-bottom) を使用してください。
例
いずれの例も同じ動画の静止画を生成しています。形を選択すると、マスクなしのフレームと並べて確認できます。
mask=ellipse — フレームいっぱいの楕円で切り抜きます。w、h、fit=crop でフレームを正方形にすると円形のアバターになります。Default
ellipse
関連
幾何学的な形ではなくレイヤー、色、テキストをフレームから切り抜くには、カットブレンドモードを使用します。blend-mode を参照してください。