# Color Class

> A color specified by values appropriate for its color space.

- Product: Adobe PDF Library 21
- Language: .NET Framework
- Version: APDFL21.0.0PlusP1e
- HTML page: https://docs.datalogics.com/apdfl21/DotNetFramework/APDFL21.0.0PlusP1e/class/Color
- Version index: https://docs.datalogics.com/apdfl21/DotNetFramework/APDFL21.0.0PlusP1e/llms.txt

```csharp
class Color : SystemIDisposable
```

**Namespace:** `Datalogics::PDFL`

**Inherits from:** `SystemIDisposable`

## Description

A color specified by values appropriate for its color space.

The values that are offered range from 0 to 1.0 for red, green, and blue (RGB) or cyan, magenta, yellow, and black (CYMK).

**Referenced by:** [`Annotation`](https://docs.datalogics.com/apdfl21/DotNetFramework/APDFL21.0.0PlusP1e/class/Annotation.md), [`AxialShadingPattern`](https://docs.datalogics.com/apdfl21/DotNetFramework/APDFL21.0.0PlusP1e/class/AxialShadingPattern.md), [`Bookmark`](https://docs.datalogics.com/apdfl21/DotNetFramework/APDFL21.0.0PlusP1e/class/Bookmark.md), [`CircleAnnotation`](https://docs.datalogics.com/apdfl21/DotNetFramework/APDFL21.0.0PlusP1e/class/CircleAnnotation.md), [`FreeTextAnnotation`](https://docs.datalogics.com/apdfl21/DotNetFramework/APDFL21.0.0PlusP1e/class/FreeTextAnnotation.md), [`GraphicState`](https://docs.datalogics.com/apdfl21/DotNetFramework/APDFL21.0.0PlusP1e/class/GraphicState.md), [`HighlightAnnotation`](https://docs.datalogics.com/apdfl21/DotNetFramework/APDFL21.0.0PlusP1e/class/HighlightAnnotation.md), [`InkAnnotation`](https://docs.datalogics.com/apdfl21/DotNetFramework/APDFL21.0.0PlusP1e/class/InkAnnotation.md), [`LineAnnotation`](https://docs.datalogics.com/apdfl21/DotNetFramework/APDFL21.0.0PlusP1e/class/LineAnnotation.md), [`LinkAnnotation`](https://docs.datalogics.com/apdfl21/DotNetFramework/APDFL21.0.0PlusP1e/class/LinkAnnotation.md), [`PolyLineAnnotation`](https://docs.datalogics.com/apdfl21/DotNetFramework/APDFL21.0.0PlusP1e/class/PolyLineAnnotation.md), [`PolygonAnnotation`](https://docs.datalogics.com/apdfl21/DotNetFramework/APDFL21.0.0PlusP1e/class/PolygonAnnotation.md), [`Redaction`](https://docs.datalogics.com/apdfl21/DotNetFramework/APDFL21.0.0PlusP1e/class/Redaction.md), [`ShadingPattern`](https://docs.datalogics.com/apdfl21/DotNetFramework/APDFL21.0.0PlusP1e/class/ShadingPattern.md), [`SquareAnnotation`](https://docs.datalogics.com/apdfl21/DotNetFramework/APDFL21.0.0PlusP1e/class/SquareAnnotation.md), [`Style`](https://docs.datalogics.com/apdfl21/DotNetFramework/APDFL21.0.0PlusP1e/class/Style.md), [`TextMarkupAnnotation`](https://docs.datalogics.com/apdfl21/DotNetFramework/APDFL21.0.0PlusP1e/class/TextMarkupAnnotation.md), [`UnderlineAnnotation`](https://docs.datalogics.com/apdfl21/DotNetFramework/APDFL21.0.0PlusP1e/class/UnderlineAnnotation.md), [`WatermarkTextParams`](https://docs.datalogics.com/apdfl21/DotNetFramework/APDFL21.0.0PlusP1e/class/WatermarkTextParams.md)

**Uses types:** [`ColorSpace`](https://docs.datalogics.com/apdfl21/DotNetFramework/APDFL21.0.0PlusP1e/class/ColorSpace.md), [`Pattern`](https://docs.datalogics.com/apdfl21/DotNetFramework/APDFL21.0.0PlusP1e/class/Pattern.md)

## Constructors

### Color

```csharp
Datalogics.PDFL.Color.Color(ColorSpace colorSpace, System.Collections.Generic.IList< System.Double > values)
```

*constructor*

**Parameters**

- `colorSpace` ([`ColorSpace`](https://docs.datalogics.com/apdfl21/DotNetFramework/APDFL21.0.0PlusP1e/class/ColorSpace.md)): the color space in which to create the color
- `values` (`System.Collections.Generic.IList< System.Double >`): the values to place into the color

Create a new color in an arbitrary color space. The number of values passed must match the number of values in the color space.

### Color

```csharp
Datalogics.PDFL.Color.Color(double c, double m, double y, double k)
```

*constructor*

**Parameters**

- `c` (`double`): the cyan color value for the new color (0.0 - 1.0)
- `m` (`double`): the magenta color value for the new color (0.0 - 1.0)
- `y` (`double`): the yellow color value for the new color (0.0 - 1.0)
- `k` (`double`): the black color value for the new color (0.0 - 1.0)

Create a new color in the DeviceCMYK colorspace with the specified value.

### Color

```csharp
Datalogics.PDFL.Color.Color(double grey)
```

*constructor*

**Parameters**

- `grey` (`double`): the grayscale color value for the new color (0.0 - 1.0)

Create a new color in the DeviceGray colorspace with the specified value.

### Color

```csharp
Datalogics.PDFL.Color.Color(double r, double g, double b)
```

*constructor*

**Parameters**

- `r` (`double`): the red color value for the new color (0.0 - 1.0)
- `g` (`double`): the green color value for the new color (0.0 - 1.0)
- `b` (`double`): the blue color value for the new color (0.0 - 1.0)

Create a new color in the DeviceRGB colorspace with the specified value.

### Color

```csharp
Datalogics.PDFL.Color.Color(Pattern pattern)
```

*constructor*

**Parameters**

- `pattern` ([`Pattern`](https://docs.datalogics.com/apdfl21/DotNetFramework/APDFL21.0.0PlusP1e/class/Pattern.md)): The pattern to turn into a color

Create a new color in the pattern color space.

## Properties

### Pattern

```csharp
Pattern Datalogics.PDFL.Color.Pattern { get; }
```

The pattern of the color. Only valid for pattern-based colors.

### Space

```csharp
ColorSpace Datalogics.PDFL.Color.Space { get; }
```

The color space of the color.

### Value

```csharp
System.Collections.Generic.IList<System.Double> Datalogics.PDFL.Color.Value { get; }
```

The values of the color. Not valid for pattern-based colors.

## Methods

### Dispose

```csharp
void Datalogics.PDFL.Color.Dispose()
```

**Returns:** `void`

### Equals

```csharp
override bool Datalogics.PDFL.Color.Equals(object obj)
```

**Parameters**

- `obj` (`object`)

**Returns:** `override bool`

### ToString

```csharp
override string Datalogics.PDFL.Color.ToString()
```

**Returns:** `override string`

A string describing the color, including its color space and component values.

Returns a string representation of this Color.