Share via


Função D3DXMatrixOrthoOffCenterRH (D3DX10Math.h)

Observação

A biblioteca de utilitários D3DX10 foi preterida. Em vez disso, recomendamos que você use DirectXMath .

Cria uma matriz de projeção ortográfica personalizada e destro.

Sintaxe

D3DXMATRIX* D3DXMatrixOrthoOffCenterRH(
  _Inout_ D3DXMATRIX *pOut,
  _In_    FLOAT      l,
  _In_    FLOAT      r,
  _In_    FLOAT      b,
  _In_    FLOAT      t,
  _In_    FLOAT      zn,
  _In_    FLOAT      zf
);

Parâmetros

pOut [in, out]

Tipo: D3DXMATRIX*

Ponteiro para o D3DXMATRIX resultante.

l [in]

Tipo: FLOAT

Valor x mínimo do volume de exibição.

r [in]

Tipo: FLOAT

Valor x máximo do volume de exibição.

b [in]

Tipo: FLOAT

Valor mínimo y do volume de exibição.

t [in]

Tipo: FLOAT

Valor máximo y do volume de exibição.

zn [in]

Tipo: FLOAT

Valor z mínimo do volume de exibição.

zf [in]

Tipo: FLOAT

Valor z máximo do volume de exibição.

Valor retornado

Tipo: D3DXMATRIX*

Ponteiro para o D3DXMATRIX resultante.

Comentários

A função D3DXMatrixOrthoRH é um caso especial da função D3DXMatrixOrthoOffCenterRH. Para criar a mesma projeção usando D3DXMatrixOrthoOffCenterRH, use os seguintes valores:

l = -w/2,

r = w/2,

b = -h/2 e

t = h/2.

Todos os parâmetros da função D3DXMatrixOrthoOffCenterRH são distâncias no espaço da câmera. Os parâmetros descrevem as dimensões do volume de exibição.

O valor retornado para essa função é o mesmo valor retornado no parâmetro pOut. Dessa forma, a função D3DXMatrixOrthoOffCenterRH pode ser usada como um parâmetro para outra função.

Essa função usa a fórmula a seguir para calcular a matriz retornada.

2/(r-l)      0            0           0
0            2/(t-b)      0           0
0            0            1/(zn-zf)   0
(l+r)/(l-r)  (t+b)/(b-t)  zn/(zn-zf)  1

Requisitos

Requisito Valor
parâmetro
D3DX10Math.h
Biblioteca
D3DX10.lib

Confira também

Funções Matemáticas