LabColor

Represents a color in the CIELAB color space.

CIELAB (or Lab) is a device-independent color space that covers the entire
range of human color perception. Components are lightness (L), and two
color-opponent dimensions (a and b). As specified by CSS Color 4 and ICC,
it uses a D50 white point, so the D65 pipeline is adapted with Bradford.

Methods

analogous

public function analogous(int $count): array

Parameters

Name	Type	Default
`$count`	int	`2`

blend

public function blend(ColorInterface|string $backdrop, string $mode): static

Parameters

Name	Type	Default
`$backdrop`	ColorInterface\|string	-
`$mode`	string	`"normal"`

complementary

public function complementary(): static

cool

public function cool(float $amount): static

Parameters

Name	Type	Default
`$amount`	float	-

darken

public function darken(float $amount): static

Parameters

Name	Type	Default
`$amount`	float	-

desaturate

public function desaturate(float $amount): static

Parameters

Name	Type	Default
`$amount`	float	-

equals

public function equals(ColorInterface $other): bool

Parameters

Name	Type	Default
`$other`	ColorInterface	-

from

static

public static function from(ColorInterface|string $input): static

Parameters

Name	Type	Default
`$input`	ColorInterface\|string	-

fromChannels

static

public static function fromChannels(array $channels, float $alpha): static

Create color from channel values.

Parameters

Name	Type	Default
`$channels`	array	-
`$alpha`	float	`1`

fromSrgb

static

public static function fromSrgb(SrgbColor $srgb): static

Parameters

Name	Type	Default
`$srgb`	SrgbColor	-

fromXyz

static

public static function fromXyz(XyzColor $xyz): static

Create a Lab color from an XYZ color instance.

Parameters

Name	Type	Default
`$xyz`	XyzColor	-

getA

public function getA(): float

Get the 'a' component value.

getAlpha

public function getAlpha(): float

getB

public function getB(): float

Get the 'b' component value.

getChannels

public function getChannels(): array

getHue

public function getHue(): float

getLightness

public function getLightness(): float

Get the lightness component value.

getLuminance

public function getLuminance(): float

getOpacity

public function getOpacity(): float

getSaturation

public function getSaturation(): float

getSpaceName

static

public static function getSpaceName(): string

grayscale

public function grayscale(): static

invert

public function invert(): static

isCold

public function isCold(): bool

isDark

public function isDark(): bool

isHot

public function isHot(): bool

isLight

public function isLight(): bool

isOpaque

public function isOpaque(): bool

isTransparent

public function isTransparent(): bool

lighten

public function lighten(float $amount): static

Parameters

Name	Type	Default
`$amount`	float	-

parse

static

public static function parse(string $color): static

Parse a lab() color string into a Lab color instance.

Parameters

Name	Type	Default
`$color`	string	-

rotateHue

public function rotateHue(float $degrees): static

Parameters

Name	Type	Default
`$degrees`	float	-

saturate

public function saturate(float $amount): static

Parameters

Name	Type	Default
`$amount`	float	-

shade

public function shade(float $t): static

Parameters

Name	Type	Default
`$t`	float	-

splitComplementary

public function splitComplementary(): array

temperature

public function temperature(): float

tetradic

public function tetradic(): array

tint

public function tint(float $t): static

Parameters

Name	Type	Default
`$t`	float	-

to

public function to(ColorInterface|string $space): ColorInterface

Parameters

Name	Type	Default
`$space`	ColorInterface\|string	-

toCss

public function toCss(string $space): string

Parameters

Name	Type	Default
`$space`	string	`null`

toHex

public function toHex(bool $withAlpha): string

Parameters

Name	Type	Default
`$withAlpha`	bool	`false`

toOklch

public function toOklch(): OklchColor

toSrgb

public function toSrgb(): SrgbColor

toString

public function toString(): string

toXyz

public function toXyz(): XyzColor

Convert the color to its XYZ representation.

triadic

public function triadic(): array

tryFrom

static

public static function tryFrom(ColorInterface|string $input): static

Parameters

Name	Type	Default
`$input`	ColorInterface\|string	-

warm

public function warm(float $amount): static

Parameters

Name	Type	Default
`$amount`	float	-

withAlpha

public function withAlpha(float $alpha): static

Parameters

Name	Type	Default
`$alpha`	float	`1`

withChannel

public function withChannel(string $name, int|float $value): static

Parameters

Name	Type	Default
`$name`	string	-
`$value`	int\|float	-

withChannels

public function withChannels(array $partial): static

Parameters

Name	Type	Default
`$partial`	array	-