PHPackages                             bensquire/php-color-extractor - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Image & Media](/categories/media)
4. /
5. bensquire/php-color-extractor

ActiveLibrary[Image & Media](/categories/media)

bensquire/php-color-extractor
=============================

A simple class to extract the primary colours from an image.

0.0.1(2mo ago)47442[3 issues](https://github.com/bensquire/php-color-extractor/issues)[2 PRs](https://github.com/bensquire/php-color-extractor/pulls)MITPHPPHP ^8.3 || ^8.4

Since Apr 15Pushed 2mo ago1 watchersCompare

[ Source](https://github.com/bensquire/php-color-extractor)[ Packagist](https://packagist.org/packages/bensquire/php-color-extractor)[ Docs](https://github.com/bensquire/php-color-extractor)[ RSS](/packages/bensquire-php-color-extractor/feed)WikiDiscussions master Synced 1w ago

READMEChangelog (1)Dependencies (3)Versions (7)Used By (0)

PHP Color Extractor
===================

[](#php-color-extractor)

[![Tests](https://github.com/bensquire/php-color-extractor/workflows/Tests/badge.svg)](https://github.com/bensquire/php-color-extractor/actions)[![PHPStan](https://camo.githubusercontent.com/b6d441ad4fe8332cb16c72aa27f22cc685181dfd74ae34964afc92c6c1146b3c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048505374616e2d6c6576656c2532306d61782d627269676874677265656e2e737667)](https://phpstan.org/)[![PHP Version](https://camo.githubusercontent.com/e69fc10ad0d3845d44d08b0eeedd6dd7a5bfa4ab872e68e26b131554122d35d5/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7068702d253545382e332d626c75652e737667)](https://php.net)[![License](https://camo.githubusercontent.com/7013272bd27ece47364536a221edb554cd69683b68a46fc0ee96881174c4214c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d626c75652e737667)](LICENSE)

A modern PHP library to extract the dominant color palette from images.

Features
--------

[](#features)

- Extract dominant colors from any image format supported by GD
- Configurable number of colors to extract
- Adjustable granularity for performance vs. accuracy tradeoff
- Fluent interface for easy chaining
- Type-safe with strict PHP 8.3+ type declarations
- Full PHPStan level max compliance
- 100% test coverage

Requirements
------------

[](#requirements)

- PHP 8.3 or 8.4
- GD extension

Installation
------------

[](#installation)

Install via Composer:

```
composer require bensquire/php-color-extractor
```

Usage
-----

[](#usage)

### Basic Example

[](#basic-example)

```