Bitmap::ApplyEffect(Effect*,RECT*)-Methode (gdiplusheaders.h)

Die Bitmap::ApplyEffect-Methode ändert dieses Bitmap-Objekt , indem sie einen angegebenen Effekt anwendet.

Syntax

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

Parameter

effect

Zeiger auf eine instance eines Nachfolgers der Effect-Klasse. Das untergeordnete Element (z. B. ein Blur-Objekt ) gibt den effekt an, der angewendet wird.

ROI

Zeiger auf eine RECT-Struktur , die den Teil der Eingabe-Bitmap angibt, auf den der Effekt angewendet wird. Übergeben Sie NULL , um anzugeben, dass der Effekt auf die gesamte Eingabebitbit angewendet wird.

Rückgabewert

Typ: Status

Wenn die Methode erfolgreich ist, gibt sie OK zurück, ein Element der Status-Enumeration .

Wenn die Methode fehlschlägt, gibt sie eines der anderen Elemente der Status-Enumeration zurück.

Bemerkungen

Beispiele

Das folgende Beispiel zeichnet ein Bild zweimal: einmal ohne Änderung und einmal, nachdem die Helligkeit für einen Teil des Bilds erhöht wurde.

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);
}

Anforderungen

Weitere Informationen

Bitmap