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

Artigo
08/23/2023

Com base na indexação, renderiza o primitivo geométrico especificado em uma matriz de vértices.

Sintaxe

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

Membro do tipo enumerado D3DPRIMITIVETYPE , descrevendo o tipo de primitivo a ser renderizado. não há suporte para D3DPT_POINTLIST com esse método. Consulte Observações.

[in] BaseVertexIndex

Tipo: INT

Deslocamento do início do buffer de vértice para o primeiro vértice. Consulte Cenário 4.

[in] MinVertexIndex

Tipo: UINT

Índice de vértice mínimo para vértices usados durante essa chamada. Este é um índice baseado em zero em relação a BaseVertexIndex.

[in] NumVertices

Tipo: UINT

Número de vértices usados durante essa chamada. O primeiro vértice está localizado no índice: BaseVertexIndex + MinIndex.

[in] startIndex

Tipo: UINT

Índice do primeiro índice a ser usado ao acessar o buffer de vértice. Começando em StartIndex para indexar vértices do buffer de vértice.

[in] primCount

Tipo: UINT

Número de primitivos a serem renderizados. O número de vértices usados é uma função da contagem primitiva e do tipo primitivo. O número máximo de primitivos permitido é determinado verificando o membro MaxPrimitiveCount da estrutura D3DCAPS9 .

Valor retornado

Tipo: HRESULT

Se o método for bem-sucedido, o valor retornado será D3D_OK. Se o método falhar, o valor retornado poderá ser o seguinte: D3DERR_INVALIDCALL.

Comentários

Esse método desenha primitivos indexados do conjunto atual de fluxos de entrada de dados. MinIndex e todos os índices no fluxo de índice são relativos ao BaseVertexIndex.

Os parâmetros MinIndex e NumVertices especificam o intervalo de índices de vértice usados para cada chamada IDirect3DDevice9::D rawIndexedPrimitive . Eles são usados para otimizar o processamento de vértice de primitivos indexados processando um intervalo sequencial de vértices antes da indexação nesses vértices. Ele é inválido para todos os índices usados durante essa chamada para fazer referência a quaisquer vértices fora desse intervalo.

IDirect3DDevice9::D rawIndexedPrimitive falhará se nenhuma matriz de índice estiver definida.

Não há suporte para o membro D3DPT_POINTLIST do tipo enumerado D3DPRIMITIVETYPE e não é um tipo válido para esse método.

Ao converter um aplicativo herdado em Direct3D 9, você deve adicionar uma chamada a IDirect3DDevice9::SetFVF para usar o pipeline de função fixa ou IDirect3DDevice9::SetVertexDeclaration para usar um sombreador de vértice antes de fazer chamadas draw.