nicktrienens / swiftcolor

A Swift Extension for UIColor.

A Swift Extension for UIColor supporting iOS and Mac.

Installation

Embedded frameworks require a minimum deployment target of iOS 8.

CocoaPods

Add pod 'SwiftColor' to your Podfile:

source 'https://github.com/CocoaPods/Specs.git'
platform :ios, '8.0'
use_frameworks!

pod 'SwiftColor'

Carthage

To integrate SwiftColor into your Xcode project using Carthage, specify it in your Cartfile:

github "iCodesign/SwiftColor"

Manually

You can also integrate SwiftColor directly with souce code. Clone the repo and copy SwiftColor.swift to your project.

Usage

Color Init

SwiftColor provides a typealias for UIColor/NSColor as Color.

Hex String Init

Color("000")
Color("000C")
Color("0x4DA2D9")
Color(hexString: "#4DA2D9")
Color(hexString: "#4DA2D9CC")

Color(hexString: "#4DA2D9", alpha: 0.8)

"#4DA2D9CC".color

Hex Int Init

Color(hexInt: 0x000)
Color(hexInt: 0x000C)
Color(hexInt: 0x4DA2D9)
Color(hexInt: 0x4DA2D9CC)

Color(hexInt: 0x4DA2D9, alpha: 0.8)

(0x4DA2D9).color

Int Byte Init

Color(byteRed: 77, green: 162, blue: 217, alpha: 0.8)

Get/Change Color Components

let color = Color(hexString: "#4DA2D9CC")

// get color components
var (r, g, b, a) = color.colorComponents()

// change color components
var red = "000".color.red(255)
var alphaColor = Color(hexInt: 0x4DA2D9).alpha(0.8)

Equal Operator

Be careful with color space when developing Mac apps. SwiftColor uses NSCustomColorSpace.

// works for both iOS and Mac
let color1 = UIColor(red: 77/255.0, green: 162/255.0, blue: 217/255.0, alpha: 0.8)
color1 == Color(hexString: "0x4DA2D9CC")  // true

// only works for iOS
let color2 = UIColor.blackColor
color2 == "000".color  // true
color2 == "000C".color  // false

Convert to image

let image = "000".color.toImage()