---
name: "SDL_UploadToGPUTexture"
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_UploadToGPUTexture"
---

# SDL\_UploadToGPUTexture(3)

Uploads data from a transfer buffer to a texture.

## NAME

SDL\_UploadToGPUTexture - Uploads data from a transfer buffer to a texture.

## HEADER FILE

Defined in SDL3/SDL\_gpu.h

## SYNOPSIS

```
#include "SDL3/SDL.h"
```

**void SDL\_UploadToGPUTexture(**     **SDL\_GPUCopyPass \*copy\_pass,**     **const SDL\_GPUTextureTransferInfo \*source,**     **const SDL\_GPUTextureRegion \*destination,**     **bool cycle);**

## DESCRIPTION

The upload occurs on the GPU timeline. You may assume that the upload has finished in subsequent commands.

You must align the data in the transfer buffer to a multiple of the texel size of the texture format.

## FUNCTION PARAMETERS

- *copy\_pass*

  a copy pass handle.

- *source*

  the source transfer buffer with image layout information.

- *destination*

  the destination texture region.

- *cycle*

  if true, cycles the texture if the texture is bound, otherwise overwrites the data.

## AVAILABILITY

This function is available since SDL 3.2.0.