/explode-view

💥 A beautiful explosion animation for Flutter.

Primary LanguageDartMIT LicenseMIT

Platform License: MIT Pub Package

A new open-source Flutter project that enables the developers to quickly enhance the ui of their application and can easily get started with the Flutter animation. The UI has been inspired from Redmi's uninstall application animation shown [here](https://github.com/mdg-soc-19/explode-view/blob/master/gif/explode-view-idea.gif).

This project contains the features of Flutter Animation that are required to complete an amazing Flutter application.

Explore how ExplodeView is made through this blog.

Index

Installing

1. Depend on it

Add this to your package's pubspec.yaml file:

  explode_view: ^1.0.4

2. Install it

You can install packages from the command line:

with pub:

$ pub get  

with Flutter:

$ flutter packages get  

Alternatively, your editor might support flutter pub get. Check the docs for your editor to learn more.

3. Import it

Now in your Dart code, you can use:

import  'package:explode_view/explode_view.dart';  

How To Use

Let's get this animation

For the explosion animation in the app, user has to simply add the ExplodeView as a child in any Widget like Stack and many more.

Example Code:

ExplodeView(  
 imagePath: 'assets/images/abc.png',  // path where the image is stored 
 imagePosFromLeft: 	120.0, // set x-coordinate for image 
 imagePosFromRight: 300.0,  // set y-coordinate for image 
);

For more info, please refer to the main.dart in example.

Algorithm

The algorithm used to build this project is as follows:

On clicking the image, the image would shake for some time and will disappear with generation of random particles in that image area and they would scatter farther with fading and upcoming transition and disappear finally on the screen. The colors of the particles are decided by the colors of the pixels of the image which provides the effect of breaking the image into pieces.

For more info, please refer to the explode_view.dart.

Documentation

Dart attribute Datatype Description Default Value
imagePath String The string which gives the path to the image. @required
imagePosFromLeft double The distance from the left edge of the screen. @required
imagePosFromTop double The distance from the top edge of the screen. @required

Bugs/Requests

If you encounter any problems feel free to open an issue. If you feel the library is
missing a feature, please raise a ticket on Github and I'll look into it.
Pull request are also welcome.

License

ExplodeView is licensed under MIT License. View license.