Bitmap ::ApplyEffect(Effect*,RECT*) , méthode (gdiplusheaders.h)

La méthode Bitmap ::ApplyEffect modifie cet objet Bitmap en appliquant un effet spécifié.

Syntaxe

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

Paramètres

effect

Pointeur vers un instance d’un descendant de la classe Effect. Le descendant (par exemple, un objet Blur ) spécifie l’effet appliqué.

ROI

Pointeur vers une structure RECT qui spécifie la partie de la bitmap d’entrée à laquelle l’effet est appliqué. Passez la valeur NULL pour spécifier que l’effet s’applique à l’ensemble de l’image bitmap d’entrée.

Valeur retournée

Type : État

Si la méthode réussit, elle retourne Ok, qui est un élément de l’énumération Status .

Si la méthode échoue, elle retourne l’un des autres éléments de l’énumération Status .

Notes

Exemples

L’exemple suivant dessine une image deux fois : une fois sans modification et une fois après que la luminosité a été augmentée pour une partie de l’image.

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

Configuration requise

Condition requise	Valeur
En-tête	gdiplusheaders.h

Voir aussi

Bitmap