指定したカテゴリのしきい値を消去します。
Overloads Public Sub ClearThreshold( _
ByVal type As ColorAdjustType _)
[C#]
public void ClearThreshold(ColorAdjustTypetype);
[C++]
public: void ClearThreshold(ColorAdjustTypetype);
[JScript]
public function ClearThreshold(
type : ColorAdjustType);
パラメータ
- type
しきい値を消去する対象のカテゴリを指定する ColorAdjustType 列挙体の要素。
戻り値
このメソッドは値を返しません。
解説
しきい値は、各色のコンポーネントのカットオフ ポイントを指定する 0 ～ 1 の範囲の値です。たとえば、しきい値が 0.7 に設定されていて、赤、緑、青のコンポーネントがそれぞれ 230、50、220 の色を描画するとします。赤のコンポーネントの 230 は 0.7x255 を超えているため、赤のコンポーネントは 255 (最大輝度) に変更されます。緑のコンポーネントは 50 で、0.7x255 より小さいため、緑のコンポーネントは 0 に変更されます。青のコンポーネントは 220 で、0.7x255 より大きいため、青のコンポーネントは 255 に変更されます。
ImageAttributes オブジェクトは、5 つの調整カテゴリ (既定、ビットマップ、ブラシ、ペン、テキスト) に関して色とグレースケールの設定を保持します。たとえば、既定のカテゴリに対してしきい値を指定し、ビットマップ カテゴリには別のしきい値を指定し、さらにペン カテゴリにも異なるしきい値を指定できます。
既定のカラー調整設定値およびグレースケール調整設定値は、調整設定値が設定されていないすべてのカテゴリに対して適用されます。たとえば、ペン カテゴリの調整設定を一切指定していない場合、ペン カテゴリには既定の設定が適用されます。
特定のカテゴリに対してカラー調整設定値またはグレースケール調整設定値を指定すると、そのカテゴリに適用されていた既定の調整設定値は解除されます。たとえば、既定のカテゴリにしきい値とガンマ値を指定したとします。SetThreshold を呼び出してペン カテゴリのしきい値を設定すると、ペンには既定のしきい値は適用されません。その後で ClearThreshold を呼び出してペンのしきい値をクリアしても、ペン カテゴリが既定のしきい値に戻されることはありません。ペン カテゴリはしきい値を持たなくなります。同様に、ペン カテゴリで既定のガンマ値が使用されることはありません。ペン カテゴリのガンマ値は指定されません。
必要条件
プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ
参照
ImageAttributes クラス | ImageAttributes メンバ | System.Drawing.Imaging 名前空間 | ImageAttributes.ClearThreshold オーバーロードの一覧