IDirect3DDevice9::SetViewport-Methode (d3d9.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 , wobei die festzulegenden Viewportparameter angegeben werden.
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 eine Region beschreibt, die 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 zum Zeichnen auf einem Teil des Bildschirms verwendet werden. Stellen Sie sicher, dass Sie sie 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
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | d3d9.h (einschließlich D3D9.h) |
| Bibliothek | D3D9.lib |