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 completó todo el trabajo para todas las celdas de las asignaciones de entrada. Si la función de kernel muestra algún valor, la llamada espera hasta que todos los resultados se escriban en la asignación de salida.

Hasta el nivel de API 23, el kernel se especifica de forma implícita como un kernel llamado "raíz" 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 en 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 utilizar 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 una manera similar a rsForEach. Sin embargo, en lugar de procesar todas las celdas de 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 mediante esta API. Si se pasan asignaciones, deben coincidir con la cantidad de argumentos y el valor de muestra que espera la función del kernel. La asignación de salida está presente solo 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 iteran en índices y que se usan con muy poca frecuencia, como el índice Array0.

Puedes acceder al contexto del kernel si agregas un parámetro especial llamado "context" del tipo rs_kernel_context a la función de tu 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 sobre 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 los 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 del kernel especificado.

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

Para acceder a ella, 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 del 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 la 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 procesada, 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.