SDL_CreateGPUDevice

Creates a GPU context.

Header File

Defined in <SDL3/SDL_gpu.h>

Syntax

SDL_GPUDevice * SDL_CreateGPUDevice(
    SDL_GPUShaderFormat format_flags,
    bool debug_mode,
    const char *name);

Function Parameters

SDL_GPUShaderFormat	format_flags	a bitflag indicating which shader formats the app is able to provide.
bool	debug_mode	enable debug mode properties and validations.
const char *	name	the preferred GPU driver, or NULL to let SDL pick the optimal driver.

Return Value

(SDL_GPUDevice *) Returns a GPU context on success or NULL on failure; call SDL_GetError() for more information.

Remarks

The GPU driver name can be one of the following:

• "vulkan": Vulkan
• "direct3d12": D3D12
• "metal": Metal
• NULL: let SDL pick the optimal driver

Version

This function is available since SDL 3.2.0.

See Also

• SDL_CreateGPUDeviceWithProperties
• SDL_GetGPUShaderFormats
• SDL_GetGPUDeviceDriver
• SDL_DestroyGPUDevice
• SDL_GPUSupportsShaderFormats

---

CategoryAPI, CategoryAPIFunction, CategoryGPU

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