/* * Copyright (c) 2016 Samsung Electronics Co., Ltd All Rights Reserved * * Licensed under the Apache License, Version 2.0 (the License); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an AS IS BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ using System; namespace Tizen.Sensor { /// /// MagnetometerRotationVectorSensor Class. Used for registering callbacks for magnetometer rotation vector sensor and getting magnetometer rotation vector data /// public sealed class MagnetometerRotationVectorSensor : Sensor { private static string MagnetometerRVKey = "http://tizen.org/feature/sensor.geomagnetic_rotation_vector"; private event EventHandler _accuracyChanged; /// /// Gets the X component of the magnetometer rotation vector. /// /// 3 /// X public float X { get; private set; } = float.MinValue; /// /// Gets the Y component of the magnetometer rotation vector. /// /// 3 /// Y public float Y { get; private set; } = float.MinValue; /// /// Gets the Z component of the magnetometer rotation vector. /// /// 3 /// Z public float Z { get; private set; } = float.MinValue; /// /// Gets the W component of the magnetometer rotation vector. /// /// 3 /// W public float W { get; private set; } = float.MinValue; /// /// Gets the Accuracy of the magnetometer rotation vector data. /// /// 3 /// Accuracy public SensorDataAccuracy Accuracy { get; private set; } /// /// Returns true or false based on whether magnetometer rotation vector sensor is supported by device. /// /// 3 /// true if supported; otherwise, false. public static bool IsSupported { get { Log.Info(Globals.LogTag, "Checking if the MagnetometerRotationVectorSensor is supported"); return CheckIfSupported(SensorType.MagnetometerRotationVectorSensor, MagnetometerRVKey); } } /// /// Returns the number of magnetometer rotation vector sensors available on the device. /// /// 3 /// The count of magnetometer rotation vector sensors public static int Count { get { Log.Info(Globals.LogTag, "Getting the count of magnetometer rotation vector sensors"); return GetCount(); } } /// /// Initializes a new instance of the class. /// /// 3 /// http://tizen.org/feature/sensor.geomagnetic_rotation_vector /// Thrown when an invalid argument is used /// Thrown when the sensor is not supported /// Thrown when the operation is invalid for the current state /// /// Index. Default value for this is 0. Index refers to a particular magnetometer rotation vector sensor in case of multiple sensors /// public MagnetometerRotationVectorSensor(uint index = 0) : base(index) { Log.Info(Globals.LogTag, "Creating MagnetometerRotationVectorSensor object"); } internal override SensorType GetSensorType() { return SensorType.MagnetometerRotationVectorSensor; } /// /// Event Handler for storing the callback functions for event corresponding to change in magnetometer rotation vector sensor data. /// /// 3 public event EventHandler DataUpdated; /// /// Event handler for accuracy changed events. /// /// 3 public event EventHandler AccuracyChanged { add { if (_accuracyChanged == null) { AccuracyListenStart(); } _accuracyChanged += value; } remove { _accuracyChanged -= value; if (_accuracyChanged == null) { AccuracyListenStop(); } } } private static bool CheckIfSupported() { bool isSupported; int error = Interop.SensorManager.SensorIsSupported(SensorType.MagnetometerRotationVectorSensor, out isSupported); if (error != (int)SensorError.None) { Log.Error(Globals.LogTag, "Error checking if magnetometer rotation vector sensor is supported"); isSupported = false; } return isSupported; } private static int GetCount() { IntPtr list; int count; int error = Interop.SensorManager.GetSensorList(SensorType.MagnetometerRotationVectorSensor, out list, out count); if (error != (int)SensorError.None) { Log.Error(Globals.LogTag, "Error getting sensor list for magnetometer rotation vector"); count = 0; } else Interop.Libc.Free(list); return count; } private static Interop.SensorListener.SensorEventCallback _callback; internal override void EventListenStart() { _callback = (IntPtr sensorHandle, IntPtr eventPtr, IntPtr data) => { Interop.SensorEventStruct sensorData = Interop.IntPtrToEventStruct(eventPtr); TimeSpan = new TimeSpan((Int64)sensorData.timestamp); X = sensorData.values[0]; Y = sensorData.values[1]; Z = sensorData.values[2]; W = sensorData.values[3]; Accuracy = sensorData.accuracy; DataUpdated?.Invoke(this, new MagnetometerRotationVectorSensorDataUpdatedEventArgs(sensorData.values, sensorData.accuracy)); }; int error = Interop.SensorListener.SetEventCallback(ListenerHandle, Interval, _callback, IntPtr.Zero); if (error != (int)SensorError.None) { Log.Error(Globals.LogTag, "Error setting event callback for magnetometer rotation vector sensor"); throw SensorErrorFactory.CheckAndThrowException(error, "Unable to set event callback for magnetometer rotation vector"); } } internal override void EventListenStop() { int error = Interop.SensorListener.UnsetEventCallback(ListenerHandle); if (error != (int)SensorError.None) { Log.Error(Globals.LogTag, "Error unsetting event callback for magnetometer rotation vector sensor"); throw SensorErrorFactory.CheckAndThrowException(error, "Unable to unset event callback for magnetometer rotation vector"); } } private static Interop.SensorListener.SensorAccuracyCallback _accuracyCallback; private void AccuracyListenStart() { _accuracyCallback = (IntPtr sensorHandle, UInt64 timestamp, SensorDataAccuracy accuracy, IntPtr data) => { TimeSpan = new TimeSpan((Int64)timestamp); Accuracy = accuracy; _accuracyChanged?.Invoke(this, new SensorAccuracyChangedEventArgs(new TimeSpan((Int64)timestamp), accuracy)); }; int error = Interop.SensorListener.SetAccuracyCallback(ListenerHandle, _accuracyCallback, IntPtr.Zero); if (error != (int)SensorError.None) { Log.Error(Globals.LogTag, "Error setting accuracy event callback for magnetometer rotation vector sensor"); throw SensorErrorFactory.CheckAndThrowException(error, "Unable to set accuracy event callback for magnetometer rotation vector"); } } private void AccuracyListenStop() { int error = Interop.SensorListener.UnsetAccuracyCallback(ListenerHandle); if (error != (int)SensorError.None) { Log.Error(Globals.LogTag, "Error unsetting accuracy event callback for magnetometer rotation vector sensor"); throw SensorErrorFactory.CheckAndThrowException(error, "Unable to unset accuracy event callback for magnetometer rotation vector"); } } } }