drawing_animation

From static SVG assets		See more examples in the showcasing app.

Dynamically created from Path objects which are animated over time
	more coming soon …

The rendering library exposes a central widget called AnimatedDrawing which allows to render SVG paths (via AnimatedDrawing.svg) or Flutter Path objects (via AnimatedDrawing.paths) in a drawing like fashion.

Getting Started – AnimatedDrawing.svg

To get started with the drawing_animation package you need a valid Svg file.
Currently only simple path elements without transforms are supported (see Supported SVG specifications)

Add dependency in your pubspec.yaml


dependencies:
drawing_animation: ^0.1.3


2. **Add the SVG asset**
```yaml
assets:
  - assets/my_drawing.svg

Use the widget

An AnimatedDrawing widget can be initiated in two ways:
1. Simplified – without animation controller (See Example_01)
  
  By default every animation repeats infinitely. For running an animation only once you can use a callback to set run to false after the first animation cycle completed (see field onFinish).
```
AnimatedDrawing.svg(
  "assets/my_drawing.svg",
  run: this.run,
  duration: new Duration(seconds: 3),
  onFinish: () => setState(() {
    this.run  = false;
  }),
)
```
2. Standard – with animation controller (See Example_02)
  
  The simplified version will be sufficient in most of the use cases. If you wish to controll the animation furthermore or you want to syncronize it with other existing animations, you might consider using an custom animation controller:
```
AnimatedDrawing.svg(
  "assets/test.svg",
  controller: this.controller,
)
```
Check out examples in the examples folder. It seems that antialising for the Paint/Canvas is switched off when using debug mode. For pretty results use flutter run --release.

Getting Started – AnimatedDrawing.paths (still experimental)

By providing Path objects directly to the widget, elements can be changed dynamically, even during the animation. The internal data structure is rebuild every time the state changes, therefore the animation performance might suffer if the amount of elements in paths is very high (see Limitations). More examples will be provided soon (for now see Example_01 and Example_04).

  AnimatedDrawing.paths(
      [
      ///Path objects
      ],
      paints:[
      ///Paint objects (optional), specifies a [Paint] object for each [Path] element in paths.
      ],
      run: this.run,
      duration: new Duration(seconds: 3),
      onFinish: () => setState(() {
        this.run  = false;
      }),
    )

Current limitations:

As stated, for every state change of the widget, the internal data structure for the path objects is rebuilt. When the amount of provided path objects is high and a custom animationOrder is defined (which triggers a sorting operation over the data structure) it can result in lags. This becomes especially apparent when the state is rebuild at 60fps by another animation (e.g. rotating the path objects at every frame). Any suggestions on how to elegantly solve this are very welcome 🙂

Option list

Here is increasingly growing list with all available parameters and their visual effect.

Field	Type	‍ ‍ ‍ ‍ ‍ ‍ ‍ ‍ ‍ ‍ ‍ ‍ ‍ ‍ ‍ ‍ ‍ ‍ ‍ ‍ ‍ ‍ ‍ ‍ ‍ ‍ ‍ ‍ ‍ ‍ Example ‍ ‍ ‍ ‍ ‍ ‍ ‍ ‍ ‍ ‍ ‍ ‍ ‍ ‍ ‍ ‍ ‍ ‍ ‍ ‍ ‍ ‍ ‍ ‍ ‍ ‍ ‍ ‍ ‍ ‍
`lineAnimation` Specifies in which way the path elements are drawn to the canvas. When `allAtOnce` selected all path segments are drawn simultaneously. `oneByOne` paints every path segment one after another.	`LineAnimation.oneByOne`
	`LineAnimation.allAtOnce`
`animationOrder` Denotes the order in which the path elements are drawn to canvas when `lineAnimation` is set to `LineAnimation.oneByOne`. When no `animationOrder` is specified it defaults to the same order specified in the Svg asset or path array (`PathOrder.original`).	`PathOrders.original`
	`PathOrders.bottomToTop`
	`PathOrders.decreasingLength`
	`PathOrders.increasingLength`
	`PathOrders.leftToRight`
	`PathOrders.rightToLeft`
	`PathOrders.topToBottom`
`animationCurve` Easing curves are used to adjust the rate of change of an animation over time, allowing them to speed up and slow down, rather than moving at a constant rate. See Flutter docs.	`Curves.linear`
	`Curves.elasticOut`
	`Curves.bounceInOut`
	`Curves.decelerate`
	Other
`onFinish` Callback when one animation cycle is finished. By default every animation repeats infinitely.
`onPaint` Callback when a complete path is painted to the canvas. Returns with the relative index and the Path element itself.
`range` Start and stop a animation from a certain moment in time by defining a `AnimationRange` object.
`scaleToV