RenderScript 核心叫用函式和類型

以零或多個輸入分配方式執行核心。這些函式會在 rs_kernel 引數後方傳遞。如果指定的核心傳回值，則須將輸出分配指定為最後一個引數。所有輸入配置和輸出分配 (如有) 都必須具有相同的維度。

這是一個同步函式。只有在所有輸入分配儲存格完成工作後，系統才會傳回此函式的呼叫。如果核心函式傳回任何值，呼叫會等到所有結果寫入輸出分配為止。

在 API 級別 23 以下的指定指令碼中，系統會以隱含方式將核心指定為名為「root」的核心，而且只能使用單一輸入分配。從 API 級別 24 開始，您可以按照核心引數指定的方式使用任意核心函式。已移除指令碼引數。您必須在目前的指令碼中定義核心。此外，您也可以使用多個輸入。

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

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



用來啟動核心的內部 API。

以類似 rsForEach 的方式啟動核心。但是，這個函式只會處理選項中指定的索引空間子空間中的儲存格，而非處理輸入中的所有儲存格。有了選項明確指定的索引空間後，使用這個 API 啟動核心時就不需要輸入或輸出分配。如果傳入配置，這些配置必須與核心函式預期的引數數量和回傳值相符。只有在核心具有非空值回傳值時，才會顯示輸出分配情形。

例如：
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 維度中的索引。

核心結構定義包含要重複使用的配置作業特性，以及極少使用的索引，例如 Array0 索引。

您可以在核心函式中新增類型為 rs_kernel_context 的特殊參數「context」，來存取核心結構定義。例如：
short RS_KERNEL myKernel(short value, uint32_t x, rs_kernel_context context) {
  // The current index in the common x, y, z dimensions are accessed by
  // adding these variables as arguments. For the more rarely used indices
  // to the other dimensions, extract them from the kernel context:
  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。

如果核心針對方塊對應進行疊代，如果存在多個臉孔，此函式會傳回 true。在所有其他情況下，則會傳回 false。如需結構定義的說明，請參閱 rsGetDimX()。

rsAllocationGetDimFaces() 類似，但會傳回 0 或 1，而非布林值。

傳回指定核心結構定義的詳細程度。這對 mipmap 來說相當實用。如要瞭解背景資訊，請參閱 rsGetDimX()。

如果未使用詳細資料層級，系統會傳回 0。

rsAllocationGetDimLOD() 類似，但會傳回 0 或 1，而非實際數量。

傳回指定核心結構定義的 X 維度大小。

核心結構定義包含要重複使用的配置作業特性，以及極少使用的索引，例如 Array0 索引。

您可以藉由在核心函式中新增名為「context」的 rs_kernel_context 類型特殊參數來存取此參數。例如：
int4 RS_KERNEL myKernel(int4 value, rs_kernel_context context) {
  uint32_t size = rsGetDimX(context); //...


如要取得特定分配的維度，請使用 rsAllocationGetDimX()。

傳回指定核心結構定義的 X 維度大小。 如要瞭解背景資訊，請參閱 rsGetDimX()。

如果沒有 Y 維度，系統會傳回 0。

如要取得特定分配的維度，請使用 rsAllocationGetDimY()。

傳回指定核心結構定義的 Z 維度大小。 如要瞭解背景資訊，請參閱 rsGetDimX()。

如果沒有 Z 維度，則傳回 0。

如要取得特定分配的維度，請使用 rsAllocationGetDimZ()。

根據提供的核心結構定義中的指定，傳回系統找到處理中儲存格的臉孔。如要瞭解背景資訊，請參閱 rsGetArray0()。

如果臉孔尺寸不存在，則傳回 RS_ALLOCATION_CUBEMAP_FACE_POSITIVE_X。

針對要處理的儲存格，傳回處理中儲存格「詳細層級」維度的索引，如提供的核心結構定義所示。如需背景資訊的說明，請參閱 rsGetArray0()。

如果沒有「詳細資料層級」維度，系統會傳回 0。