Acquire a texture to use in presentation.
Defined in <SDL3/SDL_gpu.h>
SDL_GPUTexture* SDL_AcquireGPUSwapchainTexture(
SDL_GPUCommandBuffer *command_buffer,
SDL_Window *window,
Uint32 *w, Uint32 *h);
SDL_GPUCommandBuffer * | command_buffer | a command buffer. |
SDL_Window * | window | a window that has been claimed. |
Uint32 * | w | a pointer filled in with the swapchain width. |
Uint32 * | h | a pointer filled in with the swapchain height. |
(SDL_GPUTexture *) Returns a swapchain texture.
When a swapchain texture is acquired on a command buffer, it will automatically be submitted for presentation when the command buffer is submitted. The swapchain texture should only be referenced by the command buffer used to acquire it. May return NULL under certain conditions. This is not necessarily an error. This texture is managed by the implementation and must not be freed by the user. You MUST NOT call this function from any thread other than the one that created the window.
This function is available since SDL 3.0.0.