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

Define os parâmetros do visor para o dispositivo.

Sintaxe

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

Parâmetros

[in] pViewport

Tipo: const D3DVIEWPORT9*

Ponteiro para uma estrutura D3DVIEWPORT9 , especificando os parâmetros de visor a serem definidos.

Valor retornado

Tipo: HRESULT

Se o método for bem-sucedido, o valor retornado será D3D_OK. Se o método falhar, ele retornará D3DERR_INVALIDCALL. Isso acontecerá se pViewport for inválido ou se pViewport descrever uma região que não pode existir na superfície de destino de renderização.

Comentários

O Direct3D define os seguintes valores padrão para o visor.


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 pode ser usado para desenhar em parte da tela. Certifique-se de chamá-la antes que qualquer geometria seja desenhada para que as configurações do visor entrem em vigor.

Para desenhar vários modos de exibição dentro de uma cena, repita a sequência de geometria IDirect3DDevice9::SetViewport e desenhe para cada exibição.

Requisitos

   
Plataforma de Destino Windows
Cabeçalho d3d9helper.h (inclua D3D9.h)
Biblioteca D3D9.lib

Confira também

IDirect3DDevice9

IDirect3DDevice9::GetViewport