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

Confira também

IDirect3DDevice9

IDirect3DDevice9::SetClipPlane