Método IDirect3DDevice9::GetClipPlane (d3d9.h)
Recupera os coeficientes de um plano de recorte definido pelo usuário para o dispositivo.
Sintaxe
HRESULT GetClipPlane(
[in] DWORD Index,
[out] float *pPlane
);
Parâmetros
[in] Index
Tipo: DWORD
Índice do plano de recorte para o qual os coeficientes da equação do plano são recuperados.
[out] pPlane
Tipo: float*
Ponteiro para uma matriz de quatro elementos de valores que representam os coeficientes do plano de recorte na forma da equação geral do plano. Consulte Observações.
Valor retornado
Tipo: HRESULT
Se o método for bem-sucedido, o valor retornado será D3D_OK. Se o método falhar, o valor retornado será D3DERR_INVALIDCALL. Esse erro indica que o valor em Índice excede o índice de plano de recorte máximo com suporte do dispositivo ou que a matriz em pPlane não é grande o suficiente para conter quatro valores de ponto flutuante.
Comentários
Esse método não retornará o estado do dispositivo para um dispositivo criado usando D3DCREATE_PUREDEVICE. Se você quiser usar esse método, deverá criar seu dispositivo com qualquer um dos outros valores em D3DCREATE".
Os coeficientes que esse método relata assumem a forma da equação do plano geral. Se os valores na matriz em pPlane fossem rotulados como A, B, C e D na ordem em que aparecem na matriz, eles se encaixariam na equação geral do plano para que Ax + By + Cz + Dw = 0. Um ponto com coordenadas homogêneas (x, y, z, w) fica visível na metade do espaço do plano se Ax + By + Cz + Dw >= 0. Os pontos que existem no plano de recorte ou atrás são recortados da cena.
A equação do plano usada por esse método existe no espaço mundial e é definida por uma chamada anterior para o método IDirect3DDevice9::SetClipPlane .
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Windows |
| Cabeçalho | d3d9.h (inclua D3D9.h) |
| Biblioteca | D3D9.lib |