SDL_GPUTextureSupportsFormat - Man Page

Determines whether a texture format is supported for a given type and usage.

Header File

Defined in SDL3/SDL_gpu.h

Synopsis

#include "SDL3/SDL.h"

bool SDL_GPUTextureSupportsFormat(
    SDL_GPUDevice *device,
    SDL_GPUTextureFormat format,
    SDL_GPUTextureType type,
    SDL_GPUTextureUsageFlags usage);

Function Parameters

device

a GPU context.

format

the texture format to check.

type

the type of texture (2D, 3D, Cube).

usage

a bitmask of all usage scenarios to check.

Return Value

Returns whether the texture format is supported for this type and usage.

Availability

This function is available since SDL 3.2.0.

Referenced By

SDL_CreateGPUTexture(3), SDL_GPUTextureFormat.3type(3).

SDL 3.2.2 Simple Directmedia Layer SDL3 FUNCTIONS