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

  • Artigo

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 d3d9helper.h (inclua D3D9.h)
Biblioteca D3D9.lib

Confira também

IDirect3DDevice9

IDirect3DDevice9::GetClipPlane