Sprache

SensorManager.GetRotationMatrix Methode

Definition

Berechnet die Neigungsmatrix <b></b> sowie die Drehungsmatrix <b>R</b>, die einen Vektor vom Gerätekoordinatensystem in das Koordinatensystem der Welt transformiert, das als direkte orthonormale Basis definiert ist, wobei:

[Android.Runtime.Register("getRotationMatrix", "([F[F[F[F)Z", "")]
public static bool GetRotationMatrix(float[]? R, float[]? I, float[]? gravity, float[]? geomagnetic);
[<Android.Runtime.Register("getRotationMatrix", "([F[F[F[F)Z", "")>]
static member GetRotationMatrix : single[] * single[] * single[] * single[] -> bool

Parameter

R
Single[]

ist ein Array von 9 Floats, die die Drehungsmatrix <b>R</b> enthalten, wenn diese Funktion zurückgegeben wird. R kann null sein. <p>

I
Single[]

ist ein Array von 9 Floats, die die Drehungsmatrix <b>I</b> enthalten, wenn diese Funktion zurückgegeben wird. Ich kann NULL sein. <p>

gravity
Single[]

ist ein Array von drei Floats, die den Schwerkraftvektor enthalten, der in der Koordinate des Geräts ausgedrückt wird. Sie können einfach den android.hardware.SensorEvent#values values von einem android.hardware.SensorEvent SensorEventandroid.hardware.Sensor Sensor Typ android.hardware.Sensor#TYPE_ACCELEROMETER TYPE_ACCELEROMETERzurückgegebenen Wert verwenden. <p>

geomagnetic
Single[]

ist ein Array von drei Floats, die den geomagnetischen Vektor enthalten, der in der Koordinaten des Geräts ausgedrückt wird. Sie können einfach den android.hardware.SensorEvent#values values von einem android.hardware.SensorEvent SensorEventandroid.hardware.Sensor Sensor Typ android.hardware.Sensor#TYPE_MAGNETIC_FIELD TYPE_MAGNETIC_FIELDzurückgegebenen Wert verwenden.

Gibt zurück

true bei Erfolg, false bei Fehlern (z. B. wenn das Gerät im freien Fall ist). Der freie Fall wird als Bedingung definiert, wenn die Größe der Schwerkraft kleiner als 1/10 des Nominalwerts ist. Wenn die Ausgabematrizen nicht geändert werden, werden die Ausgabematrizen nicht geändert.

Attribute

Hinweise

Berechnet die Neigungsmatrix <b></b> sowie die Drehungsmatrix <b>R</b>, die einen Vektor vom Gerätekoordinatensystem in das Koordinatensystem der Welt transformiert, das als direkte orthonormale Basis definiert ist, wobei:

<ul><li>X wird als Vektorprodukt <b>Y.Z</b> definiert (Es ist tangential für den Boden an der aktuellen Position des Geräts und ungefähr Punkt Ost).</li li><>Y ist tangential zum Boden an der aktuellen Position des Geräts und zeigt auf den magnetischen Nordpol.</li li><>Z zeigt auf den Himmel und ist senkrecht zum Boden.</li></ul>

<center><img src=".. /.. /.. /images/axis_globe.png" alt="World-Koordinatensystemdiagramm". border="0" /></center>

<hr>

Definition:

[0 0 g] = <b>R</b> * <b>Schwerkraft</b> (g = Schweregrad)

[0 m 0] = <b>I</b> * <b>R</b> * <b>geomagnetisch</b> (m = Größenordnung des geomagnetischen Felds)

<b>R</b> ist die Identitätsmatrix, wenn das Gerät mit dem Koordinatensystem der Welt ausgerichtet ist, d. h., wenn die X-Achse des Geräts nach Osten zeigt, zeigt die Y-Achse auf den Nordpol, und das Gerät steht auf dem Himmel.

<b>I</b> ist eine Drehungsmatrix, die den geomagnetischen Vektor in den gleichen Koordinatenraum wie die Schwerkraft (koordinatenraum der Welt) transformiert. <b>I</b> ist eine einfache Drehung um die X-Achse. Der Neigungswinkel in Bogenmaßen kann mit #getInclinationberechnet werden. <hr>

Jede Matrix wird je nach Länge des übergebenen Arrays als 3x3- oder 4x4-Zeilen-Hauptmatrix zurückgegeben:

<u>Wenn die Arraylänge 16:</u ist>

/  M[ 0]   M[ 1]   M[ 2]   M[ 3]  \
              |  M[ 4]   M[ 5]   M[ 6]   M[ 7]  |
              |  M[ 8]   M[ 9]   M[10]   M[11]  |
              \  M[12]   M[13]   M[14]   M[15]  /

Diese Matrix kann von OpenGL ES verwendet javax.microedition.khronos.opengles.GL10#glLoadMatrixf(float[], int) glLoadMatrixf(float[], int)werden.

Beachten Sie, dass Es sich bei OpenGL-Matrizen um Spaltenmatrizen handelt, die Sie vor der Verwendung der Matrix transponieren müssen. Da es sich bei der Matrix jedoch um eine Drehungsmatrix handelt, ist ihre Transponation auch umgekehrt, bequem, sie ist häufig umgekehrt, die zum Rendern erforderlich ist; sie kann daher direkt mit OpenGL ES verwendet werden.

Beachten Sie außerdem, dass die zurückgegebenen Matrizen immer über dieses Formular verfügen:

/  M[ 0]   M[ 1]   M[ 2]   0  \
              |  M[ 4]   M[ 5]   M[ 6]   0  |
              |  M[ 8]   M[ 9]   M[10]   0  |
              \      0       0       0   1  /

<u>Wenn die Arraylänge 9:</u ist>

/  M[ 0]   M[ 1]   M[ 2]  \
              |  M[ 3]   M[ 4]   M[ 5]  |
              \  M[ 6]   M[ 7]   M[ 8]  /

<hr>

Die Umkehrung jeder Matrix kann einfach berechnet werden, indem sie ihre Transponieren.

Die von dieser Funktion zurückgegebenen Matrizen sind nur dann aussagekräftig, wenn das Gerät nicht frei fällt und nicht nahe am magnetischen Norden liegt. Wenn das Gerät beschleunigt oder in ein starkes Magnetfeld versetzt wird, können die zurückgegebenen Matrizen ungenau sein.

Java Dokumentation für android.hardware.SensorManager.getRotationMatrix(float[], float[], float[], 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:

Siehe auch

  • GetInclination(Single[])
  • <xref:Android.Hardware.SensorManager.GetOrientation(System.Single%5b%5d%2c+System.Single%5b%5d)>
  • <xref:Android.Hardware.SensorManager.RemapCoordinateSystem(System.Single%5b%5d%2c+Android.Hardware.Axis%2c+Android.Hardware.Axis%2c+Android.Hardware.Axis)>