Shape Ripple is a library that emulates a ripple like animations with cool tweaks on the go. It runs on API level 11 and upwards.

As addition you can even create your own shape renderer through the canvas to create a custom shape ripple.

Demo

For a brief overview of the library you can download the app in Google PlayStore Shape Ripple apk and try it out. The apk code for this demo app is located in the ShapeRippleExample folder

Features

Ripple effect
Random ripple colors
Random ripple position
Stroke or Filled Ripple
Loaded with 5 different shapes
Create customizable shapes
Modify duration and interval of ripples

All Available Attributes

Attributes	Effect
`ripple_color`	color color of the base ripple
`enable_single_ripple`	boolean flag for enabling the single ripple only
`ripple_duration`	millisecond the duration of each ripple animation
`enable_color_transition`	boolean flag for enabling the color transition
`enable_random_position`	boolean flag for enabling the random positining of ripple in the view
`enable_random_color`	boolean flag for enabling the random coloring for each ripple
`enable_stroke_style`	boolean flag for enabling the stroke style for each ripple
`ripple_from_color`	color starting color for the color transition of the ripple
`ripple_to_color`	color end color for the color transition of the ripple
`ripple_stroke_width`	dimension base stroke width for each of the ripple
`ripple_maximum_radius`	dimension maximum radius of each of the ripples
`ripple_count`	integer number of ripples to be rendered

Customizing Ripples

Customizing the ripple is easy. You can create a class that extends BaseShapeRipple and fill out the:

onSetup(Context context, Paint shapePaint)

This is called only once before any rendering happens, good for loading data/resources.

onDraw(Canvas canvas, int x, int y, float radiusSize, int color, int rippleIndex, Paint shapePaint)

This draws the actual ripple to the canvas. You can create your custom shapes here whatever you want.

For full documentation of the of the methods above go the the BaseShapeRipple class.

Usage

You can select which options you want to use:

1. JCenter dependency(Recommended)

Add it to your app build.gradle:

dependencies {
    compile 'com.rodolfonavalon:ShapeRippleLibrary:1.0.0'
}

2. Gradle maven dependency

Add it to your app build.gradle:

repositories {
    maven {
        url 'https://dl.bintray.com/poldz123/maven/'
    }
}

...

dependencies {
    compile 'com.rodolfonavalon:ShapeRippleLibrary:1.0.0'
}

3. arr file only

Down the latest arr file from the release section
Copy the latest arr file to your libs folder of your Android Application
Start using the library

4. Clone whole repository

Open your commandline-input and navigate to the desired destination folder on your machine (where you want to place the library)
Use the command https://github.com/poldz123/ShapeRipple.git to download the full ShapeRipple repository to your computer (this includes the folder of the library as well as the folder of the example project)
Import the library folder (ShapeRippleLibrary) into Android Studio (recommended) or your Eclipse workspace
Add it as a reference to your project:
- referencing library projects in Eclipse
- managing projects from Android Studio

License

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

poldz123/ShapeRipple

poldz123

Reviews

Repository Details