RenderScript-Kernelaufruffunktionen und -typen

Führt den Kernel für null oder mehr Eingabezuweisungen aus. Sie werden nach dem Argument rs_kernel übergeben. Wenn der angegebene Kernel einen Wert zurückgibt, muss eine Ausgabezuweisung als letztes Argument angegeben werden. Alle Eingabezuweisungen und ggf. die Ausgabezuordnungen müssen dieselben Dimensionen haben.

Dies ist eine synchrone Funktion. Ein Aufruf dieser Funktion wird erst zurückgegeben, wenn die Arbeit für alle Zellen der Eingabezuweisungen abgeschlossen ist. Wenn die Kernelfunktion einen Wert zurückgibt, wartet der Aufruf, bis alle Ergebnisse in die Ausgabezuweisung geschrieben wurden.

Bis API-Level 23 wird der Kernel im angegebenen Skript implizit als Kernel mit dem Namen "root" angegeben. Es kann nur eine einzige Eingabezuweisung verwendet werden. Ab API-Level 24 kann eine beliebige Kernelfunktion verwendet werden, wie durch das Kernel-Argument angegeben. Das Skriptargument wird entfernt. Der Kernel muss im aktuellen Skript definiert sein. Außerdem kann mehr als eine Eingabe verwendet werden.

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

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



Interne API zum Starten eines Kernels.

Startet den Kernel auf ähnliche Weise wie rsForEvery. Anstatt jedoch alle Zellen in der Eingabe zu verarbeiten, verarbeitet diese Funktion nur Zellen im Unterraum des in den Optionen angegebenen Indexraums. Wenn der Indexbereich explizit durch Optionen angegeben wird, ist für einen Kernelstart mit dieser API keine Eingabe- oder Ausgabezuweisung erforderlich. Wenn Zuweisungen übergeben werden, müssen sie der Anzahl der Argumente und dem Rückgabewert entsprechen, der von der Kernelfunktion erwartet wird. Die Ausgabezuweisung ist nur dann vorhanden, wenn der Kernel einen nicht ungültigen Rückgabewert hat.

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


Gibt den Index in der Array0-Dimension der verarbeiteten Zelle zurück, wie im angegebenen Kernelkontext angegeben.

Der Kernel-Kontext enthält allgemeine Merkmale der Zuweisungen, die iteriert werden, und selten verwendete Indexe, wie den Array0-Index.

Sie können auf den Kernel-Kontext zugreifen, indem Sie Ihrer Kernel-Funktion einen speziellen Parameter namens "context" vom Typ "rs_kernel_context" hinzufügen. Beispiel:
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);
  //...
}


Diese Funktion gibt 0 zurück, wenn die Dimension Array0 nicht vorhanden ist.

Gibt den Index in der Dimension Array1 der verarbeiteten Zelle zurück, wie im angegebenen Kernelkontext angegeben. Eine Erklärung des Kontexts finden Sie unter rsGetArray0().

Gibt 0 zurück, wenn die Dimension Array1 nicht vorhanden ist.

Gibt den Index in der Array2-Dimension der verarbeiteten Zelle zurück, wie im angegebenen Kernelkontext angegeben. Eine Erläuterung des Kontexts finden Sie unter rsGetArray0().

Gibt 0 zurück, wenn die Dimension Array2 nicht vorhanden ist.

Gibt den Index in der Array3-Dimension der verarbeiteten Zelle zurück, wie im angegebenen Kernelkontext angegeben. Eine Erklärung des Kontexts finden Sie unter rsGetArray0().

Gibt 0 zurück, wenn die Dimension Array3 nicht vorhanden ist.

Gibt die Größe der Array0-Dimension für den angegebenen Kernel-Kontext zurück. Eine Erklärung des Kontexts finden Sie unter rsGetDimX().

Gibt 0 zurück, wenn die Dimension Array0 nicht vorhanden ist.

Gibt die Größe der Array1-Dimension für den angegebenen Kernelkontext zurück. Eine Erklärung des Kontexts finden Sie unter rsGetDimX().

Gibt 0 zurück, wenn die Dimension Array1 nicht vorhanden ist.

Gibt die Größe der Array2-Dimension für den angegebenen Kernelkontext zurück. Eine Erklärung des Kontexts finden Sie unter rsGetDimX().

Gibt 0 zurück, wenn die Dimension Array2 nicht vorhanden ist.

Gibt die Größe der Array3-Dimension für den angegebenen Kernelkontext zurück. Eine Erklärung des Kontexts finden Sie unter rsGetDimX().

Gibt 0 zurück, wenn die Dimension Array3 nicht vorhanden ist.

Wenn der Kernel über eine Cubemap iteriert, gibt diese Funktion „true“ zurück, wenn mehr als ein Gesicht vorhanden ist. In allen anderen Fällen wird „false“ zurückgegeben. Eine Erläuterung des Kontexts finden Sie unter rsGetDimX().

rsAllocationGetDimFaces() ist ähnlich, gibt aber „0“ oder „1“ anstelle eines booleschen Werts zurück.

Gibt die Anzahl der Detailebenen für den angegebenen Kernel-Kontext zurück. Dies ist nützlich für Mipmaps. Eine Erklärung des Kontexts finden Sie unter rsGetDimX().

Gibt 0 zurück, wenn keine Detailebene verwendet wird.

rsAllocationGetDimLOD() ist ähnlich, gibt aber anstelle der tatsächlichen Anzahl der Ebenen 0 oder 1 zurück.

Gibt die Größe der X-Dimension für den angegebenen Kernel-Kontext zurück.

Der Kernel-Kontext enthält allgemeine Merkmale der Zuweisungen, die iteriert werden, und selten verwendete Indexe, wie den Array0-Index.

Sie können darauf zugreifen, indem Sie Ihrer Kernelfunktion einen speziellen Parameter namens „context“ vom Typ „rs_kernel_context“ hinzufügen. Beispiel:
int4 RS_KERNEL myKernel(int4 value, rs_kernel_context context) {
  uint32_t size = rsGetDimX(context); //...


Mit rsAllocationGetDimX() können Sie die Dimension einer bestimmten Zuweisung abrufen.

Gibt die Größe der X-Dimension für den angegebenen Kernel-Kontext zurück. Eine Erklärung des Kontexts finden Sie unter rsGetDimX().

Gibt 0 zurück, wenn die Dimension Y nicht vorhanden ist.

Mit rsAllocationGetDimY() können Sie die Dimension einer bestimmten Zuweisung abrufen.

Gibt die Größe der Z-Dimension für den angegebenen Kernelkontext zurück. Eine Erklärung des Kontexts finden Sie unter rsGetDimX().

Gibt 0 zurück, wenn die Z-Dimension nicht vorhanden ist.

Die Dimension einer bestimmten Zuweisung rufen Sie mit rsAllocationGetDimZ() ab.

Gibt das Gesicht zurück, auf dem die verarbeitete Zelle gefunden wurde, wie im angegebenen Kernelkontext angegeben. Eine Erklärung des Kontexts finden Sie unter rsGetArray0().

Gibt RS_ALLOCATION_CUBEMAP_FACE_POSITIVE_X zurück, wenn die Dimension "Gesicht" nicht vorhanden ist.

Gibt den Index in der Dimension „Detailebenen“ der verarbeiteten Zelle zurück, wie im angegebenen Kernelkontext angegeben. Eine Erklärung des Kontexts finden Sie unter rsGetArray0().

Gibt 0 zurück, wenn die Dimension „Detailebenen“ nicht vorhanden ist.