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

ImageAttributes::SetThreshold メソッドは、指定したカテゴリのしきい値 (透過性範囲) を設定します。

構文

Status SetThreshold(
  [in]           REAL            threshold,
  [in, optional] ColorAdjustType type
);

パラメーター

[in] threshold

種類: REAL

しきい値を指定する REAL 番号。

[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 つの調整カテゴリの色とグレースケールの設定を維持します。 たとえば、既定のカテゴリのしきい値、ビットマップ カテゴリのしきい値、ペン カテゴリに別のしきい値を指定できます。

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

特定のカテゴリに対してカラーまたはグレースケールの調整設定を指定するとすぐに、既定の調整設定はそのカテゴリに適用されなくなります。 たとえば、既定のカテゴリの調整設定のコレクションを指定するとします。 ColorAdjustTypePen を ImageAttributes::SetThreshold メソッドに渡してペン カテゴリのしきい値を設定した場合、既定の調整設定はペンに適用されません。

例

次の例では、.bmp ファイルに基づいて Image オブジェクトを作成します。 また、 ImageAttributes オブジェクトを作成し、そのビットマップしきい値を 0.6 に設定します。 その後、コードはイメージを 2 回描画します。1 回は色調整なし、1 回はしきい値で指定された調整を使用します。

VOID Example_SetThreshold(HDC hdc)
{
   Graphics graphics(hdc);

   // Create an Image object based on a .bmp file.
   // The image has one stripe with RGB components (160, 0, 0)
   // and one stripe with RGB components (0, 140, 0).
   Image image(L"RedGreenThreshold.bmp");

   // Create an ImageAttributes object, and set its bitmap threshold to 0.6.
   ImageAttributes imAtt;
   imAtt.SetThreshold(0.6f, ColorAdjustTypeBitmap);

   // Draw the image with no color adjustment.
   graphics.DrawImage(&image, 10, 10, image.GetWidth(), image.GetHeight());
 
   // Draw the image with the threshold applied.
   // 160 > 0.6*255, so the red stripe will be changed to full intensity.
   // 140 < 0.6*255, so the green stripe will be changed to zero intensity.   
   graphics.DrawImage(&image,
      Rect(100, 10, image.GetWidth(), image.GetHeight()),  // dest rect
      0, 0, image.GetWidth(), image.GetHeight(),           // source rect
      UnitPixel,
      &imAtt);
}
				

次の図は、上記のコードの出力を示しています。 赤は最大強度に変換され、緑はゼロ強度に変換されることに注意してください。

要件

関連項目

Bitmap

Color

ColorAdjustType

イメージ

ImageAttributes

ImageAttributes::ClearColorKey

ImageAttributes::ClearThreshold

ImageAttributes::SetColorKey

メタファイル

色変更