Bitmap::ApplyEffect(Effect*,RECT*) メソッド (gdiplusheaders.h)

Bitmap::ApplyEffect メソッドは、指定した効果を適用することによって、この Bitmap オブジェクトを変更します。

構文

Status ApplyEffect(
  Effect *effect,
  RECT   *ROI
);

パラメーター

effect

Effect クラスの子孫のインスタンスへのポインター。 子孫 ( Blur オブジェクトなど ) は、適用される効果を指定します。

ROI

効果が適用される入力ビットマップの部分を指定する RECT 構造体へのポインター。 NULL を渡して、効果が入力ビットマップ全体に適用されることを指定します。

戻り値

種類: 状態

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

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

解説

例

次の例では、イメージを 2 回描画します。1 回は変更なしで、1 回はイメージの一部で明るさが上がっています。

VOID Example_BrightnessContrastApplyEffect1(HDC hdc)
{
   Graphics graphics(hdc);
   Bitmap myBitmap(L"Picture.bmp");
   UINT srcWidth = myBitmap.GetWidth();
   UINT srcHeight = myBitmap.GetHeight();

   BrightnessContrastParams briConParams;
   briConParams.brightnessLevel = 50;
   briConParams.contrastLevel = 0;
   BrightnessContrast briCon;
   briCon.SetParameters(&briConParams);
   RECT rectOfInterest = {20, 15, 80, 50};

   // Draw the original image.
   graphics.DrawImage(&myBitmap, 20, 20, srcWidth, srcHeight);

   // Increase the brightness in a portion of the image.
   myBitmap.ApplyEffect(&briCon, &rectOfInterest);

   // Draw the image again.
   graphics.DrawImage(&myBitmap, 200, 20, srcWidth, srcHeight);
}

要件

こちらもご覧ください

Bitmap