https://github.com/acoomans/Parallax

Parallax is an iOS library that reproduces the parallax effect of the iOS7 home screen.
https://github.com/acoomans/Parallax

Last synced: 3 months ago
JSON representation

Parallax is an iOS library that reproduces the parallax effect of the iOS7 home screen.

• Host: GitHub
• URL: https://github.com/acoomans/Parallax
• Owner: acoomans
• License: bsd-2-clause
• Created: 2013-06-16T15:50:17.000Z (over 11 years ago)
• Default Branch: master
• Last Pushed: 2014-01-15T23:48:25.000Z (about 11 years ago)
• Last Synced: 2024-09-20T04:16:55.511Z (5 months ago)
• Language: Objective-C
• Size: 2.18 MB
• Stars: 407
• Watchers: 25
• Forks: 49
• Open Issues: 4
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Parallax

Parallax is an iOS library that reproduces the parallax effect of the iOS7 home screen.

[![Build Status](https://api.travis-ci.org/acoomans/Parallax.png)](https://api.travis-ci.org/acoomans/Parallax.png)

[![Cocoapods](https://cocoapod-badges.herokuapp.com/v/Parallax/badge.png)](http://beta.cocoapods.org/?q=on%3Aios%20name%3Aparallax%2A)

[![Cocoapods](https://cocoapod-badges.herokuapp.com/p/Parallax/badge.png)](http://beta.cocoapods.org/?q=on%3Aios%20name%3Aparallax%2A)

## Dependencies

- QuartzCore

- CoreMotion

## Usage

1. Add the _Parallax_ directory into your project.

2. Add `#import "ACParallax.h"` to your view controller.

3. Add a _ACParallax_ view and start the parallax effect with `parallaxView.parallax = YES;`

Optional:

If you want a delegate to be notified of begin/end parallax effect and changes in the motion attitude:

    

    parallaxView.parallaxDelegate = self;

    

    

If you want the parallax view to refocus slowly and automatically:

    parallaxView.refocusParallax = YES;

    

## Install with CocoaPods

Use [CocoaPods](http://cocoapods.org) add Parallax to your project.

* Add a pod entry for Parallax to your Podfile 

```

pod 'Parallax', '~> 0.0.1'

```

* Install the pod(s) by running:

```

pod install

```

## Screenshot

![screenshots](https://raw.github.com/acoomans/Parallax/master/ParallaxDemo/parallax.gif)

## Bugs

- Device pitch is not handled correctly; behaves weirdly when the device is held straight up.

- Some implementations details missing (see TODOs)

## Thanks

[San Francisco Bridge by Jeff Gunn (Creative Commons)](http://www.flickr.com/photos/jeffgunn/6663234085/)

Cocoapods specs by [Bruno Furtado](https://github.com/Bruno-Furtado)