Freigeben über


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

Zeichnet das bereitgestellte Bild in die Befehlssenke.

Syntax

HRESULT DrawImage(
  [in]           ID2D1Image              *image,
  [in, optional] const D2D1_POINT_2F     *targetOffset,
  [in, optional] const D2D1_RECT_F       *imageRectangle,
                 D2D1_INTERPOLATION_MODE interpolationMode,
                 D2D1_COMPOSITE_MODE     compositeMode
);

Parameter

[in] image

Typ: ID2D1Image*

Das Bild, das in die Befehlssenke gezeichnet werden soll.

[in, optional] targetOffset

Typ: const D2D1_POINT_2F*

Dadurch wird der Offset im Zielbereich definiert, in den das Bild gerendert wird. Der gesamte logische Bereich des Bilds wird an das entsprechende Ziel gerendert. Wenn nicht angegeben, lautet der Zielursprung (0, 0). Die obere linke Ecke des Bilds wird dem Zieloffset zugeordnet. Dies wird nicht unbedingt der Ursprung sein.

[in, optional] imageRectangle

Typ: const D2D1_RECT_F*

Das entsprechende Rechteck im Bildbereich wird den angegebenen Ursprüngen bei der Verarbeitung des Bilds zugeordnet.

interpolationMode

Typ: D2D1_INTERPOLATION_MODE

Der Interpolationsmodus, der bei Bedarf zum Skalieren des Bilds verwendet werden soll.

compositeMode

Typ: D2D1_COMPOSITE_MODE

Wenn angegeben, der zusammengesetzte Modus, der auf die Grenzwerte des derzeit ausgewählten Clips angewendet wird.

Rückgabewert

Typ: HRESULT

Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Wenn ein Fehler auftritt, wird ein HRESULT-Fehlercode zurückgegeben.

Hinweise

Da das Bild selbst eine Befehlsliste sein kann oder ein Effektdiagramm enthalten kann, das wiederum eine Befehlsliste enthält, kann diese Methode zu einer rekursiven Verarbeitung führen.

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

ID2D1CommandList::Stream

ID2D1CommandSink

ID2D1DeviceContext::D rawImage