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 |