Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/kesa2773/uiimagecolorpalette
UIImageColorPalette is a versatile utility for extracting the prominent colors from images in iOS. It efficiently identifies and provides the three most prevalent colors in a UIImage.
https://github.com/kesa2773/uiimagecolorpalette
clustering-algorithms color-analysis color-palette computer-vision graphics-programming image-processing image-rendering ios-development objective-c uicolor uiimage
Last synced: 3 months ago
JSON representation
UIImageColorPalette is a versatile utility for extracting the prominent colors from images in iOS. It efficiently identifies and provides the three most prevalent colors in a UIImage.
- Host: GitHub
- URL: https://github.com/kesa2773/uiimagecolorpalette
- Owner: Kesa2773
- License: mit
- Created: 2023-10-05T01:58:18.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2023-10-06T19:55:16.000Z (over 1 year ago)
- Last Synced: 2024-09-30T02:21:18.874Z (4 months ago)
- Topics: clustering-algorithms, color-analysis, color-palette, computer-vision, graphics-programming, image-processing, image-rendering, ios-development, objective-c, uicolor, uiimage
- Language: Objective-C
- Homepage:
- Size: 10.7 KB
- Stars: 8
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
## UIImageColorPalette
`UIImageColorPalette` is a versatile utility for extracting the prominent colors from images in iOS. It efficiently identifies and provides the three most prevalent colors in a `UIImage`.
### Table of Contents
- [Installation](#installation)
- [Quick Start](#quick-start)
- [Examples](#examples)
- [Example 1: Using a local image file](#example-1-using-a-local-image-file)
- [Example 2: Using a remote image URL](#example-2-using-a-remote-image-url)
- [Example 3: Asynchronous retrieval](#example-3-asynchronous-retrieval)
- [Example 4: Customizing the resize quality](#example-4-customizing-the-resize-quality)
- [License](#license)
### Installation
To install `UIImageColorPalette`, follow these steps:
1. **Download**: Download the `UIImageColorPalette.h` and `UIImageColorPalette.m` files.
2. **Add to project**: Integrate the downloaded files into your project.
3. **Import the Class**: Import the class wherever you want to use it:
```objective-c
#import "UIImageColorPalette.h"
```
### Quick Start
Here are quick examples of how to use `UIImageColorPalette` to extract the color palette from an image:
### Example 1: Using a local image file
```objective-c
// Load an image
NSString *imagePath = [[NSBundle mainBundle] pathForResource:@"imageName" ofType:@"jpg"];
UIImage *image = [UIImage imageWithContentsOfFile:imagePath];
// Retrieve the color palette
UIImageColorPalette *palette = [image retrieveColorPaletteWithQuality:UIImageResizeQualityStandard];
if (palette) {
NSLog(@"Color Palette: %@", palette);
} else {
NSLog(@"Failed to retrieve color palette.");
}
// Set the background color of view
UIColor *backgroundColor = palette.primary;
self.view.backgroundColor = backgroundColor;
// Set the text color for a label
UIColor *textColor = palette.secondary;
myLabel.textColor = textColor;
```
#### Example 2: Using a remote image URL
```objective-c
// Load an image from a remote URL
NSURL *imageURL = [NSURL URLWithString:@"https://example.com/image.jpg"];
NSData *imageData = [NSData dataWithContentsOfURL:imageURL];
UIImage *image = [UIImage imageWithData:imageData];
// Retrieve the color palette
UIImageColorPalette *palette = [image retrieveColorPaletteWithQuality:UIImageResizeQualityStandard];
if (palette) {
NSLog(@"Color Palette: %@", palette);
} else {
NSLog(@"Failed to retrieve color palette.");
}
```
#### Example 3: Asynchronous retrieval
```objective-c
// Load an image from a remote URL asynchronously
NSURL *imageURL = [NSURL URLWithString:@"https://example.com/image.jpg"];
dispatch_async(dispatch_get_global_queue(QOS_CLASS_BACKGROUND, 0), ^{
NSData *imageData = [NSData dataWithContentsOfURL:imageURL];
UIImage *image = [UIImage imageWithData:imageData];
[image retrieveColorPaletteWithQuality:UIImageResizeQualityStandard completion:^(UIImageColorPalette *palette) {
if (palette) {
NSLog(@"Color Palette: %@", palette);
} else {
NSLog(@"Failed to retrieve color palette.");
}
}];
});
```
#### Example 4: Customizing the resize quality
You can use other presets besides `UIImageResizeQualityStandard` by using the following options:
- `UIImageResizeQualityLow`: Use low-quality resizing algorithm.
- `UIImageResizeQualityMedium`: Use medium-quality resizing algorithm.
- `UIImageResizeQualityHigh`: Use high-quality resizing algorithm.
```objective-c
// Load an image
NSString *imagePath = [[NSBundle mainBundle] pathForResource:@"imageName" ofType:@"jpg"];
UIImage *image = [UIImage imageWithContentsOfFile:imagePath];
// Retrieve the color palette with custom resize quality
UIImageColorPalette *palette = [image retrieveColorPaletteWithQuality:UIImageResizeQualityHigh];
if (palette) {
NSLog(@"Color Palette: %@", palette);
} else {
NSLog(@"Failed to retrieve color palette.");
}
```
### License
This project is licensed under the MIT License.