マスクタイプ
mask
画像における mask と同じように、静止フレームを形で切り抜きます。形の外側は、アルファを持つ出力では透明になり、不透明な出力では mask-bg の色になります。
有効な値は ellipse、corners、poly3 から poly32、または画像 URL です。
ellipseはフレームを楕円で塗りつぶします。cornersはフレームの角を丸めます。丸みの大きさはcorner-radiusで制御します。polyNは 3 時の位置に頂点を持つ正 N 角形を描き、フレーム全体に引き伸ばします。
形の名前は完全一致で、大文字小文字を区別します。それ以外はすべて画像 URL として扱われ、取得されてフレームに引き伸ばされ、輝度×アルファに応じて映像を残します。poly6.png のような値も六角形ではなく画像として扱われます。相対 URL はソースのフォルダを基準に解決され、取得またはデコードに失敗した画像はマスクを描画しません。
mask は静止フレームにのみ適用されます。動画、アニメーション、スプライトシートにマスクは描画されません。
ビットマップのマスク画像は、ウォーターマークやブレンドレイヤーの画像と同じく sRGB として読み取られます。sRGB 以外の ICC プロファイル (Adobe RGB、Display P3、Generic RGB) を持つマスクは意図しない切り抜きになるため、事前に sRGB に変換してください。
合成のタイミング
マスクは fit=fill の帯を含む静止画全体を覆います。グラデーションとフェードの後、ウォーターマークとテキストの前に適用されるため、マークやテキストがマスクで切り取られることはありません。
dpr はピクセル単位の半径とフェザーをスケールします。波形とプログレスバーはマスクされた領域の上に描画されます。
エッジのフェザー
mask=ellipse または mask=corners とともにベアの fade を指定すると、フレーム端をフェードさせる代わりにマスクのエッジを内側に向かってぼかします。ぼかしは短い辺の半分を超えず、1 ピクセル未満の値はハードエッジになります。各辺個別のフェードパラメータはこれまでどおりフレーム端をフェードさせます。動画出力では、ベアの fade はマスクに属するため何も描画されません。動画では各辺個別のパラメータ (fade-left、fade-right、fade-top、fade-bottom) を使用してください。
形ではなくレイヤーやテキストをフレームから切り抜くには、blend-mode を参照してください。
例
以下の各値は同じ動画の PNG 静止画に適用し、マスクなしのフレームと並べて表示しています。
mask=ellipse — フレームいっぱいの楕円で切り抜きます。Default
ellipse
