iTunes style color fetcher for UIImage and NSImage. It fetches the most dominant and prominent colors.

Add the following to the dependencies of your Package.swift:

.package(url: "https://github.com/jathu/UIImageColors.git", from: "x.x.x")

Add UIImageColors to your Podfile:

pod 'UIImageColors' 

Add UIImageColors to your Cartfile:

github "jathu/UIImageColors" 

Copy the UIImageColors folder into your project.

For Objective-C projects copy the entire Sources folder.

import UIImageColors let image = UIImage(named: "example.png") // Synchronous let colors = image.getColors() // Asynchronous(completion-handler) image.getColors { colors in } // Asynchronous(async/await) let colors = await image.colors()

@import UIImageColorsObjc; UIImage *image = [UIImage imageNamed:@"example.png"]; // Synchronous UIImageColors *colors = [image getColorsWithQuality:UIImageColorsScaleQualityHigh]; // Asynchronous [image getColorsWithQuality:UIImageColorsScaleQualityHigh completion:^(UIImageColors * _Nullable colors) { }];

import UIImageColors let image = NSImage(named: "example.png") // Synchronous let colors = image.getColors() // Asynchronous(completion-handler) image.getColors { colors in } // Asynchronous(async/await) let colors = await image.colors()

@import UIImageColorsObjc; NSImage *image = [NSImage imageNamed:@"example.png"]; // Synchronous NSImageColors *colors = [image getColorsWithQuality:UIImageColorsScaleQualityHigh]; // Asynchronous [image getColorsWithQuality:UIImageColorsScaleQualityHigh completion:^(NSImageColors * _Nullable colors) { }];

Colors is an object that contains four different color-properties and is used as the return type.

In Swift Colors is a struct and an extension of UIImage/NSImage; in Objective-C there is a UIImageColors/NSImageColors class which is a concrete subclass of NSObject.

ScaleQuality is an enum with four different qualities. The qualities refer to how much the original image is scaled down. Higher qualities will give better results at the cost of performance.

All methods provide a quality parameter (which is set to .high by default in Swift).

let colors = image.getColors(quality: .low) let asyncColors = await image.colors(quality: .custom(10)) image.getColors(quality: .full) { colors in /*...*/ }

UIImageColors *colors = [image getColorsWithQuality:UIImageColorsScaleQualityLow]; [image getColorsWithQuality:UIImageColorsScaleQualityFull completion:^(NSImageColors * _Nullable colors) { /*...*/ }];

The license is provided in the project folder. This is based on Panic's OS X ColorArt.

June 2015 - Toronto