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 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.