THotPDF.RegisterDeviceN Method

Deklaruje farebný priestor PDF 1.3+ DeviceN podložený N spotovými farbami dodanými používateľom (ISO 32000-1 8.6.6.5). Zovšeobecňuje RegisterSeparation z jedného farbiva na viacero: šesťfarebnú tlač, kovové / fluorescenčné farby, vlastné zmesi atramentov PDF/X alebo ľubovoľnú N-kanálovú sadu atramentov

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

AnsiString RegisterDeviceN(const AnsiString* ColorantNames, int ColorantNameCount, const AnsiString& AlternateCS, const Extended* TintC1Matrix, int TintC1MatrixCount);

DeviceN berie N tint operandov v [0..1], jeden na každý colorant, a vypočíta M výstupných komponentov v AlternateCS pomocou lineárnej tint transformácie s váženým miešaním, ktorú HotPDF interne zostaví ako PostScript-calculator Function Type 4. Výstup pre kanál m je súčet cez všetky colorants n z tint[n] * TintC1Matrix[n*M + m], orezaný na [0..1] renderovacím reťazcom

ColorantNames - pole N názvov atramentov. Každá položka sa zapíše ako PDF name; medzery sa podľa PDF 1.7 7.3.5 escapujú na #20. Špeciálny názov 'None' označuje nevyužitý slot colorantu. Zoznam názvov určuje N vstupných rozmerov výsledného farebného priestoru

AlternateCS - 'DeviceGray' (M = 1), 'DeviceRGB' (M = 3), or 'DeviceCMYK' (M = 4). Any other value raises an exception.

TintC1Matrix - pole Extended v poradí row-major s rozmerom N * M. Riadok n, stĺpec m predstavuje príspevok colorantu n do kanála m v AlternateCS pri plnej sile (tint[n] = 1.0) a všetkých ostatných tintoch na nule. Dĺžka musí byť presne Length(ColorantNames) * M

Návratová hodnota: automaticky vygenerovaný názov (DevN1, DevN2, ...). Vracia prázdny reťazec, keď je StrictVersionLock zapnutý a aktívna Version je pod PDF 1.3 (inak sa verzia dokumentu automaticky zvýši na 1.3)

Code Example

// Two-colorant DeviceN over DeviceRGB. Colorant 0 ('Red') is pure
// red at full strength, colorant 1 ('Blue') is pure blue. Mixing
// (0.5, 0.5) yields a 50/50 blend; (1, 1) saturates to magenta
var
  CSName: AnsiString;
  Mat: array[0..5] of Extended;
begin
  HPDF.Version := pdf14;
  HPDF.BeginDoc;
  Mat[0] := 1.0; Mat[1] := 0.0; Mat[2] := 0.0;  // Red row     -> (1, 0, 0)
  Mat[3] := 0.0; Mat[4] := 0.0; Mat[5] := 1.0;  // Blue row    -> (0, 0, 1)
  CSName := HPDF.RegisterDeviceN(
    ['Red', 'Blue'], 'DeviceRGB', Mat);
  HPDF.CurrentPage.SetFillColorSpace(CSName);
  HPDF.CurrentPage.SetFillColor([0.5, 0.5]);   // mid-purple
  HPDF.CurrentPage.Rectangle(60, 60, 200, 100);
  HPDF.CurrentPage.Fill;
  HPDF.EndDoc;
end;