ID2D1CommandSink::D rawBitmap-Methode (d2d1_1.h)

Artikel
08/22/2023

Zeichnet eine Bitmap auf das Renderziel.

Syntax

HRESULT DrawBitmap(
  [in]           ID2D1Bitmap             *bitmap,
  [in, optional] const D2D1_RECT_F       *destinationRectangle,
                 FLOAT                   opacity,
                 D2D1_INTERPOLATION_MODE interpolationMode,
  [in, optional] const D2D1_RECT_F       *sourceRectangle,
  [in, optional] const D2D1_MATRIX_4X4_F *perspectiveTransform
);

Parameter

[in] bitmap

Typ: ID2D1Bitmap*

Die zu zeichnende Bitmap.

[in, optional] destinationRectangle

Typ: D2D1_RECT_F

Das Zielrechteck. Der Standardwert ist die Größe der Bitmap, und die Position ist die obere linke Ecke des Renderziels.

opacity

Typ: FLOAT

Die Deckkraft der Bitmap.

interpolationMode

Typ: D2D1_INTERPOLATION_MODE

Der zu verwendende Interpolationsmodus.

[in, optional] sourceRectangle

Typ: const D2D1_RECT_F

Ein optionales Quellrechteck.

[in, optional] perspectiveTransform

Typ: const D2D1_MATRIX_4X4_F

Eine optionale Perspektivtransformation.

Rückgabewert

Diese Methode gibt keinen Wert zurück.

Bemerkungen

Der Parameter destinationRectangle definiert das Rechteck im Ziel, in dem die Bitmap angezeigt wird (in geräteunabhängigen Pixeln(DIPs)). Dies wird durch die aktuell festgelegte Transformation und die perspektivische Transformation beeinflusst, sofern festgelegt. Wenn Sie NULL angeben, lautet das Zielrechteck (left=0, top=0, right = width(sourceRectangle), bottom = height(sourceRectangle).

Das sourceRectangle definiert das Unterrechteck der Quellbitbitte (in DIPs). DrawBitmap schneidet dieses Rechteck auf die Größe der Quellbit ab, sodass es unmöglich ist, ein Beispiel außerhalb der Bitmap zu erstellen. Wenn Sie NULL angeben, wird das Quellrechteck auf die Größe der Quell-Bitmap festgelegt.

Die perspectiveTransform wird zusätzlich zur Transformation im Gerätekontext angegeben.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 8 und Plattformupdate für Windows 7 [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 und Plattformupdate für Windows Server 2008 R2 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	d2d1_1.h
DLL	D2d1.dll

Weitere Informationen

ID2D1CommandSink

Freigeben über