SDL_SetGPUTextureName - Man Page

Sets an arbitrary string constant to label a texture.

Header File

Defined in SDL3/SDL_gpu.h

Synopsis

#include "SDL3/SDL.h"

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

Description

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.

See Also

·(3), SDL_CreateGPUTexture(3)

Info

SDL 3.2.2 Simple Directmedia Layer SDL3 FUNCTIONS