Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ondrejkunc/skiascene
Simple API to transform SkiaSharp objects using functions like zoom and rotate or using gestures like pan and pinch.
https://github.com/ondrejkunc/skiascene
Last synced: 3 days ago
JSON representation
Simple API to transform SkiaSharp objects using functions like zoom and rotate or using gestures like pan and pinch.
- Host: GitHub
- URL: https://github.com/ondrejkunc/skiascene
- Owner: OndrejKunc
- License: mit
- Created: 2017-12-23T17:32:59.000Z (about 7 years ago)
- Default Branch: master
- Last Pushed: 2022-04-30T20:32:49.000Z (over 2 years ago)
- Last Synced: 2024-12-17T19:06:59.525Z (10 days ago)
- Language: C#
- Homepage:
- Size: 354 KB
- Stars: 68
- Watchers: 5
- Forks: 18
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# SkiaScene
Collection of lightweight libraries which can be used to simplify manuplation with SkiaSharp graphic objects.
Supported platforms are .NET Standard 1.3, UWP, Xamarin.iOS, Xamarin.Android.
## Libraries
### SkiaScene
```
Install-Package SkiaScene
```
Implemented as .NET Standard 1.3 library.
Basic class which allows controlling `SKCanvas` transformations without the need to directly manipulate underlaying Matrix.
First you need to implement `Render` method of `ISKSceneRenderer` interface, where you define all your drawing logic on `SKCanvas`.
Then create the `SKScene` instance:
```csharp
//Create scene
ISKSceneRenderer myRenderer = new MyRenderer(); //user defined instance
scene = new SKScene(myRenderer);
//In your paint method
scene.Render(canvas); //Pass canvas from SKPaintSurfaceEventArgs
//Scene manipulation
scene.MoveByVector(new SKPoint(10, 0)); //Move by 10 units to the right independently from current rotation and zoom
scene.ZoomByScaleFactor(scene.GetCenter(), 1.2f); //Zoom to the center
scene.RotateByRadiansDelta(scene.GetCenter(), 0.1f); //Rotate around center
canvasView.InvalidateSurface(); //Force to repaint
```
### TouchTracking
```
Install-Package TouchTracking
```
Implemented as .NET Standard 1.3 and platform specific libraries.
TouchTracking provides unified API for multi-touch gestures on Android, iOS and UWP. It can be used without Xamarin.Forms.
Basic principles are described in Xamarin Documentation https://developer.xamarin.com/guides/xamarin-forms/application-fundamentals/effects/touch-tracking/
Usage is similar on each platform.
Android example:
```csharp
//Initialization
canvasView = FindViewById(Resource.Id.canvasView); //Get SKCanvasView
touchHandler = new TouchHandler() { UseTouchSlop = true };
touchHandler.RegisterEvents(canvasView); //Pass View to the touch handler
touchHandler.TouchAction += OnTouch; //Listen to the touch gestures
void OnTouch(object sender, TouchActionEventArgs args) {
var point = args.Location; //Point location
var type = args.Type; //Entered, Pressed, Moved ... etc.
//... do something
}
```
### TouchTracking.Forms
```
Install-Package TouchTracking.Forms
```
Implemented as .NET Standard 1.3 and platform specific libraries.
Same functionality as TouchTracking library but can be consumed in Xamarin.Forms as an Effect called TouchEffect.
```
xmlns:tt="clr-namespace:TouchTracking.Forms;assembly=TouchTracking.Forms"
```
**Important:** Right now, there is an issue on iOS in Xamarin.Forms, where routing effect resolution fails silently. To fix it, you must include this line in your AppDelegate FinishedLaunching:
```csharp
var _ = new TouchTracking.Forms.iOS.TouchEffect();
```
On UWP there is a similar problem in the Release mode where you need to provide explicit Assembly parameter to your Xamarin.Forms.Init method in App.Xaml.cs inside UWP project:
```csharp
Xamarin.Forms.Forms.Init(e, new[] { typeof(TouchTracking.Forms.UWP.TouchEffect).Assembly });
```
### SkiaScene.TouchManipulations
```
Install-Package SkiaScene.TouchManipulations
```
Implemented as .NET Standard 1.3 library.
Combines SkiaScene and TouchTracking libraries to detect and respond to the tap, pinch and pan gestures. Most of the functionality is described in Xamarin Documentation https://developer.xamarin.com/guides/xamarin-forms/advanced/skiasharp/transforms/touch/
`TouchGestureRecognizer` recieves touch event info in 'ProcessTouchEvent' method and fires concrete gesture event.
`SceneGestureResponder` subscribes to the events of `TouchGestureRecognizer` and executes correct actions in underlying `SKScene`.
`SceneGestureRenderingResponder` inherits from `SceneGestureResponder` and additionally controls frequency of calling `InvalidateSurface` method through `MaxFramesPerSecond` property.