feat: Add Camera.EaseTo function (#17)

Author: tuyen-vuduc

src/libs/Mapbox.Maui/IMapboxView.cs

@@ -70,6 +70,7 @@ public interface IMapboxController
 public interface IMapCameraController
 {
     void FlyTo(CameraOptions cameraOptions, AnimationOptions animationOptions = default, Action<AnimationState> completion = default);
+    void EaseTo(CameraOptions cameraOptions, AnimationOptions animationOptions = default, Action<AnimationState> completion = default);
 }
 
 public class MapTappedEventArgs : EventArgs

src/libs/Mapbox.Maui/Platforms/Android/MapboxViewHandler.Camera.cs

@@ -5,6 +5,25 @@ namespace MapboxMaui;
 
 partial class MapboxViewHandler : IMapCameraController
 {
+    public void EaseTo(CameraOptions cameraOptions, AnimationOptions animationOptions = null, Action<AnimationState> completion = null)
+    {
+        var mapView = mapboxFragment?.MapView;
+
+        if (mapView == null) return;
+
+        var xcameraOptions = cameraOptions.ToNative();
+        var xanimationOptions = animationOptions?.ToNative();
+
+        // TODO Return Cancellable obj
+        CameraAnimationsUtils.EaseTo(
+            mapView.MapboxMap,
+            xcameraOptions,
+            xanimationOptions,
+            completion != null
+            ? new XAnimationListener(completion)
+            : null);
+    }
+
     public void FlyTo(CameraOptions cameraOptions, AnimationOptions animationOptions = default, Action<AnimationState> completion = default)
     {
         var mapView = mapboxFragment?.MapView;

src/libs/Mapbox.Maui/Platforms/iOS/MapboxViewHandler.Camera.cs

@@ -4,6 +4,29 @@ namespace MapboxMaui;
 
 partial class MapboxViewHandler : IMapCameraController
 {
+    public void EaseTo(CameraOptions cameraOptions, AnimationOptions animationOptions = default, Action<AnimationState> completion = default)
+    {
+        var mapView = PlatformView.MapView;
+
+        if (mapView == null) return;
+
+        var xcameraOptions = cameraOptions.ToNative();
+        mapView.Camera().FlyTo(
+            xcameraOptions,
+            animationOptions?.Duration / 1000L ?? 0,
+            (position) =>
+            {
+                var xposition = position switch
+                {
+                    UIKit.UIViewAnimatingPosition.Start => AnimatingPosition.Start,
+                    UIKit.UIViewAnimatingPosition.End => AnimatingPosition.End,
+                    UIKit.UIViewAnimatingPosition.Current => AnimatingPosition.Current,
+                    _ => AnimatingPosition.Current,
+                };
+
+                completion?.Invoke(new AnimationState(xposition));
+            });
+    }
     public void FlyTo(CameraOptions cameraOptions, AnimationOptions animationOptions = default, Action<AnimationState> completion = default)
     {
         var mapView = PlatformView.MapView;

src/qs/MapboxMauiQs/Examples/Lab/65.CameraFlyAnimation/CameraFlyAnimationExample.cs src/qs/MapboxMauiQs/Examples/Lab/65.CameraAnimations/CameraAnimationsExample.cs

@@ -1,27 +1,43 @@
 namespace MapboxMauiQs;
 
-public class CameraFlyAnimationExample : ContentPage, IExamplePage, IQueryAttributable
+public class CameraAnimationsExample : ContentPage, IExamplePage, IQueryAttributable
 {
     MapboxView map;
     IExampleInfo info;
 
-    public CameraFlyAnimationExample()
+    public CameraAnimationsExample()
 	{
         iOSPage.SetUseSafeArea(this, false);
 
         var grid = new Grid();
 		map = new MapboxView();
         grid.Children.Add(map);
 
-        var btnMoveCamera = new Button()
+        var btnFlyCamera = new Button()
         {
-            Text = "Move Camera",
+            Text = "Fly to Hanoi",
+        };
+        btnFlyCamera.Clicked += HandleCameraFlyTo;
+
+        var btnEaseCamera = new Button()
+        {
+            Text = "Ease to HCMC",
+        };
+        btnEaseCamera.Clicked += HandleCameraEaseTo;
+
+        var btns = new HorizontalStackLayout
+        {
+            Children = {
+                btnFlyCamera,
+                btnEaseCamera,
+            },
             VerticalOptions = LayoutOptions.End,
             HorizontalOptions = LayoutOptions.Center,
             Margin = new Thickness(24),
+            Spacing = 16,
         };
-        btnMoveCamera.Clicked += HandleMoveCamera;
-        grid.Children.Add(btnMoveCamera);
+
+        grid.Children.Add(btns);
 
         map.MapReady += Map_MapReady;
         map.StyleLoaded += Map_StyleLoaded;
@@ -30,9 +46,9 @@ public CameraFlyAnimationExample()
         Content = grid;
 	}
 
-    private void HandleMoveCamera(object sender, EventArgs e)
+    private void HandleCameraFlyTo(object sender, EventArgs e)
     {
-        var centerLocation = new MapPosition(21.0278, 105.8342);
+        var centerLocation = new MapPosition(21.028511, 105.804817);
         var cameraOptions = new CameraOptions
         {
             Center = centerLocation,
@@ -43,6 +59,19 @@ private void HandleMoveCamera(object sender, EventArgs e)
             new AnimationOptions(3000L));
     }
 
+    private void HandleCameraEaseTo(object sender, EventArgs e)
+    {
+        var centerLocation = new MapPosition(10.762622, 106.660172);
+        var cameraOptions = new CameraOptions
+        {
+            Center = centerLocation,
+            Zoom = 12,
+        };
+        map.CameraController.EaseTo(
+            cameraOptions,
+            new AnimationOptions(3000L));
+    }
+
     public void ApplyQueryAttributes(IDictionary<string, object> query)
     {
         info = query["example"] as IExampleInfo;

src/qs/MapboxMauiQs/Examples/Lab/65.CameraAnimations/CameraAnimationsExampleInfo.cs

@@ -0,0 +1,11 @@
+namespace MapboxMauiQs;
+
+class CameraAnimationsExampleInfo : IExampleInfo
+{
+    public string Group => "Lab";
+    public string Title => "Camera Animations";
+    public string Subtitle => "Demo how camera animations work.";
+    public string PageRoute => typeof(CameraAnimationsExample).FullName;
+    public int GroupIndex => 0;
+    public int Index => 65;
+}