Método IDirect3DDevice9::GetClipPlane (d3d9.h)
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
Requisito | Value |
---|---|
Plataforma de destino | Windows |
Encabezado | d3d9.h (incluya D3D9.h) |
Library | D3D9.lib |