decodelabs/spectrum

Bring colour to PHP

v0.2.3 2024-08-22 02:03 UTC

This package is auto-updated.

Last update: 2024-12-04 22:06:34 UTC


README

PHP from Packagist Latest Version Total Downloads GitHub Workflow Status PHPStan License

Parse and manipulate colors

Spectrum offers a simple but powerful system for parsing, inspecting, manipulating and exporting colors.

Get news and updates on the DecodeLabs blog.

Installation

composer require decodelabs/spectrum

Usage

Load and manipulate any color with ease through RGB, HSL and HSV formats.

use DecodeLabs\Spectrum\Color;

$color = Color::create('#5AB3CD');
$color = Color::create('darkblue');
$color = Color::create('rgba(25,25,25,0.4)');
$color = Color::random();

$color->toHsl();
$color->lighten(0.3); // 30% lighter
$color->setAlpha(0.5); // 50% opacity
$color->toMidtone(); // Medium saturation and lightness

echo $color; // Converts to appropriate CSS value

$contrastColor = $color->contrastAgainst('pink');
$textColor = $color->getTextContrastColor();

Licensing

Spectrum is licensed under the MIT License. See LICENSE for the full license text.