Plugin.Maui.XTiltIndicator 1.0.1

Plugin.Maui.XTiltIndicator

XPitchIndicator is a MAUI control for displaying the device's tilt (pitch) in both horizontal and vertical axes. It supports two display modes: Gauge (semi-circular arc with indicator) and Bars (horizontal/vertical bars). Ideal for flight simulators, technical instruments, HUDs, or any app that needs to visualize device orientation.

Features

• Supports HorizontalPitch and VerticalPitch.
• Display modes: Gauge or Bars.
• Customizable colors for the indicator and zero line.
• Optional numeric display of pitch value.
• Smooth motion with easing (lerp) for natural transitions.
• Built on GraphicsView for optimal performance.
• Uses the device accelerometer to calculate pitch angles.

Installation

Install via NuGet:

dotnet add package Plugin.Maui.XTiltIndicator --version 1.0.1

Configuration

Add UseXTiltIndicator() inside MauiProgram >>> MauiApp CreateMauiApp()

     public static MauiApp CreateMauiApp() {
        var builder = MauiApp.CreateBuilder();
        builder
            .UseMauiApp<App>()
            .UseXTiltIndicator() //<<< This line

You can customize the control by setting its bindable properties in XAML or C#.

Example XAML

<Grid BackgroundColor="White">
    <xctrls:XPitchIndicator
        HorizontalOptions="Fill"
        VerticalOptions="Fill"
        PitchColor="Red"
        PitchZeroColor="Lime"
        HorizontalPitch="Gauge"
        VerticalPitch="Gauge"
        ShowHorizontalPitchValue="False"/>
        
    <Label Text="Your content" HorizontalOptions="Center" />
</Grid>

Example C# Usage

using Plugin.Maui.XTiltIndicator;

var pitchIndicator = new XPitchIndicator
{
    HorizontalOptions = LayoutOptions.Fill,
    VerticalOptions = LayoutOptions.Fill,
    PitchColor = Colors.Red,
    PitchZeroColor = Colors.Lime,
    HorizontalPitch = TPitchType.Gauge,
    VerticalPitch = TPitchType.Gauge,
    ShowHorizontalPitchValue = false
};

var grid = new Grid { BackgroundColor = Colors.White };
grid.Children.Add(pitchIndicator);
grid.Children.Add(new Label 
{ 
    Text = "Your content", 
    HorizontalOptions = LayoutOptions.Center 
});

Content = grid;

Bindable Properties

Smooth Motion / Easing

The control applies a linear interpolation (lerp) to smooth the movement of the indicator when pitch values change. This creates a natural, analog-style motion, avoiding abrupt jumps from sensor updates.

Notes

• On emulators, accelerometer values may not be exactly zero due to simulation offsets.
• Tested on Android, iOS, and Windows MAUI apps.
• For best results, test on a real device.

License

MIT License. Free to use and modify.