Skip to content

Commit

Permalink
Merge pull request #63 from willowtreeapps/feature/readme-update
Browse files Browse the repository at this point in the history
Readme and docs
  • Loading branch information
bret-fears authored Mar 24, 2017
2 parents 9205dec + 0a81bb7 commit 7e0a7cd
Show file tree
Hide file tree
Showing 54 changed files with 9,761 additions and 5 deletions.
12 changes: 7 additions & 5 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
![Spruce Logo](https://github.com/willowtreeapps/spruce-android/blob/develop/imgs/header_image.png)
![Spruce Logo](https://github.com/willowtreeapps/spruce-android/blob/master/imgs/header_image.png)

# Spruce Android Animation Library
[![CircleCI Build Status](https://circleci.com/gh/willowtreeapps/spruce-android.svg?style=shield)](https://circleci.com/gh/willowtreeapps/spruce-android)
Expand All @@ -8,6 +8,8 @@
## What is it?
Spruce is a lightweight animation library that helps choreograph the animations on the screen. With so many different animation libraries out there, developers need to make sure that each view is animating at the appropriate time. Spruce can help designers request complex multi-view animations and not have the developers cringe at the prototype.

![left](https://github.com/willowtreeapps/spruce-android/blob/master/imgs/top-left-corner.gif)![recycler](https://github.com/willowtreeapps/spruce-android/blob/master/imgs/recycler-example.gif)![right](https://github.com/willowtreeapps/spruce-android/blob/master/imgs/bottom-right-corner.gif)

### Gradle
Add the following to your project's build.gradle file

Expand All @@ -18,7 +20,7 @@ dependencies {
```

## Documentation
For javadocs checkout [the documentation](https://willowtreeapps.github.io/spruce-android/javadoc_output/index.html) for more information.
For javadocs checkout [the documentation](https://willowtreeapps.github.io/spruce-android/docs/index.html) for more information.

## Basic Usage
```java
Expand All @@ -29,7 +31,7 @@ Animator spruceAnimator = new Spruce
.start();
```

Checkout [the builder documentation](https://willowtreeapps.github.io/spruce-android/javadoc_output/com/willowtreeapps/spruce/Spruce.SpruceBuilder.html) for more information.
Checkout [the builder documentation](https://willowtreeapps.github.io/spruce-android/docs/com/willowtreeapps/spruce/Spruce.SpruceBuilder.html) for more information.

### Preparing for Animation
Spruce comes packed with `Animator` options within the `DefaultAnimations` class meant to make your life easier when calling an animation. Let's say we want to have your views fade in. For example, we would create an `animators = new Animator[] {}` and add `DefaultAnimations.fadeInAnimator(parentViewGroup, /*duration=*/800)` as an array item.
Expand All @@ -47,7 +49,7 @@ Animator spruceAnimator = new Spruce
.start();
```

Checkout [the builder documentation](https://willowtreeapps.github.io/spruce-android/javadoc_output/com/willowtreeapps/spruce/animation/DefaultAnimations.html) for more information.
Checkout [the builder documentation](https://willowtreeapps.github.io/spruce-android/docs/com/willowtreeapps/spruce/animation/DefaultAnimations.html) for more information.

## Using a SortFunction
Luckily, Spruce comes with 8 `SortFunction` implementations with a wide open possibility to make more! Use the `SortFunction` to change the order in which views animate. Consider the following example:
Expand Down Expand Up @@ -98,7 +100,7 @@ To make sure that developers can use Spruce out of the box, we included about 8
- `ContinousSort`
- `ContinuousWeightedSort`

Check out the docs [here](https://willowtreeapps.github.io/spruce-android/javadoc_output/com/willowtreeapps/spruce/sort/SortFunction.html) for more information
Check out the docs [here](https://willowtreeapps.github.io/spruce-android/docs/com/willowtreeapps/spruce/sort/SortFunction.html) for more information

## Stock Animators
To make everybody's lives easier, the stock animators perform basic `View` animations that a lot of apps use today. Mix and match these animators to get the core motion you are looking for.
Expand Down
34 changes: 34 additions & 0 deletions docs/allclasses-frame.html
Original file line number Diff line number Diff line change
@@ -0,0 +1,34 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<!-- NewPage -->
<html lang="en">
<head>
<!-- Generated by javadoc (1.8.0_65) on Fri Mar 17 15:59:04 EDT 2017 -->
<title>All Classes</title>
<meta name="date" content="2017-03-17">
<link rel="stylesheet" type="text/css" href="stylesheet.css" title="Style">
<script type="text/javascript" src="script.js"></script>
</head>
<body>
<h1 class="bar">All&nbsp;Classes</h1>
<div class="indexContainer">
<ul>
<li><a href="com/willowtreeapps/spruce/sort/ContinuousSort.html" title="class in com.willowtreeapps.spruce.sort" target="classFrame">ContinuousSort</a></li>
<li><a href="com/willowtreeapps/spruce/sort/ContinuousWeightedSort.html" title="class in com.willowtreeapps.spruce.sort" target="classFrame">ContinuousWeightedSort</a></li>
<li><a href="com/willowtreeapps/spruce/sort/CorneredSort.html" title="class in com.willowtreeapps.spruce.sort" target="classFrame">CorneredSort</a></li>
<li><a href="com/willowtreeapps/spruce/sort/CorneredSort.Corner.html" title="enum in com.willowtreeapps.spruce.sort" target="classFrame">CorneredSort.Corner</a></li>
<li><a href="com/willowtreeapps/spruce/animation/DefaultAnimations.html" title="class in com.willowtreeapps.spruce.animation" target="classFrame">DefaultAnimations</a></li>
<li><a href="com/willowtreeapps/spruce/sort/DefaultSort.html" title="class in com.willowtreeapps.spruce.sort" target="classFrame">DefaultSort</a></li>
<li><a href="com/willowtreeapps/spruce/sort/InlineSort.html" title="class in com.willowtreeapps.spruce.sort" target="classFrame">InlineSort</a></li>
<li><a href="com/willowtreeapps/spruce/sort/LinearSort.html" title="class in com.willowtreeapps.spruce.sort" target="classFrame">LinearSort</a></li>
<li><a href="com/willowtreeapps/spruce/sort/LinearSort.Direction.html" title="enum in com.willowtreeapps.spruce.sort" target="classFrame">LinearSort.Direction</a></li>
<li><a href="com/willowtreeapps/spruce/sort/RadialSort.html" title="class in com.willowtreeapps.spruce.sort" target="classFrame">RadialSort</a></li>
<li><a href="com/willowtreeapps/spruce/sort/RadialSort.Position.html" title="enum in com.willowtreeapps.spruce.sort" target="classFrame">RadialSort.Position</a></li>
<li><a href="com/willowtreeapps/spruce/sort/RandomSort.html" title="class in com.willowtreeapps.spruce.sort" target="classFrame">RandomSort</a></li>
<li><a href="com/willowtreeapps/spruce/sort/SortFunction.html" title="class in com.willowtreeapps.spruce.sort" target="classFrame">SortFunction</a></li>
<li><a href="com/willowtreeapps/spruce/Spruce.html" title="class in com.willowtreeapps.spruce" target="classFrame">Spruce</a></li>
<li><a href="com/willowtreeapps/spruce/Spruce.SpruceBuilder.html" title="class in com.willowtreeapps.spruce" target="classFrame">Spruce.SpruceBuilder</a></li>
<li><a href="com/willowtreeapps/spruce/sort/SpruceTimedView.html" title="class in com.willowtreeapps.spruce.sort" target="classFrame">SpruceTimedView</a></li>
</ul>
</div>
</body>
</html>
34 changes: 34 additions & 0 deletions docs/allclasses-noframe.html
Original file line number Diff line number Diff line change
@@ -0,0 +1,34 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<!-- NewPage -->
<html lang="en">
<head>
<!-- Generated by javadoc (1.8.0_65) on Fri Mar 17 15:59:04 EDT 2017 -->
<title>All Classes</title>
<meta name="date" content="2017-03-17">
<link rel="stylesheet" type="text/css" href="stylesheet.css" title="Style">
<script type="text/javascript" src="script.js"></script>
</head>
<body>
<h1 class="bar">All&nbsp;Classes</h1>
<div class="indexContainer">
<ul>
<li><a href="com/willowtreeapps/spruce/sort/ContinuousSort.html" title="class in com.willowtreeapps.spruce.sort">ContinuousSort</a></li>
<li><a href="com/willowtreeapps/spruce/sort/ContinuousWeightedSort.html" title="class in com.willowtreeapps.spruce.sort">ContinuousWeightedSort</a></li>
<li><a href="com/willowtreeapps/spruce/sort/CorneredSort.html" title="class in com.willowtreeapps.spruce.sort">CorneredSort</a></li>
<li><a href="com/willowtreeapps/spruce/sort/CorneredSort.Corner.html" title="enum in com.willowtreeapps.spruce.sort">CorneredSort.Corner</a></li>
<li><a href="com/willowtreeapps/spruce/animation/DefaultAnimations.html" title="class in com.willowtreeapps.spruce.animation">DefaultAnimations</a></li>
<li><a href="com/willowtreeapps/spruce/sort/DefaultSort.html" title="class in com.willowtreeapps.spruce.sort">DefaultSort</a></li>
<li><a href="com/willowtreeapps/spruce/sort/InlineSort.html" title="class in com.willowtreeapps.spruce.sort">InlineSort</a></li>
<li><a href="com/willowtreeapps/spruce/sort/LinearSort.html" title="class in com.willowtreeapps.spruce.sort">LinearSort</a></li>
<li><a href="com/willowtreeapps/spruce/sort/LinearSort.Direction.html" title="enum in com.willowtreeapps.spruce.sort">LinearSort.Direction</a></li>
<li><a href="com/willowtreeapps/spruce/sort/RadialSort.html" title="class in com.willowtreeapps.spruce.sort">RadialSort</a></li>
<li><a href="com/willowtreeapps/spruce/sort/RadialSort.Position.html" title="enum in com.willowtreeapps.spruce.sort">RadialSort.Position</a></li>
<li><a href="com/willowtreeapps/spruce/sort/RandomSort.html" title="class in com.willowtreeapps.spruce.sort">RandomSort</a></li>
<li><a href="com/willowtreeapps/spruce/sort/SortFunction.html" title="class in com.willowtreeapps.spruce.sort">SortFunction</a></li>
<li><a href="com/willowtreeapps/spruce/Spruce.html" title="class in com.willowtreeapps.spruce">Spruce</a></li>
<li><a href="com/willowtreeapps/spruce/Spruce.SpruceBuilder.html" title="class in com.willowtreeapps.spruce">Spruce.SpruceBuilder</a></li>
<li><a href="com/willowtreeapps/spruce/sort/SpruceTimedView.html" title="class in com.willowtreeapps.spruce.sort">SpruceTimedView</a></li>
</ul>
</div>
</body>
</html>
Loading

0 comments on commit 7e0a7cd

Please sign in to comment.