Close Menu

lsanimator

Introduction

The LSAnimator library is a powerful animation framework for iOS development. It provides an intuitive interface to create stunning animations with ease.

With LSAnimator, you can:

  • Create complex animations without writing complicated code

  • Effortlessly animate various properties of views and layers

  • Apply animation presets for common design patterns

  • Sequence and synchronize multiple animations

Installation

CocoaPods: To install LSAnimator using CocoaPods, add the following line to your Podfile:

pod 'LSAnimator'

Manual: If you prefer manual installation, you can download the LSAnimator framework from the official GitHub repository: https://github.com/ls1intum/LSAnimator.

Getting Started

To start using LSAnimator in your project, import the LSAnimator module:

import LSAnimator

To create a basic animation, follow these steps:

  1. Create an instance of LSAnimator:
let animator = LSAnimator(view: myView)

  1. Apply animation properties:
// Example - Change alpha value to 0 with duration 0.5 seconds
animator.animate(alpha: 0).withDuration(0.5)

  1. Start the animation:
animator.startAnimation()

LSAnimator allows you to chain multiple animations together:

// Example - Chain multiple animations
animator.animate(alpha: 0).and.then.animate(scale: 2).withDuration(1)

Advanced Features

Animation Presets: LSAnimator provides a set of animation presets for common design patterns. These presets simplify the creation of complex animations. For example, you can use the bounce preset to create a bouncing animation:

// Example - Bounce animation
animator.bounce().withDuration(1)

Synchronization: With LSAnimator, you can easily synchronize multiple animations using the .withDelay and .withCompletion methods. This allows you to create smooth and coordinated animations:

// Example - Synchronized animations
animator.animate(x: 100).withDuration(1).withDelay(0)
        .and.then.animate(y: 200).withDuration(1).withDelay(0)
        .and.then.animate(rotation: 90).withDuration(1).withDelay(0)
        .withCompletion {
            print("All animations completed.")
        }

Custom Animations: LSAnimator provides various methods to customize animations. You can specify easing functions, animation curves, repeat modes, and more:

// Example - Customizing animations
animator.animate(scale: 2).withDuration(1).usingSpring(damping: 0.5, velocity: 0)
        .and.then.animate(rotation: 180).withDuration(1).withCurve(.easeInOut)
        .and.then.animate(x: 100).withDuration(1).withRepeatMode(.reverse(count: 3))

Conclusion

LSAnimator is a feature-rich animation framework for iOS development. With its intuitive interface and extensive capabilities, you can create stunning animations to enhance your app’s user experience. Whether you need basic animations or advanced customization, LSAnimator has got you covered.