Método ID3D11DeviceContext::RSSetViewports (d3d11.h)

  • Artigo

Associe uma matriz de visores ao estágio de rasterizador do pipeline.

Sintaxe

void RSSetViewports(
  [in]           UINT                 NumViewports,
  [in, optional] const D3D11_VIEWPORT *pViewports
);

Parâmetros

[in] NumViewports

Tipo: UINT

Número de visores a serem associados.

[in, optional] pViewports

Tipo: const D3D11_VIEWPORT*

Uma matriz de estruturas D3D11_VIEWPORT a serem associadas ao dispositivo. Consulte a página de estrutura para obter detalhes sobre como o tamanho do visor depende do nível de recurso do dispositivo que foi alterado entre o Direct3D 11 e o Direct3D 10.

Retornar valor

Nenhum

Comentários

Todos os visores devem ser definidos atomicamente como uma operação. Todos os visores não definidos pela chamada são desabilitados.

Qual visor usar é determinado pela saída semântica SV_ViewportArrayIndex por um sombreador de geometria; se um sombreador de geometria não especificar a semântica, o Direct3D usará o primeiro visor na matriz.

Nota Embora você especifique valores float para os membros da estrutura D3D11_VIEWPORT para a matriz pViewports em uma chamada para ID3D11DeviceContext::RSSetViewports para níveis de recursos 9_x, RSSetViewports usa DWORDs internamente. Devido a esse comportamento, quando você usa um canto superior esquerdo negativo para o visor, a chamada para RSSetViewports para níveis de recursos 9_x falha. Essa falha ocorre porque RSSetViewports para 9_x converte os valores de ponto flutuante em inteiros sem sinal sem validação, o que resulta em estouro de inteiro.
 

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho d3d11.h
Biblioteca D3D11.lib

Confira também

ID3D11DeviceContext