THotPDF.RegisterNChannelColorSpace Method

Registers process-only or mixed process-and-spot NChannel color 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 color space
`AlternateCS`	`DeviceGray`, `DeviceRGB`, or `DeviceCMYK` process and alternate color space
`TintC1Matrix`	Tint transform matrix mapping colorant values into the alternate color space
`ProcessColorantNames`	Ordered process components that occur in the master colourant array
`TintTransform`	Indirect N-component function mapping the master colourants into the alternate color 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

Color space resource name for use with page fill and stroke color 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 from 0 through 1
Registering the same spot name with a different alternate color space or tint function in one document fails before output

THotPDF.RegisterNChannelColorSpace Method

Declaration

Unit

Parameters

Return value

Usage notes

Related APIs