Método IDirect3DDevice9::D rawRectPatch (d3d9.h)

Artículo
08/23/2023

Dibuja una revisión rectangular mediante los flujos establecidos actualmente.

Sintaxis

HRESULT DrawRectPatch(
  [in] UINT                    Handle,
  [in] const float             *pNumSegs,
  [in] const D3DRECTPATCH_INFO *pRectPatchInfo
);

Parámetros

[in] Handle

Tipo: UINT

Controle la revisión rectangular que se va a dibujar.

[in] pNumSegs

Tipo: const float*

Puntero a una matriz de cuatro valores de punto flotante que identifican el número de segmentos en los que se debe dividir cada borde de la revisión de rectángulo cuando se tesela. Consulte D3DRECTPATCH_INFO.

[in] pRectPatchInfo

Tipo: const D3DRECTPATCH_INFO*

Puntero a una estructura D3DRECTPATCH_INFO , que describe la revisión rectangular que se va a dibujar.

Valor devuelto

Tipo: HRESULT

Si el método se ejecuta correctamente, el valor devuelto es D3D_OK. Si se produce un error en el método, el valor devuelto se puede D3DERR_INVALIDCALL.

Comentarios

Para las revisiones estáticas: establezca el sombreador de vértices, establezca las secuencias adecuadas, proporcione información de revisión en el parámetro pRectPatchInfo y especifique un identificador para que Direct3D pueda capturar y almacenar en caché información. Llame a IDirect3DDevice9::D rawRectPatch posteriormente con pRectPatchInfo establecido en NULL para dibujar eficazmente la revisión. Al dibujar una revisión almacenada en caché, se omiten las secuencias establecidas actualmente. Invalide el valor pNumSegs almacenado en caché especificando un nuevo valor para pNumSegs. Al representar una revisión almacenada en caché, debe establecer el mismo sombreador de vértices que se estableció cuando se capturó.

Llamar a IDirect3DDevice9::D rawRectPatch con un identificador invalida el mismo identificador almacenado en caché por una llamada IDirect3DDevice9::D rawTriPatch .

En el caso de las revisiones dinámicas, los datos de revisión cambian para cada representación de la revisión, por lo que no es eficaz almacenar en caché la información. La aplicación puede transmitir esto a Direct3D estableciendo Identificador en 0. En este caso, Direct3D dibuja la revisión con los flujos establecidos actualmente y los valores pNumSegs, y no almacena en caché ninguna información. No es válido establecer simultáneamente Handle en 0 y pRectPatchInfo en NULL.