Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Added all of Robert Penner's easing equations, moved operations to th…
…eir own class
- Loading branch information
Dominik Hofmann
committed
Jul 9, 2011
1 parent
826859b
commit 435fc91
Showing
12 changed files
with
441 additions
and
106 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,8 @@ | ||
| Copyright (c) 2011, Dominik Hofmann | ||
| All rights reserved. | ||
|
|
||
| Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: | ||
|
|
||
| Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. | ||
| Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. | ||
| THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,114 @@ | ||
| PRTween | ||
| === | ||
|
|
||
| PRTween is a lightweight tweening library built for iOS. While Apple has done an incredible job with UIView Animations and Core Animation, there are some conscious limitations in these systems that are difficult to get around. PRTween is a great alternative if you'd like to: | ||
|
|
||
| * Animate a property Apple won't allow you to | ||
| * Ensure that <pre>[someView layoutSubviews]</pre> is respected during an animation | ||
| * Tween arbitrary numerical values, such as: sound volume, scroll position, a price counter, or many others | ||
| * Define your timing curve as a function rather than a bezier with control points | ||
|
|
||
| Installation | ||
| === | ||
|
|
||
| Simply grab the PRTween and PRTweenTimingFunction files from /lib/ and get them into your project. | ||
|
|
||
| Example Project | ||
| === | ||
|
|
||
| If you prefer to learn by looking at code that is already written, you can check out the example project in /example/ | ||
|
|
||
| Usage | ||
| === | ||
|
|
||
| At its core, PRTween is broken into two components. | ||
|
|
||
| A **period** is a representation of three points in time (beginning, current, and end) for a particular value that you plan on tweening. For example, suppose that are tweening a value from 100 to 200 over the course of 3 seconds. You can create an object to represent that period like this: | ||
|
|
||
| PRTweenPeriod *period = [PRTweenPeriod periodWithStartValue:100 endValue:200 duration:3]; | ||
|
|
||
| The second component that makes up PRTween is an **operation**. An operation contains logistic information about how a period should play out, as well as what should happen while it does. You can think of a period as an abstract representation of work that should be carried out, and an operation as the worker who decides *how* it gets carried out. An operation might get added to the queue like this: | ||
|
|
||
| PRTweenOperation *operation = [[PRTweenOperation new] autorelease]; | ||
| operation.period = period; | ||
| operation.target = self; | ||
| operation.timingFunction = &PRTweenTimingFunctionLinear; | ||
| operation.updateSelector = @selector(update:) | ||
|
|
||
| The code creates a new operation that carries out a tween over the period we defined earlier. Additionally, you've told the operation to call the <pre>update:</pre> selector every time the value is adjusted. <pre>update:</pre> might look like this: | ||
|
|
||
| - (void)update:(PRTweenPeriod*)period { | ||
| NSLog(@"%f", period.tweenedValue); | ||
| } | ||
|
|
||
| Finally, you will need to add the operation to the queue. | ||
|
|
||
| [[PRTween sharedInstance] addTweenOperation:operation] | ||
|
|
||
| As soon as you've done this and run your code, you should be able to see a console trace of a value moving from 100 to 200 over the course of 3 seconds. If you wanted to apply this to an object on screen, it could be as simple as changing <pre>update:</pre> to the following: | ||
|
|
||
| // will animate the Y offset of testView from 100 to 200 over the course of 3 seconds | ||
| - (void)update:(PRTweenPeriod*)period { | ||
| testView.frame = CGRectMake(0, period.tweenedValue, 100, 100); | ||
| } | ||
|
|
||
| Timing Functions | ||
| === | ||
|
|
||
| Timing functions are a key feature of PRTween, and allow you to modify how an operation interprets a period. For example, try changing <pre>operation.period</pre> from <pre>&PRTweenTimingFunctionLinear</pre> to <pre>&PRTweenTimingFunctionBounceOut</pre> and running your code again. You should see a similar animation play out, but this time a bounce will be added to the end of it. PRTween comes bundled with a number of timing functions for your convenience: | ||
|
|
||
| * PRTweenTimingFunctionLinear | ||
| * PRTweenTimingFunctionBack*[In / Out / InOut]* | ||
| * PRTweenTimingFunctionBounce*[In / Out / InOut]* | ||
| * PRTweenTimingFunctionCircOut*[In / Out / InOut]* | ||
| * PRTweenTimingFunctionCubicOut*[In / Out / InOut]* | ||
| * PRTweenTimingFunctionElasticOut*[In / Out / InOut]* | ||
| * PRTweenTimingFunctionExpoOut*[In / Out / InOut]* | ||
| * PRTweenTimingFunctionQuadOut*[In / Out / InOut]* | ||
| * PRTweenTimingFunctionQuartOut*[In / Out / InOut]* | ||
| * PRTweenTimingFunctionQuintOut*[In / Out / InOut]* | ||
| * PRTweenTimingFunctionSineOut*[In / Out / InOut]* | ||
|
|
||
| We encourage you to experiment with PRTween's timing functions in your applications to see which ones you like best. | ||
|
|
||
| Custom Functions | ||
| --- | ||
|
|
||
| One of the most powerful capabilities of PRTween is the ability to write your own timing functions. In lieu of documentation at this time, have a look through PRTweenTimingFunctions.m for example timing functions. | ||
|
|
||
| Advanced | ||
| === | ||
|
|
||
| API docs are coming with the next push. Until then, you are encouraged to dig through the code for details on advanced functionality. PRTween is incredibly minimal, so you can probably figure everything out in an hour or two. | ||
|
|
||
| Contributing | ||
| === | ||
|
|
||
| PRTween is incredibly young, so there many rules right now. | ||
|
|
||
| * Fork it | ||
| * Fix it or add it | ||
| * Add yourself to the contributor list | ||
| * Commit | ||
| * Send a pull request | ||
|
|
||
| Contributors | ||
| --- | ||
|
|
||
| * [This link](https://github.com/dominikhofmann/)Dominik Hofmann | ||
|
|
||
| License | ||
| === | ||
| Surprise! It's a BSD license. | ||
|
|
||
| <pre> | ||
| Copyright (c) 2011, Dominik Hofmann | ||
| All rights reserved. | ||
|
|
||
| Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: | ||
|
|
||
| Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. | ||
| Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. | ||
| THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. | ||
| </pre> | ||
|
|
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,6 +1,5 @@ | ||
|
|
||
| #import "PRTweenExampleViewController.h" | ||
| #import "PRTween.h" | ||
|
|
||
| @implementation PRTweenExampleViewController | ||
|
|
||
|
|
||
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Oops, something went wrong.