Imgix APIsレンダリング API背景カラーキーのモード

カラーキーのモード

colorkey-mode

colorkey-mode パラメーターは、colorkey がピクセルとキーカラーの近さをどのように測定するかを選択します。colorkey を指定していない場合は効果がありません。

値測定対象用途
color(デフォルト)明度を含む赤・緑・青白、グレー、黒などの単色背景
chroma明度を無視した色味のみ照明にムラのあるグリーンスクリーンやブルースクリーン

chroma はVideo APIの video-mark-chromakey と同じ方式およびデフォルト値を使用するため、画像と動画で同じ挙動になります。モードを切り替えると、他のカラーキーパラメーターのデフォルト値も変わります。

パラメーターcolor のデフォルトchroma のデフォルト
colorkey-tol2054.09
colorkey-feather3018.03
colorkey-defringe10.5

chroma モードでは許容値が大幅に広くなります。明度を無視するということは、グリーンスクリーンの明るい部分と影の部分がすべて1つの範囲に収まる必要があるためです。一方でフェザーとフリンジ除去のデフォルト値は小さくなります。彩度の高いキーカラーは被写体とよりはっきり分離するため、エッジの補正があまり必要ないからです。

クロマモードを使うべきでない場合

chroma は明度を無視するため、白・グレー・黒を区別できず、彩度の低い色をすべてグレーやくすんだキーカラーに近いものとして扱います。クロマモードで白背景をキーイングすると画像全体が除去されます。ニュートラルな背景やくすんだ背景には、デフォルトの color モードを使用してください。

クロマモードでは、キーの色相に近い彩度の高い被写体の色も部分的に除去されることがあります。たとえばシアンの被写体は緑のキーカラーに近い色です。そうした場合は colorkey-tol を下げてください。

colorkeymode はエイリアスとして使用できます。

colorkey-mode=color(デフォルト)
sandbox-demo
colorkey-mode=chroma:くすんだ青のキーカラーでは被写体まで除去されます
sandbox-demo