---
name: "SDL_DrawGPUIndexedPrimitives"
section: "3"
platform: "linux"
package: "libsdl3-doc"
version: "3.2.10+ds-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/SDL_DrawGPUIndexedPrimitives"
---

# SDL\_DrawGPUIndexedPrimitives(3)

Draws data using bound graphics state with an index buffer and instancing enabled.

## NAME

SDL\_DrawGPUIndexedPrimitives - Draws data using bound graphics state with an index buffer and instancing enabled.

## HEADER FILE

Defined in SDL3/SDL\_gpu.h

## SYNOPSIS

```
#include "SDL3/SDL.h"
```

**void SDL\_DrawGPUIndexedPrimitives(**     **SDL\_GPURenderPass \*render\_pass,**     **Uint32 num\_indices,**     **Uint32 num\_instances,**     **Uint32 first\_index,**     **Sint32 vertex\_offset,**     **Uint32 first\_instance);**

## DESCRIPTION

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); GPU APIs and shader languages do not define these built-in variables consistently, so if your shader depends on them, the only way to keep behavior consistent and portable is to always pass 0 for the correlating parameter in the draw calls.

## FUNCTION PARAMETERS

- *render\_pass*

  a render pass handle.

- *num\_indices*

  the number of indices to draw per instance.

- *num\_instances*

  the number of instances to draw.

- *first\_index*

  the starting index within the index buffer.

- *vertex\_offset*

  value added to vertex index before indexing into the vertex buffer.

- *first\_instance*

  the ID of the first instance to draw.

## AVAILABILITY

This function is available since SDL 3.2.0.