RenderScript 内核调用函数和类型

在零个或多个输入 allocation 上运行内核。它们在 rs_kernel 参数之后传递。如果指定的内核返回值，则必须将输出 allocation 指定为最后一个参数。所有输入 allocation（如果存在输出 allocation，则包括输出 allocation）必须具有相同的维度。

这是一个同步函数。对此函数的调用只有在所有输入 allocation 的所有单元工作完成后才会返回。如果内核函数返回任何值，则调用会等待直到所有结果都已写入输出 allocation。

在 API level 23 及之前，内核隐式指定为指定脚本中名为 "root" 的内核，并且只能使用一个输入 allocation。从 API level 24 开始，可以使用任意内核函数，由 kernel 参数指定。script 参数被移除。内核必须在当前脚本中定义。此外，可以使用多个输入。

例如：
float __attribute__((kernel)) square(float a) {
  return a * a;
}

void compute(rs_allocation ain, rs_allocation aout) {
  rsForEach(square, ain, aout);
}



内部 API，用于启动内核。

以类似于 rsForEach 的方式启动内核。但是，此函数不处理输入中的所有单元，而只处理 options 中指定的索引空间的子空间中的单元。由于索引空间由 options 显式指定，因此使用此 API 启动内核不需要输入或输出 allocation。如果传入了 allocation，它们必须与内核函数期望的参数数量和返回值匹配。仅当内核具有非 void 返回值时，输出 allocation 才存在。

例如：
rs_script_call_t opts = {0};
opts.xStart = 0;
opts.xEnd = dimX;
opts.yStart = 0;
opts.yEnd = dimY / 2;
rsForEachWithOptions(foo, &opts, out, out);


返回正在处理的单元的 Array0 维度中的索引，由提供的内核上下文指定。

内核上下文包含正在迭代的 allocation 的共同特性和很少使用的索引，如 Array0 索引。

您可以通过向内核函数添加一个名为 "context" 的特殊参数（类型为 rs_kernel_context）来访问内核上下文。例如：
short RS_KERNEL myKernel(short value, uint32_t x, rs_kernel_context context) {
  // 通过添加这些变量作为参数来访问常见的 x, y, z 维度中的当前索引
  // 。对于其他维度中很少使用的索引
  // ，从内核上下文提取它们
  uint32_t index_a0 = rsGetArray0(context);
  //...
}


如果 Array0 维度不存在，此函数返回 0。

返回正在处理的单元的 Array1 维度中的索引，由提供的内核上下文指定。请参阅 rsGetArray0() 以获取上下文说明。

如果 Array1 维度不存在，返回 0。

返回正在处理的单元的 Array2 维度中的索引，由提供的内核上下文指定。请参阅 rsGetArray0() 以获取上下文说明。

如果 Array2 维度不存在，返回 0。

返回正在处理的单元的 Array3 维度中的索引，由提供的内核上下文指定。请参阅 rsGetArray0() 以获取上下文说明。

如果 Array3 维度不存在，返回 0。

返回指定内核上下文的 Array0 维度的尺寸。请参阅 rsGetDimX() 以获取上下文说明。

如果 Array0 维度不存在，返回 0。

返回指定内核上下文的 Array1 维度的尺寸。请参阅 rsGetDimX() 以获取上下文说明。

如果 Array1 维度不存在，返回 0。

返回指定内核上下文的 Array2 维度的尺寸。请参阅 rsGetDimX() 以获取上下文说明。

如果 Array2 维度不存在，返回 0。

返回指定内核上下文的 Array3 维度的尺寸。请参阅 rsGetDimX() 以获取上下文说明。

如果 Array3 维度不存在，返回 0。

如果内核正在迭代 cubemap，则此函数在存在多个面时返回 true。在所有其他情况下，返回 false。请参阅 rsGetDimX() 以获取上下文说明。

rsAllocationGetDimFaces() 类似，但返回 0 或 1，而不是 bool。

返回指定内核上下文的详细级别数。这对于 mipmap 非常有用。请参阅 rsGetDimX() 以获取上下文说明。

如果未使用详细级别，返回 0。

rsAllocationGetDimLOD() 类似，但返回 0 或 1，而不是实际的级别数。

返回指定内核上下文的 X 维度的尺寸。

内核上下文包含正在迭代的 allocation 的共同特性和很少使用的索引，如 Array0 索引。

您可以通过向内核函数添加一个名为 "context" 的特殊参数（类型为 rs_kernel_context）来访问它。例如：
int4 RS_KERNEL myKernel(int4 value, rs_kernel_context context) {
  uint32_t size = rsGetDimX(context); //...


要获取特定 allocation 的维度，请使用 rsAllocationGetDimX()。

返回指定内核上下文的 X 维度的尺寸。请参阅 rsGetDimX() 以获取上下文说明。

如果 Y 维度不存在，返回 0。

要获取特定 allocation 的维度，请使用 rsAllocationGetDimY()。

返回指定内核上下文的 Z 维度的尺寸。请参阅 rsGetDimX() 以获取上下文说明。

如果 Z 维度不存在，返回 0。

要获取特定 allocation 的维度，请使用 rsAllocationGetDimZ()。

返回找到正在处理的单元的面，由提供的内核上下文指定。请参阅 rsGetArray0() 以获取上下文说明。

如果面维度不存在，返回 RS_ALLOCATION_CUBEMAP_FACE_POSITIVE_X。

返回正在处理的单元的详细级别维度中的索引，由提供的内核上下文指定。请参阅 rsGetArray0() 以获取上下文说明。

如果详细级别维度不存在，返回 0。