Graphics::ColorUtils 0.17

Graphics::ColorUtils Perl module is an easy-to-use color space conversions and more.

SYNOPSIS

use Graphics::ColorUtils;

( $y, $i, $q ) = rgb2yiq( $r, $g, $b );
( $r, $g, $b ) = yiq2rgb( $y, $i, $q );
$hex_string = yiq2rgb( $y, $i, $q );

( $c, $m, $y ) = rgb2cmy( $r, $g, $b );
( $r, $g, $b ) = cmy2rgb( $c, $m, $y );
$hex_string = cmy2rgb( $c, $m, $y );

( $h, $l, $s ) = rgb2hls( $r, $g, $b );
( $r, $g, $b ) = hls2rgb( $h, $l, $s );
$hex_string = hls2rgb( $h, $l, $s );

( $h, $s, $v ) = rgb2hsv( $r, $g, $b );
( $r, $g, $b ) = hsv2rgb( $h, $s, $v );
$hex_string = hsv2rgb( $h, $s, $v );

# -----

use Graphics::ColorUtils qw( :gradients );

( $r, $g, $b ) = grad2rgb( $name, $f ); # where 0.0 <= $f < 1.0
$hex_string = grad2rgb( $name, $f );

%color_count_for_gradient_name = available_gradients();
$array_ref_of_rgb_triples = gradient( $name );
$array_ref_old_grad = register_gradient( $name, $array_ref_of_rgb_triples );

# -----

use Graphics::ColorUtils qw( :names );

( $r, $g, $b ) = name2rgb( $name );
$hex_string = name2rgb( $name );

$hash_ref_rgb_triples_for_name = available_names();
( $old_r, $old_g, $old_b ) = register_name( $name, $r, $g, $b );
$old_hex_string = register_name( $name, $r, $g, $b );
$default_ns = get_default_namespace();
$old_ns = set_default_namespace( $new_ns );

This modules provides some utility functions to handle colors and color space conversions.

The interface has been kept simple, so that most functions can be called "inline" when making calls to graphics libraries such as GD, Tk, or when generating HTML/CSS. (E.g. for GD: $c = $img->colorAllocate( hsv2rgb( 270, 0.5, 0.3 ) );.)

Features:

Color Space Conversions
Color space conversions, in particular between the "intuitive" color spaces HSV (Hue/Saturation/Value) and HLS (Hue/Lightness/Saturation) to and from RGB (Red/Green/Blue).
Color Lookup
Color lookup by name for three standard sets of colors: WWW/CSS, SVG, and X11.
Color Gradients
Management of color gradients, which can be indexed by a floating point number in the range 0..1. (Mostly intended for false-color data visualization.)