SDL3/SDL_PushGPUVertexUniformData: Clarify that the reuse of uniform data applies only to the current command buffer

[SDLWikiBot]

This edit was made by @LittleCodingFox.

Live page is here: https://wiki.libsdl.org/SDL3/SDL_PushGPUVertexUniformData

If this user should be blocked from further edits, an admin should go to https://wiki.libsdl.org/LittleCodingFox/block
If this user should be trusted to make direct pushes to main, without a pull request, an admin should go to https://wiki.libsdl.org/LittleCodingFox/trust

WHETHER YOU MERGE OR REJECT THIS PULL REQUEST, DON'T FORGET TO DELETE THE BRANCH. Otherwise, LittleCodingFox won't be able to start a new PR for this page.

[LittleCodingFox]

Howdy, it's my first edit, hope it's okay!

I realized that the SDL GPU uniform data is reused across subsequent drawcalls only for the current command buffer, so I thought it'd be good to clarify that in the wiki.

[slouken]

@thatcosmonaut, @TheSpydog, is this correct?

[LittleCodingFox]

From what I saw in the code, the vulkan renderer at least, clears the uniform buffer data when a command buffer is acquired

SDL_gpu_vulkan.c:9566 (VULKAN_AcquireCommandBuffer), the uniform buffers are cleared

[thatcosmonaut]

This is correct, but the wording of "reuse" feels awkward to me. Also this should probably be applied to the other push uniform commands too.

[LittleCodingFox]

Perhaps I could change it to "Subsequent drawcalls in a command buffer will use previously submitted uniform data unless replaced"?

[thatcosmonaut]

I think "Subsequent draw calls in this command buffer will use this uniform data." is clear enough.

[LittleCodingFox]

Gotcha, how may I correct this? I've never used a wiki that works like this, hehe

[slouken]

Just do another edit and we’ll close these. Please make sure you update all the relevant calls.

Thanks!

[LittleCodingFox]

Updated! Seems it updates the PR

[slouken]

I went ahead and added that note for all the uniform functions. Thanks!