SeparationColorSpace Class

class SeparationColorSpace : ColorSpace

Namespace:com::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 SeparationColorSpacePtrVector

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.

Field Documentation

static DEVICE_CMYK

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

static DEVICE_GRAY

The DeviceGray color space, representing a single grayscale component.

static DEVICE_RGB

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

static DEVICE_RGBA

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

static LAB

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

static LAB_A

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

Member Function Documentation

synchronized void delete(Boolean disposing)

Parameters

disposing: Boolean

Returns:

synchronized void

synchronized void delete()

Returns:

synchronized void

boolean equals(Object rhs)

Parameters

rhs: Object

Returns:

boolean

void finalize()

Returns:

void

ColorSpace getAlternate()

Returns:

ColorSpace

The alternate color space.

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

Function getFunction()

Returns:

Function

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.

String getName()

Returns:

String

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 getNumComponents()

Returns:

int

The number of color components.

The number of components in the color space. For example, DeviceGray has 1 component, DeviceRGB has 3, and DeviceCMYK has 4.

PDFObject getPDFObject()

Returns:

PDFObject

The PDFObject associated with the color space.

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

String getSeparationName()

Returns:

String

The separation colorant name as a string.

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

byte[] getSeparationNameArray()

Returns:

byte[]

A byte array containing the raw separation name.

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

String toString()

Returns:

String

A string describing this ColorSpace.

Convert a ColorSpace to a string representation.