SDL_CreateGPURenderState

Create custom GPU render state.

Header File

Defined in <SDL3/SDL_render.h>

Syntax

SDL_GPURenderState * SDL_CreateGPURenderState(SDL_Renderer *renderer, SDL_GPURenderStateDesc *desc);

Function Parameters

SDL_Renderer * renderer the renderer to use.
SDL_GPURenderStateDesc * desc GPU render state description, initialized using SDL_INIT_INTERFACE().

Return Value

(SDL_GPURenderState *) Returns a custom GPU render state or NULL on failure; call SDL_GetError() for more information.

Thread Safety

This function should be called on the thread that created the renderer.

Version

This function is available since SDL 3.4.0.

See Also

CategoryAPI, CategoryAPIFunction, CategoryRender