SensorManager.GetRotationMatrix Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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.
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)>