ID2D1RenderTarget::FillOpacityMask(ID2D1Bitmap*,ID2D1Brush*,D2D1_OPACITY_MASK_CONTENT,constD2D1_RECT_F&,constD2D1_RECT_F&)-Methode (d2d1.h)

  • Artikel

Wendet die Deckkraftmaske, die durch die angegebene Bitmap beschrieben wird, auf einen Pinsel an und verwendet diesen Pinsel, um einen Bereich des Renderziels zu zeichnen.

Syntax

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

Parameter

[in] opacityMask

Typ: ID2D1Bitmap*

Die Deckkraftmaske, die auf den Pinsel angewendet werden soll. Der Alphawert jedes Pixels in dem von sourceRectangle angegebenen Bereich wird mit dem Alphawert des Pinsels multipliziert, nachdem der Pinsel dem durch destinationRectangle definierten Bereich zugeordnet wurde.

[in] brush

Typ: ID2D1Brush*

Der Pinsel, der verwendet wird, um den von destinationRectangle angegebenen Bereich des Renderziels zu zeichnen.

content

Typ: D2D1_OPACITY_MASK_CONTENT

Der Inhaltstyp, den die Deckkraftmaske enthält. Der Wert wird verwendet, um den Farbraum zu bestimmen, in dem die Deckkraftmaske gemischt wird.

Hinweis Ab Windows 8 ist die D2D1_OPACITY_MASK_CONTENT nicht erforderlich. Weitere Informationen finden Sie unter der ID2D1DeviceContext::FillOpacityMask-Methode , die keinen D2D1_OPACITY_MASK_CONTENT Parameter aufweist.
 

[ref] destinationRectangle

Typ: const D2D1_RECT_F

Der Bereich des zu zeichnenden Renderziels in geräteunabhängigen Pixeln.

[ref] sourceRectangle

Typ: const D2D1_RECT_F

Der Bereich der Bitmap, die als Deckkraftmaske in geräteunabhängigen Pixeln verwendet werden soll.

Rückgabewert

Keine

Bemerkungen

Damit diese Methode ordnungsgemäß funktioniert, muss das Renderziel den D2D1_ANTIALIAS_MODE_ALIASED Antialiasingmodus verwenden. Sie können den Antialiasingmodus festlegen, indem Sie die ID2D1RenderTarget::SetAntialiasMode-Methode aufrufen.

Diese Methode gibt keinen Fehlercode zurück, wenn sie fehlschlägt. Um festzustellen, ob ein Zeichnungsvorgang (z. B. FillOpacityMask) fehlgeschlagen ist, überprüfen Sie das ergebnis, das von der ID2D1RenderTarget::EndDraw - oder ID2D1RenderTarget::Flush-Methode zurückgegeben wird.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 7, Windows Vista mit SP2 und Plattformupdate für Windows Vista [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 R2, Windows Server 2008 mit SP2 und Plattformupdate für Windows Server 2008 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile d2d1.h
Bibliothek D2d1.lib
DLL D2d1.dll

Weitere Informationen

ID2D1RenderTarget