index/tests/ColourTest.php

661 lines
32 KiB
PHP

<?php
// ColourTest.php
// Created: 2023-01-02
// Updated: 2024-12-02
declare(strict_types=1);
use PHPUnit\Framework\TestCase;
use PHPUnit\Framework\Attributes\CoversClass;
use Index\Colour\{Colour,ColourHsl,ColourNamed,ColourNull,ColourRgb};
#[CoversClass(Colour::class)]
#[CoversClass(ColourHsl::class)]
#[CoversClass(ColourNamed::class)]
#[CoversClass(ColourNull::class)]
#[CoversClass(ColourRgb::class)]
final class ColourTest extends TestCase {
public function testNone(): void {
$none = Colour::none();
$this->assertInstanceOf(ColourNull::class, $none);
$this->assertTrue($none->shouldInherit());
$this->assertEquals('inherit', $none);
}
public function testLuminance(): void {
for($i = 0; $i < 0xB; ++$i) {
$num = ($i << 4) | $i;
$colour = new ColourRgb($num, $num, $num, 1);
$this->assertTrue($colour->isDark());
$this->assertFalse($colour->isLight());
}
for($i = 0xB; $i < 0x10; ++$i) {
$num = ($i << 4) | $i;
$colour = new ColourRgb($num, $num, $num, 1);
$this->assertFalse($colour->isDark());
$this->assertTrue($colour->isLight());
}
}
public function testNamed(): void {
$names = [
['red', 0xFF, 0, 0, false],
['orange', 0xFF, 0xA5, 0, false],
['tan', 0xD2, 0xB4, 0x8C, false],
['rebeccapurple', 0x66, 0x33, 0x99, false],
['transparent', 0, 0, 0, true],
['xthiswillneverexist', 0, 0, 0, true],
];
foreach($names as $name) {
$colour = new ColourNamed($name[0]);
$this->assertEquals($name[0], $colour->getName());
$this->assertEquals($name[1], $colour->getRed());
$this->assertEquals($name[2], $colour->getGreen());
$this->assertEquals($name[3], $colour->getBlue());
if($name[4]) {
$this->assertTrue($colour->isTransparent());
$this->assertEquals(0.0, $colour->getAlpha());
} else {
$this->assertFalse($colour->isTransparent());
$this->assertEquals(1.0, $colour->getAlpha());
}
$this->assertFalse($colour->shouldInherit());
$this->assertInstanceOf(ColourNamed::class, $colour);
$this->assertEquals($name[0], $name[0]);
}
}
public function testRGB(): void {
$colour = new ColourRgb(31, 120, 50, 1.0);
$this->assertEquals(31, $colour->getRed());
$this->assertEquals(120, $colour->getGreen());
$this->assertEquals(50, $colour->getBlue());
$this->assertEquals(1.0, $colour->getAlpha());
$this->assertEquals(0x1F7832, Colour::toRawRgb($colour));
$this->assertEquals(0xFF1F7832, Colour::toRawArgb($colour));
$this->assertEquals(0x1F7832FF, Colour::toRawRgba($colour));
$this->assertInstanceOf(ColourRgb::class, $colour);
$this->assertFalse($colour->shouldInherit());
$this->assertFalse($colour->isLight());
$this->assertTrue($colour->isDark());
$this->assertEquals('#1f7832', $colour);
$colour = ColourRgb::fromRawArgb(0xCCFF7A7F);
$this->assertEquals(255, $colour->getRed());
$this->assertEquals(122, $colour->getGreen());
$this->assertEquals(127, $colour->getBlue());
$this->assertEquals(.8, $colour->getAlpha());
$this->assertEquals(0xFF7A7F, Colour::toRawRgb($colour));
$this->assertEquals(0xCCFF7A7F, Colour::toRawArgb($colour));
$this->assertEquals(0xFF7A7FCC, Colour::toRawRgba($colour));
$this->assertInstanceOf(ColourRgb::class, $colour);
$this->assertFalse($colour->shouldInherit());
$this->assertFalse($colour->isLight());
$this->assertTrue($colour->isDark());
$this->assertEquals('rgba(255, 122, 127, 0.8)', $colour);
$colour = ColourRgb::fromRawRgb(0x4D3380);
$this->assertEquals(77, $colour->getRed());
$this->assertEquals(51, $colour->getGreen());
$this->assertEquals(128, $colour->getBlue());
$this->assertEquals(1.0, $colour->getAlpha());
$this->assertEquals(0x4D3380, Colour::toRawRgb($colour));
$this->assertEquals(0xFF4D3380, Colour::toRawArgb($colour));
$this->assertEquals(0x4D3380FF, Colour::toRawRgba($colour));
$this->assertInstanceOf(ColourRgb::class, $colour);
$this->assertFalse($colour->shouldInherit());
$this->assertFalse($colour->isLight());
$this->assertTrue($colour->isDark());
$this->assertEquals('#4d3380', $colour);
$colour = ColourRgb::fromRawRgba(0xFF7A7F33);
$this->assertEquals(255, $colour->getRed());
$this->assertEquals(122, $colour->getGreen());
$this->assertEquals(127, $colour->getBlue());
$this->assertEquals(.2, $colour->getAlpha());
$this->assertEquals(0xFF7A7F, Colour::toRawRgb($colour));
$this->assertEquals(0x33FF7A7F, Colour::toRawArgb($colour));
$this->assertEquals(0xFF7A7F33, Colour::toRawRgba($colour));
$this->assertInstanceOf(ColourRgb::class, $colour);
$this->assertFalse($colour->shouldInherit());
$this->assertFalse($colour->isLight());
$this->assertTrue($colour->isDark());
$this->assertEquals('rgba(255, 122, 127, 0.2)', $colour);
}
public function testConvertToRGB(): void {
$colourA = new ColourRgb(31, 120, 50, 1.0);
$colourB = ColourRgb::convert($colourA);
$this->assertSame($colourA, $colourB); // converting to the same type should passthru
$colourA = Colour::none();
$colourB = ColourRgb::convert($colourA); // converting none to RGB makes very little sense, but you can do it if you want...
$this->assertEquals(0, $colourB->getRed());
$this->assertEquals(0, $colourB->getGreen());
$this->assertEquals(0, $colourB->getBlue());
$this->assertEquals(1.0, $colourB->getAlpha());
$this->assertEquals(0, Colour::toRawRgb($colourB));
$this->assertEquals(0xFF000000, Colour::toRawArgb($colourB));
$this->assertEquals(0xFF, Colour::toRawRgba($colourB));
$this->assertInstanceOf(ColourRgb::class, $colourB);
$this->assertFalse($colourB->shouldInherit()); // it does lose the inherit flag, which is intentional
$this->assertFalse($colourB->isLight());
$this->assertTrue($colourB->isDark());
$this->assertEquals('#000000', $colourB);
$colourA = new ColourNamed('steelblue');
$colourB = ColourRgb::convert($colourA);
$this->assertEquals(0x46, $colourB->getRed());
$this->assertEquals(0x82, $colourB->getGreen());
$this->assertEquals(0xB4, $colourB->getBlue());
$this->assertEquals(1.0, $colourB->getAlpha());
$this->assertEquals(0x4682B4, Colour::toRawRgb($colourB));
$this->assertEquals(0xFF4682B4, Colour::toRawArgb($colourB));
$this->assertEquals(0x4682B4FF, Colour::toRawRgba($colourB));
$this->assertInstanceOf(ColourRgb::class, $colourB);
$this->assertFalse($colourB->shouldInherit());
$this->assertFalse($colourB->isLight());
$this->assertTrue($colourB->isDark());
$this->assertEquals('#4682b4', $colourB);
$colourA = new ColourHsl(50, .8, .4, 1.0);
$colourB = ColourRgb::convert($colourA);
$this->assertEquals(0xB8, $colourB->getRed());
$this->assertEquals(0x9C, $colourB->getGreen());
$this->assertEquals(0x14, $colourB->getBlue());
$this->assertEquals(1.0, $colourB->getAlpha());
$this->assertEquals(0xB89C14, Colour::toRawRgb($colourB));
$this->assertEquals(0xFFB89C14, Colour::toRawArgb($colourB));
$this->assertEquals(0xB89C14FF, Colour::toRawRgba($colourB));
$this->assertInstanceOf(ColourRgb::class, $colourB);
$this->assertFalse($colourB->shouldInherit());
$this->assertFalse($colourB->isLight());
$this->assertTrue($colourB->isDark());
$this->assertEquals('#b89c14', $colourB);
}
public function testHSL(): void {
$colour = new ColourHsl(50, .8, .4, 1.0);
$this->assertEquals(50, $colour->getHue());
$this->assertEquals(.8, $colour->getSaturation());
$this->assertEquals(.4, $colour->getLightness());
$this->assertEquals(0xB8, $colour->getRed());
$this->assertEquals(0x9C, $colour->getGreen());
$this->assertEquals(0x14, $colour->getBlue());
$this->assertEquals(1.0, $colour->getAlpha());
$this->assertEquals(0xB89C14, Colour::toRawRgb($colour));
$this->assertEquals(0xFFB89C14, Colour::toRawArgb($colour));
$this->assertEquals(0xB89C14FF, Colour::toRawRgba($colour));
$this->assertInstanceOf(ColourHsl::class, $colour);
$this->assertFalse($colour->shouldInherit());
$this->assertFalse($colour->isLight());
$this->assertTrue($colour->isDark());
$this->assertEquals('hsl(50deg, 80%, 40%)', $colour);
$colour = new ColourHsl(150, .3, .6, 1.0);
$this->assertEquals(150, $colour->getHue());
$this->assertEquals(.3, $colour->getSaturation());
$this->assertEquals(.6, $colour->getLightness());
$this->assertEquals(0x7A, $colour->getRed());
$this->assertEquals(0xB8, $colour->getGreen());
$this->assertEquals(0x99, $colour->getBlue());
$this->assertEquals(1.0, $colour->getAlpha());
$this->assertEquals(0x7AB899, Colour::toRawRgb($colour));
$this->assertEquals(0xFF7AB899, Colour::toRawArgb($colour));
$this->assertEquals(0x7AB899FF, Colour::toRawRgba($colour));
$this->assertInstanceOf(ColourHsl::class, $colour);
$this->assertFalse($colour->shouldInherit());
$this->assertFalse($colour->isLight());
$this->assertTrue($colour->isDark());
$this->assertEquals('hsl(150deg, 30%, 60%)', $colour);
$colour = new ColourHsl(108, .6, .45, .7);
$this->assertEquals(108, $colour->getHue());
$this->assertEquals(.6, $colour->getSaturation());
$this->assertEquals(.45, $colour->getLightness());
$this->assertEquals(0x49, $colour->getRed());
$this->assertEquals(0xB8, $colour->getGreen());
$this->assertEquals(0x2E, $colour->getBlue());
$this->assertEquals(0x49B82E, Colour::toRawRgb($colour));
$this->assertEquals(0xB349B82E, Colour::toRawArgb($colour));
$this->assertEquals(0x49B82EB3, Colour::toRawRgba($colour));
$this->assertEquals(.7, $colour->getAlpha());
$this->assertInstanceOf(ColourHsl::class, $colour);
$this->assertFalse($colour->shouldInherit());
$this->assertFalse($colour->isLight());
$this->assertTrue($colour->isDark());
$this->assertEquals('hsla(108deg, 60%, 45%, 0.7)', $colour);
$colour = new ColourHsl(0, .8, .5, .25);
$this->assertEquals(0, $colour->getHue());
$this->assertEquals(.8, $colour->getSaturation());
$this->assertEquals(.5, $colour->getLightness());
$this->assertEquals(0xE5, $colour->getRed());
$this->assertEquals(0x19, $colour->getGreen());
$this->assertEquals(0x19, $colour->getBlue());
$this->assertEquals(.25, $colour->getAlpha());
$this->assertEquals(0xE51919, Colour::toRawRgb($colour));
$this->assertEquals(0x40E51919, Colour::toRawArgb($colour));
$this->assertEquals(0xE5191940, Colour::toRawRgba($colour));
$this->assertInstanceOf(ColourHsl::class, $colour);
$this->assertFalse($colour->shouldInherit());
$this->assertFalse($colour->isLight());
$this->assertTrue($colour->isDark());
$this->assertEquals('hsla(0deg, 80%, 50%, 0.25)', $colour);
}
public function testConvertToHSL(): void {
$colourA = new ColourHsl(50, .8, .4, 1.0);
$colourB = ColourHsl::convert($colourA);
$this->assertSame($colourA, $colourB); // converting to the same type should passthru
$colourA = Colour::none();
$colourB = ColourHsl::convert($colourA); // converting none to HSL makes very little sense, but you can do it if you want...
$this->assertEquals(0, $colourB->getHue());
$this->assertEquals(0, $colourB->getSaturation());
$this->assertEquals(0, $colourB->getLightness());
$this->assertEquals(0, $colourB->getRed());
$this->assertEquals(0, $colourB->getGreen());
$this->assertEquals(0, $colourB->getBlue());
$this->assertEquals(1.0, $colourB->getAlpha());
$this->assertEquals(0, Colour::toRawRgb($colourB));
$this->assertEquals(0xFF000000, Colour::toRawArgb($colourB));
$this->assertEquals(0xFF, Colour::toRawRgba($colourB));
$this->assertInstanceOf(ColourHsl::class, $colourB);
$this->assertFalse($colourB->shouldInherit()); // it does lose the inherit flag, which is intentional
$this->assertFalse($colourB->isLight());
$this->assertTrue($colourB->isDark());
$this->assertEquals('hsl(0deg, 0%, 0%)', $colourB);
$colourA = new ColourNamed('yellowgreen');
$colourB = ColourHsl::convert($colourA);
$this->assertEquals(79.742, $colourB->getHue());
$this->assertEquals(.608, $colourB->getSaturation());
$this->assertEquals(.5, $colourB->getLightness());
$this->assertEquals(0x9A, $colourB->getRed());
$this->assertEquals(0xCD, $colourB->getGreen());
$this->assertEquals(0x32, $colourB->getBlue());
$this->assertEquals(1.0, $colourB->getAlpha());
$this->assertEquals(0x9ACD32, Colour::toRawRgb($colourB));
$this->assertEquals(0xFF9ACD32, Colour::toRawArgb($colourB));
$this->assertEquals(0x9ACD32FF, Colour::toRawRgba($colourB));
$this->assertInstanceOf(ColourHsl::class, $colourB);
$this->assertFalse($colourB->shouldInherit());
$this->assertFalse($colourB->isLight());
$this->assertTrue($colourB->isDark());
$this->assertEquals('hsl(79.74deg, 61%, 50%)', $colourB);
$colourA = new ColourRgb(31, 120, 50, 1.0);
$colourB = ColourHsl::convert($colourA);
$this->assertEquals(132.809, $colourB->getHue());
$this->assertEquals(.589, $colourB->getSaturation());
$this->assertEquals(.296, $colourB->getLightness());
$this->assertEquals(0x1F, $colourB->getRed());
$this->assertEquals(0x78, $colourB->getGreen());
$this->assertEquals(0x32, $colourB->getBlue());
$this->assertEquals(1.0, $colourB->getAlpha());
$this->assertEquals(0x1F7832, Colour::toRawRgb($colourB));
$this->assertEquals(0xFF1F7832, Colour::toRawArgb($colourB));
$this->assertEquals(0x1F7832FF, Colour::toRawRgba($colourB));
$this->assertInstanceOf(ColourHsl::class, $colourB);
$this->assertFalse($colourB->shouldInherit());
$this->assertFalse($colourB->isLight());
$this->assertTrue($colourB->isDark());
$this->assertEquals('hsl(132.81deg, 59%, 30%)', (string)$colourB);
}
public function testMisuzu(): void {
$colour = Colour::fromMisuzu(0x40AABBCC);
$this->assertInstanceOf(ColourNull::class, $colour);
$this->assertTrue($colour->shouldInherit());
$this->assertEquals('inherit', $colour);
$this->assertEquals(0x40000000, Colour::toMisuzu($colour));
$this->assertEquals(0, Colour::toRawRgb($colour));
$this->assertEquals(0xFF000000, Colour::toRawArgb($colour));
$this->assertEquals(0xFF, Colour::toRawRgba($colour));
$colour = Colour::fromMisuzu(0xAABBCC);
$this->assertEquals(0xAA, $colour->getRed());
$this->assertEquals(0xBB, $colour->getGreen());
$this->assertEquals(0xCC, $colour->getBlue());
$this->assertEquals(1.0, $colour->getAlpha());
$this->assertEquals(0xAABBCC, Colour::toRawRgb($colour));
$this->assertEquals(0xFFAABBCC, Colour::toRawArgb($colour));
$this->assertEquals(0xAABBCCFF, Colour::toRawRgba($colour));
$this->assertInstanceOf(ColourRgb::class, $colour);
$this->assertFalse($colour->shouldInherit());
$this->assertFalse($colour->isLight());
$this->assertTrue($colour->isDark());
$this->assertEquals('#aabbcc', $colour);
$this->assertEquals(0xAABBCC, Colour::toMisuzu($colour));
$colour = Colour::fromMisuzu(1693465);
$this->assertEquals(0x19, $colour->getRed());
$this->assertEquals(0xD7, $colour->getGreen());
$this->assertEquals(0x19, $colour->getBlue());
$this->assertEquals(1.0, $colour->getAlpha());
$this->assertEquals(0x19D719, Colour::toRawRgb($colour));
$this->assertEquals(0xFF19D719, Colour::toRawArgb($colour));
$this->assertEquals(0x19D719FF, Colour::toRawRgba($colour));
$this->assertInstanceOf(ColourRgb::class, $colour);
$this->assertFalse($colour->shouldInherit());
$this->assertFalse($colour->isLight());
$this->assertTrue($colour->isDark());
$this->assertEquals('#19d719', $colour);
$this->assertEquals(1693465, Colour::toMisuzu($colour));
$colour = Colour::fromMisuzu(16711680);
$this->assertEquals(0xFF, $colour->getRed());
$this->assertEquals(0, $colour->getGreen());
$this->assertEquals(0, $colour->getBlue());
$this->assertEquals(1.0, $colour->getAlpha());
$this->assertEquals(0xFF0000, Colour::toRawRgb($colour));
$this->assertEquals(0xFFFF0000, Colour::toRawArgb($colour));
$this->assertEquals(0xFF0000FF, Colour::toRawRgba($colour));
$this->assertInstanceOf(ColourRgb::class, $colour);
$this->assertFalse($colour->shouldInherit());
$this->assertFalse($colour->isLight());
$this->assertTrue($colour->isDark());
$this->assertEquals('#ff0000', $colour);
$this->assertEquals(16711680, Colour::toMisuzu($colour));
$colour = Colour::fromMisuzu(7558084);
$this->assertEquals(0x73, $colour->getRed());
$this->assertEquals(0x53, $colour->getGreen());
$this->assertEquals(0xC4, $colour->getBlue());
$this->assertEquals(1.0, $colour->getAlpha());
$this->assertEquals(0x7353C4, Colour::toRawRgb($colour));
$this->assertEquals(0xFF7353C4, Colour::toRawArgb($colour));
$this->assertEquals(0x7353C4FF, Colour::toRawRgba($colour));
$this->assertInstanceOf(ColourRgb::class, $colour);
$this->assertFalse($colour->shouldInherit());
$this->assertFalse($colour->isLight());
$this->assertTrue($colour->isDark());
$this->assertEquals('#7353c4', $colour);
$this->assertEquals(7558084, Colour::toMisuzu($colour));
}
public function testParse(): void {
$colour = Colour::parse(null);
$this->assertTrue($colour->shouldInherit());
$this->assertSame(Colour::none(), $colour);
$this->assertEquals('inherit', $colour);
$this->assertEquals(0, Colour::toRawRgb($colour));
$this->assertEquals(0xFF000000, Colour::toRawArgb($colour));
$this->assertEquals(0xFF, Colour::toRawRgba($colour));
$colour = Colour::parse(' ');
$this->assertTrue($colour->shouldInherit());
$this->assertSame(Colour::none(), $colour);
$this->assertEquals('inherit', $colour);
$this->assertEquals(0, Colour::toRawRgb($colour));
$this->assertEquals(0xFF000000, Colour::toRawArgb($colour));
$this->assertEquals(0xFF, Colour::toRawRgba($colour));
$colour = Colour::parse('inherit');
$this->assertTrue($colour->shouldInherit());
$this->assertSame(Colour::none(), $colour);
$this->assertEquals('inherit', $colour);
$this->assertEquals(0, Colour::toRawRgb($colour));
$this->assertEquals(0xFF000000, Colour::toRawArgb($colour));
$this->assertEquals(0xFF, Colour::toRawRgba($colour));
$colour = Colour::parse('xthiswillalsoneverexist');
$this->assertTrue($colour->shouldInherit());
$this->assertSame(Colour::none(), $colour);
$this->assertEquals('inherit', $colour);
$this->assertEquals(0, Colour::toRawRgb($colour));
$this->assertEquals(0xFF000000, Colour::toRawArgb($colour));
$this->assertEquals(0xFF, Colour::toRawRgba($colour));
$colour = Colour::parse('TRANSPARENT');
$this->assertInstanceOf(ColourNamed::class, $colour);
$this->assertFalse($colour->shouldInherit());
$this->assertTrue($colour->isTransparent());
$this->assertEquals('transparent', $colour->getName());
$this->assertEquals('transparent', $colour);
$this->assertEquals(0, $colour->getAlpha());
$this->assertEquals(0, Colour::toRawRgb($colour));
$this->assertEquals(0, Colour::toRawArgb($colour));
$this->assertEquals(0, Colour::toRawRgba($colour));
$colour = Colour::parse(' MediumOrchid ');
$this->assertInstanceOf(ColourNamed::class, $colour);
$this->assertFalse($colour->shouldInherit());
$this->assertFalse($colour->isTransparent());
$this->assertEquals('mediumorchid', $colour->getName());
$this->assertEquals('mediumorchid', $colour);
$this->assertEquals(1, $colour->getAlpha());
$this->assertEquals(0xBA, $colour->getRed());
$this->assertEquals(0x55, $colour->getGreen());
$this->assertEquals(0xD3, $colour->getBlue());
$this->assertEquals(0xBA55D3, Colour::toRawRgb($colour));
$this->assertEquals(0xFFBA55D3, Colour::toRawArgb($colour));
$this->assertEquals(0xBA55D3FF, Colour::toRawRgba($colour));
$colour = Colour::parse('#123');
$this->assertInstanceOf(ColourRgb::class, $colour);
$this->assertFalse($colour->shouldInherit());
$this->assertEquals('#112233', $colour);
$this->assertEquals(1, $colour->getAlpha());
$this->assertEquals(0x11, $colour->getRed());
$this->assertEquals(0x22, $colour->getGreen());
$this->assertEquals(0x33, $colour->getBlue());
$this->assertEquals(0x112233, Colour::toRawRgb($colour));
$this->assertEquals(0xFF112233, Colour::toRawArgb($colour));
$this->assertEquals(0x112233FF, Colour::toRawRgba($colour));
$colour = Colour::parse('#3456');
$this->assertInstanceOf(ColourRgb::class, $colour);
$this->assertFalse($colour->shouldInherit());
$this->assertEquals('rgba(51, 68, 85, 0.4)', $colour);
$this->assertEquals(0.4, $colour->getAlpha());
$this->assertEquals(0x33, $colour->getRed());
$this->assertEquals(0x44, $colour->getGreen());
$this->assertEquals(0x55, $colour->getBlue());
$this->assertEquals(0x334455, Colour::toRawRgb($colour));
$this->assertEquals(0x66334455, Colour::toRawArgb($colour));
$this->assertEquals(0x33445566, Colour::toRawRgba($colour));
$colour = Colour::parse('#9475b2');
$this->assertInstanceOf(ColourRgb::class, $colour);
$this->assertFalse($colour->shouldInherit());
$this->assertEquals('#9475b2', $colour);
$this->assertEquals(1, $colour->getAlpha());
$this->assertEquals(0x94, $colour->getRed());
$this->assertEquals(0x75, $colour->getGreen());
$this->assertEquals(0xB2, $colour->getBlue());
$this->assertEquals(0x9475B2, Colour::toRawRgb($colour));
$this->assertEquals(0xFF9475B2, Colour::toRawArgb($colour));
$this->assertEquals(0x9475B2FF, Colour::toRawRgba($colour));
$colour = Colour::parse('#8559A5b3');
$this->assertInstanceOf(ColourRgb::class, $colour);
$this->assertFalse($colour->shouldInherit());
$this->assertEquals('rgba(133, 89, 165, 0.702)', $colour);
$this->assertEquals(0.702, round($colour->getAlpha(), 3));
$this->assertEquals(0x85, $colour->getRed());
$this->assertEquals(0x59, $colour->getGreen());
$this->assertEquals(0xA5, $colour->getBlue());
$this->assertEquals(0x8559A5, Colour::toRawRgb($colour));
$this->assertEquals(0xB38559A5, Colour::toRawArgb($colour));
$this->assertEquals(0x8559A5B3, Colour::toRawRgba($colour));
$colour = Colour::parse('rgb( 17 , 34 , 51)');
$this->assertInstanceOf(ColourRgb::class, $colour);
$this->assertFalse($colour->shouldInherit());
$this->assertEquals('#112233', $colour);
$this->assertEquals(1, $colour->getAlpha());
$this->assertEquals(0x11, $colour->getRed());
$this->assertEquals(0x22, $colour->getGreen());
$this->assertEquals(0x33, $colour->getBlue());
$this->assertEquals(0x112233, Colour::toRawRgb($colour));
$this->assertEquals(0xFF112233, Colour::toRawArgb($colour));
$this->assertEquals(0x112233FF, Colour::toRawRgba($colour));
$colour = Colour::parse('rgba(51 , 68, 85 ,0.4 )');
$this->assertInstanceOf(ColourRgb::class, $colour);
$this->assertFalse($colour->shouldInherit());
$this->assertEquals('rgba(51, 68, 85, 0.4)', $colour);
$this->assertEquals(0.4, $colour->getAlpha());
$this->assertEquals(0x33, $colour->getRed());
$this->assertEquals(0x44, $colour->getGreen());
$this->assertEquals(0x55, $colour->getBlue());
$this->assertEquals(0x334455, Colour::toRawRgb($colour));
$this->assertEquals(0x66334455, Colour::toRawArgb($colour));
$this->assertEquals(0x33445566, Colour::toRawRgba($colour));
$colour = Colour::parse('rgba( 148,117,178 )');
$this->assertInstanceOf(ColourRgb::class, $colour);
$this->assertFalse($colour->shouldInherit());
$this->assertEquals('#9475b2', $colour);
$this->assertEquals(1, $colour->getAlpha());
$this->assertEquals(0x94, $colour->getRed());
$this->assertEquals(0x75, $colour->getGreen());
$this->assertEquals(0xB2, $colour->getBlue());
$this->assertEquals(0x9475B2, Colour::toRawRgb($colour));
$this->assertEquals(0xFF9475B2, Colour::toRawArgb($colour));
$this->assertEquals(0x9475B2FF, Colour::toRawRgba($colour));
$colour = Colour::parse('rgb(133 ,89,165,.700)');
$this->assertInstanceOf(ColourRgb::class, $colour);
$this->assertFalse($colour->shouldInherit());
$this->assertEquals('rgba(133, 89, 165, 0.7)', $colour);
$this->assertEquals(0.7, $colour->getAlpha());
$this->assertEquals(0x85, $colour->getRed());
$this->assertEquals(0x59, $colour->getGreen());
$this->assertEquals(0xA5, $colour->getBlue());
$this->assertEquals(0x8559A5, Colour::toRawRgb($colour));
$this->assertEquals(0xB38559A5, Colour::toRawArgb($colour));
$this->assertEquals(0x8559A5B3, Colour::toRawRgba($colour));
// these results aren't really correct
// the difference in results is probably negligible for now
// but should definitely be reviewed in the future
$colour = Colour::parse('hsla( 210 , 50 , 13 )');
$this->assertInstanceOf(ColourHsl::class, $colour);
$this->assertFalse($colour->shouldInherit());
$this->assertEquals('hsl(210deg, 50%, 13%)', $colour);
$this->assertEquals(1, $colour->getAlpha());
$this->assertEquals(210, $colour->getHue());
$this->assertEquals(.5, $colour->getSaturation());
$this->assertEquals(.13, $colour->getLightness());
$this->assertEquals(17, $colour->getRed());
$this->assertEquals(33, $colour->getGreen());
$this->assertEquals(50, $colour->getBlue());
$this->assertEquals(0x112132, Colour::toRawRgb($colour));
$this->assertEquals(0xFF112132, Colour::toRawArgb($colour));
$this->assertEquals(0x112132FF, Colour::toRawRgba($colour));
$colour = Colour::parse('hsl(210deg ,25%, 27% ,.6)');
$this->assertInstanceOf(ColourHsl::class, $colour);
$this->assertFalse($colour->shouldInherit());
$this->assertEquals('hsla(210deg, 25%, 27%, 0.6)', $colour);
$this->assertEquals(.6, $colour->getAlpha());
$this->assertEquals(210, $colour->getHue());
$this->assertEquals(.25, $colour->getSaturation());
$this->assertEquals(.27, $colour->getLightness());
$this->assertEquals(52, $colour->getRed());
$this->assertEquals(69, $colour->getGreen());
$this->assertEquals(86, $colour->getBlue());
$this->assertEquals(0x344556, Colour::toRawRgb($colour));
$this->assertEquals(0x99344556, Colour::toRawArgb($colour));
$this->assertEquals(0x34455699, Colour::toRawRgba($colour));
$colour = Colour::parse('hsl(300grad,28%,58)');
$this->assertInstanceOf(ColourHsl::class, $colour);
$this->assertFalse($colour->shouldInherit());
$this->assertEquals('hsl(270deg, 28%, 58%)', $colour);
$this->assertEquals(1.0, $colour->getAlpha());
$this->assertEquals(270, $colour->getHue());
$this->assertEquals(.28, $colour->getSaturation());
$this->assertEquals(.58, $colour->getLightness());
$this->assertEquals(148, $colour->getRed());
$this->assertEquals(118, $colour->getGreen());
$this->assertEquals(178, $colour->getBlue());
$this->assertEquals(0x9476B2, Colour::toRawRgb($colour));
$this->assertEquals(0xFF9476B2, Colour::toRawArgb($colour));
$this->assertEquals(0x9476B2FF, Colour::toRawRgba($colour));
$colour = Colour::parse('hsl( 4.799rad ,30 , 50%)');
$this->assertInstanceOf(ColourHsl::class, $colour);
$this->assertFalse($colour->shouldInherit());
$this->assertEquals('hsl(275deg, 30%, 50%)', $colour);
$this->assertEquals(1.0, $colour->getAlpha());
$this->assertEquals(275, $colour->getHue());
$this->assertEquals(.3, $colour->getSaturation());
$this->assertEquals(.5, $colour->getLightness());
$this->assertEquals(134, $colour->getRed());
$this->assertEquals(89, $colour->getGreen());
$this->assertEquals(166, $colour->getBlue());
$this->assertEquals(0x8659A6, Colour::toRawRgb($colour));
$this->assertEquals(0xFF8659A6, Colour::toRawArgb($colour));
$this->assertEquals(0x8659A6FF, Colour::toRawRgba($colour));
$colour = Colour::parse('hsl( .775turn , 13,60, .54)');
$this->assertInstanceOf(ColourHsl::class, $colour);
$this->assertFalse($colour->shouldInherit());
$this->assertEquals('hsla(279deg, 13%, 60%, 0.54)', $colour);
$this->assertEquals(0.54, $colour->getAlpha());
$this->assertEquals(279, $colour->getHue());
$this->assertEquals(.13, $colour->getSaturation());
$this->assertEquals(.6, $colour->getLightness());
$this->assertEquals(157, $colour->getRed());
$this->assertEquals(140, $colour->getGreen());
$this->assertEquals(166, $colour->getBlue());
$this->assertEquals(0x9D8CA6, Colour::toRawRgb($colour));
$this->assertEquals(0x8A9D8CA6, Colour::toRawArgb($colour));
$this->assertEquals(0x9D8CA68A, Colour::toRawRgba($colour));
}
public function testMix(): void {
// none should always return none if involved...
$mixed = Colour::mix(Colour::none(), Colour::parse('lemonchiffon'), 0.243);
$this->assertTrue($mixed->shouldInherit());
$mixed = Colour::mix(Colour::parse('powderblue'), Colour::none(), 0.76);
$this->assertTrue($mixed->shouldInherit());
// ...unless absolute 0 or 1
$mixed = Colour::mix(Colour::none(), Colour::parse('lemonchiffon'), 1.0);
$this->assertFalse($mixed->shouldInherit());
$mixed = Colour::mix(Colour::parse('powderblue'), Colour::none(), 0.0);
$this->assertFalse($mixed->shouldInherit());
// probably a pretty naive test but its better than nothing
$mixed = Colour::mix(new ColourRgb(0, 100, 50), new ColourRgb(100, 0, 50), 0.5);
$this->assertEquals(50, $mixed->getRed());
$this->assertEquals(50, $mixed->getGreen());
$this->assertEquals(50, $mixed->getBlue());
// absolutes should return one of the args
$colour1 = Colour::parse('royalblue');
$colour2 = Colour::parse('tomato');
$this->assertSame($colour1, Colour::mix($colour1, $colour2, 0.0));
$this->assertSame($colour2, Colour::mix($colour1, $colour2, 1.0));
$mixed = Colour::mix($colour1, $colour2, 0.5);
$this->assertEquals(160, $mixed->getRed());
$this->assertEquals(102, $mixed->getGreen());
$this->assertEquals(148, $mixed->getBlue());
$mixed = Colour::mix($colour1, $colour2, 0.2);
$this->assertEquals(103, $mixed->getRed());
$this->assertEquals(104, $mixed->getGreen());
$this->assertEquals(194, $mixed->getBlue());
$mixed = Colour::mix($colour1, $colour2, 0.8);
$this->assertEquals(217, $mixed->getRed());
$this->assertEquals(100, $mixed->getGreen());
$this->assertEquals(102, $mixed->getBlue());
}
}