THotPDF.RegisterNChannelColorSpace Method

Registers process-only or mixed process-and-spot NChannel colour spaces using the PDF 1.6 DeviceN attributes form

Declaration

function RegisterNChannelColorSpace(
  const ColorantNames: array of AnsiString;
  const AlternateCS: AnsiString;
  const TintC1Matrix: array of Extended): AnsiString; overload;

function RegisterNChannelColorSpace(
  const ColorantNames, ProcessColorantNames: array of AnsiString;
  const AlternateCS: AnsiString; TintTransform: THPDFObject;
  const SpotColorants: array of THPDFNChannelSpotColorant;
  const PrintingOrder: array of AnsiString): AnsiString; overload;

Unit

HPDFDoc

Parameters

Name	Purpose
`ColorantNames`	Names that map the NChannel process components into the process colour space
`AlternateCS`	`DeviceGray`, `DeviceRGB` or `DeviceCMYK` process and alternate colour space
`TintC1Matrix`	Tint transform matrix mapping colorant values into the alternate colour space
`ProcessColorantNames`	Ordered process components that occur in the master colourant array
`TintTransform`	Indirect N-component function mapping the master colourants into the alternate colour space
`SpotColorants`	Spot names, Separation tint functions, optional solidities and optional dot-gain functions
`PrintingOrder`	Optional permutation of every process and spot colourant

Return value

Colour space resource name for use with page fill and stroke colour space APIs

Usage notes

Emits a five-element DeviceN array whose attributes dictionary contains /Subtype /NChannel and a matching /Process dictionary
Requires PDF 1.6 or later and rejects empty, duplicate, All and None component names
DeviceGray requires one component, DeviceRGB requires three ordered components and a partial DeviceCMYK set uses the reserved Cyan, Magenta, Yellow and Black names
The advanced overload emits individual Separation definitions in /Colorants, exact /Process components and optional /MixingHints containing /Solidities, /PrintingOrder and /DotGain
Master, process and spot arrays must cover every colourant exactly once, tint and dot-gain functions must be indirect with valid shapes and solidities must lie between 0 and 1
Registering the same spot name with a different alternate colour space or tint function in one document fails before output

THotPDF.RegisterNChannelColorSpace Method

Declaration

Unit

Parameters

Return value

Usage notes

Related APIs