ImageAttributes::ClearThreshold メソッド (gdiplusimageattributes.h)

ImageAttributes::ClearThreshold メソッドは、指定されたカテゴリのしきい値をクリアします。

構文

Status ClearThreshold(
  [in, optional] ColorAdjustType type
);

パラメーター

[in, optional] type

種類: ColorAdjustType

しきい値をクリアするカテゴリを指定する ColorAdjustType 列挙体の要素。 既定値は ColorAdjustTypeDefault です。

戻り値

種類: 状態

メソッドが成功した場合は、Status 列挙体の要素である Ok を返します。

メソッドが失敗した場合は、 Status 列挙体の他の要素のいずれかを返します。

解説

しきい値は 0 ~ 1 の値で、各色コンポーネントのカットオフ ポイントを指定します。 たとえば、しきい値が 0.7 に設定されていて、赤、緑、青のコンポーネントが 230、50、220 である色をレンダリングするとします。 赤の成分 230 は 0.7×255 より大きいので、赤色の成分は 255 (完全な強度) に変更されます。 緑のコンポーネント 50 は 0.7×255 未満であるため、緑のコンポーネントは 0 に変更されます。 青いコンポーネント 220 は 0.7×255 より大きいので、青のコンポーネントは 255 に変更されます。

ImageAttributes オブジェクトは、既定、ビットマップ、ブラシ、ペン、テキストの 5 つの調整カテゴリの色とグレースケールの設定を維持します。 たとえば、既定のカテゴリのしきい値、ビットマップ カテゴリに別のしきい値、ペン カテゴリに別のしきい値を指定できます。

既定の色とグレースケールの調整設定は、独自の調整設定を持たないすべてのカテゴリに適用されます。 たとえば、ペン カテゴリの調整設定を指定しない場合、既定の設定はペン カテゴリに適用されます。

特定のカテゴリに対してカラーまたはグレースケールの調整設定を指定するとすぐに、既定の調整設定はそのカテゴリに適用されなくなります。 たとえば、既定のカテゴリにしきい値とガンマ値を指定するとします。 ImageAttributes::SetThreshold を呼び出してペン カテゴリのしきい値を設定した場合、既定のしきい値はペンには適用されません。 後で ImageAttributes::ClearThreshold を呼び出してペンのしきい値をクリアした場合、ペン カテゴリは既定のしきい値に戻りません。むしろ、ペン カテゴリにはしきい値はありません。 同様に、ペン カテゴリは既定のガンマ値に戻りません。むしろ、ペンカテゴリにはガンマ値はありません。

要件

サポートされている最小のクライアント	Windows XP、Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	gdiplusimageattributes.h (Gdiplus.h を含む)
Library	Gdiplus.lib
[DLL]	Gdiplus.dll

関連項目

Bitmap

ColorAdjustType

イメージ

ImageAttributes

ImageAttributes::ClearColorKey

ImageAttributes::SetColorKey

ImageAttributes::SetThreshold

メタファイル

色変更