---
name: "Graphics::Color::HSL"
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::HSL"
---

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

HSL color space

## NAME

Graphics::Color::HSL - HSL color space

## VERSION

version 0.31

## SYNOPSIS

```
    use Graphics::Color::HSL;
    my $color = Graphics::Color::HSL->new({
        hue         => 120,
        saturation  => .5,
        lightness   => .25,
    });
```

## DESCRIPTION

Graphics::Color::HSL represents a Color in an RGB color space.  HSL stands for **Hue** **Saturation** and **Lightness**.

## ATTRIBUTES

### hue

### h

Set/Get the hue component of this Color.

### saturation

### s

Set/Get the saturation component of this Color.

### lightness

### l

Set/Get the lightness component of this Color.

### alpha

Set/Get the alpha component of this Color.

### 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: HUE,SATURATION,LIGHTNESS,ALPHA

### as\_percent\_string

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

### as\_array

Get the HSL values as an array

### as\_array\_with\_alpha

Get the HSLA 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.

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