Felucia 1.5.3

You want to add pod 'Felucia', '~> 1.5' similar to the following to your Podfile:

target 'MyApp' do
  pod 'Felucia', '~> 1.5'
end

Then run a pod install inside your terminal, or from CocoaPods.app.

Alternatively to give it a test run, run the command:

pod try Felucia

Felucia 1.5.3

By
Michał Tynior
mtynior

Felucia provides useful extensions to UIColor.

Requirements

iOS 9.0+ / tvOS 9.0+ / watchOS 2.0+
Xcode 8+

Integration

Swift Package Managers (SPM)

You can use The Swift Package Manager to install Felucia by adding it to your Package.swift file:

import PackageDescription

let package = Package(
    name: "MyApp",
    targets: [],
    dependencies: [
        .Package(url: "https://github.com/mtynior/Felucia.git", majorVersion: 1)
    ]
)

Manually

You can also manually add Felucia to you project:

Download Felucia.swift file,
Drag Felucia.swift into you project's tree.

Usage

Color initialization

Hex ARGB string

UIColor(hexARGB: "#fff")
UIColor(hexARGB: "fff")
UIColor(hexARGB: "#e2f5d3")
UIColor(hexARGB: "e2f5d3")
UIColor(hexARGB: "#ffe2f5d3")
UIColor(hexARGB: "ffe2f5d3")

RGBA

UIColor(r: 255, g: 128, b: 64, a: 255)
UIColor(r: 255, g: 128, b: 64)

UIColor(red: 1.0, green: 0.5, blue: 0.25, alpha: 1.0)
UIColor(red: 1.0, green: 0.5, blue: 0.25)

CMYK

UIColor(cyan: 0, magneta: 0.5, yellow: 0.75, black: 0.498)

HSLA

The h can be set as value in [0, 1] or [0, 360].

The s can be set as value in l are in [0, 1] or [0, 100].

The a can be set as value in [0, 1].

UIColor(h: 157.0, s: 24, l: 51)
UIColor(h: 0.436, s: 0.24, l: 0.51)
UIColor(h: 0.436, s: 0.24, l: 0.51, a: 1.0)

Retrieving color components

UIColor(r: 255, g: 128, b: 64, a: 255).rgba() // (r: 255, g: 128, b: 64, a: 255)
UIColor(r: 255, g: 128, b: 64, a: 255).rgbaArray() // [255, 128, 64, 255]

UIColor(r: 255, g: 128, b: 64, a: 255).rgbaf() // (r: 1.0, g: 0.5, b: 0.25, a: 1.0)
UIColor(r: 255, g: 128, b: 64, a: 255).rgbafArray() // [1.0, 0.5, 0.25, 1.0]

UIColor(r: 255, g: 128, b: 64, a: 255).hsba() // (h: 0.056, s: 0.749, b: 1.0, a: 1.0)
UIColor(r: 255, g: 128, b: 64, a: 255).hsbaArray() // [0.056, 0.749, 1.0, 1.0]

UIColor(r: 255, g: 128, b: 64, a: 255).hsla() // (h: 0.0558464, s: 1.0, l: 0.62549, a: 1.0)
UIColor(r: 255, g: 128, b: 64, a: 255).hslaArray() // [0.0558464, 1.0, 0.62549, a:1.0]

UIColor(r: 255, g: 128, b: 64, a: 255).cmyk() // (c: 0.0, m: 0.498, y: 0.749, k: 0.0)
UIColor(r: 255, g: 128, b: 64, a: 255).cmykArray() // [0.0, 0.498, 0.749, 0.0]

Utilities

Complementary

Returns complementary color.

let color = UIColor.whiteColor().complementaryColor() 
color.rgba() // (r: 0, g: 0, b: 0, a: 255)

Lighten

Lightens the color a given amount, from 0.0 to 1.0. Providing 1.0 will always return white.

let color = UIColor.redColor().lighten()
color.rgba() // (r: 255, g: 51, b: 51, a: 255)

let color = UIColor.redColor().lighten(1.0)
color.rgba() // (r: 255, g: 255, b: 255, a: 255)

Darken

Darkens the color a given amount, from 0.0 to 1.0. Providing 1.0 will always return black.

let color = UIColor.redColor().darken()
color.rgba() // (r: 204, g: 0, b: 0, a: 255)

let color = UIColor.redColor().darken(1.0)
color.rgba() // (r: 0, g: 0, b: 0, a: 255)

Grayscale

Desaturates a color into greyscale.

let color = UIColor(r: 67, g: 122, b: 134).grayscale()
color.rgba() // (r: 106, g: 106, b: 106, a: 255)

IsLight

Returns true when the color's perceived brightness is light.

UIColor.whiteColor().isLight() // true

UIColor.blackColor().isLight() // false

IsDark

Returns true when the color's perceived brightness is dark.

UIColor.blackColor().isLight() // true

UIColor.whiteColor().isLight() // false

Random

Returns a random color.

let color = UIColor.randomColor()
color.rgba() // (r: 67, g: 122, b: 134 a:255)

License

Felucia is released under the MIT license. See LICENSE for details.