SDL_WaitAndAcquireGPUSwapchainTexture - Man Page

Defined in SDL3/SDL_gpu.h

#include "SDL3/SDL.h"

bool SDL_WaitAndAcquireGPUSwapchainTexture(
    SDL_GPUCommandBuffer *command_buffer,
    SDL_Window *window,
    SDL_GPUTexture **swapchain_texture,
    Uint32 *swapchain_texture_width,
    Uint32 *swapchain_texture_height);

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. It is an error to call

SDL_CancelGPUCommandBuffer () after a swapchain texture is acquired.

This function can fill the swapchain texture handle with NULL in certain cases, for example if the window is minimized. This is not an error. You should always make sure to check whether the pointer is NULL before actually using it.

The swapchain 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.

command_buffer

a command buffer.

window

a window that has been claimed.

swapchain_texture

a pointer filled in with a swapchain texture handle.

swapchain_texture_width

a pointer filled in with the swapchain texture width, may be NULL.

swapchain_texture_height

a pointer filled in with the swapchain texture height, may be NULL.

Returns true on success, false on error; call

SDL_GetError () for more information.

This function should only be called from the thread that created the window.

This function is available since SDL 3.2.0.

·(3), SDL_SubmitGPUCommandBuffer(3), ·(3), SDL_SubmitGPUCommandBufferAndAcquireFence(3)

SDL_AcquireGPUSwapchainTexture(3), SDL_CancelGPUCommandBuffer(3), SDL_ClaimWindowForGPUDevice(3), SDL_GPUPresentMode.3type(3), SDL_GPUSwapchainComposition.3type(3), SDL_SubmitGPUCommandBuffer(3), SDL_SubmitGPUCommandBufferAndAcquireFence(3), SDL_WaitForGPUSwapchain(3).