Compartir a través de

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

  • Artículo

Recupera el estado del clip.

Sintaxis

HRESULT GetClipStatus(
  [out] D3DCLIPSTATUS9 *pClipStatus
);

Parámetros

[out] pClipStatus

Tipo: D3DCLIPSTATUS9*

Puntero a una estructura de D3DCLIPSTATUS9 que describe el estado del clip.

Valor devuelto

Tipo: HRESULT

Si el método se realiza correctamente, el valor devuelto es D3D_OK.

D3DERR_INVALIDCALL se devuelve si el argumento no es válido.

Comentarios

Cuando se habilita el recorte durante el procesamiento de vértices (por IDirect3DDevice9::P rocessVertices, IDirect3DDevice9::D rawPrimitive u otras funciones de dibujo), Direct3D calcula un código de clip para cada vértice. El código de clip es una combinación de bits D3DCS_*. Cuando un vértice está fuera de un plano de recorte determinado, el bit correspondiente se establece en el código de recorte. Direct3D mantiene el estado del clip mediante D3DCLIPSTATUS9, que tiene miembros ClipUnion y ClipIntersection. ClipUnion es un "OR" bit a bit de todos los códigos de clip de vértice y ClipIntersection es un "AND" bit a bit de todos los códigos de clip de vértices. Los valores iniciales son cero para ClipUnion y 0xFFFFFFFF para ClipIntersection. Cuando D3DRS_CLIPPING se establece en FALSE, ClipUnion y ClipIntersection se establecen en cero. Direct3D actualiza el estado del clip durante las llamadas de dibujo. Para calcular el estado del clip de un objeto determinado, establezca ClipUnion y ClipIntersection en su valor inicial y continúe dibujando.

El estado del clip no se actualiza mediante IDirect3DDevice9::D rawRectPatch e IDirect3DDevice9::D rawTriPatch porque no hay ninguna emulación de software para ellos.

El estado del clip se usa durante el procesamiento de vértices de software. Por lo tanto, este método no se admite en dispositivos de procesamiento de hardware puros o no depuro. Para obtener más información sobre los dispositivos puros, consulte D3DCREATE.

Requisitos

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

Consulte también

IDirect3DDevice9

IDirect3DDevice9::SetClipStatus