README

Converter to convert between various color systems such as RGB, CIELAB, CMYK, HEX, RGB, and XYZ

Contents

• Source Code and Documentation
• About
• Requirements
• Installation
• Usage
• Support
• Licensing

Source Code and Documentation

• Source Code: https://github.com/mindpowered/color-converter-php
• Documentation: https://mindpowered.github.io/color-converter-php

About

Defining a color is difficult. The first challenge is finding a way to describe a color. One way is to describe color based on constituent colors. We can describe constituent colors by adding them, like in RGB, or subtracting them, like in CMYK. Gamut is the range of all colors that are representable in a color system. RGB trades a limited gamut for performance. LAB trades performance for the full gamut of visible colors. CMYK represents the gamut used in color printing.

The second challenge to defining a color is that it depends on the observer. Viewing the same color will look different when:

• printed on paper or displayed on a screen
• seen in daylight or under fluorescent lighting
• positioned at a close or far distance Standard references such as the Pantone Matching System refer to specific colors. We lose information when converting from a reference color to a color system. Printing or rendering an RGB or CMYK color equivalent to a reference color may not match. We can avoid information loss during conversion by using an unlimited gamut such as LAB. We must also take into account the effect of the observer and illumination.

This package aims to provide tools to perform:

• Color conversion between color systems
• A way of searching for similar standardized reference colors

Requirements

• php >= 7
• php mbstring extension
• php xml extension

Third-party dependencies may have additional requirements.

Installation

You can get colorconverter using Composer. Composer manages dependencies for packages from Packagist and you can get it here: https://getcomposer.org/ .

Create a composer.json file in the top-most directory of your project and add mindpowered/colorconverter to the requirements:

{
        "require": {
                "mindpowered/colorconverter" : "*"
        }
}

Now you can run the command to update composer: composer update. In order for composer to install the package dependencies you will need an archive manager such as zip installed. Composer requires use of the commands zip and unzip.

Usage

require __DIR__ . '/vendor/autoload.php';

use \mindpowered\colorconverter\ColorConverter;

$cc = new ColorConverter();
$colors = $cc->FromHEX("#336699");

Support

We are here to support using this package. If it doesn't do what you're looking for, isn't working, or you just need help, please Contact us.

There is also a public Issue Tracker available for this package.

Licensing

This package is released under the MIT License.