Tipos y funciones de invocación del kernel de RenderScript

Ejecuta el kernel en cero o más asignaciones de entrada. Se pasan después del argumento rs_kernel. Si el kernel especificado muestra un valor, se debe especificar una asignación de salida como el último argumento. Todas las asignaciones de entrada, y la asignación de salida (si existe), deben tener las mismas dimensiones.

Esta es una función síncrona. Una llamada a esta función solo se muestra después de que se haya completado todo el trabajo para todas las celdas de las asignaciones de entrada. Si la función del kernel muestra algún valor, la llamada espera hasta que se escriban todos los resultados en la asignación de salida.

Hasta el nivel de API 23, el kernel se especifica implícitamente como el kernel llamado "root" en la secuencia de comandos especificada, y solo se puede usar una asignación de entrada. A partir del nivel de API 24, se puede usar una función de kernel arbitraria, según lo especificado por el argumento del kernel. Se quita el argumento de la secuencia de comandos. El kernel debe definirse en la secuencia de comandos actual. Además, se puede usar más de una entrada.

P.ej.,
float __attribute__((kernel)) square(float a) {
  return a * a;
}

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



API interna para iniciar un kernel

Inicia el kernel de manera similar a rsForEach. Sin embargo, en lugar de procesar todas las celdas en la entrada, esta función solo procesa las celdas en el subespacio del espacio de índice especificado en las opciones. Con el espacio de índice especificado de forma explícita por las opciones, no se requiere ninguna asignación de entrada o salida para un lanzamiento de kernel con esta API. Si se pasan asignaciones, deben coincidir con la cantidad de argumentos y el valor que espera la función del kernel. La asignación de salida solo está presente si el kernel tiene un valor de retorno no vacío.

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


Muestra el índice en la dimensión Array0 de la celda que se procesa, como lo especifica el contexto de kernel proporcionado.

El contexto del kernel contiene características comunes de las asignaciones que se repiten y los índices que se usan con muy poca frecuencia, como el índice Array0.

Para acceder al contexto del kernel, agrega un parámetro especial llamado "context" del tipo rs_kernel_context a la función del kernel. P.ej.,
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);
  //...
}


Esta función muestra 0 si la dimensión Array0 no está presente.

Muestra el índice en la dimensión Array1 de la celda que se procesa, como lo especifica el contexto de kernel proporcionado. Consulta rsGetArray0() para obtener una explicación del contexto.

Muestra 0 si la dimensión Array1 no está presente.

Muestra el índice en la dimensión Array2 de la celda que se procesa, según lo especificado en el contexto de kernel proporcionado. Consulta rsGetArray0() para obtener una explicación del contexto.

Muestra 0 si la dimensión Array2 no está presente.

Muestra el índice en la dimensión Array3 de la celda que se procesa, como lo especifica el contexto de kernel proporcionado. Consulta rsGetArray0() para obtener una explicación del contexto.

Muestra 0 si la dimensión Array3 no está presente.

Muestra el tamaño de la dimensión Array0 para el contexto de kernel especificado. Consulta rsGetDimX() para obtener una explicación del contexto.

Muestra 0 si la dimensión Array0 no está presente.

Muestra el tamaño de la dimensión Array1 para el contexto de kernel especificado. Consulta rsGetDimX() para obtener una explicación del contexto.

Muestra 0 si la dimensión Array1 no está presente.

Muestra el tamaño de la dimensión Array2 para el contexto de kernel especificado. Consulta rsGetDimX() para obtener una explicación del contexto.

Muestra 0 si la dimensión Array2 no está presente.

Muestra el tamaño de la dimensión Array3 para el contexto de kernel especificado. Consulta rsGetDimX() para obtener una explicación del contexto.

Muestra 0 si la dimensión Array3 no está presente.

Si el kernel itera en un cubemap, esta función muestra "true" si hay más de un rostro presente. En todos los demás casos, el resultado es falso. Consulta rsGetDimX() para obtener una explicación del contexto.

rsAllocationGetDimFaces() es similar, pero muestra 0 o 1 en lugar de un bool.

Muestra la cantidad de niveles de detalle para el contexto de kernel especificado. Esto es útil para mipmaps. Consulta rsGetDimX() para obtener una explicación del contexto.

Muestra 0 si no se usa Level of Detail.

rsAllocationGetDimLOD() es similar, pero muestra 0 o 1 en lugar de la cantidad real de niveles.

Muestra el tamaño de la dimensión X para el contexto de kernel especificado.

El contexto del kernel contiene características comunes de las asignaciones que se repiten y los índices que se usan con muy poca frecuencia, como el índice Array0.

Para acceder, agrega un parámetro especial llamado "context" del tipo rs_kernel_context a la función de tu kernel. P.ej.,
int4 RS_KERNEL myKernel(int4 value, rs_kernel_context context) {
  uint32_t size = rsGetDimX(context); //...


Para obtener la dimensión de la asignación específica, usa rsAllocationGetDimX().

Muestra el tamaño de la dimensión X para el contexto de kernel especificado. Consulta rsGetDimX() para obtener una explicación del contexto.

Muestra 0 si la dimensión Y no está presente.

Para obtener la dimensión de una asignación específica, usa rsAllocationGetDimY().

Muestra el tamaño de la dimensión Z para el contexto de kernel especificado. Consulta rsGetDimX() para obtener una explicación del contexto.

Muestra 0 si la dimensión Z no está presente.

Para obtener la dimensión de la asignación específica, usa rsAllocationGetDimZ().

Muestra el rostro en el que se encuentra la celda que se procesa, según lo especificado en el contexto de kernel proporcionado. Consulta rsGetArray0() para obtener una explicación del contexto.

Muestra RS_ALLOCATION_CUBEMAP_FACE_POSITIVE_X si la dimensión del rostro no está presente.

Muestra el índice en la dimensión Niveles de detalle de la celda que se procesa, según lo especificado en el contexto de kernel proporcionado. Consulta rsGetArray0() para obtener una explicación del contexto.

Muestra 0 si la dimensión Niveles de detalle no está presente.