---
name: "Convert::Color::CMYK"
section: "3pm"
platform: "linux"
package: "libconvert-color-perl"
version: "0.18-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/Convert::Color::CMYK"
---

# Convert::Color::CMYK(3pm)

a color value represented as cyan/magenta/yellow/key

## NAME

"Convert::Color::CMYK" - a color value represented as cyan/magenta/yellow/key

## SYNOPSIS

Directly:

```
   use Convert::Color::CMYK;
   my $red = Convert::Color::CMYK->new( 0, 1, 1, 0 );
   # Can also parse strings
   my $pink = Convert::Color::CMYK->new( '0,0.3,0.3,0' );
```

Via Convert::Color:

```
   use Convert::Color;
   my $cyan = Convert::Color->new( 'cmyk:1,0,0,0' );
```

## DESCRIPTION

Objects in this class represent a color in CMYK space, as a set of four floating-point values in the range 0 to 1.

## CONSTRUCTOR

### new

```
   $color = Convert::Color::CMYK->new( $cyan, $magenta, $yellow, $key );
```

Returns a new object to represent the set of values given. These values should be floating-point numbers between 0 and 1. Values outside of this range will be clamped.

```
   $color = Convert::Color::CMYK->new( $string );
```

Parses `$string` for values, and construct a new object similar to the above three-argument form. The string should be in the form

```
   cyan,magenta,yellow,key
```

containing the three floating-point values in decimal notation.

## METHODS

### cyan

```
   $c = $color->cyan;
```

### magenta

```
   $m = $color->magenta;
```

### yellow

```
   $y = $color->yellow;
```

### key

```
   $k = $color->key;
```

Accessors for the four components of the color.

### black

```
   $k = $color->black;
```

An alias to `"key"`

### cmyk

```
   ( $cyan, $magenta, $yellow, $key ) = $color->cmyk;
```

Returns the individual cyan, magenta, yellow and key components of the color value.

## SEE ALSO

- •

  Convert::Color - color space conversions

- •

  Convert::Color::CMY - a color value represented as cyan/magenta/yellow

## AUTHOR

Paul Evans \<leonerd@leonerd.org.uk\>