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

Artículo
08/23/2023

En función de la indexación, representa el primitivo geométrico especificado en una matriz de vértices.

Sintaxis

HRESULT DrawIndexedPrimitive(
  [in] D3DPRIMITIVETYPE unnamedParam1,
  [in] INT              BaseVertexIndex,
  [in] UINT             MinVertexIndex,
  [in] UINT             NumVertices,
  [in] UINT             startIndex,
  [in] UINT             primCount
);

Parámetros

[in] unnamedParam1

Tipo: D3DPRIMITIVETYPE

Miembro del tipo enumerado D3DPRIMITIVETYPE , que describe el tipo de primitivo que se va a representar. D3DPT_POINTLIST no se admite con este método. Vea la sección Comentarios.

[in] BaseVertexIndex

Tipo: INT

Desplazamiento desde el principio del búfer de vértices hasta el primer vértice. Consulte escenario 4.

[in] MinVertexIndex

Tipo: UINT

Índice mínimo de vértices para vértices usados durante esta llamada. Se trata de un índice de base cero con respecto a BaseVertexIndex.

[in] NumVertices

Tipo: UINT

Número de vértices usados durante esta llamada. El primer vértice se encuentra en el índice: BaseVertexIndex + MinIndex.

[in] startIndex

Tipo: UINT

Índice del primer índice que se va a usar al acceder al búfer de vértices. A partir de StartIndex para indexar vértices desde el búfer de vértices.

[in] primCount

Tipo: UINT

Número de primitivos que se van a representar. El número de vértices utilizados es una función del recuento primitivo y del tipo primitivo. El número máximo de primitivos permitidos se determina comprobando el miembro MaxPrimitiveCount de la estructura D3DCAPS9 .

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 puede ser el siguiente: D3DERR_INVALIDCALL.

Comentarios

Este método dibuja primitivos indexados del conjunto actual de flujos de entrada de datos. MinIndex y todos los índices del flujo de índice son relativos a BaseVertexIndex.

Los parámetros MinIndex y NumVertices especifican el intervalo de índices de vértice usados para cada llamada IDirect3DDevice9::D rawIndexedPrimitive . Se usan para optimizar el procesamiento de vértices de primitivos indexados mediante el procesamiento de un intervalo secuencial de vértices antes de indexar en estos vértices. No es válido para los índices usados durante esta llamada para hacer referencia a los vértices fuera de este intervalo.

IDirect3DDevice9::D rawIndexedPrimitive produce un error si no se establece ninguna matriz de índices.

No se admite el miembro D3DPT_POINTLIST del tipo enumerado D3DPRIMITIVETYPE y no es un tipo válido para este método.

Al convertir una aplicación heredada en Direct3D 9, debes agregar una llamada a IDirect3DDevice9::SetFVF para usar la canalización de función fija o IDirect3DDevice9::SetVertexDeclaration para usar un sombreador de vértices antes de realizar llamadas a Draw.