THotPDF.RegisterSeparation Methode

Declareert een Separation-kleurspatie voor PDF 1.3+ voor afdrukworkflows met steunkleuren (ISO 32000-1 8.6.6.4). Elke aanroep registreert één steunkleur en geeft een automatisch gegenereerde kleurnaam terug (Sep1, Sep2, ...) die kan worden gebruikt met THPDFPage.SetFillColorSpace / SetStrokeColorSpace + SetFillColor([tint]) / SetStrokeColor([tint])

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

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

Een Separation-kleurspatie laat een PDF naar een steunkleur verwijzen, bijvoorbeeld een Pantone-kleur, bij naam. Conformerende afdrukapparaten gebruiken de werkelijke inkt; schermviewers en digitale proefweergaven vallen terug op de opgegeven AlternateCS-kleur bij tint = 1.0 en interpoleren lineair naar "geen inkt" bij tint = 0

ColorantName - de inktnaam, bijvoorbeeld 'Pantone 185 C'. Spaties worden in de uitvoer-PDF-naam vervangen door #20 volgens PDF 1.7 7.3.5; andere PDF-scheidingstekens, zoals haakjes, blokhaken, schuine strepen en procenttekens, moeten worden vermeden

AlternateCS - 'DeviceGray' (1 component), 'DeviceRGB' (3) of 'DeviceCMYK' (4). Elke andere waarde leidt tot een uitzondering

TintC1 - componenten van de alternatieve kleurspatie bij volle inktsterkte (tint = 1.0). Het aantal componenten moet overeenkomen met AlternateCS; waarden liggen in [0..1]. Houd er rekening mee dat voor DeviceGray de conventie 0 = zwart en 1 = wit is, tegenovergesteld aan de standaardwaarde BlackIs1 voor afbeeldingen

Retourwaarde: een automatisch gegenereerde naam (Sep1, Sep2, ...). Geeft een lege tekenreeks terug wanneer StrictVersionLock aan staat en de actieve Version onder PDF 1.3 ligt (anders wordt de documentversie automatisch naar 1.3 verhoogd)

Codevoorbeeld

// 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;