Método IDirect3DDevice9::SetViewport (d3d9helper.h)

Establece los parámetros de ventanilla para el dispositivo.

Sintaxis

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

Parámetros

[in] pViewport

Tipo: const D3DVIEWPORT9*

Puntero a una estructura D3DVIEWPORT9 , especificando los parámetros de ventanilla que se van a establecer.

Valor devuelto

Tipo: HRESULT

Si el método se ejecuta correctamente, el valor devuelto es D3D_OK. Si se produce un error en el método, devolverá D3DERR_INVALIDCALL. Esto ocurrirá si pViewport no es válido o si pViewport describe una región que no puede existir dentro de la superficie de destino de representación.

Comentarios

Direct3D establece los siguientes valores predeterminados para la ventanilla.

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 se puede usar para dibujar parte de la pantalla. Asegúrese de llamarlo antes de dibujar cualquier geometría para que la configuración de la ventanilla surta efecto.

Para dibujar varias vistas dentro de una escena, repita la secuencia de geometría IDirect3DDevice9::SetViewport y dibuje la secuencia de geometría para cada vista.

Requisitos

Consulte también

IDirect3DDevice9

IDirect3DDevice9::GetViewport