/Randient

🎨 Radient, random gradients in Swift

Primary LanguageSwiftMIT LicenseMIT

Tabman

CocoaPods Platforms

Tabman

⭐️ Features

  • Beautiful, automatically generated gradients from uiGradients in Swift.
  • Smoothly animating, randomizable gradient views.
  • Life is like a box of chocolates.

📋 Requirements

iOS 9 & Swift 4 / 5.

📲 Installation

CocoaPods

To install Randient using CocoaPods, add this line to your Podfile:

pod 'Randient'

Carthage

To install Randient using Carthage, add this line to your Cartfile:

github "Randient"

🚀 Usage

Gradient Roulette

RandientView is a simple view that will display a randomly selected gradient from the uiGradients catalog.

let randientView = RandientView()
randientView.frame = CGRect(x: 0, y: 0, width: 100, height: 100)
view.addSubview(randientView)

Updating to a new gradient is as simple as...

randientView.randomize(animated: true)

Those wonderful gradients

An enum of all the gradients from uiGradients is generated every time that Randient is built.

These are available as an enum via UIGradient.

let gradient = UIGradient.royalBlue
let colors = gradient.data.colors

If you're feeling lucky, a randomized UIGradient can also be retrieved.

let randomGradient = Randient.randomize()

The raw stuff

Each UIGradient has associated Data which can be accessed via .data.

struct Data {
    public let name: String
    public let colors: [UIColor]
}

Metadata is also available, accessible via .metadata.

struct Metadata {
    public let isPredominantlyLight: Bool
}

Gradient View

RandientView inherits from GradientView, which under the hood uses simply uses a CAGradientLayer for rendering gradients.

GradientView provides the following:

  • .colors: [UIColor]? - Colors of the gradient.
  • .locations: [Double]? - Locations of each gradient stop.
  • .startPoint: CGPoint - Start point of the gradient (Defaults to 0.5, 0.0).
  • .endPoint: CGPoint - End point of the gradient (Defaults to 0.5, 1.0).

👨🏻‍💻 About

❤️ Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/uias/Randient.

👮🏻‍♂️ License

The library is available as open source under the terms of the MIT License.