(This is the documentation for SDL3, which is the current stable version. SDL2 was the previous version!)

SDL_DrawGPUPrimitives

Draws data using bound graphics state.

Header File

Defined in <SDL3/SDL_gpu.h>

Syntax

void SDL_DrawGPUPrimitives(
    SDL_GPURenderPass *render_pass,
    Uint32 num_vertices,
    Uint32 num_instances,
    Uint32 first_vertex,
    Uint32 first_instance);

Function Parameters

SDL_GPURenderPass *	render_pass	a render pass handle.
Uint32	num_vertices	the number of vertices to draw.
Uint32	num_instances	the number of instances that will be drawn.
Uint32	first_vertex	the index of the first vertex to draw.
Uint32	first_instance	the ID of the first instance to draw.

Remarks

You must not call this function before binding a graphics pipeline.

Note that the first_vertex and first_instance parameters are NOT compatible with built-in vertex/instance ID variables in shaders (for example, SV_VertexID). If your shader depends on these variables, the correlating draw call parameter MUST be 0.

Version

This function is available since SDL 3.1.3.

---

CategoryAPI, CategoryAPIFunction, CategoryGPU

[ front page | index | search | recent changes | git repo | offline html ]

All wiki content is licensed under Creative Commons Attribution 4.0 International (CC BY 4.0).
Wiki powered by ghwikipp.