Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/LeoNatan/LNInterpolation
An interpolation framework for Cocoa and Cocoa Touch.
https://github.com/LeoNatan/LNInterpolation
cocoa cocoa-touch interpolation objective-c swift
Last synced: about 1 month ago
JSON representation
An interpolation framework for Cocoa and Cocoa Touch.
- Host: GitHub
- URL: https://github.com/LeoNatan/LNInterpolation
- Owner: LeoNatan
- License: mit
- Archived: true
- Created: 2016-10-05T13:50:41.000Z (about 8 years ago)
- Default Branch: master
- Last Pushed: 2023-02-16T11:32:19.000Z (almost 2 years ago)
- Last Synced: 2024-10-29T08:06:12.249Z (about 1 month ago)
- Topics: cocoa, cocoa-touch, interpolation, objective-c, swift
- Language: Objective-C
- Homepage:
- Size: 315 KB
- Stars: 30
- Watchers: 3
- Forks: 6
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome - LNInterpolation - An interpolation framework for Cocoa and Cocoa Touch. (swift)
README
# LNInterpolation
An interpolation framework for Cocoa and Cocoa Touch.
[](https://github.com/LeoNatan/LNInterpolation/releases) [](https://github.com/LeoNatan/LNInterpolation/stargazers) [](https://raw.githubusercontent.com/LeoNatan/LNInterpolation/master/LICENSE) 
[](https://github.com/LeoNatan/LNInterpolation/issues) [](https://github.com/LeoNatan/LNInterpolation/graphs/contributors) [](https://swift.org/package-manager/) [](https://github.com/Carthage/Carthage)
## Protocol
The framework defines a protocol, `LNInterpolable` (`Interpolable` in Swift), defining a common API for interpolating between two values.
The protocol defines two methods.
### Objective C
```objective-c
- (instancetype)interpolateToValue:(id)toValue progress:(double)progress;
- (instancetype)interpolateToValue:(id)toValue progress:(double)progress behavior:(LNInterpolationBehavior)behavior;
```
### Swift
```
public func interpolate(to toValue: Any, progress: Double) -> Self
public func interpolate(to toValue: Any, progress: Double, behavior: InterpolationBehavior) -> Self
```
The first variant returns an interpolated value between the original and `toValue` according to progress, using the default behavior.
The second is similar, but receives a behavior modifier. Each implementation can use this to choose how to implement the interpolation between the values. A default value of `LNInterpolationBehaviorUseDefault` (`.useDefault` in Swift) is always available.
## Provided Implementations
The framework provides implementation for the most common cases where interpolation may be needed.
### `NSValue` and `NSNumber`
An implementation is provided for `NSValue`, which provides support for the following values:
* Numbers (`NSNumber`)
* Decimal numbers (`NSDecimalNumber`)
* Core Graphics: `CGPoint`, `CGSize`, `CGVector`, `CGRect`, `CGAffineTransform` (`NSValue`)
* UIKit: `UIOffset`, `UIEdgeInsets` (`NSValue`)
* AppKit: `NSEdgeInsets` (`NSValue`)
### `UIColor` and `NSColor`
An implementation is provided for colors (both for iOS and macOS). By default, color interpolation is performed in Lab colorspace for best possible interpolation quality. If performance is an issue, you may use `LNInterpolationBehaviorUseRGBColorSpace` (`.useRGBColorSpace` in Swift) to specify a behavior where RGB colorspace is used.
## Demo Playground
A demo playground is provided. Open LNInterpolationExample/LNInterpolationExample.xcworkspace and build the framework for macOS. Open the playground and explore the available pages.
## Adding to Your Project
### Swift Package Manager
Swift Package Manager is the recommended way to integrate `LNInterpolation` in your project.
`LNInterpolation` supports SPM versions 5.1.0 and above. To use SPM, you should use Xcode 11 to open your project. Click `File` -> `Swift Packages` -> `Add Package Dependency`, enter `https://github.com/LeoNatan/LNInterpolation`. Select the version you’d like to use.
You can also manually add the package to your `Package.swift` file:
```swift
.package(url: "https://github.com/LeoNatan/LNInterpolation.git", from: "1.0")
```
And the dependency in your target:
```swift
.target(name: "BestExampleApp", dependencies: ["LNInterpolation"]),
```
### Carthage
Add the following to your Cartfile:
```github "LeoNatan/LNInterpolation"```
### Manual
Drag the `LNInterpolation.xcodeproj` project to your project, and add `LNInterpolation.framework` to **Embedded Binaries** in your project target's **General** tab. Xcode should sort everything else on its own.