Datenzugriffsfunktionen der RenderScript-Zuweisung

Kopiert die angegebene Anzahl von Zellen von einer Zuweisung in eine andere.

Die Zuweisungen müssen sich unterscheiden. Wenn Sie diese Funktion zum Kopieren innerhalb derselben Zuweisung verwenden, erhalten Sie undefinierte Ergebnisse.

Die Funktion prüft nicht, ob das Offset plus die Anzahl die Größe einer der beiden Zuweisungen überschreitet. Achtung:

Diese Funktion sollte nur zwischen Zuweisungen vom Typ „1D“ aufgerufen werden. Ein Aufruf für andere Zuweisungen ist nicht definiert.

Diese Funktion sollte nicht innerhalb eines Kernels oder über eine Funktion aufgerufen werden, die direkt oder indirekt von einem Kernel aufgerufen werden kann. Dies würde zu einem Laufzeitfehler führen.

Kopiert einen rechteckigen Bereich von Zellen von einer Zuweisung in eine andere. (Breite * Höhe) werden kopiert.

Die Zuweisungen müssen sich unterscheiden. Wenn Sie diese Funktion zum Kopieren innerhalb derselben Zuweisung verwenden, erhalten Sie undefinierte Ergebnisse.

Die Funktion prüft nicht, ob die Quell- oder Zielregion die Größe der entsprechenden Zuweisung überschreitet. Achtung:

Diese Funktion sollte nur zwischen 2D-Zuweisungen aufgerufen werden. Ein Aufruf für andere Zuweisungen ist nicht definiert.

Diese Funktion sollte nicht innerhalb eines Kernels oder über eine Funktion aufgerufen werden, die direkt oder indirekt von einem Kernel aufgerufen werden kann. Dies würde zu einem Laufzeitfehler führen.

Diese Funktion gibt einen Vektor zurück, der aus aufeinanderfolgenden Zellen der Zuordnung besteht. Es wird davon ausgegangen, dass die Zuordnung Skalare enthält.

Das "X" im Namen zeigt an, dass aufeinanderfolgende Werte durch Erhöhung des X-Index extrahiert werden. Derzeit gibt es keine Funktionen zum Abrufen aufeinanderfolgender Werte, die andere Dimensionen erhöhen. Verwenden Sie stattdessen mehrere Aufrufe von rsGetElementAt().

Wenn Sie beispielsweise rsAllocationVLoadX_int4(a, 20, 30) aufrufen, wird eine Ganzzahl zurückgegeben, die aus a[20, 30], a[21, 30], a[22, 30] und a[23, 30] besteht.

Verwenden Sie beim Abrufen aus dreidimensionalen Zuweisungen die Variante x, y und z. Verwenden Sie in ähnlicher Weise die Variante x und y für zweidimensionale Zuweisungen und x für monodimensionale Zuweisungen.

Aus Gründen der Effizienz validiert diese Funktion die Eingaben nicht. Wenn Sie versuchen, den X-Index zu kapseln, die Größe der Zuweisung überschreiten oder Indexe verwenden, die nicht mit der Dimensionalität der Zuordnung kompatibel sind, erhalten Sie undefinierte Ergebnisse.

Siehe auch rsAllocationVStoreX().

Diese Funktion speichert die Einträge eines Vektors in aufeinanderfolgenden Zellen einer Zuordnung. Es wird davon ausgegangen, dass die Zuordnung Skalare enthält.

Das "X" im Namen zeigt an, dass aufeinanderfolgende Werte durch Erhöhen des X-Index gespeichert werden. Es gibt derzeit keine Funktionen zum Speichern aufeinanderfolgender Werte, die andere Dimensionen erhöhen. Verwenden Sie stattdessen mehrere Aufrufe von rsSetElementAt().

Wenn Sie beispielsweise rsAllocationVStoreX_int3(a, v, 20, 30) aufrufen, wird v.x unter a[20, 30], v.y bei a[21, 30] und v.z unter a[22, 30] gespeichert.

