---
name: "Graphics::Color::RGB"
section: "3pm"
platform: "linux"
package: "libgraphics-color-perl"
version: "0.31-2"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/Graphics::Color::RGB"
---

# Graphics::Color::RGB(3pm)

RGB color model

## NAME

Graphics::Color::RGB - RGB color model

## VERSION

version 0.31

## 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) 2014 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.