Generate a color palette from a UIImage.

Other color palette generators will only give you a list of the dominant colors in an image. Vibrant does much more.

Now I know what you're thinking: "But Bryce, colors from an image! That's what I want! That's why I'm on your repository in the first place!"

Well I've got news for you: swift-vibrant (or node-vibrant, if you use JavaScript. No affiliation but that's what this project is based off of) will not only give you the dominant colors in an image, oh no. It will also give you a fully featured palette. What's the difference you might ask?

It provides:

• A Vibrant Color (Duh)
• A Muted Color
• A Dark Vibrant Color
• A Dark Muted Color
• A Light Vibrant Color
• A Light Muted Color

As well as 2 different text colors for each of the above that look good on the color they're designed for.

Don't believe me? There's a 100% money back guarantee! (Just kidding, it's MIT licensed aka free for your use).

swift-vibrant is available through CocoaPods. To install it, simply add the following line to your Podfile:

pod 'swift-vibrant'

import swiftVibrant

let image = UIImage(named: "name_of_image")

// Calling from a background thread
Vibrant.from(image).getPalette({ palette in 
    // do stuff with your palette
})
// Calling in main thread
Vibrant.from(image).getPalette()
/// do stuff with your palette here

// Using constructor
let v = Vibrant(image, Vibrant.Options)
v.getPalette({ palette in 
    // do stuff with your palette
})

Main class of swift-vibrant.

Make a Builder for an image. Returns a Builder instance.

public struct Options {
       var colorCount: Int = 64
       var quality: Int = 5
       var quantizer: Quantizer.quantizer
       var generator: Generator.generator
       var maxDimension: CGFloat?
       var filters: [Filter]
   }

public typealias quantizer = (_ pixels: [UInt8], _ options: Vibrant.Options)->[Swatch]

public typealias generator = (_ swatches: [Swatch])->Palette

Returns true if the color is to be kept.

public class Filter {
    public typealias filterFunction = (_ red: UInt8, _ green: UInt8, _ blue: UInt8, _ alpha: UInt8)->Bool
    
    var f: filterFunction
}

Helper class for change configurations and create a Vibrant instance. Methods of a Builder instance can be chained like:

Vibrant.from(src)
  .quality(1)
  .clearFilters()
  // ...
  .getPalette()

Sets opts.quality to q. Returns this Builder instance.

Sets opts.colorCount to n. Returns this Builder instance.

Sets opts.maxDimension to d. Returns this Builder instance.

Adds a filter function. Returns this Builder instance.

Removes a filter function. Returns this Builder instance.

Clear all filters. Returns this Builder instance.

Specifies which Quantizer implementation class to use. Returns this Builder instance.

Sets opts.generator to generator. Returns this Builder instance.

Builds and returns a Vibrant instance as configured.

Builds a Vibrant instance as configured and calls its getPalette method on a background thread. Calls cb on main thread.

Builds a Vibrant instance as configured and calls its getPalette method on the main thread.

Represents a color swatch generated from an image's palette.

public typealias Vec3<T> = (T, T, T)

public typealias RGB = (r: UInt8, g: UInt8, b: UInt8)

public typealias HSL = (r: Double, g: Double, b: Double)

public typealias HSL = (r: Double, g: Double, b: Double)

public typealias HSL = (r: Double, g: Double, b: Double)

Internal use.

Returns a hexadecimal value of the swatch

Returns an appropriate color to use for any 'title' text which is displayed over this Swatch's color.

Returns an appropriate color to use for any 'body' text which is displayed over this Swatch's color.

Utility methods. Internal usage.

Computes CIE delta E 1994 diff between lab1 and lab2. The 2 colors are in CIE-Lab color space. Used in tests to compare 2 colors' perceptual similarity.

Compute CIE delta E 1994 diff between rgb1 and rgb2.

Compute CIE delta E 1994 diff between hex1 and hex2.

Gets a string to describe the meaning of the color diff. Used in tests.

• This library uses code from ColorThiefSwift, mostly borrowing from their implementation of the modified median cut quantization (MMCQ) algorithm
• A majority of the rest was adapted from node-vibrant

Bryce Dougherty: [email protected]

Kazuki Ohara: ColorThiefSwift

Jari Zwarts: node-vibrant

swiftVibrant is available under the MIT license. See the LICENSE file for more info.