GD::Graph::colour - Colour manipulation routines for use with GD::Graph
SYNOPSIS
use GD::Graph::colour qw(:colours :lists :files :convert);
DESCRIPTION
The GD::Graph::colour package provides a few routines to work with
colours. The functionality of this package is mainly defined by what is
needed, now and historically, by the GD::Graph modules.
FUNCTIONS
colour_list( number of colours )
Returns a list of number of colours colour names known to the package.
Exported with the :lists tag.
sorted_colour_list( number of colours )
Returns a list of number of colours colour names known to the package,
sorted by luminance or hue.
NB. Right now it always sorts by luminance. Will add an option in a later
stage to decide sorting method at run time.
Exported with the :lists tag.
_rgb( colour name )
Returns a list of the RGB values of colour name. if the colour name
is a string of the form that is acceptable to the hex2rgb sub, then the
colour will be added to the list dynamically.
Exported with the :colours tag.
_hue( R,G,B )
Returns the hue of the colour with the specified RGB values.
Exported with the :colours tag.
_luminance( R,G,B )
Returns the luminance of the colour with the specified RGB values.
Exported with the :colours tag.
add_colour(colourname => [$r, $g, $b]) or add_colour('#7fe310')
Self-explanatory.
Exported with the :colours tag.
rgb2hex($red, $green, $blue)
hex2rgb('#7fe310')
These functions translate a list of RGB values into a hexadecimal
string, as is commonly used in HTML and the Image::Magick API, and vice
versa.
Exported with the :convert tag.
read_rgb( file name )
Reads in colours from a rgb file as used by the X11 system.
Doing something like:
use GD::Graph::bars;
use GD::Graph::colour;
GD::Graph::colour::read_rgb("rgb.txt") or die "cannot read colours";
Will allow you to use any colours defined in rgb.txt in your graph.
Exported with the :files tag.
