RecolorDocument
Couleur
Description
Convertit toutes les pages du document dans un espace colorimétrique
Syntaxe
Delphi
Function TPDFlib.RecolorDocument(TargetSpace: Integer): Integer;Paramètres
| TargetSpace | 1 niveaux de gris, 2 RGB, 3 CMYK |
|---|
Valeurs de retour
| Count | Nombre de couleurs converties dans l’ensemble du document |
|---|---|
| 0 | Aucune conversion n'était nécessaire ou TargetSpace était hors de 1 à 3. Une page dont les couleurs sont déjà dans l'espace cible conserve ses octets d'origine |
Remarques
La conversion utilise l’arithmétique ordinaire des périphériques, sans gestion des couleurs : un document qui déclare seulement DeviceRGB ne porte aucun profil. RGB devient gris selon les pondérations ITU-R BT.601, et CMYK selon ISO 32000-1 §8.6.4.4, comme le fait déjà un visualiseur à l’écran
Les couleurs définies dans un espace ICCBased, Separation, Indexed ou Pattern restent inchangées. Lire leurs composantes sans leur profil modifierait l’apparence de la page ; un tel document n’est donc converti que dans les parties qui désignent directement un espace de périphérique
Les images tracées par une page sont aussi converties lorsqu’elles ont huit bits par composante, un espace colorimétrique de périphérique et aucune compression ou Flate simple. Une image JPEG ou fax devrait être réencodée, opération différente de la conversion de couleurs ; elle conserve donc ses octets
Une image indexée est plutôt convertie par sa table de couleurs, de sorte que ses échantillons conservent leurs index. Ce chemin ne dépend pas de leur empaquetage ni de leur compression, ce qui permet de convertir une capture ou un graphique à palette même si les échantillons ne peuvent pas être réécrits
Les dégradés sont convertis avec les fonctions qui les sous-tendent, afin que l’espace et les points d’arrêt concordent toujours. Un dégradé fondé sur une fonction échantillonnée ou PostScript conserve ses propres couleurs, tout comme les ombrages en maillage dont les couleurs résident dans un flux plutôt que dans une fonction
Les masques doux et de pochoir restent intacts. Ils sont lus comme couverture plutôt que comme couleur, et leur conversion afficherait le masque comme une image
La géométrie, le texte, le détourage et tous les autres opérateurs sont réécrits sans modification
La page sélectionnée est restaurée au retour de l’appel
Exemple
// Send a mixed-colour document to a press that expects CMYK
PDF.LoadFromFile('brochure.pdf', '');
Converted := PDF.RecolorDocument(3);
PDF.SaveToFile('brochure-cmyk.pdf');