Verwenden Sie beim Speichern in dreidimensionalen Zuweisungen die Variante x, y und z. Verwenden Sie in ähnlicher Weise die Variante x und y für zweidimensionale Zuweisungen und x für monodimensionale Zuweisungen.

Aus Gründen der Effizienz validiert diese Funktion die Eingaben nicht. Der Versuch, den X-Index zu kapseln, die Größe der Zuweisung überschreitet oder Indexe verwenden, die nicht mit der Dimensionalität der Zuweisungsergebnisse kompatibel sind, führt zu undefinierten Ergebnissen.

Weitere Informationen finden Sie unter rsAllocationVLoadX().

Diese Funktion extrahiert eine einzelne Zelle aus einer Zuweisung.

Verwenden Sie beim Abrufen aus dreidimensionalen Zuweisungen die Variante x, y und z. Verwenden Sie in ähnlicher Weise die Variante x und y für zweidimensionale Zuweisungen und x für monodimensionale Zuweisungen.

Diese Funktion verfügt über zwei Stile. Der eine gibt die Adresse des Werts mit einem void*-Element zurück, der andere den tatsächlichen Wert, z. B. rsGetElementAt() im Vergleich zu rsGetElementAt_int4(). Für primitive Typen sollten Sie immer Letzteres verwenden, da es effizienter ist.

Extrahiert die U-Komponente eines einzelnen YUV-Werts aus einer 2D-Zuordnung von YUVs.

Innerhalb einer Zuweisung können Y-, U- und V-Komponenten bei unterschiedlichen Ebenen und mit unterschiedlichen Auflösungen gespeichert werden. Die hier angegebenen x- und y-Koordinaten beziehen sich auf die Abmessungen der Y-Ebene.

Siehe rsGetElementAtYuv_uchar_Y().

Extrahiert die V-Komponente eines einzelnen YUV-Werts aus einer 2D-Zuordnung von YUVs.

Innerhalb einer Zuweisung können Y-, U- und V-Komponenten bei unterschiedlichen Ebenen und mit unterschiedlichen Auflösungen gespeichert werden. Die hier angegebenen x- und y-Koordinaten beziehen sich auf die Abmessungen der Y-Ebene.

Siehe rsGetElementAtYuv_uchar_Y().

Extrahiert die Y-Komponente eines einzelnen YUV-Werts aus einer 2D-Zuordnung von YUVs.

Innerhalb einer Zuweisung können Y-, U- und V-Komponenten bei unterschiedlichen Ebenen und mit unterschiedlichen Auflösungen gespeichert werden. Die hier angegebenen x- und y-Koordinaten beziehen sich auf die Abmessungen der Y-Ebene.

Siehe rsGetElementAtYuv_uchar_U() und rsGetElementAtYuv_uchar_V().

Ruft einen Wert aus einer Texturzuordnung auf eine vom Sampler beschriebene Weise ab.

Wenn Ihre Zuweisung 1D ist, verwenden Sie die Variante mit Gleitkommazahl für den Standort. Verwenden Sie für 2D die Variante „FLOAT2“.

Weitere Informationen finden Sie unter android.renderscript.Sampler.

Diese Funktion speichert einen Wert in einer einzelnen Zelle einer Zuweisung.

Verwenden Sie beim Speichern in dreidimensionalen Zuweisungen die Variante x, y und z. Verwenden Sie in ähnlicher Weise die Variante x und y für zweidimensionale Zuweisungen und x für monodimensionale Zuweisungen.

Diese Funktion verfügt über zwei Stile. Der eine übergibt den zu speichernden Wert mit einem void*-Element, der andere hat den tatsächlichen Wert als Argument, z. B. rsSetElementAt() im Vergleich zu rsSetElementAt_int4(). Für primitive Typen sollten Sie immer Letzteres verwenden, da es effizienter ist.

Siehe auch rsGetElementAt().