IDirect3DDevice9::SetRenderTarget-Methode (d3d9helper.h)

  • Artikel

Legt einen neuen Farbpuffer für das Gerät fest.

Syntax

HRESULT SetRenderTarget(
  [in] DWORD             RenderTargetIndex,
  [in] IDirect3DSurface9 *pRenderTarget
);

Parameter

[in] RenderTargetIndex

Typ: DWORD

Index des Renderziels. Siehe Hinweise.

[in] pRenderTarget

Typ: IDirect3DSurface9*

Zeiger auf einen neuen Farbpuffer. Bei NULL ist der Farbpuffer für den entsprechenden RenderTargetIndex deaktiviert. Geräte müssen immer einem Farbpuffer zugeordnet sein. Für die neue Renderzieloberfläche muss mindestens D3DUSAGE_RENDERTARGET angegeben sein.

Rückgabewert

Typ: HRESULT

Wenn die Methode erfolgreich ist, wird der Rückgabewert D3D_OK. Diese Methode gibt D3DERR_INVALIDCALL zurück, wenn:

  • pRenderTarget = NULL und RenderTargetIndex = 0
  • pRenderTarget ist != NULL , und das Renderziel ist ungültig.

Hinweise

Das Gerät kann mehrere Renderziele unterstützen. Die Anzahl der von einem Gerät unterstützten Renderziele ist im NumSimultaneousRTs-Member von D3DCAPS9 enthalten. Weitere Informationen finden Sie unter Mehrere Renderziele (Direct3D 9).

Das Festlegen eines neuen Renderziels bewirkt, dass der Viewport (siehe Viewports und Clipping (Direct3D 9)) auf die volle Größe des neuen Renderziels festgelegt wird.

Einige Hardwaretests testen die Kompatibilität des Tiefenschablonenpuffers mit dem Farbpuffer. Wenn dies erfolgt, erfolgt dies nur in einem Debugbuild.

Einschränkungen für die Verwendung dieser Methode umfassen folgendes:

  • Der Multisampeltyp muss für das Renderziel und die Tiefenschablonenoberfläche identisch sein.
  • Die Formate müssen für das Renderziel und die Tiefenschablonenoberfläche kompatibel sein. Siehe IDirect3D9::CheckDepthStencilMatch.
  • Die Größe der Tiefenschablonenoberfläche muss größer oder gleich der Größe des Renderziels sein.
Diese Einschränkungen werden nur überprüft, wenn die Debugruntime verwendet wird, wenn eine der IDirect3DDevice9Draw-Methoden aufgerufen wird.

Würfeltexturen unterscheiden sich von anderen Oberflächen darin, dass es sich um Oberflächensammlungen handelt. Um IDirect3DDevice9::SetRenderTarget mit einer Cubetextur aufzurufen, müssen Sie mithilfe von IDirect3DCubeTexture9::GetCubeMapSurface ein einzelnes Gesicht auswählen und die resultierende Oberfläche an IDirect3DDevice9::SetRenderTarget übergeben.

Anforderungen

   
Zielplattform Windows
Kopfzeile d3d9helper.h (include D3D9.h)
Bibliothek D3D9.lib

Weitere Informationen

IDirect3DDevice9