RenderScript 分配数据访问函数

将指定数量的单元从一个分配复制到另一个分配。

这两个分配必须不同。使用此函数在同一个分配内进行复制将导致未定义的结果。

该函数不验证偏移量加数量是否超出任一分配的大小。请务必小心！

此函数只能用于 1D 分配之间的复制。在其他分配上调用它将导致未定义的结果。

不应在内核内部调用此函数，也不应在任何可能直接或间接从内核调用的函数中调用此函数。这样做将导致运行时错误。

将一个矩形区域的单元从一个分配复制到另一个分配。(width * height) 个单元将被复制。

这两个分配必须不同。使用此函数在同一个分配内进行复制将导致未定义的结果。

该函数不验证源或目标区域是否超出各自分配的大小。请务必小心！

此函数只能用于 2D 分配之间的复制。在其他分配上调用它将导致未定义的结果。

不应在内核内部调用此函数，也不应在任何可能直接或间接从内核调用的函数中调用此函数。这样做将导致运行时错误。

此函数返回一个由分配的连续单元组成的向量。它假定分配包含标量。

名称中的“X”表示通过增加 X 索引来提取连续的值。目前没有函数可以获取递增其他维度的连续值。请改为多次调用 rsGetElementAt()。

例如，当调用 rsAllocationVLoadX_int4(a, 20, 30) 时，将返回一个由 a[20, 30]、a[21, 30]、a[22, 30] 和 a[23, 30] 组成的 int4。

从三维分配中检索时，请使用包含 x、y、z 的变体。类似地，对于二维分配，请使用包含 x、y 的变体；对于一维分配，请使用 x。

为了效率，此函数不验证输入。尝试环绕 X 索引、超出分配大小或使用与分配维度不兼容的索引将导致未定义的结果。

另请参阅 rsAllocationVStoreX()。

此函数将向量的条目存储到分配的连续单元格中。它假设分配包含标量。

名称中的“X”表示通过增加 X 索引来存储连续值。目前没有函数可以存储递增其他维度的连续值。请改为使用多个 rsSetElementAt() 调用。

例如，当调用 rsAllocationVStoreX_int3(a, v, 20, 30) 时，v.x 存储在 a[20, 30]，v.y 存储在 a[21, 30]，v.z 存储在 a[22, 30]。

存储到三维分配中时，请使用 x, y, z 变体。类似地，二维分配使用 x, y 变体，一维分配使用 x 变体。

为了提高效率，此函数不验证输入。尝试封装 X 索引、超出分配大小或使用与分配维度不兼容的索引会导致未定义的结果。

另请参阅 rsAllocationVLoadX()。

此函数从分配中提取单个单元格。

从三维分配中检索时，请使用包含 x、y、z 的变体。类似地，对于二维分配，请使用包含 x、y 的变体；对于一维分配，请使用 x。

此函数有两种样式。一种使用 void* 返回值的地址，另一种返回实际值，例如 rsGetElementAt() 与 rsGetElementAt_int4()。对于原始类型，请始终使用后一种样式，因为它更高效。

从 YUV 的二维分配中提取单个 YUV 值的 U 分量。

在分配内部，Y、U 和 V 分量可以存储在不同的平面中，并具有不同的分辨率。此处提供的 x、y 坐标位于 Y 平面的维度中。

请参阅 rsGetElementAtYuv_uchar_Y()。

从 YUV 的二维分配中提取单个 YUV 值的 V 分量。

在分配内部，Y、U 和 V 分量可以存储在不同的平面中，并具有不同的分辨率。此处提供的 x、y 坐标位于 Y 平面的维度中。

请参阅 rsGetElementAtYuv_uchar_Y()。

从 YUV 的二维分配中提取单个 YUV 值的 Y 分量。

在分配内部，Y、U 和 V 分量可以存储在不同的平面中，并具有不同的分辨率。此处提供的 x、y 坐标位于 Y 平面的维度中。

请参阅 rsGetElementAtYuv_uchar_U() 和 rsGetElementAtYuv_uchar_V()。

按照采样器描述的方式从纹理分配中获取一个值。

如果您的分配是一维的，请使用 location 参数类型为 float 的变体。对于二维，请使用 float2 变体。

有关更多详细信息，请参阅 android.renderscript.Sampler。

此函数将值存储到分配中的单个单元格中。

存储到三维分配中时，请使用 x, y, z 变体。类似地，二维分配使用 x, y 变体，一维分配使用 x 变体。

此函数有两种调用方式。一种使用 void* 传递要存储的值，另一种将实际值作为参数，例如 rsSetElementAt() 与 rsSetElementAt_int4()。对于基本类型，始终使用后者，因为它更高效。

另请参阅 rsGetElementAt()。