ブレンドモード
blend-mode
ブレンドレイヤーを映像とどのように合成するかを設定します。デフォルトは overlay です。
値は大文字小文字を区別しません。ブレンドモードでは、接頭辞が Rendering API と同じ順序で最初に一致するものを選択するため、d は dodge に解決されます。空の値は overlay となり、どれにも一致しない名前はレイヤーをまったく描画しません。
エイリアス: blendmode、bm。
特定のブレンドレイヤーを指定するには blend-mode[N] を使用します。N は 0〜3 です。レイヤー 0 はベアの blend-mode または blend-mode[0] のどちらでも指定でき、両方を指定した場合はベアの名前が優先されます。
有効な値
ブレンドモード
ブレンドレイヤーを持つすべての出力で描画されます。動画も含みます。
| 値 | 映像に対する効果 |
|---|---|
normal | レイヤーをそのまま映像の上に描画します。不透明なレイヤーでは映像が完全に隠れるため、スクリムには blend-alpha または AARRGGBB 形式の色を使用してください。 |
multiply | 映像にレイヤーを乗算します。結果が元より明るくなることはありません。レイヤーの白は映像をそのまま残し、黒は映像を黒に落とします。ブランドカラーのティントの定番です。 |
screen | multiply の逆で、結果が元より暗くなることはありません。レイヤーの黒は映像をそのまま残し、白は映像を白に飛ばします。ヘイズやグローに向いています。 |
overlay | デフォルト。映像の暗部では multiply、明部では screen として働き、コントラストを上げつつ中間調を着色します。 |
darken | 各チャンネルで映像とレイヤーの暗いほうを残します。 |
lighten | 各チャンネルで映像とレイヤーの明るいほうを残します。 |
color-dodge (dodge) | レイヤーに応じて映像を明るくし、ハイライトを強く飛ばします。 |
color-burn (burn) | レイヤーに応じて映像を暗くし、シャドウを強く潰します。 |
hard-light (hardlight) | 役割を入れ替えた overlay。どこを乗算しどこをスクリーンするかをレイヤー側が決めるため、overlay より強い効果になります。 |
soft-light (softlight) | より穏やかな overlay。レイヤーの明るい部分では拡散的なドッジ、暗い部分では拡散的なバーンとして働きます。 |
difference | チャンネルごとの差の絶対値を取り、反転した高コントラストの見た目になります。 |
exclusion | difference と同じ考え方ですが、コントラストが低く中間調がグレーに寄ります。 |
hue | 映像の輝度と彩度を保ち、レイヤーの色相を取り込みます。 |
saturation | 映像の輝度と色相を保ち、レイヤーの彩度を取り込みます。グレーのレイヤーは映像の彩度を落とします。 |
color | 映像の輝度を保ち、レイヤーの色相と彩度を取り込みます。ディテールを残したままのデュオトーン風のティントになります。 |
luminosity | 映像の色相と彩度を保ち、レイヤーの輝度を取り込みます。単色のレイヤーでは映像の明暗が平坦になります。 |
カットモード
透明になれる出力が必要なため、静止フレームにのみ適用されます。詳細は後述します。
| 値 | 映像に対する効果 |
|---|---|
destination-out | レイヤーがある部分の映像を削除し、レイヤーの形をフレームから打ち抜きます。 |
destination-in | レイヤーがある部分の映像のみを残し、フレームをレイヤーの形に切り抜きます。 |
上の例はいずれも同じソースに同じ不透明の色レイヤー blend=ff8800 を重ねたもので、変えているのは blend-mode だけです。効果を弱めるには blend-alpha を下げるか、AARRGGBB 形式の色を使用してください。
カットモードは静止画のみ
destination-out はレイヤーがある部分の映像を削除し、destination-in はレイヤーがある部分の映像のみを残します。どちらも透明になれる出力が必要で、それが可能なのは静止フレームだけです。
- 動画からの静止画 (
jpg、png、webp、avif、jxlなどの画像fm。フレームの指定にはvideo-thumbnailを併用) およびオーディオグラムの静止画はカットに対応しています。 - MP4、WebM、HLS、DASH、アニメーション、オーディオグラムの動画 は不透明のため、カットは何も描画しません。
- スプライトシートとストーリーボード はカットもブレンドモードもサポートしません。
2 つのカットモードは接頭辞ではなく完全一致でマッチするため、de のような省略形は何も描画しません。
カットは fade と同じように、穴を bg で埋めます。アルファを持つ静止画では指定された bg が使われ、指定がなければ透明になります。不透明な静止画では bg が不透明化され、指定がなければ白になります。blend-alpha でカットの強さを制御できます。
カットの穴の周辺における 2 つの重なり順の振る舞いは、同じ URL でも Rendering API と異なります。いずれもアルファを持つ静止画での話です。
normal以外のモードの後続レイヤーは、穴の中には描画されません。normalのレイヤーは描画されます。- カットの後に適用されたグラデーション、または不透明な
bgへのフェードは、穴にも色が乗ります。
レイヤーではなく動画フレームそのものから形を切り抜くには、静止画を生成して mask を使用してください。
以下の例はいずれも同じ動画の PNG 静止画を生成し、blend-size=inherit でフレームサイズに合わせた透過 PNG をレイヤーとして使用しています。
destination-out — レイヤーの形がフレームから取り除かれ、その部分が透明になります。Default
destination-out
