Swiftpack.co -  ivanvorobei/SPPerspective as Swift Package
Swiftpack.co is a collection of thousands of indexed Swift packages. Search packages.
ivanvorobei/SPPerspective
Widgets iOS 14 animation with 3D and dynamic shadow. Customisable transform and duration.
.package(url: "https://github.com/ivanvorobei/SPPerspective.git", from: "1.3.4")

SPPerspective

About

Animatable widgets from iOS 14. Same animation for transform and shadow.

Customisable duration, perspective and shadow also. For visual edit use example app, check video preview:

https://opensource.ivanvorobei.by/spperspective/preview

If you like the project, don't forget to put star ★
Check out my other libraries:

Navigate

Installation

Ready for use on iOS 12+. Works with Swift 5+. Required Xcode 12.0 and higher.

Swift Package Manager

The Swift Package Manager is a tool for managing the distribution of Swift code. It’s integrated with the Swift build system to automate the process of downloading, compiling, and linking dependencies.

To integrate SPPerspective into your Xcode project using Xcode 12, specify it in File > Swift Packages > Add Package Dependency...:

https://github.com/ivanvorobei/SPPerspective

CocoaPods:

CocoaPods is a dependency manager for Cocoa projects. For usage and installation instructions, visit their website. To integrate SPPerspective into your Xcode project using CocoaPods, specify it in your Podfile:

pod 'SPPerspective'

Manually

If you prefer not to use any of dependency managers, you can integrate SPPerspective into your project manually. Put Sources/SPPerspective folder in your Xcode project. Make sure to enable Copy items if needed and Create groups.

Quick Start

For apply animation for your view, use this code:

view.applyPerspective(.iOS14WidgetAnimatable)

Use this, if need apply non-animation transform:

view.applyPerspective(.iOS14WidgetStatic)

Customise

Summary

You can customise duration, angle, shadow properties and other. All this customising by configuration file. Configuration can be animatable or static. Above you see .iOS14WidgetAnimatable & .iOS14WidgetStatic, its also configurations wich already have good-usage values same as native widgets.

For get fine configuration, better use example app (video preview). You can in real time see changes in configuration.

https://opensource.ivanvorobei.by/spperspective/preview

Next more details about customise.

Duration

When you init new animation configuration, you can set duration:

let animationConfig = SPPerspectiveAnimationConfig(duration: 16, distortion: 600, angle: 10, vectorStep: 3.14, shadow: nil)
view.applyPerspective(animationConfig)

If need change duration for default config, using this:

let animationConfig = SPPerspectiveConfig.iOS14WidgetAnimatable
animationConfig.animationDuration = 8
view.applyPerspective(animationConfig)

Perspective

Angle is how much the view will rotate. For change it call angle in config:

animationConfig.angle = 10

Also you can customise distortion of perspective. Using this:

animationConfig.distortionPerspective = 600

Both properties allow you configure transform for your view. If you don't know which values shoud using, check use example app (video preview). With sliders you can customize it in detail.

Shadow

Shadow also using configuration. Static and animation configs contains shadow property.

Blur, Opacity & Color

It simple. For change blur, opacity and color call this in configuration.

animationConfig.shadowConfig?.blurRadius = 5
animationConfig.shadowConfig?.opacity = 0.3
animationConfig.shadowConfig?.color = .black

Translations

Translation help customise position of shadow for any state of transform. For example you can want do more vertical translation for show deep transform.

Transform adaptive for each higlight corner. For example startVerticalOffset using when highlight top-center side. For bottom corners available cornerVerticalOffset. For bottom-center side shoud change maximumVerticalOffset . Horizontal trnalation customising by maximumHorizontalOffset.

animationConfig.shadowConfig?.startVerticalOffset = 8
animationConfig.shadowConfig?.cornerVerticalOffset = 18
animationConfig.shadowConfig?.maximumVerticalOffset = 21
animationConfig.shadowConfig?.maximumHorizontalOffset = 12

For get fine result, you shoud use this rule: startVerticalOffset < cornerVerticalOffset < maximumVerticalOffset. Visual transform available in example app (video preview), with it you get fine values.

Other Projects

I love being helpful. Here I have provided a list of libraries that I keep up to date. For see video previews of libraries without install open opensource.ivanvorobei.by website.
I have libraries with native interface and managing permissions. Also available pack of useful extensions for boost your development process.

Russian Community

Веду каналы об iOS разработке. Один с туториалами и новостями, другой с обзором библиотек.
Со сложной задачей помогут в чате.

Видео-туториалы выклыдываю на YouTube:

Tutorials on YouTube

GitHub

link
Stars: 178
Last commit: 5 days ago

Ad: Job Offers

iOS Software Engineer @ Perry Street Software
Perry Street Software is Jack’d and SCRUFF. We are two of the world’s largest gay, bi, trans and queer social dating apps on iOS and Android. Our brands reach more than 20 million members worldwide so members can connect, meet and express themselves on a platform that prioritizes privacy and security. We invest heavily into SwiftUI and using Swift Packages to modularize the codebase.

Release Notes

Fixed SPM.
5 days ago

Swiftpack is being maintained by Petr Pavlik | @ptrpavlik | @swiftpackco | API