Funzioni e tipi di chiamata kernel RenderScript

Esegue il kernel su zero o più allocazioni di input. Vengono passati dopo l'argomento rs_kernel. Se il kernel specificato restituisce un valore, è necessario specificare un'allocazione di output come ultimo argomento. Tutte le allocazioni di input e quella di output, se esistente, devono avere le stesse dimensioni.

Questa è una funzione sincrona. Una chiamata a questa funzione restituisce solo dopo che tutto il lavoro è stato completato per tutte le celle delle allocazioni dell'input. Se la funzione kernel restituisce un valore qualsiasi, la chiamata attende che tutti i risultati siano stati scritti nell'allocazione dell'output.

Fino al livello API 23, il kernel viene specificato implicitamente come kernel denominato "root" nello script specificato ed è possibile utilizzare una sola allocazione di input. A partire dal livello API 24, è possibile utilizzare una funzione kernel arbitrario, come specificato dall'argomento kernel. L'argomento di script viene rimosso. Il kernel deve essere definito nello script corrente. Inoltre, è possibile utilizzare più di un input.

Ad es.
float __attribute__((kernel)) square(float a) {
  return a * a;
}

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



API interna per avviare un kernel.

Avvia il kernel in modo simile a rsForOgni. Tuttavia, anziché elaborare tutte le celle nell'input, questa funzione elabora solo le celle nel sottospazio dello spazio dell'indice specificato nelle opzioni. Con lo spazio dell'indice esplicitamente specificato dalle opzioni, non è richiesta alcuna allocazione di input o output per il lancio del kernel mediante questa API. Se vengono trasmesse le allocazioni, devono corrispondere al numero di argomenti e al valore restituito atteso dalla funzione kernel. L'allocazione dell'output è presente solo se il kernel ha un valore restituito non void.

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


Restituisce l'indice nella dimensione Array0 della cella in fase di elaborazione, come specificato dal contesto del kernel fornito.

Il contesto kernel contiene caratteristiche comuni delle allocazioni sottoposte a iterazione e indici utilizzati raramente, come l'indice Array0.

Puoi accedere al contesto del kernel aggiungendo un parametro speciale denominato "context" di tipo rs_kernel_context alla funzione kernel. Ad es.
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);
  //...
}


Questa funzione restituisce 0 se la dimensione Array0 non è presente.

Restituisce l'indice nella dimensione Array1 della cella in fase di elaborazione, come specificato dal contesto del kernel fornito. Consulta rsGetArray0() per una spiegazione del contesto.

Restituisce 0 se la dimensione Array1 non è presente.

Restituisce l'indice nella dimensione Array2 della cella in fase di elaborazione, come specificato dal contesto del kernel fornito. Consulta rsGetArray0() per una spiegazione del contesto.

Restituisce 0 se la dimensione Array2 non è presente.

Restituisce l'indice nella dimensione Array3 della cella in fase di elaborazione, come specificato dal contesto del kernel fornito. Consulta rsGetArray0() per una spiegazione del contesto.

Restituisce 0 se la dimensione Array3 non è presente.

Restituisce la dimensione della dimensione Array0 per il contesto del kernel specificato. Consulta rsGetDimX() per una spiegazione del contesto.

Restituisce 0 se la dimensione Array0 non è presente.

Restituisce la dimensione della dimensione Array1 per il contesto del kernel specificato. Consulta rsGetDimX() per una spiegazione del contesto.

Restituisce 0 se la dimensione Array1 non è presente.

Restituisce la dimensione della dimensione Array2 per il contesto del kernel specificato. Consulta rsGetDimX() per una spiegazione del contesto.

Restituisce 0 se la dimensione Array2 non è presente.

Restituisce la dimensione della dimensione Array3 per il contesto kernel specificato. Consulta rsGetDimX() per una spiegazione del contesto.

Restituisce 0 se la dimensione Array3 non è presente.

Se il kernel esegue l'iterazione su una mappa cubica, questa funzione restituisce true se è presente più di una faccia. In tutti gli altri casi, restituisce false. Per una spiegazione del contesto, consulta rsGetDimX().

rsAllocationGetDimFaces() è simile, ma restituisce 0 o 1 invece di bool.

Restituisce il numero di livelli di dettaglio per il contesto del kernel specificato. È utile per le mipmap. Consulta rsGetDimX() per una spiegazione del contesto.

Restituisce 0 se il livello di dettaglio non è utilizzato.

rsAllocationGetDimLOD() è simile, ma restituisce 0 o 1 invece del numero effettivo di livelli.

Restituisce la dimensione della dimensione X per il contesto del kernel specificato.

Il contesto kernel contiene caratteristiche comuni delle allocazioni sottoposte a iterazione e indici utilizzati raramente, come l'indice Array0.

Puoi accedervi aggiungendo un parametro speciale denominato "context" di tipo rs_kernel_context alla funzione kernel. Ad es.
int4 RS_KERNEL myKernel(int4 value, rs_kernel_context context) {
  uint32_t size = rsGetDimX(context); //...


Per ottenere la dimensione di allocazione specifica, utilizza rsAllocationGetDimX().

Restituisce la dimensione della dimensione X per il contesto del kernel specificato. Consulta rsGetDimX() per una spiegazione del contesto.

Restituisce 0 se la dimensione Y non è presente.

Per ottenere la dimensione di allocazione specifica, utilizza rsAllocationGetDimY().

Restituisce la dimensione della dimensione Z per il contesto del kernel specificato. Consulta rsGetDimX() per una spiegazione del contesto.

Restituisce 0 se la dimensione Z non è presente.

Per ottenere la dimensione di allocazione specifica, utilizza rsAllocationGetDimZ().

Restituisce il volto in cui si trova la cella in fase di elaborazione, come specificato dal contesto del kernel fornito. Consulta rsGetArray0() per una spiegazione del contesto.

Restituisce RS_ALLOCATION_CUBEMAP_FACE_POSITIVE_X se la dimensione faccia non è presente.

Restituisce l'indice nella dimensione Livelli di dettaglio della cella in fase di elaborazione, come specificato dal contesto del kernel fornito. Consulta rsGetArray0() per una spiegazione del contesto.

Restituisce 0 se la dimensione Livelli di dettaglio non è presente.