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-standard modules:

      Module::Load

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 qw( hex2tuple tuple2hex );

      tie %ColorTable, 'Graphics::ColorNames', 'X';

      $rgbhex1 = $ColorTable{'green'};    # returns '00ff00'
      $rgbhex2 = tuple2hex( 0, 255, 0 );  # returns '00ff00'
      @rgbtup  = hex2tuple( $rgbhex );    # returns (0, 255, 0)

      $rgbhex3 = $ColorTable{'#123abc'};  # returns '123abc'
      $rgbhex4 = $ColorTable{'123abc'};   # returns '123abc'

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

