Idioma

SensorManager.GetOrientation(Single[], Single[]) Método

Definição

Calcula a orientação do dispositivo com base na matriz de rotação.

[Android.Runtime.Register("getOrientation", "([F[F)[F", "")]
public static float[]? GetOrientation(float[]? R, float[]? values);
[<Android.Runtime.Register("getOrientation", "([F[F)[F", "")>]
static member GetOrientation : single[] * single[] -> single[]

Parâmetros

R
Single[]

matriz de rotação ver #getRotationMatrix.

values
Single[]

uma matriz de 3 floats para manter o resultado.

Retornos

Single[]

Os valores de matriz passados como argumento.

Atributos

Comentários

Calcula a orientação do dispositivo com base na matriz de rotação.

Quando retorna, os valores da matriz são os seguintes: <ul><li>values[0]: Azimuth, ângulo de rotação sobre o eixo -z. Esse valor representa o ângulo entre o eixo y do dispositivo e o pólo norte magnético. Quando voltado para o norte, esse ângulo é 0, quando voltado para o sul, esse ângulo é π. Da mesma forma, quando voltado para leste, esse ângulo é π/2 e, quando voltado para oeste, esse ângulo é -π/2. O intervalo de valores é -π para π.</li><li>values[1]: Pitch, ângulo de rotação sobre o eixo -x. Esse valor representa o ângulo entre um plano paralelo à tela do dispositivo e um plano paralelo ao solo. Supondo que a borda inferior do dispositivo enfrente o usuário e que a tela esteja voltada para cima, inclinar a borda superior do dispositivo em direção ao chão cria um ângulo de tom positivo. O intervalo de valores é -π/2 a π/2.</li><li>values[2]: Roll, angle of rotation about the y axis. Esse valor representa o ângulo entre um plano perpendicular à tela do dispositivo e um plano perpendicular ao solo. Supondo que a borda inferior do dispositivo enfrente o usuário e que a tela esteja voltada para cima, inclinar a borda direita do dispositivo em direção ao chão cria um ângulo de rolagem positivo. O intervalo de valores é -π para π.</li></ul>

A aplicação dessas três rotações na ordem azimute, pitch, roll transforma uma matriz de identidade para a matriz de rotação passada para esse método. Além disso, observe que todos os três ângulos de orientação são expressos em <b radians>/b<>.

Java documentação para android.hardware.SensorManager.getOrientation(float[], float[]).

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Project Open Source do Open Source e usadas de acordo com os termos descritos na Creative Commons 2.5.

Aplica-se a

Confira também

  • <xref:Android.Hardware.SensorManager.GetRotationMatrix(System.Single%5b%5d%2c+System.Single%5b%5d%2c+System.Single%5b%5d%2c+System.Single%5b%5d)>
  • GeomagneticField