Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/wieslawsoltes/panandzoom
Pan and zoom control for Avalonia.
https://github.com/wieslawsoltes/panandzoom
avalonia avaloniaui c-sharp control gui multi-platform pan pan-and-zoom xaml zoom
Last synced: 25 days ago
JSON representation
Pan and zoom control for Avalonia.
- Host: GitHub
- URL: https://github.com/wieslawsoltes/panandzoom
- Owner: wieslawsoltes
- License: mit
- Created: 2016-02-16T23:49:29.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2024-03-03T16:51:57.000Z (8 months ago)
- Last Synced: 2024-05-15T16:00:44.013Z (6 months ago)
- Topics: avalonia, avaloniaui, c-sharp, control, gui, multi-platform, pan, pan-and-zoom, xaml, zoom
- Language: C#
- Homepage: http://wieslawsoltes.github.io/PanAndZoom/
- Size: 260 MB
- Stars: 301
- Watchers: 10
- Forks: 43
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE.TXT
Awesome Lists containing this project
README
# PanAndZoom
[](https://gitter.im/wieslawsoltes/PanAndZoom?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge)
[](https://dev.azure.com/wieslawsoltes/GitHub/_build/latest?definitionId=98&branchName=master)
[](https://github.com/wieslawsoltes/PanAndZoom/actions/workflows/build.yml)
[](https://www.nuget.org/packages/Avalonia.Controls.PanAndZoom)
[](https://www.nuget.org/packages/Avalonia.Controls.PanAndZoom)
[](https://www.myget.org/gallery/panandzoom-nightly)
PanAndZoom control for Avalonia
## NuGet
PanAndZoom is delivered as a NuGet package.
You can find the NuGet packages here for [Avalonia](https://www.nuget.org/packages/Avalonia.Controls.PanAndZoom/) or by using nightly build feed:
* Add `https://www.myget.org/F/panandzoom-nightly/api/v2` to your package sources
* Alternative nightly build feed `https://pkgs.dev.azure.com/wieslawsoltes/GitHub/_packaging/Nightly/nuget/v3/index.json`
* Update your package using `PanAndZoom` feed
You can install the package for `Avalonia` based projects like this:
`Install-Package Avalonia.Controls.PanAndZoom -Pre`
### Package Sources
* https://api.nuget.org/v3/index.json
* https://www.myget.org/F/panandzoom-nightly/api/v2
## Resources
* [GitHub source code repository.](https://github.com/wieslawsoltes/PanAndZoom)
## Using PanAndZoom
`MainWindow.xaml`
```XAML
```
`MainWindow.xaml.cs`
```C#
using System.Diagnostics;
using Avalonia;
using Avalonia.Controls;
using Avalonia.Controls.PanAndZoom;
using Avalonia.Input;
using Avalonia.Markup.Xaml;
namespace AvaloniaDemo
{
public class MainWindow : Window
{
private readonly ZoomBorder? _zoomBorder;
public MainWindow()
{
this.InitializeComponent();
this.AttachDevTools();
_zoomBorder = this.Find("ZoomBorder");
if (_zoomBorder != null)
{
_zoomBorder.KeyDown += ZoomBorder_KeyDown;
_zoomBorder.ZoomChanged += ZoomBorder_ZoomChanged;
}
}
private void InitializeComponent()
{
AvaloniaXamlLoader.Load(this);
}
private void ZoomBorder_KeyDown(object? sender, KeyEventArgs e)
{
switch (e.Key)
{
case Key.F:
_zoomBorder?.Fill();
break;
case Key.U:
_zoomBorder?.Uniform();
break;
case Key.R:
_zoomBorder?.ResetMatrix();
break;
case Key.T:
_zoomBorder?.ToggleStretchMode();
_zoomBorder?.AutoFit();
break;
}
}
private void ZoomBorder_ZoomChanged(object sender, ZoomChangedEventArgs e)
{
Debug.WriteLine($"[ZoomChanged] {e.ZoomX} {e.ZoomY} {e.OffsetX} {e.OffsetY}");
}
}
}
```
### Getting zoom ratio
To get current zoom ratio use `ZoomX` and `ZoomY` properties.
### Getting pan offset
To get current pan offset use `OffsetX` and `OffsetY` properties.
### Constrain zoom ratio
To constrain zoom ratio use `MinZoomX`, `MaxZoomX`, `MinZoomY` and `MaxZoomY` properties.
### Constrain pan offset
To constrain pan offset use `MinOffsetX`, `MaxOffsetX`, `MinOffsetY` and `MaxOffsetY` properties.
### Enable or disable constrains
To enable or disable constrains use `EnableConstrains` flag.
## License
PanAndZoom is licensed under the [MIT license](LICENSE.TXT).