Поделиться через

Метод ID2D1RenderTarget::FillOpacityMask(ID2D1Bitmap*,ID2D1Brush*,D2D1_OPACITY_MASK_CONTENT,constD2D1_RECT_F*,constD2D1_RECT_F*) (d2d1.h)

  • Статья

Применяет маску непрозрачности, описанную указанным растровым рисунком, к кисти, и использует ее для рисования области целевого объекта отрисовки.

Синтаксис

void FillOpacityMask(
  [in]           ID2D1Bitmap               *opacityMask,
  [in]           ID2D1Brush                *brush,
                 D2D1_OPACITY_MASK_CONTENT content,
  [in, optional] const D2D1_RECT_F         *destinationRectangle,
  [in, optional] const D2D1_RECT_F         *sourceRectangle
);

Параметры

[in] opacityMask

Тип: ID2D1Bitmap*

Маска непрозрачности, применяемая к кисти. Альфа-значение каждого пикселя в области, заданной sourceRectangle , умножается на альфа-значение кисти после сопоставления кисти с областью, определенной destinationRectangle.

[in] brush

Тип: ID2D1Brush*

Кисть, используемая для рисования области целевого объекта отрисовки, заданной destinationRectangle.

content

Тип: D2D1_OPACITY_MASK_CONTENT

Тип содержимого, содержащегося в маске непрозрачности. Значение используется для определения цветового пространства, в котором смешивается маска непрозрачности.

Примечание Начиная с Windows 8 D2D1_OPACITY_MASK_CONTENT не требуется. См. метод ID2D1DeviceContext::FillOpacityMask , который не имеет D2D1_OPACITY_MASK_CONTENT параметра.
 

[in, optional] destinationRectangle

Тип: const D2D1_RECT_F*

Область целевого объекта отрисовки, в независимых от устройства пикселях или NULL. Если задано значение NULL , кисть закрашивает прямоугольник того же размера, что и sourceRectangle, но расположен в источнике. Если параметр sourceRectangle не указан, кисть закрашивает прямоугольник того же размера, что и растровое изображение opacityMask , и размещает его в источнике.

[in, optional] sourceRectangle

Тип: const D2D1_RECT_F*

Область растрового изображения, используемая в качестве маски непрозрачности, в аппаратно-независимых пикселях или null. Если задано значение NULL , используется все растровое изображение.

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

None

Remarks

Для правильной работы этого метода целевой объект отрисовки должен использовать D2D1_ANTIALIAS_MODE_ALIASED режиме сглаживания. Вы можете задать режим сглаживания, вызвав метод ID2D1RenderTarget::SetAntialiasMode .

Этот метод не возвращает код ошибки в случае сбоя. Чтобы определить, завершилась ли операция рисования (например, FillOpacityMask) сбоем, проверка результат, возвращаемый методами ID2D1RenderTarget::EndDraw или ID2D1RenderTarget::Flush.

Требования

   
Минимальная версия клиента Windows 7, Windows Vista с пакетом обновления 2 (SP2) и обновлением платформы для Windows Vista [классические приложения | Приложения UWP]
Минимальная версия сервера Windows Server 2008 R2, Windows Server 2008 с пакетом обновления 2 (SP2) и Обновление платформы для Windows Server 2008 [классические приложения | Приложения UWP]
Целевая платформа Windows
Header d2d1.h
Библиотека D2d1.lib
DLL D2d1.dll

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

ID2D1RenderTarget