ID2D1SourceTransform::D raw-Methode (d2d1effectauthor.h)

  • Artikel

Zeichnet die Transformation in die gpubasierte Direct2D-Pipeline (Graphics Processing Unit) ab.

Syntax

HRESULT Draw(
  [in] ID2D1Bitmap1      *target,
  [in] const D2D1_RECT_L *drawRect,
       D2D1_POINT_2U     targetOrigin
);

Parameter

[in] target

Typ: ID2D1Bitmap1*

Das Ziel, in das die Transformation geschrieben werden soll.

[in] drawRect

Typ: const D2D1_RECT_L*

Der Bereich innerhalb der Quelle, aus dem das Bild gezeichnet werden soll.

targetOrigin

Typ: D2D1_POINT_2U

Der Ursprung innerhalb der Ziel-Bitmap, für die die Quelldaten gezeichnet werden sollen.

Rückgabewert

Typ: HRESULT

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

Hinweise

Die Implementierung des Rasterizers garantiert, dass das Hinzufügen von renderRect zu targetOrigin die Grenzen der Bitmap nicht überschreitet.

Wenn Sie diese Methode implementieren, müssen Sie die Bitmap auf folgende Weise aktualisieren:

  1. Rufen Sie die ID2D1Bitmap::Map-Methode mit den Flags D2D1_MAP_OPTIONS_DISCARD und D2D1_MAP_OPTIONS_WRITE auf.
  2. Aktualisieren Sie den Puffer, den diese Methode zurückgibt.
  3. Rufen Sie die ID2D1Bitmap::Unmap-Methode auf .
Wenn Sie die Puffergenauigkeit für das zugeordnete ID2D1RenderInfo-Objekt manuell festlegen, müssen verschiedene Pixelformate in dieser Methode verarbeitet werden, indem ID2D1Bitmap::GetPixelFormat aufgerufen wird. Wenn Sie die Puffergenauigkeit manuell festlegen, können Sie sich darauf verlassen, dass dieses Format immer das von Ihnen bereitgestellte ist.

Anforderungen

Anforderung Wert
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 d2d1effectauthor.h
Bibliothek D2d1.lib

Weitere Informationen

ID2D1EffectImpl

ID2D1SourceTransform