https://github.com/carleihar/JRMFloatingAnimation

An Objective-C animation library used to create floating image views.
https://github.com/carleihar/JRMFloatingAnimation

Last synced: 3 months ago
JSON representation

An Objective-C animation library used to create floating image views.

• Host: GitHub
• URL: https://github.com/carleihar/JRMFloatingAnimation
• Owner: carleihar
• License: mit
• Created: 2016-03-07T20:02:52.000Z (over 8 years ago)
• Default Branch: master
• Last Pushed: 2017-10-02T18:10:55.000Z (about 7 years ago)
• Last Synced: 2024-07-19T13:22:37.041Z (4 months ago)
• Language: Objective-C
• Homepage:
• Size: 1.1 MB
• Stars: 233
• Watchers: 8
• Forks: 30
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-ios - JRMFloatingAnimation - An Objective-C animation library used to create floating image views. (UI / Animation)
• awesome-ios-star - JRMFloatingAnimation - An Objective-C animation library used to create floating image views. (UI / Animation)

README

        
# JRMFloatingAnimation

[![CI Status](http://img.shields.io/travis/Caroline Harrison/JRMFloatingAnimation.svg?style=flat)](https://travis-ci.org/Caroline Harrison/JRMFloatingAnimation)

[![Version](https://img.shields.io/cocoapods/v/JRMFloatingAnimation.svg?style=flat)](http://cocoapods.org/pods/JRMFloatingAnimation)

[![License](https://img.shields.io/cocoapods/l/JRMFloatingAnimation.svg?style=flat)](http://cocoapods.org/pods/JRMFloatingAnimation)

[![Platform](https://img.shields.io/cocoapods/p/JRMFloatingAnimation.svg?style=flat)](http://cocoapods.org/pods/JRMFloatingAnimation)

## About

JRMFloatingAnimation is an ObjC library used to create floating image views:

![Bubbles](http://i.imgur.com/qK2cqsA.gif) ![Sax](http://i.imgur.com/8NPeUXq.gif)

![Balloons](http://i.imgur.com/0yiav9V.gif) ![Tractor](http://i.imgur.com/2BOmIcQ.gif)

## Usage

To run the example project, clone the repo, and run `pod install` from the Example directory first.

To create the animation view:

	self.floatingView = [[JRMFloatingAnimationView alloc] initWithStartingPoint:self.view.center];

	[self.floatingView addImage:[UIImage imageName:@"myImage"]];

	[self.view addSubview:self.floatingView];

To animate the view:

	[self.floatingView animate];

You can add as many images to your view as you want, and they will be used randomly. Note that the images should be square.

There are a variety of different settings you can add to your animation view.

* `startingPointWidth` - Varies the x of the starting point, with the starting point y being the middle. default is 0.

* `maxAnimationHeight` - The maximum height that the animation may go. Default is the distance from the top of the frame to the starting point y value.

* `minAnimationHeight` - The minimum height that the animation may go. If this is larger than the maxAnimationHeight, they will swap. Default is 1/3 the maxAnimationHeight .

* `animationWidth` - The maximum "width" of the bezier path's control points fro the object's starting point. Changing this may give you unexpected results. Defaults: 

	* `JRMFloatingShape`: The object's size * 2.

	* `JRMFloatingShapeCurveLeft`: The distance between the starting point x and the let edge of the frame.

	* `JRMFloatingShapeCurveRight`: The distance between the starting point x and the right edge of the frame.

	* `JRMFloatingShapeTriangleUp`: The width of the frame.

* `pop`: Gives the impression of the images "popping" before they are removed from the view. Default NO.

* `maxFloatObjectSize`: The maximum size a floating object can be. Default is 20.

* `minFloatObjectSize`: The minimum size a floating object can be. If the minFloatObjectSize < maxFloatObjectSize, both sizes become the minFloatObjectSize. Default is 10.

* `floatingShape`: The "shape" that the animation can take. Default is JRMFloatingShapeStraight.

	* `JRMFloatingShapeTriangleUp` - Floats up in a cone shape from the starting point.

	* `JRMFloatingShapeStraight` - Floats straight up from the starting point.

	* `JRMFloatingShapeCurveLeft` - Floats up and curves to the left.

	* `JRMFloatingShapeCurveRight` - Floats up and curves to the right.

* `fadeOut`: If the floating object's alpha should fade out before disappearing from the view. Default NO.

* `varyAlpha`: If the floating object's alpahs should vary (to give a more randomized look). Default NO.

* `animationDuration`: The speed of the animation. Default 2.

* `removeOnCompletion`: If the floating object should be removed from the superview when the animation is finished. Default YES.

* `imageViewAnimationCompleted`: A completion block to call whenever an image view is finished animating. It will return the image view. (See the JRMDemoBalloonViewController.m file for an example.)

## Installation

#### CocoaPods

JRMFloatingAnimation is available through [CocoaPods](http://cocoapods.org). To install

it, simply add the following line to your Podfile:

```ruby

pod "JRMFloatingAnimation"

```

#### Manually

1. Download and drop ```/Pod/Classes```folder in your project.  

2. Congratulations! 

## Author

Caroline Harrison, [email protected]

## License

JRMFloatingAnimation is available under the MIT license. See the LICENSE file for more info.