THotPDF.RegisterSeparation Method

Declara um espaço de cor Separation PDF 1.3+ para fluxos de impressão com cores spot (ISO 32000-1 8.6.6.4). Cada chamada regista uma tinta spot e devolve um nome de espaço de cor gerado automaticamente (Sep1, Sep2, ...) utilizável com 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);

Um espaço de cor Separation permite que um PDF referencie uma tinta spot (por exemplo, uma cor Pantone) pelo nome. Os dispositivos de impressão conformes usam a tinta real; os visualizadores no ecrã e os pré-visualizadores digitais recorrem à cor AlternateCS fornecida em tint = 1.0, interpolando linearmente até "sem tinta" em tint = 0

ColorantName - o nome da tinta, por exemplo 'Pantone 185 C'. Os espaços são escapados para #20 no nome PDF de saída conforme PDF 1.7 7.3.5; outros caracteres delimitadores do PDF (parênteses, colchetes, barras, sinais de percentagem) devem ser evitados

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

TintC1 - componentes alternate-CS à força total da tinta (tint = 1.0). A contagem de componentes tem de corresponder a AlternateCS; os valores estão em [0..1]. Note que para DeviceGray, a convenção é 0 = preto e 1 = branco (o oposto da predefinição BlackIs1 da imagem)

Valor devolvido: um nome gerado automaticamente (Sep1, Sep2, ...). Devolve uma string vazia quando StrictVersionLock está ativo e a Version em vigor está abaixo de PDF 1.3 (caso contrário a versão do documento sobe automaticamente para 1.3)

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;