THotPDF.RegisterSeparation metódus

 

THotPDF.RegisterSeparation

THotPDF

 

Tetejére

Deklarál egy PDF 1.3+ Separation színteret a spot-color nyomtatási munkafolyamatokhoz (ISO 32000-1 8.6.6.4). Minden hívás regisztrál egy spot festéket, és egy automatikusan generált színtérnevet (Sep1, Sep2, ...) ad vissza, amely használható a THPDFPage.SetFillColorSpace / SetStrokeColorSpace + SetFillColor([tint]) / SetStrokeColor([tint]) metódusokkal

 

Delphi szintaxis:

function RegisterSeparation(const ColorantName: AnsiString; const AlternateCS: AnsiString; const TintC1: array of Extended): AnsiString;

 

C++ szintaxis:

AnsiString RegisterSeparation(const AnsiString& ColorantName, const AnsiString& AlternateCS, const Extended* TintC1, int TintC1Count);

 

Leírás

A Separation színtér lehetővé teszi, hogy egy PDF név szerint hivatkozzon egy spot festékre (pl. egy Pantone színre). A megfelelő nyomtatóeszközök a tényleges festéket használják; a képernyős megjelenítők és a digitális előnézetek a megadott AlternateCS színre esnek vissza tint = 1.0 esetén, lineárisan interpolálva a "nincs festék" felé tint = 0 esetén

 

ColorantName - a festék neve, pl. 'Pantone 185 C'. A szóközök a PDF 1.7 7.3.5 szerint #20-ra vannak kódolva a kimeneti PDF névben; a többi PDF elválasztó karaktert (zárójelek, szögletes zárójelek, perjelek, százalékjelek) kerülni kell

AlternateCS - 'DeviceGray' (1 komponens), 'DeviceRGB' (3) vagy 'DeviceCMYK' (4). Bármely más érték kivételt vált ki

TintC1 - alternate-CS komponensek teljes festékerősségnél (tint = 1.0). A komponensek számának meg kell egyeznie az AlternateCS értével; az értékek a [0..1] tartományban vannak. Vegye figyelembe, hogy a DeviceGray esetében a konvenció: 0 = fekete és 1 = fehér (ellentéte a kép BlackIs1 alapértelmezésének)

 

Visszatérési érték: automatikusan generált név (Sep1, Sep2, ...). Üres karakterláncot ad vissza, ha a StrictVersionLock be van kapcsolva és az aktív Version PDF 1.3 alatt van; ellenkező esetben a dokumentumverzió automatikusan 1.3-ra emelkedik

 

Code Example

// Register a Pantone-style spot ink backed by CMYK, paint four tint
// swatches showing the linear progression from no ink to full ink
var
  SpotName: AnsiString;
  T: Integer;
begin
  HPDF.Version := pdf14;
  HPDF.BeginDoc;
  SpotName := HPDF.RegisterSeparation(
    'Pantone 185 C',                 // ink name (spaces auto-escaped)
    'DeviceCMYK',                    // alternate CS for screen / digital
    [0.0, 0.95, 0.75, 0.0]);         // CMYK at tint = 1.0
  HPDF.CurrentPage.SetFillColorSpace(SpotName);
  for T := 1 to 4 do
  begin
    HPDF.CurrentPage.SetFillColor([T * 0.25]);
    HPDF.CurrentPage.Rectangle(60 + (T - 1) * 100, 100, 80, 60);
    HPDF.CurrentPage.Fill;
  end;
  HPDF.EndDoc;
end;

 

Lásd még

RegisterDeviceN, RegisterLabColorSpace, Version, PDF Filter Support