しきい値

threshold

threshold パラメーターは、画像を純粋な白黒に変換します。明るさがしきい値以上のピクセルは白に、それ未満のピクセルは黒になります。ステンシル、シルクスクリーンの版分け、ハイコントラストなポスター表現、1ビット出力などに使用します。

threshold は 0 から 100 の値を受け取り、小数も使用できます。値は明るさのしきい値をパーセンテージで表すため、threshold=50 は中間の明るさで画像を分割します。しきい値を下げると白い領域が増え、上げると黒い領域が増えます。範囲外の値は範囲内に丸められます。threshold=0 では明るさが0以上のすべてのピクセルが白側に入るため、画像全体が白になります。

数値以外の値は無視され、X-Imgix-Params レスポンスヘッダーからも除外されます。

透明度は保持されます。透明なピクセルは黒にならず、透明なままです。

元の画像
sandbox-demo
threshold=50 は中間の明るさで画像を分割します
sandbox-demo

ディザリング

しきい値による分割では、中間調がすべて失われます。threshold-dither は、この分割をドットパターンに置き換えて中間調を近似します。印刷やレトロ調の表現では通常こちらを使用します。このパラメーターは threshold が同時に指定されている場合にのみ適用されます。

処理の順序

threshold は gradient-map と階調調整の後に適用されるため、これらの指定によってしきい値の位置づけが変わります。mark、txt、blend の各レイヤーはその後に描画されるため、元の色が保たれます。