Experimental: this API is experimental and might be changed or removed in the future.

AsyncGPUReadback.Request

切换到手册
public static Experimental.Rendering.AsyncGPUReadbackRequest Request (ComputeBuffer src, int size, int offset);
public static Experimental.Rendering.AsyncGPUReadbackRequest Request (Texture src, int mipIndex);
public static Experimental.Rendering.AsyncGPUReadbackRequest Request (Texture src, int mipIndex, TextureFormat dstFormat);
public static Experimental.Rendering.AsyncGPUReadbackRequest Request (Texture src, int mipIndex, int x, int width, int y, int height, int z, int depth);
public static Experimental.Rendering.AsyncGPUReadbackRequest Request (Texture src, int mipIndex, int x, int width, int y, int height, int z, int depth, TextureFormat dstFormat);

参数

src要从中读取数据的资源。
size要从 ComputeBuffer 中检索的数据的大小(以字节为单位)。
offset ComputeBuffer 中的偏移量(以字节为单位)。
mipIndex要获取的 Mipmap 的索引。
dstFormat数据的目标 TextureFormat。如果该格式不同于 GPU 中存储的格式,则系统会自动执行转换。
x要获取的纹理数据的起始 X 坐标(以像素为单位)。
width要获取的纹理数据的宽度(以像素为单位)。
y要获取的纹理数据的起始 Y 坐标(以像素为单位)。
height要获取的纹理数据的高度(以像素为单位)。
z正在获取的 Texture3D 的起始 Z 坐标(以像素为单位)。正在获取的 TextureCube、Texture2DArray 和 TextureCubeArray 的起始层索引。
depth正在获取的 Texture3D 的深度(以像素为单位)。TextureCube、TextureArray 和 TextureCubeArray 的层数。

返回

AsyncGPUReadbackRequest 可用于访问数据并检查数据是否可用的 AsyncGPUReadbackRequest

描述

触发从 GPU 资源中异步获取数据的请求。

如果由于将某些无效参数传递给此方法而发生错误,则返回带有错误的请求。如果返回了带有错误的请求,则对该请求调用 AsyncGPUReadbackRequest.hasError 将返回 true。