SensorManager.GetOrientation(Single[], Single[]) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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
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