Metodo ID3D12GraphicsCommandList::D rawInstanced (d3d12.h)

Disegna primitive non indicizzate e istanze.

Sintassi

void DrawInstanced(
  [in] UINT VertexCountPerInstance,
  [in] UINT InstanceCount,
  [in] UINT StartVertexLocation,
  [in] UINT StartInstanceLocation
);

Parametri

[in] VertexCountPerInstance

Tipo: UINT

Numero di vertici da disegnare.

[in] InstanceCount

Tipo: UINT

Numero di istanze da disegnare.

[in] StartVertexLocation

Tipo: UINT

Indice del primo vertice.

[in] StartInstanceLocation

Tipo: UINT

Valore aggiunto a ogni indice prima di leggere i dati per istanza da un vertex buffer.

Valore restituito

nessuno

Osservazioni

Un'API di disegno invia il lavoro alla pipeline di rendering.

La creazione di istanze può estendere le prestazioni riutilizzando la stessa geometria per disegnare più oggetti in una scena. Un esempio di creazione di istanze può essere quello di disegnare lo stesso oggetto con posizioni e colori diversi.

I dati dei vertici per una chiamata di disegno di istanza provengono in genere da un buffer dei vertici associato alla pipeline. Tuttavia, è anche possibile fornire i dati dei vertici da uno shader con dati di istanza identificati con una semantica del valore di sistema (SV_InstanceID).

Esempio

L'esempio D3D12HelloTriangle usa ID3D12GraphicsCommandList::D rawInstanced come indicato di seguito:

D3D12_VIEWPORT m_viewport;
D3D12_RECT m_scissorRect;
ComPtr<IDXGISwapChain3> m_swapChain;
ComPtr<ID3D12Device> m_device;
ComPtr<ID3D12Resource> m_renderTargets[FrameCount];
ComPtr<ID3D12CommandAllocator> m_commandAllocator;
ComPtr<ID3D12CommandQueue> m_commandQueue;
ComPtr<ID3D12RootSignature> m_rootSignature;
ComPtr<ID3D12DescriptorHeap> m_rtvHeap;
ComPtr<ID3D12PipelineState> m_pipelineState;
ComPtr<ID3D12GraphicsCommandList> m_commandList;
UINT m_rtvDescriptorSize;

void D3D12HelloTriangle::PopulateCommandList()
{
    // Command list allocators can only be reset when the associated 
    // command lists have finished execution on the GPU; apps should use 
    // fences to determine GPU execution progress.
    ThrowIfFailed(m_commandAllocator->Reset());

    // However, when ExecuteCommandList() is called on a particular command 
    // list, that command list can then be reset at any time and must be before 
    // re-recording.
    ThrowIfFailed(m_commandList->Reset(m_commandAllocator.Get(), m_pipelineState.Get()));

    // Set necessary state.
    m_commandList->SetGraphicsRootSignature(m_rootSignature.Get());
    m_commandList->RSSetViewports(1, &m_viewport);
    m_commandList->RSSetScissorRects(1, &m_scissorRect);

    // Indicate that the back buffer will be used as a render target.
    m_commandList->ResourceBarrier(1, &CD3DX12_RESOURCE_BARRIER::Transition(m_renderTargets[m_frameIndex].Get(), D3D12_RESOURCE_STATE_PRESENT, D3D12_RESOURCE_STATE_RENDER_TARGET));

    CD3DX12_CPU_DESCRIPTOR_HANDLE rtvHandle(m_rtvHeap->GetCPUDescriptorHandleForHeapStart(), m_frameIndex, m_rtvDescriptorSize);
    m_commandList->OMSetRenderTargets(1, &rtvHandle, FALSE, nullptr);

    // Record commands.
    const float clearColor[] = { 0.0f, 0.2f, 0.4f, 1.0f };
    m_commandList->ClearRenderTargetView(rtvHandle, clearColor, 0, nullptr);
    m_commandList->IASetPrimitiveTopology(D3D_PRIMITIVE_TOPOLOGY_TRIANGLELIST);
    m_commandList->IASetVertexBuffers(0, 1, &m_vertexBufferView);
    m_commandList->DrawInstanced(3, 1, 0, 0);

    // Indicate that the back buffer will now be used to present.
    m_commandList->ResourceBarrier(1, &CD3DX12_RESOURCE_BARRIER::Transition(m_renderTargets[m_frameIndex].Get(), D3D12_RESOURCE_STATE_RENDER_TARGET, D3D12_RESOURCE_STATE_PRESENT));

    ThrowIfFailed(m_commandList->Close());
}

Vedere Codice di esempio nel riferimento D3D12.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Windows
Intestazione	d3d12.h
Libreria	D3d12.lib
DLL	D3d12.dll

Vedi anche

ID3D12GraphicsCommandList