RenderScript カーネル呼び出し関数と型

ゼロ個以上の入力割り当てでカーネルを実行します。これらは rs_kernel 引数の後に渡されます。指定されたカーネルが値を返す場合、出力割り当てを最後の引数として指定する必要があります。すべての入力割り当てと出力割り当て（存在する場合）は、同じディメンションでなければなりません。

これは同期関数です。この関数の呼び出しは、入力割り当てのすべてのセルに対するすべての処理が完了した後にのみ戻ります。カーネル関数が任意の値を返した場合、すべての結果が出力割り当てに書き込まれるまで待機します。

API レベル 23 までは、カーネルは、指定されたスクリプトで「root」という名前のカーネルとして暗黙的に指定され、単一の入力割り当てしか使用できません。API レベル 24 以降では、kernel 引数で指定されたように、任意のカーネル関数を使用できます。スクリプト引数が削除されました。 カーネルは現在のスクリプトで定義する必要があります。また、複数の入力を使用できます。

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

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



カーネルを起動するための内部 API。

rsForEach と同様の方法でカーネルを起動します。ただし、この関数は入力内のすべてのセルを処理するのではなく、オプションで指定されたインデックス空間のサブスペース内のセルのみを処理します。オプションによってインデックス空間が明示的に指定されている場合、この API を使用してカーネルを起動するときに、入力または出力の割り当てを行う必要はありません。割り当てを渡す場合は、カーネル関数が期待する引数の数と戻り値と一致させる必要があります。出力割り当ては、カーネルに void 以外の戻り値がある場合にのみ存在します。

例:
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 インデックスなど）が含まれます。

このツールにアクセスするには、カーネル関数に rs_kernel_context タイプの「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 を返します。