---
name: "SDL_SetGPUTextureName"
section: "3"
platform: "linux"
package: "libsdl3-doc"
version: "3.2.10+ds-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/SDL_SetGPUTextureName"
---

# SDL\_SetGPUTextureName(3)

Sets an arbitrary string constant to label a texture.

## NAME

SDL\_SetGPUTextureName - 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)](/SDL_CreateGPUTexture/3.md)