DeviceNColorSpace Class Documentation

class DeviceNColorSpace : ColorSpace

Namespace:com::datalogics::PDFL

Inherits from:
ColorSpace

Detailed Description

Represents a color space with an arbitrary number of color components. DeviceN color spaces were designed to represent color spaces containing multiple color components that correspond to the colorants of some target device. They provide greater flexibility than is possible with standard device color spaces such as DeviceCMYK or with individual Separation color spaces. For example, it is possible to create a DeviceN color space consisting of only the cyan, magenta, and yellow color components, with the black component excluded.

Constructor & Destructor Documentation

DeviceNColorSpace

DeviceNColorSpace(java.util.List< String > names, ColorSpace alternate, Function tintTransform)

Parameters

names: java.util.List< String >

the names of the colorants that the DeviceN space is intended to represent, among which may be 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 DeviceN color space.

Field Documentation

DEVICE_CMYK

static DEVICE_CMYK

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

DEVICE_GRAY

static DEVICE_GRAY

The DeviceGray color space, representing a single grayscale component.

DEVICE_RGB

static DEVICE_RGB

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

DEVICE_RGBA

static DEVICE_RGBA

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

LAB

static LAB

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

LAB_A

static LAB_A

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

Member Function Documentation

delete

synchronized void delete(Boolean disposing)

Parameters

disposing: Boolean

Returns:

synchronized void

delete

synchronized void delete()

Returns:

synchronized void

equals

boolean equals(Object rhs)

Parameters

rhs: Object

Returns:

boolean

finalize

void finalize()

Returns:

void

getAlternate

ColorSpace getAlternate()

Returns:

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

getAttributes

PDFDict getAttributes()

Returns:

PDFDict

The dictionary of extended attributes associated with the color space.

getFunction

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.

getName

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.

getNames

java.util.List< String > getNames()

Returns:

java.util.List< String >

the names of the colorant that the DeviceN space is intended to represent, some of which may be All or None.

getNumComponents

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.

getPDFObject

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.

toString

String toString()

Returns:

String

A string describing this ColorSpace.

Convert a ColorSpace to a string representation.