Ver Fonte

Sync SDL3 wiki -> header

[ci skip]
SDL Wiki Bot há 1 semana atrás
pai
commit
1d9fc5f2c8
1 ficheiros alterados com 8 adições e 0 exclusões
  1. 8 0
      include/SDL3/SDL_gpu.h

+ 8 - 0
include/SDL3/SDL_gpu.h

@@ -3125,6 +3125,14 @@ extern SDL_DECLSPEC void SDLCALL SDL_PushGPUComputeUniformData(
  * is called. You cannot begin another render pass, or begin a compute pass or
  * is called. You cannot begin another render pass, or begin a compute pass or
  * copy pass until you have ended the render pass.
  * copy pass until you have ended the render pass.
  *
  *
+ * Using SDL_GPU_LOADOP_LOAD before any contents have been written to the
+ * texture subresource will result in undefined behavior. SDL_GPU_LOADOP_CLEAR
+ * will set the contents of the texture subresource to a single value before
+ * any rendering is performed. It's fine to do an empty render pass using
+ * SDL_GPU_STOREOP_STORE to clear a texture, but in general it's better to
+ * think of clearing not as an independent operation but as something that's
+ * done as the beginning of a render pass.
+ *
  * \param command_buffer a command buffer.
  * \param command_buffer a command buffer.
  * \param color_target_infos an array of texture subresources with
  * \param color_target_infos an array of texture subresources with
  *                           corresponding clear values and load/store ops.
  *                           corresponding clear values and load/store ops.