瀏覽代碼

Sync SDL3 wiki -> header

[ci skip]
SDL Wiki Bot 2 周之前
父節點
當前提交
1d9fc5f2c8
共有 1 個文件被更改,包括 8 次插入0 次删除
  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
  * 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 color_target_infos an array of texture subresources with
  *                           corresponding clear values and load/store ops.