Sprache

SurfaceTexture.GetTransformMatrix(Single[]) Methode

Definition

Rufen Sie die 4x4 Texturkoordinatentransformationsmatrix ab, die dem Texturbild zugeordnet ist, das durch den letzten Aufruf von #updateTexImage.

[Android.Runtime.Register("getTransformMatrix", "([F)V", "GetGetTransformMatrix_arrayFHandler")]
public virtual void GetTransformMatrix(float[]? mtx);
[<Android.Runtime.Register("getTransformMatrix", "([F)V", "GetGetTransformMatrix_arrayFHandler")>]
abstract member GetTransformMatrix : single[] -> unit
override this.GetTransformMatrix : single[] -> unit

Parameter

mtx
Single[]

das Array, in dem die 4x4-Matrix gespeichert wird. Das Array muss genau 16 Elemente aufweisen.

Attribute

Hinweise

Rufen Sie die 4x4 Texturkoordinatentransformationsmatrix ab, die dem Texturbild zugeordnet ist, das durch den letzten Aufruf von #updateTexImage.

Diese Transformationsmatrix ordnet 2D homogene Texturkoordinaten des Formulars (s, t, 0, 1) mit s und t im inklusiven Bereich [0, 1] der Texturkoordinate zu, die zum Beispiel für diese Position aus der Textur verwendet werden soll. Das Sampling der Textur außerhalb des Bereichs dieser Transformation ist nicht definiert.

Die Matrix wird in Spalten-Hauptreihenfolge gespeichert, sodass sie über die glLoadMatrixf Funktionen glUniformMatrix4fv direkt an OpenGL ES übergeben werden kann.

Wenn dem zugrunde liegenden Puffer eine Zuschneide zugeordnet ist, enthält die Transformation auch eine leichte Skalierung, um einen 1-Texel-Rahmen um den Rand des Zuschnitts zu schneiden. Dadurch wird sichergestellt, dass bei einem bilinearen Beispiel für die Textur keine Texel außerhalb des gültigen Bereichs des Puffers von der GPU aufgerufen werden, sodass beim Skalieren keine Samplingartefakte vermieden werden.

Java Dokumentation für android.graphics.SurfaceTexture.getTransformMatrix(float[]).

Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die von der Android Open Source Project erstellt und gemeinsam verwendet und gemäß den in der 2.5 Attribution License beschriebenen Begriffen verwendet werden.

Gilt für: