graphics::color(3pm) [debian man page]

Graphics::Color(3pm)					User Contributed Perl Documentation				      Graphics::Color(3pm)

NAME

       Graphics::Color - Device and library agnostic color spaces.

VERSION

       version 0.29

SYNOPSIS

	 my $color = Graphics::Color::RGB->new(
	     red => .5, green => .5, blue => .5, alpha => .5
	 );
	 say $color->as_string;

DESCRIPTION

       Graphics color is a device and library agnostic system for creating and manipulating colors in various color spaces.

DISCLAIMER

       I'm not an art student or a wizard of arcane color knowledge.  I'm a normal programmer with a penchant for things graphical.  Hence this
       module is likely incomplete in some places.  Patches are encouraged.  I've intentions of adding more color spaces as well as conversion
       routines (where applicable).

COLOR TYPES

       The following color types are supported.

       CMYK

       HSL

       HSV

       RGB

       YIQ

       YUV

METHODS

   derive
       Clone this color but allow one of more of it's attributes to change by passing in a hashref of options:

	 my $new = $color->derive({ attr => $newvalue });

       The returned color will be identical to the cloned one, save the attributes specified.

   equal_to
       Compares this color to the provided one.  Returns 1 if true, else 0;

   not_equal_to
       The opposite of equal_to.

AUTHOR

       Cory G Watson <gphat@cpan.org>

COPYRIGHT AND LICENSE

       This software is copyright (c) 2011 by Cold Hard Code, LLC.

       This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.

perl v5.12.4							    2011-08-11						      Graphics::Color(3pm)

Graphics::Color::RGB(3pm)				User Contributed Perl Documentation				 Graphics::Color::RGB(3pm)

NAME

       Graphics::Color::RGB - RGB color model

VERSION

       version 0.29

SYNOPSIS

	   use Graphics::Color::RGB;

	   my $color = Graphics::Color::RGB->new({
	       red     => 1,
	       blue    => .31,
	       green   => .25,
	   });

DESCRIPTION

       Graphics::Color::RGB represents a Color in the sRGB color space.  Individual color channels are expressed as decimal values from 0 to 1, 0
       being a lack of that color (or opaque in the case of alpha) and 1 being full color (or transparent in the case of alpha).  If no options
       are provided then new instance of RGB are opaque white, (that is equivalent to red => 1, green => 1, blue => 1, alpha => 1).

       Convenience methods are supplied to convert to various string values.

ATTRIBUTES

   red
   r
       Set/Get the red component of this Color.  Aliased to 'r' as well.

   green
   g
       Set/Get the green component of this Color. Aliased to 'g' as well.

   blue
   b
       Set/Get the blue component of this Color. Aliased to 'b' as well.

   alpha
   a
       Set/Get the alpha component of this Color. Aliased to 'a' as well.

   name
       Get the name of this color.  Only valid if the color was created by name.

METHODS

   as_string
       Get a string version of this Color in the form of RED,GREEN,BLUE,ALPHA

   as_integer_string
       Return an integer formatted value for this color.  This format is suitable for CSS RGBA values.

   as_css_hex
       Return a hex formatted value with a prepended '#' for use in CSS and HTML.

   as_hex_string ( [$prepend] )
       Return a hex formatted value for this color.  The output ignores the alpha channel because, per the W3C, there is no hexadecimal notiation
       for an RGBA value. Optionally allows you to include a string that will be prepended. This is a common way to add the "#".

   as_percent_string
       Return a percent formatted value for this color.  This format is suitable for CSS RGBA values.

   as_array
       Get the RGB values as an array.

   as_array_with_alpha
       Get the RGBA values as an array

   equal_to
       Compares this color to the provided one.  Returns 1 if true, else 0;

   not_equal_to
       The opposite of equal_to.

   from_color_library ($color_id)
       Attempts to retrieve the specified color-id using Color::Library.  The result is then converted into a Graphics::Color::RGB object.

   from_hex_string($hex)
       Attempts to create a Graphics::Color::RGB object from a hex string. Works with or without the leading # and with either 3 or 6 character
       hex strings.

   to_hsl
       Creates this RGB color in HSL space.  Returns a Graphics::Color::HSL object.

   to_hsv
       Creates this RGB color in HSV space.  Returns a Graphics::Color::HSV object.

AUTHOR

       Cory G Watson <gphat@cpan.org>

COPYRIGHT AND LICENSE

       This software is copyright (c) 2011 by Cold Hard Code, LLC.

       This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.

perl v5.12.4							    2011-08-11						 Graphics::Color::RGB(3pm)