easeqs-objc 0.1.1

Maintained by Nik Burnt.

You want to add pod 'easeqs-objc', '~> 0.1' similar to the following to your Podfile:

target 'MyApp' do
  pod 'easeqs-objc', '~> 0.1'
end

Then run a pod install inside your terminal, or from CocoaPods.app.

Alternatively to give it a test run, run the command:

pod try easeqs-objc

easeqs-objc 0.1.1

By
Nik Burnt

Quick Look

This library was created for general usage when keyframe animations used and key values can't be easily interpolated thru animation progress.

easeqs

Availabble Easing Functions

Here is the list of available easing functions:

	In	Out	InOut	OutIn
Linear
Sinusoidal
Quadratic
Cubic
Quartic
Quintic
Exponential
Circular
Back
Bounce
Elastic

Usage

This library can be used in two ways: OOP and functional.
In the first case easing function represents one of the next objects instance(they all are childs of ESQEasingFunction):

ESQLinearEasingFunction
ESQSinusoidalEasingFunction
ESQQuadraticEasingFunction
ESQCubicEasingFunction
ESQQuarticEasingFunction
ESQQuinticEasingFunction
ESQExponentialEasingFunction
ESQCircularEasingFunction
ESQBackEasingFunction
ESQBounceEasingFunction
ESQElasticEasingFunction

Those object can be instantiated in the few ways:

Without any parameters, default values will be used for type(ESQEasingFunctionTypeOut) and parameters

CGFloat progress = ...
ESQEasingFunction *easingFunction = [[ESQElasticEasingFunction alloc] init];
CGFloat easedProgress = [easingFunction easedProgress:progress];

With specified type(if functiona also have a parameters default values will be used)

CGFloat progress = ...
ESQEasingFunction *easingFunction = [ESQElasticEasingFunction easingFunctionWithType:ESQEasingFunctionTypeInOut];
CGFloat easedProgress = [easingFunction easedProgress:progress];

With specified type and parameters:

CGFloat customAmplitude = ...
CGFloat progress = ...
ESQEasingFunction *easingFunction = [ESQElasticEasingFunction easingFunctionWithType:ESQEasingFunctionTypeInOut amplitude:customAmplitude  period:ESQDefaultElasticPeriod];
CGFloat easedProgress = [easingFunction easedProgress:progress];

Also, if you preffer funcitons or need more perfomance you may use easing functions which can provide the same results as using objects. Here is the list of all available easing funcitons:

	In	Out	InOut	OutIn
Linear	`linearIn(p)`	`linearOut(p)`	`linearInOut(p)`	`linearOutIn(p)`
Sinusoidal	`sinusoidalIn(p)`	`sinusoidalOut(p)`	`sinusoidalInOut(p)`	`sinusoidalOutIn(p)`
Quadratic	`quadraticIn(p)`	`quadraticOut(p)`	`quadraticInOut(p)`	`quadraticOutIn(p)`
Cubic	`cubicIn(p)`	`cubicOut(p)`	`cubicInOut(p)`	`cubicOutIn(p)`
Quartic	`quarticIn(p)`	`quarticOut(p)`	`quarticInOut(p)`	`quarticOutIn(p)`
Quintic	`quinticIn(p)`	`quinticOut(p)`	`quinticInOut(p)`	`quinticOutIn(p)`
Exponential	`exponentialIn(p)`	`exponentialOut(p)`	`exponentialInOut(p)`	`exponentialOutIn(p)`
Circular	`circularIn(p)`	`circularOut(p)`	`circularInOut(p)`	`circularOutIn(p)`
Back	`backIn(p, o)`	`backOut(p, o)`	`backInOut(p, o)`	`backOutIn(p, o)`
Bounce	`bounceIn(p, o)`	`bounceOut(p, o)`	`bounceInOut(p, o)`	`bounceOutIn(p, o)`
Elastic	`elasticIn(p, a, q)`	`elasticOut(p, a, q)`	`elasticInOut(p, a, q)`	`elasticOutIn(p, a, q)`

Every function should obtain progress as input and a few parameters(if needed).

CGFloat customAmplitude = ...
CGFloat progress = ...
CGFloat easedProgress = elasticInOut(progress, customAmplitude, ESQDefaultElasticPeriod);

Pleae, take a note, that default values for functions provided available in each header where this funciton described.

Installing

easeqs-objc is available through CocoaPods or may be easily build from source.

Dynamic Framework

If you're using Swift, you may wish to install dynamic frameworks, which can be done with the Podfile shown below:

platform :ios, '9.0'

use_frameworks!

pod 'easeqs-objc'

Roadmap

Add 4 dimensions structures keyframe animaiton support(CGRect)
Add Carthage support
Think about better way to describe multiple easing funcitons for the animaiton of complex structures(2 or more dimensional)
Create Swift version