Documentation

Lab extends AbstractColor
in package

Pop Color CIE Lab color class

Tags
category

Pop

author

Nick Sagona, III nick@popphp.org

copyright

Copyright (c) 2009-2026 Nick Sagona, III

license

https://www.popphp.org/license New BSD License

version
2.0.0

Table of Contents

Constants

COMMA  = 'COMMA'
String formats
CSS  = 'CSS'
PERCENT  = 'PERCENT'

Properties

$a  : float
A value
$alpha  : float|null
Alpha value
$b  : float
B value
$l  : float
L value

Methods

__construct()  : mixed
Constructor
__get()  : mixed
Magic method to return the color value
__isset()  : bool
Magic method to return whether the color value exists
__set()  : void
Magic method to set the color value
__toString()  : string
Return CSS-formatted string
__unset()  : void
Magic method to unset color value
getA()  : float
Get A value
getAlpha()  : float|null
Get alpha value
getB()  : float
Get B value
getL()  : float
Get L value
hasAlpha()  : bool
Determine if the color object has an alpha value
offsetExists()  : bool
ArrayAccess offsetExists
offsetGet()  : mixed
ArrayAccess offsetGet
offsetSet()  : void
ArrayAccess offsetSet
offsetUnset()  : void
ArrayAccess offsetUnset
render()  : string
Convert to readable string
setA()  : self
Set A value
setAlpha()  : self
Set alpha value
setB()  : self
Set B value
setL()  : self
Set L value
toArray()  : array<string|int, mixed>
Convert to array
toCss()  : string
Convert to a CSS-formatted string, regardless of the class's default __toString() format
toLch()  : Lch
Convert to LCH
toRgb()  : Rgb
Convert to RGB
channels()  : array<string|int, mixed>
Get the valid channel names
channelsForError()  : string
Format the valid channel names for an exception message, e.g. "'r', 'g', 'b' or 'a'"
labFInv()  : float
Inverse of the CIE Lab f() nonlinearity

Constants

Properties

$a

A value

protected float $a = 0

$alpha

Alpha value

protected float|null $alpha = null

$b

B value

protected float $b = 0

$l

L value

protected float $l = 0

Methods

__construct()

Constructor

public __construct(float|string $l, float|string $a, float|string $b[, float|string|null $alpha = null ]) : mixed

Instantiate the CIE Lab color object

Parameters
$l : float|string
$a : float|string
$b : float|string
$alpha : float|string|null = null

__get()

Magic method to return the color value

public __get(string $name) : mixed
Parameters
$name : string
Tags
throws
Exception

__isset()

Magic method to return whether the color value exists

public __isset(string $name) : bool
Parameters
$name : string
Return values
bool

__set()

Magic method to set the color value

public __set(string $name, mixed $value) : void
Parameters
$name : string
$value : mixed
Tags
throws
Exception

__toString()

Return CSS-formatted string

public __toString() : string
Return values
string

__unset()

Magic method to unset color value

public __unset(string $name) : void
Parameters
$name : string
Tags
throws
Exception

getA()

Get A value

public getA() : float
Return values
float

getAlpha()

Get alpha value

public getAlpha() : float|null
Return values
float|null

getB()

Get B value

public getB() : float
Return values
float

getL()

Get L value

public getL() : float
Return values
float

hasAlpha()

Determine if the color object has an alpha value

public hasAlpha() : bool
Return values
bool

offsetExists()

ArrayAccess offsetExists

public offsetExists(mixed $offset) : bool
Parameters
$offset : mixed
Return values
bool

offsetGet()

ArrayAccess offsetGet

public offsetGet(mixed $offset) : mixed
Parameters
$offset : mixed
Tags
throws
Exception

offsetSet()

ArrayAccess offsetSet

public offsetSet(mixed $offset, mixed $value) : void
Parameters
$offset : mixed
$value : mixed
Tags
throws
Exception

offsetUnset()

ArrayAccess offsetUnset

public offsetUnset(mixed $offset) : void
Parameters
$offset : mixed
Tags
throws
Exception

render()

Convert to readable string

public render([string|null $format = null ]) : string
Parameters
$format : string|null = null
Return values
string

setA()

Set A value

public setA(float|string $a) : self
Parameters
$a : float|string
Tags
throws
OutOfRangeException
Return values
self

setAlpha()

Set alpha value

public setAlpha(float|string $alpha) : self
Parameters
$alpha : float|string
Tags
throws
OutOfRangeException
Return values
self

setB()

Set B value

public setB(float|string $b) : self
Parameters
$b : float|string
Tags
throws
OutOfRangeException
Return values
self

setL()

Set L value

public setL(float|string $l) : self
Parameters
$l : float|string
Tags
throws
OutOfRangeException
Return values
self

toArray()

Convert to array

public toArray([bool $assoc = true ]) : array<string|int, mixed>
Parameters
$assoc : bool = true
Return values
array<string|int, mixed>

toCss()

Convert to a CSS-formatted string, regardless of the class's default __toString() format

public toCss() : string
Return values
string

toLch()

Convert to LCH

public toLch() : Lch
Return values
Lch

toRgb()

Convert to RGB

public toRgb() : Rgb
Return values
Rgb

channels()

Get the valid channel names

protected channels() : array<string|int, mixed>
Return values
array<string|int, mixed>

channelsForError()

Format the valid channel names for an exception message, e.g. "'r', 'g', 'b' or 'a'"

protected channelsForError() : string
Return values
string

labFInv()

Inverse of the CIE Lab f() nonlinearity

private static labFInv(float $t, float $kappa) : float
Parameters
$t : float
$kappa : float
Return values
float 

        

        
    




    

    

                                

                

                                
    

        On this page

        
    


                

                            

            

    

        

            
Search results