github

poldz123 / ShapeRipple

  • среда, 24 августа 2016 г. в 03:14:04
https://github.com/poldz123/ShapeRipple

Java
None



Release API GitHub license Twitter

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

alt tag

Features

  • Ripple effect
  • Random ripple colors
  • Random ripple position
  • Loaded with 4 different shapes
  • Create customizable shapes
  • Modify duration and interval of ripples

All Available Attributes

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

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

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:0.2.0'
}

2. Gradle maven dependency

  • Add it to your app build.gradle:
repositories {
    maven {
        url 'https://dl.bintray.com/nuuneoi/maven/'
    }
}

...

dependencies {
    compile 'com.rodolfonavalon:ShapeRippleLibrary:0.2.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:

License

Copyright 2016 Rodolfo Navalon

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.