IDirect3DDevice9::SetViewport-Methode (d3d9helper.h)

Legt die Viewportparameter für das Gerät fest.

Syntax

HRESULT SetViewport(
  [in] const D3DVIEWPORT9 *pViewport
);

Parameter

[in] pViewport

Typ: const D3DVIEWPORT9*

Zeiger auf eine D3DVIEWPORT9-Struktur , die die festzulegenden Viewportparameter angibt.

Rückgabewert

Typ: HRESULT

Wenn die Methode erfolgreich ist, wird der Rückgabewert D3D_OK. Wenn die Methode fehlschlägt, wird D3DERR_INVALIDCALL zurückgegeben. Dies geschieht, wenn pViewport ungültig ist oder wenn pViewport einen Bereich beschreibt, der nicht innerhalb der Renderzieloberfläche vorhanden ist.

Hinweise

Direct3D legt die folgenden Standardwerte für den Viewport fest.

D3DVIEWPORT9 vp;
vp.X      = 0;
vp.Y      = 0;
vp.Width  = RenderTarget.Width;
vp.Height = RenderTarget.Height;
vp.MinZ   = 0.0f;
vp.MaxZ   = 1.0f;

IDirect3DDevice9::SetViewport kann verwendet werden, um auf einem Teil des Bildschirms zu zeichnen. Stellen Sie sicher, dass Sie ihn aufrufen, bevor eine Geometrie gezeichnet wird, damit die Viewporteinstellungen wirksam werden.

Um mehrere Ansichten innerhalb einer Szene zu zeichnen, wiederholen Sie IDirect3DDevice9::SetViewport , und zeichnen Sie die Geometriesequenz für jede Ansicht.

Anforderungen

Weitere Informationen

IDirect3DDevice9

IDirect3DDevice9::GetViewport