SeparationColorSpace Class

class SeparationColorSpace : ColorSpace

Namespace:Datalogics::PDFL

Inherits from:: ColorSpace

Detailed Description

Defines the use of additional named colorants in a PDF document.

Colorants in a separation color space are also sometimes referred to as spot colorants. The device displaying or printing the PDF document will supply an appropriate color based on the colorant included in the separation color space.

Referenced by

Page

Uses types

ColorSpace Function Ink PDFObject Page

Constructor & Destructor Documentation

SeparationColorSpace(Page page, Ink ink)

Parameters

page: Page: Page, that contains an ink
ink: Ink: Represents an ink used in a page

Create a separation color space from page's Ink. If page doesn't have a separation color space with passed ink in it's resources, then linear grayscale tint transform function and CMYK as alternate colorspace will be used.

SeparationColorSpace(string separationName, ColorSpace alternate, Function tintTransform)

Parameters

separationName: string: the name of the colorant that the Separation space is intended to represent, or All, or None
alternate: ColorSpace: the alternate color space, which can be any device or CIE-based color space but not another special color space (Pattern, Indexed, Separation, or DeviceN).
tintTransform: Function: function, called with the tint value and returning the corresponding color component values. That is, the number of components and the interpretation of their values depend on the alternate color space.

Create a separation color space.

Property Documentation

ColorSpace Alternate[get]

The alternate color space.

The alternate color space can be any device or CIE-based color space but not another special color space (Pattern, Indexed, Separation, or DeviceN).

static ColorSpace DeviceCMYK[get]

The DeviceCMYK color space, representing cyan, magenta, yellow, and black components.

static ColorSpace DeviceGray[get]

The DeviceGray color space, representing a single grayscale component.

static ColorSpace DeviceRGB[get]

The DeviceRGB color space, representing red, green, and blue components.

static ColorSpace DeviceRGBA[get]

The DeviceRGBA color space, representing red, green, blue, and alpha components.

Function Function[get]

A function, called with the tint value and returning the corresponding color component values. That is, the number of components and the interpretation of their values depend on the alternate color space.

static ColorSpace Lab[get]

The CIE-based L*a*b* color space.

static ColorSpace LabA[get]

The CIE-based L*a*b* color space with an alpha component.

string Name[get]

The name of the color space. A named color space may be named something like DeviceRGB. More complicated color spaces may have a name like Indexed or ICCBased.

int NumComponents[get]

The number of components in the color space.

For example, DeviceGray has 1 component, DeviceRGB has 3, and DeviceCMYK has 4.

PDFObject PDFObject[get]

Get the PDFObject associated with the color space. This may be a PDFName, PDFDict, PDFStream, or PDFArray.

string SeparationName[get]

The name of the colorant that the Separation space is intended to represent, or All, or None.

System.Byte[] SeparationNameArray[get]

The name of the colorant as a byte array.

The name of the colorant that the Separation space is intended to represent, or All, or None. This property is suitable for retrieving the name when the SeparationName cannot be retrieved as a string (for example, when the name contains non-Unicode characters).

Member Function Documentation

void Dispose()

Returns:

void

override bool Equals(object obj)

Parameters

obj: object

Returns:

override bool

override string ToString()

Returns:

override string

A string describing this ColorSpace.

Convert a ColorSpace to a string representation.

static bool operator!=(ColorSpace a, ColorSpace b)

Parameters

a: ColorSpace: The first ColorSpace to compare.
b: ColorSpace: The second ColorSpace to compare.

Returns:

bool

true if the two ColorSpace objects are not equal; false otherwise.

Test two ColorSpace objects for inequality.

static bool operator==(ColorSpace a, ColorSpace b)

Parameters

a: ColorSpace: The first ColorSpace to compare.
b: ColorSpace: The second ColorSpace to compare.

Returns:

bool

true if the two ColorSpace objects are equal; false otherwise.

Test two ColorSpace objects for equality.