NAME

Color::Library::Color - Color entry for a Color::Library color dictionary

METHODS

$id = $color->id

Returns the id of the color

A color id is in the format of <dictionary_id:color_name>, e.g.

    svg:aliceblue
    x11:bisque2
    nbs-iscc-f:chromeyellow.66
    vaccc:darkspringyellow

$name = $color->name

Returns the name of the color, e.g.

    aliceblue
    bisque2
    chromeyellow
    darkspringyellow

$title = $color->title

Returns the title of the color, e.g.

    aliceblue
    bisque2
    chrome yellow
    Dark Spring-Yellow

$dictionary = $color->dictionary

Returns the Color::Library::Dictionary object that the color belongs to

$hex = $color->hex

Returns the hex value of the color, e.g.

    ff08ff
    eed5b7
    eaa221
    669900

Note that $hex does NOT include the leading #, for that use $color->html, $color->css, or $color->svg

$html = $color->html

$css = $color->css

$svg = $color->svg

Returns the hex value of the color with a leading #, suitable for use in HTML, CSS, or SVG documents, e.g.

    #ff08ff
    #eed5b7
    #eaa221
    #669900

$value = $color->value

Returns the numeric value of the color, e.g.

($r, $g, $b) = $color->rgb

Returns r, g, and b values of the color as a 3 element list (list context), e.g.

    (240, 248, 255)

$rgb = $color->rgb

Returns r, g, and b values of the color in a 3 element array (scalar context), e.g.

    [ 240, 248, 255 ]

$color = Color::Library::Color->new( id => $id, name => $name, title => $title, value => $value )

$color = Color::Library::Color->new( { id => $id, name => $name, title => $title, value => $value } )

$color = Color::Library::Color->new( [[ $id, $name, $title, $rgb, $hex, $value ]] )

Returns a new Color::Library::Color object representing the specified color

You probably don't want/need to call this yourself

$hex = Color::Library::Color::rgb2hex( $rgb )
$hex = Color::Library::Color::rgb2hex( $r, $g, $b ): Converts an rgb value to its hex representation
$value = Color::Library::Color::rgb2value( $rgb )
$value = Color::Library::Color::rgb2value( $r, $g, $b ): Converts an rgb value to its numeric representation
$rgb = Color::Library::Color::value2rgb( $value )
($r, $g, $b) = Color::Library::Color::value2rgb( $value ): Converts a numeric color value to its rgb representation
($r, $g, $b) = Color::Library::Color::parse_rgb_color( $hex )
($r, $g, $b) = Color::Library::Color::parse_rgb_color( $value ): Makes a best effort to convert a hex or numeric color value to its rgb representation

2022-11-27

perl v5.36.0