Version: 2023.1

AsyncGPUReadbackRequest

struct in UnityEngine.Rendering

切换到手册

描述

表示 GPU 资源的异步请求。

使用 AsyncGPUReadback.Request 检索 GPU 资源的异步请求。 每帧自动更新待处理请求。只有成功完成的单个帧才能访问结果,然后在下一帧中处理此请求。 常见用途是在每一帧(或在协同程序中)查询 AsyncGPUReadbackRequest.done,然后在 AsyncGPUReadbackRequest.hasError 为 false 时调用 AsyncGPUReadbackRequest.GetData。 您无需管理请求生命周期,因为这是在内部进行管理。已处理的请求将导致 AsyncGPUReadbackRequest.hasError 属性为 true。 另请参阅:AsyncGPUReadback

变量

depth从 ComputeBuffer 读取数据时,深度为 1,否则,属性将从纹理中获取所请求深度的值。
done检查请求是否已被处理。
forcePlayerLoopUpdateIn the Editor, defines whether the Player loop is updated while the GPU request is in flight.
hasError如果请求出现错误,则此属性为 true。
height从 ComputeBuffer 读取数据时,高度为 1,否则,属性将从纹理中获取所请求高度的值。
layerCount当前请求中的层数。
layerDataSize一层回读数据的大小(以字节为单位)。
width请求的 GPU 数据的宽度。

公共函数

GetData获取成功请求的数据。
Update触发请求的更新。
WaitForCompletion等待请求完成。