diff --git a/include/SDL3/SDL_gpu.h b/include/SDL3/SDL_gpu.h index 899297ef0..e20c443cb 100644 --- a/include/SDL3/SDL_gpu.h +++ b/include/SDL3/SDL_gpu.h @@ -3529,10 +3529,11 @@ extern SDL_DECLSPEC SDL_GPUTextureFormat SDLCALL SDL_GetGPUSwapchainTextureForma * freed by the user. You MUST NOT call this function from any thread other * than the one that created the window. * - * When using SDL_GPU_PRESENTMODE_VSYNC, this function will block if too many frames are in flight. - * Otherwise, this function will fill the swapchain texture handle with NULL if too many frames are in flight. - * The best practice is to call SDL_CancelGPUCommandBuffer if the swapchain texture handle is NULL - * to avoid enqueuing needless work on the GPU. + * When using SDL_GPU_PRESENTMODE_VSYNC, this function will block if too many + * frames are in flight. Otherwise, this function will fill the swapchain + * texture handle with NULL if too many frames are in flight. The best + * practice is to call SDL_CancelGPUCommandBuffer if the swapchain texture + * handle is NULL to avoid enqueuing needless work on the GPU. * * \param command_buffer a command buffer. * \param window a window that has been claimed. @@ -3611,12 +3612,15 @@ extern SDL_DECLSPEC SDL_GPUFence *SDLCALL SDL_SubmitGPUCommandBufferAndAcquireFe SDL_GPUCommandBuffer *command_buffer); /** - * Cancels a command buffer. None of the enqueued commands are executed. + * Cancels a command buffer. + * + * None of the enqueued commands are executed. * * This must be called from the thread the command buffer was acquired on. * - * You must not reference the command buffer after calling this function. - * It is an error to call this function after a swapchain texture has been acquired. + * You must not reference the command buffer after calling this function. It + * is an error to call this function after a swapchain texture has been + * acquired. * * \param command_buffer a command buffer. * \returns true on success, false on error; call SDL_GetError() for more