SDL_SetGPUTextureName(3)

SDL_SetGPUTextureName3

Sets an arbitrary string constant to label a texture.

Usage

#include "SDL3/SDL.h"

void SDL_SetGPUTextureName( SDL_GPUDevice *device, SDL_GPUTexture *texture, const char *text);

Header file

Defined in SDL3/SDL_gpu.h

Overview

You should use

SDL_PROP_GPU_TEXTURE_CREATE_NAME_STRING

with SDL_CreateGPUTexture
instead of this function to avoid thread safety issues.

Function parameters

device

a GPU Context.

texture

a texture to attach the name to.

text

a UTF-8 string constant to mark as the name of the texture.

Thread safety

This function is not thread safe, you must make sure the texture is not simultaneously used by any other thread.

Availability

This function is available since SDL 3.2.0.

From libsdl3-doc 3.2.10+ds-1 in Debian 13 (Trixie). Parsed by carta from the page's man source.