Método IDirect3DDevice9::SetClipPlane (d3d9.h)
Define os coeficientes de um plano de recorte definido pelo usuário para o dispositivo.
Sintaxe
HRESULT SetClipPlane(
[in] DWORD Index,
[in] const float *pPlane
);
Parâmetros
[in] Index
Tipo: DWORD
Índice do plano de recorte para o qual os coeficientes da equação do plano devem ser definidos.
[in] pPlane
Tipo: const float*
Ponteiro para um endereço de uma matriz de quatro elementos de valores que representam os coeficientes do plano de recorte a serem definidos, 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
Os coeficientes que esse método define 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 atrás do plano de recorte são recortados da cena.
Quando o pipeline de funções fixas é usado, as equações do plano são consideradas no espaço mundial. Quando o pipeline programável é usado, as equações do plano são consideradas no espaço de recorte (o mesmo espaço que os vértices de saída).
Esse método não habilita a equação do plano de recorte que está sendo definida. Para habilitar um plano de recorte, defina o bit correspondente no valor DWORD aplicado ao estado de renderização D3DRS_CLIPPLANEENABLE.
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Windows |
| Cabeçalho | d3d9.h (inclua D3D9.h) |
| Biblioteca | D3D9.lib |