Método IDirect3DDevice9::GetClipStatus (d3d9.h)
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 ejecuta 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.
IDirect3DDevice9::D rawRectPatch y IDirect3DDevice9::D rawTriPatch no actualizan el estado del clip porque no hay 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 | d3d9.h (incluya D3D9.h) |
| Library | D3D9.lib |