This class provides many functions for converting color spaces, calculates color differences, scales and much more.

Defines color from parameters red, green and blue [0...255].

Defines color from parameters red, yellow and blue [0...255].

Defines color from hexadecimal notation hex (3 or 6 digits, with or without hash).

Defines color from parameters hue [0...360], saturnation [0...1] and lightness [0...1].

Defines color from parameters hue [0...360], saturnation [0...1] and value [0...1].

Defines color from parameters cyan, magenta, yellow and black key [0...1].

Defines color from luma component y and chrominance components, called u (blue projection) and v (red projection) [0...255].

Returns color as [ r, g, b ].

Returns color as [ r, y, b ].

Returns color as [ c, m, y, k ].

Returns color with hexadecimal notation.

Returns color as [ h, s, l ].

Returns color as [ h, s, v ].

Returns color as [ x, y, z ].

Returns color as [ Y, x, y ].

Returns color as [ l, a, b ].

Returns color as [ l, c, h ].

Returns color as [ y, u, v ].

Returns color as [ y, i, q ].

Returns color as [ y, Cb, Cr ].

Returns color as [ y, Pb, Pr ].

Returns [ r, g, b ] with gamma correction.

Returns ∆E as the difference or distance between two colors (CIE76).

Returns difference or distance between two colors. Accepted color spaces are RGB and RYB.

Returns difference or distance between two colors at percentage value. Accepted color spaces are RGB and RYB.

Returns Color object with complementary color.

Return Color object with color shift (rotation) by degrees [-359...359].

Return Color object with changed saturation by value [-1...1].

Return Color object lightened by value [0...1].

Return Color object darkened by value [0...1].

Return value of grayscale. Gamma correction is optional.

Return Color object for grayscale color. Gamma correction is optional.

Return triadic color scheme (three colors that have the same distance from each other in the color wheel).

Return contrast of given color: 0 is dark and 1 is light contrast.

Return array of Color objects with colors bewteen itself and stop color. steps form 0 up to 255 allowed, boundary = false returns array without start and stop colors.

Return array of Color objects with tints or shades form itself. steps form 0 up to 255 allowed.

Return array of named colors with their Color objects nearest to itself.

# define new Color object
$color = new Color();

# set RGB color
$color->setRGB( 136, 176, 75 );

# convert to HEX
print_r( $color->toHEX() );

# convert to CMYK
print_r( $color->toCMYK() );

Output:

#88b04b

Array
(
    [c] => 0.22727272727273
    [m] => 0
    [y] => 0.57386363636364
    [k] => 0.30980392156863
)

# define new Color objects and set colors
$color_1 = ( new Color() )->setHEX( '#34568B' );
$color_2 = ( new Color() )->setHSL( 257, 0.242, 0.471 );

# get ΔE
print_r( $color_1->deltaE( $color_2 ) );

# get color match
print_r( $color_1->match( $color_2 ) );

Output:

16.369734508952

0.87070712531894

# define new Color objects and set colors
$color_1 = ( new Color() )->setHEX( '#c8dee3' );
$color_2 = ( new Color() )->setRGB( 24, 53, 140 );

# generate gradient with 10 colors
$gradient = $color_1->gradient( $color_2, 10, true );

# output result colors
foreach( $gradient as $i => $color ) {
    
    printf( '[%2d] %s', $i, $color->toHEX() );
    
}

Output:

[ 0] #c8dee3
[ 1] #b8cedb
[ 2] #a8bfd3
[ 3] #98afcb
[ 4] #88a0c3
[ 5] #7891bb
[ 6] #6881b3
[ 7] #5872ab
[ 8] #4863a3
[ 9] #37539b
[10] #284493
[11] #18358c

# define new Color object and set color
$color = ( new Color() )->setHEX( '#cc9074' );

# find nearest 10 named colors
$nearest = $color->nearest( 10 );

# output result colors
foreach( $nearest as $i => $color ) {
    
    printf( '[%d] %s (#%s)', $i, $color['name'], $color['color']->toHEX() );
    
}

Output:

[0] Antique brass (#cd9575)
[1] Burning Sand (#d99376)
[2] Antique Brass (#c88a65)
[3] Whiskey (#d59a6f)
[4] Copperfield (#da8a67)
[5] Tan (Crayola) (#d99a6c)
[6] Middle red (#e58e73)
[7] Camel (#c19a6b)
[8] Raw sienna (#d68a59)
[9] Dark salmon (#e9967a)