villfa/php-invert-color

Invert a given color.

php-invert-color

invert hex color code

Installation

composer require villfa/invert-color

Usage

Here a basic example:

<?php
require_once 'vendor/autoload.php';

use InvertColor\Color;
use InvertColor\Exceptions\InvalidColorFormatException;

try {
    echo Color::fromHex('#fff')->invert(); // #000000
} catch (InvalidColorFormatException $e) {
    echo 'Invalid color: ', $e->getValue();
}

Color::fromHex(string $color): Color - throws InvalidColorFormatException

• $color: string Color in HEX string. Accepted formats: #000000, #000, 000000, 000

InvertColor\Color::fromHex('#fff')->invert(); // #000000

Color::fromRGB(array $rgb): Color - throws InvalidRGBException

• $rgb: array Color as an array of RGB values.

InvertColor\Color::fromRGB([0, 255, 0])->invert(); // #ff00ff

Color::invert([bool $bw]): string

• $bw: bool Optional. A boolean value indicating whether the output should be amplified to black (#000000) or white (#ffffff), according to the luminance of the original color.

InvertColor\Color::fromHex('#000')->invert(); // #ffffff
InvertColor\Color::fromHex('#282b35')->invert(); // #d7d4ca

// amplify to black or white
InvertColor\Color::fromHex('282b35')->invert(true); // #ffffff

Color::invertAsRGB([bool $bw]): array

• $bw: bool Optional. A boolean value indicating whether the output should be amplified to black or white, according to the luminance of the original color.

InvertColor\Color::fromHex('#000')->invertAsRGB(); // [255, 255, 255]
InvertColor\Color::fromHex('#282b35')->invertAsRGB(); // [215, 212, 202]

// amplify to black or white
InvertColor\Color::fromHex('282b35')->invertAsRGB(true); // [255, 255, 255]

Color::invertAsObj([bool $bw]): Color

• $bw: bool Optional. A boolean value indicating whether the output should be amplified to black or white, according to the luminance of the original color.

InvertColor\Color::fromHex('#000')->invertAsObj()->getHex(); // #ffffff
InvertColor\Color::fromHex('#282b35')->invertAsObj()->getRGB(); // [215, 212, 202]

// amplify to black or white
InvertColor\Color::fromHex('282b35')->invertAsObj(true)->getRGB(); // [255, 255, 255]

Color::getHex(): string

InvertColor\Color::fromHex('#FFF')->getHex(); // #ffffff

Color::getRGB(): array

InvertColor\Color::fromHex('#fff')->getRGB(); // [255, 255, 255]

Color::getLuminance(): float

InvertColor\Color::fromHex('#fff')->getLuminance(); // 1
InvertColor\Color::fromHex('#000')->getLuminance(); // 0

Color::isBright(): bool

InvertColor\Color::fromHex('#fff')->isBright(); // true
InvertColor\Color::fromHex('#000')->isBright(); // false

Color::isDark(): bool

InvertColor\Color::fromHex('#fff')->isDark(); // false
InvertColor\Color::fromHex('#000')->isDark(); // true

Tests

To validate and test the library:

composer run-script test

Acknowledgement

This library is a port of the JS package invert-color.

More resources:

• https://stackoverflow.com/questions/35969656/how-can-i-generate-the-opposite-color-according-to-current-color
• https://stackoverflow.com/questions/3942878/how-to-decide-font-color-in-white-or-black-depending-on-background-color/3943023#3943023

License

MIT

php-invert-color's Issues

Bug - Inaccessible Method

Following method is inaccessible.

echo InvertColor\Color::fromHex('#fff')->invert() // #000000;

Is planned to release a new version?

Last tagged version was 0.5, is it possible to add a new release in composer?

thanks!

Failure to Acknowledge const STR_PAD_LEFT

Hi, I really like this piece of software, but sometime in the past several months it stopped working. I am running in PHP 7.2 and my system is rejecting the constant STR_PAD_LEFT in https://github.com/villfa/php-invert-color/blob/master/src/Color.php.

The error message reads: [05-Jan-2020 23:08:20 UTC] PHP Parse error: syntax error, unexpected 'const' (T_CONST), expecting variable (T_VARIABLE) in /home/thege0/vendor/villfa/invert-color/src/Color.php on line 16.

I am an advanced novice in webpage development and am just learning how to use GIT, so please excuse me for not being able to be anymore helpful.

Roddy at nudge.online