(This is the documentation for SDL3, which is the current stable version. SDL2 was the previous version!)

SDL_CreateGPUTransferBuffer

Creates a transfer buffer to be used when uploading to or downloading from graphics resources.

Header File

Defined in <SDL3/SDL_gpu.h>

Syntax

SDL_GPUTransferBuffer* SDL_CreateGPUTransferBuffer(
    SDL_GPUDevice *device,
    const SDL_GPUTransferBufferCreateInfo *createinfo);

Function Parameters

SDL_GPUDevice *	device	a GPU Context.
const SDL_GPUTransferBufferCreateInfo *	createinfo	a struct describing the state of the transfer buffer to create.

Return Value

(SDL_GPUTransferBuffer *) Returns a transfer buffer on success, or NULL on failure; call SDL_GetError() for more information.

Remarks

Download buffers can be particularly expensive to create, so it is good practice to reuse them if data will be downloaded regularly.

Version

This function is available since SDL 3.1.3.

See Also

• SDL_UploadToGPUBuffer
• SDL_DownloadFromGPUBuffer
• SDL_UploadToGPUTexture
• SDL_DownloadFromGPUTexture
• SDL_ReleaseGPUTransferBuffer

---

CategoryAPI, CategoryAPIFunction, CategoryGPU

[ front page | index | search | recent changes | git repo | offline html ]

All wiki content is licensed under Creative Commons Attribution 4.0 International (CC BY 4.0).
Wiki powered by ghwikipp.