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

  • Artículo

Recupera los coeficientes de un plano de recorte definido por el usuario para el dispositivo.

Sintaxis

HRESULT GetClipPlane(
  [in]  DWORD Index,
  [out] float *pPlane
);

Parámetros

[in] Index

Tipo: DWORD

Índice del plano de recorte para el que se recuperan los coeficientes de ecuación del plano.

[out] pPlane

Tipo: float*

Puntero a una matriz de cuatro elementos de valores que representan los coeficientes del plano de recorte en forma de ecuación del plano general. Vea la sección Comentarios.

Valor devuelto

Tipo: HRESULT

Si el método se realiza correctamente, el valor devuelto es D3D_OK. Si se produce un error en el método, el valor devuelto es D3DERR_INVALIDCALL. Este error indica que el valor de Index supera el índice máximo del plano de recorte admitido por el dispositivo, o que la matriz de pPlane no es lo suficientemente grande como para contener cuatro valores de punto flotante.

Comentarios

Este método no devolverá el estado del dispositivo para un dispositivo que se crea mediante D3DCREATE_PUREDEVICE. Si desea usar este método, debe crear el dispositivo con cualquiera de los demás valores en D3DCREATE".

Los coeficientes que informa este método toman la forma de la ecuación del plano general. Si los valores de la matriz de pPlane se etiquetaron como A, B, C y D en el orden en que aparecen en la matriz, caberían en la ecuación del plano general para que Ax + By + Cz + Dw = 0. Un punto con coordenadas homogéneas (x, y, z, w) es visible en el espacio medio del plano si Ax + By + Cz + Dw >= 0. Los puntos que existen en o detrás del plano de recorte se recortan desde la escena.

La ecuación del plano utilizada por este método existe en el espacio mundial y se establece mediante una llamada anterior al método IDirect3DDevice9::SetClipPlane .

Requisitos

   
Plataforma de destino Windows
Encabezado d3d9helper.h (incluya D3D9.h)
Library D3D9.lib

Consulte también

IDirect3DDevice9

IDirect3DDevice9::SetClipPlane