Gyrometer class (Windows)

1 out of 1 rated this helpful - Rate this topic

Represents a gyrometer sensor.

This sensor returns angular velocity values with respect to the x, y, and z axes.

Syntax


var gyrometer = Windows.Devices.Sensors.Gyrometer;

Attributes

DualApiPartitionAttribute()
MarshalingBehaviorAttribute(Agile)
StaticAttribute(Windows.Devices.Sensors.IGyrometerStatics, NTDDI_WIN8)
ThreadingAttribute(Both)
VersionAttribute(NTDDI_WIN8)

Members

The Gyrometer class has these types of members:

Events
Methods
Properties

Events

The Gyrometer class has these events.

Event	Description
ReadingChanged	Occurs each time the gyrometer reports the current sensor reading.

Methods

The Gyrometer class has these methods. With C#, Visual Basic, and C++, it also inherits methods from the Object class.

Method	Description
GetCurrentReading	Gets the current gyrometer reading.
GetDefault	Returns the default gyrometer.

Properties

The Gyrometer class has these properties.

Property	Access type	Description
MinimumReportInterval	Read-only	Gets the minimum report interval supported by the gyrometer.
ReportInterval	Read/write	Gets or sets the current report interval for the gyrometer.

Remarks

The following example demonstrates how a Windows Store app built with XAML and C# uses the GetDefault method to establish a connection to a gyrometer. If no integrated gyrometer is found, the method will return a null value.


_gyrometer = Gyrometer.GetDefault();

The following example demonstrates how a Windows Store app built with XAML registers a ReadingChanged event handler.


private void ScenarioEnable(object sender, RoutedEventArgs e)
{
    if (_gyrometer != null)
    {
        // Establish the report interval
        _gyrometer.ReportInterval = _desiredReportInterval;

        Window.Current.VisibilityChanged += new WindowVisibilityChangedEventHandler(VisibilityChanged);
        _gyrometer.ReadingChanged += new TypedEventHandler<Gyrometer, GyrometerReadingChangedEventArgs>(ReadingChanged);

        ScenarioEnableButton.IsEnabled = false;
        ScenarioDisableButton.IsEnabled = true;
    }
    else
    {
        rootPage.NotifyUser("No gyrometer found", NotifyType.StatusMessage);
    }
}

The following example shows the ReadingChanged event handler.


async private void ReadingChanged(object sender, GyrometerReadingChangedEventArgs e)
{
    await Dispatcher.RunAsync(CoreDispatcherPriority.Normal, () =>
    {
        GyrometerReading reading = e.Reading;
        ScenarioOutput_X.Text = String.Format("{0,5:0.00}", reading.AngularVelocityX);
        ScenarioOutput_Y.Text = String.Format("{0,5:0.00}", reading.AngularVelocityY);
        ScenarioOutput_Z.Text = String.Format("{0,5:0.00}", reading.AngularVelocityZ);
    });
}

Requirements

Minimum supported client	Windows 8 [Windows Store apps, desktop apps]
Minimum supported server	Windows Server 2012 [Windows Store apps, desktop apps]
Minimum supported phone	Windows Phone 8
Namespace	Windows.Devices.Sensors Windows::Devices::Sensors [C++]
Metadata	Windows.winmd

Gyrometer class