Метод Bitmap::ApplyEffect(Effect*,RECT*) (gdiplusheaders.h)

Метод Bitmap::ApplyEffect изменяет этот объект Bitmap , применяя указанный эффект.

Синтаксис

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

Параметры

effect

Указатель на экземпляр потомка класса Effect . Потомок (например, объект Blur ) указывает примененный эффект.

ROI

Указатель на структуру RECT , указывающую часть входного растрового изображения, к которой применяется эффект. Передайте значение NULL , чтобы указать, что эффект применяется ко всему входной растровой диаграмме.

Возвращаемое значение

Тип: Состояние

В случае успешного выполнения метода возвращается ОК, который является элементом перечисления Status .

Если метод завершается ошибкой, он возвращает один из других элементов перечисления Status .

Remarks

Примеры

В следующем примере изображение рисуется дважды: один раз без изменений и один раз после увеличения яркости для части изображения.

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

Требования

Требование	Значение
Заголовок	gdiplusheaders.h

См. также раздел

Bitmap