RecolorDocument
Colore
Descrizione
Converte ogni pagina del documento in un unico spazio colore
Sintassi
Delphi
Function TPDFlib.RecolorDocument(TargetSpace: Integer): Integer;Parametri
| TargetSpace | 1 grigio, 2 RGB, 3 CMYK |
|---|
Valori restituiti
| Count | Il numero di colori convertiti nell'intero documento |
|---|---|
| 0 | Nessuna conversione necessaria oppure TargetSpace fuori da 1 a 3. Una pagina già nello spazio di destinazione conserva i byte originali. |
Note
La conversione usa la normale aritmetica del dispositivo anziché la gestione del colore: un documento che indica soltanto DeviceRGB non contiene un profilo attraverso cui effettuare la conversione. RGB diventa grigio secondo i pesi di luminanza di ITU-R BT.601, mentre CMYK viene convertito come descritto in ISO 32000-1 §8.6.4.4, ossia nello stesso modo in cui un visualizzatore mostra già sullo schermo un documento CMYK
I colori impostati tramite uno spazio ICCBased, Separation, Indexed o Pattern vengono lasciati invariati. La lettura dei loro componenti senza il relativo profilo modificherebbe l'aspetto della pagina anziché conservarlo, pertanto un documento di questo tipo viene convertito solo nelle parti che fanno riferimento direttamente a uno spazio dispositivo
Vengono convertite anche le immagini a otto bit per componente, spazio colore device e nessuna compressione o Flate. JPEG e fax richiederebbero ricodifica e mantengono i propri byte
Un'immagine indicizzata viene convertita mediante la propria tabella dei colori, quindi i campioni mantengono gli indici già presenti. Tale percorso non dipende dal modo in cui i campioni sono impacchettati o compressi, consentendo la conversione di una schermata o un grafico con palette anche se non è possibile riscriverne i campioni
I gradienti vengono convertiti insieme alle funzioni, mantenendo coerenti spazio e stop. Quelli basati su funzioni sampled o PostScript e gli shading mesh conservano i propri colori
Maschere morbide e stencil restano invariate. Entrambe rappresentano copertura, non colore, e convertirle mostrerebbe la maschera come immagine.
Geometria, testo, ritaglio e ogni altro operatore vengono riscritti senza modifiche
La pagina selezionata viene ripristinata al ritorno della chiamata
Esempio
// Send a mixed-colour document to a press that expects CMYK
PDF.LoadFromFile('brochure.pdf', '');
Converted := PDF.RecolorDocument(3);
PDF.SaveToFile('brochure-cmyk.pdf');