NAME
Graphics::ColorNames - defines RGB values for common color names
REQUIREMENTS
`Graphics::ColorNames' should work on Perl 5.6.0. It requires the
following non-core (depending on your Perl version) modules:
Module::Load
Module::Loaded
The following modules are not required for using most features but are
recommended:
Color::Library
Tie::Sub
Installation requires the following testing modules:
Test::Exception
Test::More
If the `DEVEL_TESTS' environment variable is set, the tests will also
use the following modules for running developer tests, if they are
installed:
Test::Pod
Test::Pod::Coverage
Test::Portability::Files
The developer tests are for quality-control purposes.
INSTALLATION
Installation can be done using the traditional Makefile.PL or the newer
Build.PL methods.
Using Makefile.PL:
perl Makefile.PL
make test
make install
(On Windows platforms you should use `nmake' instead.)
Using Build.PL (if you have Module::Build installed):
perl Build.PL
perl Build test
perl Build install
SYNOPSIS
use Graphics::ColorNames 2.10;
$po = new Graphics::ColorNames(qw( X ));
$rgb = $po->hex('green'); # returns '00ff00'
$rgb = $po->hex('green', '0x'); # returns '0x00ff00'
$rgb = $po->hex('green', '#'); # returns '#00ff00'
$rgb = $po->rgb('green'); # returns '0,255,0'
@rgb = $po->rgb('green'); # returns (0, 255, 0)
$rgb = $po->green; # same as $po->hex('green');
tie %ph, 'Graphics::ColorNames', (qw( X ));
$rgb = $ph{green}; # same as $po->hex('green');
DESCRIPTION
This module provides a common interface for obtaining the RGB values of
colors by standard names. The intention is to (1) provide a common
module that authors can use with other modules to specify colors by
name; and (2) free module authors from having to "re-invent the wheel"
whenever they decide to give the users the option of specifying a color
by name rather than RGB value.
See the module POD for complete documentation.
REVISION HISTORY
Changes since the last release:
2.11 Thu Jan 10 2008
- updated version number for release
- minor changes of text format
- added fix for problems with Graphics::ColorNames::GrayScale
2.10_05 Tue Jan 8 2008
* checks if modules already loaded before re-loading them
(uses Module::Loaded for this)
- requires changed to load for dynamically loaded modules
- updated README
2.10_04 Sun Jan 6 2008
- reverted back to standard object-oriented style
- Tie::Sub is only loaded when a subroutine is used for scheme
2.10_03 Sat Jan 5 2008
- tests use Test::Exception to catch errors
- rewrite parts of documentation to emphasize object-oriented
interface rather than the tied interface
- implemented a proper DESTROY method
- misc code cleanup and reorganization
2.10_02 Fri Jan 4 2008
* added support for Color::Library dictionaries
- minor changes to error messages
- underscores in color names ignored
- auto-loading color names in object-oriented interface, e.g.
$obj->black()
- stubs for DESTROY and UNTIE methods
- 06-obj.t test more flexible
- pointless 01-ColourNames test removed
- more updates to documentation
2.10_01 Thu Dec 20 2007
* non-word characters (spaces, punctuation) now ignored in
color names
* smarter handling of comments in rgb.txt files
* significant rewrite to parts of the code, requires Tie::Sub
* rewritten how FIRSTKEY and NEXTKEY methods work
- better error handling
- minor updates to documentation
- typos in comments
- added better checking for minimum Perl version reqs
- added aliaes w/out punctuation in Netscape scheme
More details can be found in the Changes file.
AUTHOR
Robert Rothenberg <rrwo at cpan.org>
LICENSE
Copyright (c) 2001-2008 Robert Rothenberg. All rights reserved. This
program is free software; you can redistribute it and/or modify it under
the same terms as Perl itself.