Une façon courante de poser un titre en PDF est /F1 1 Tf 10 0 0 10 72 700 Tm (Total) Tj ( due) Tj : une taille de police de 1 et la vraie taille portée par la matrice de texte. Donnez cela à un convertisseur PDF-vers-SVG fait main et le second run atterrit souvent presque sur le premier. Supposons que les cinq glyphes de "Total" fassent en moyenne un demi-em ; l'origine du texte devrait avancer de 2.5 unités d'espace texte, que la matrice transforme en 25 points. Un convertisseur qui ajoute 2.5 directement à la translation de la matrice déplace le stylo du dixième du chemin, et " due" se surimprime sur le mot qui la précède
ISO 32000-1 §9.4.4 dit explicitement que les déplacements dans l'espace texte passent par la matrice de texte, si bien que la mise à jour est e += tx*a et f += tx*b, jamais une addition directe à e. C'est l'un des nombreux endroits où l'état PDF doit être porté dans des attributs SVG à l'instant exact où un élément est écrit, et le reste de cet article les parcourt
Exporter une page chargée avec BuildLoadedPageSVG
HotPDF exporte n'importe quelle page d'un document chargé sous forme de fichier SVG 1.1 autonome. THotPDF.BuildLoadedPageSVG prend un index de page en base zéro et renvoie le document entier sous forme d'AnsiString, ou une chaîne vide quand la page ne peut pas être exportée ; SaveLoadedPageAsSVG écrit le même balisage dans un fichier et renvoie False en cas d'échec. Les deux ont une surcharge avec un drapeau EmbedFonts, couvert plus bas
La page exportée prend sa taille dans le crop box. Largeur et hauteur sont écrites en points, et la viewBox utilise les unités utilisateur PDF, si bien qu'une unité dans le SVG vaut une unité dans le PDF. Chemins, runs de texte, XObjects d'image, images inline, shadings, motifs de tuiles, chemins de clipping, glyphes Type 3 et Form XObjects imbriqués atteignent tous la sortie, et le contenu matriciel voyage sous forme de data URIs PNG base64 à l'intérieur du fichier
var
Pdf: THotPDF;
I: Integer;
begin
Pdf := THotPDF.Create(nil);
try
if Pdf.LoadFromFile('statements.pdf', '') <= 0 then
Exit; // LoadFromFile renvoie le nombre de pages
for I := 0 to Pdf.LoadedPageCount - 1 do
if not Pdf.SaveLoadedPageAsSVG(I, Format('page-%d.svg', [I + 1])) then
Writeln('Page ', I + 1, ' could not be exported');
finally
Pdf.Free;
end;
end;
Pour des pipelines de build qui ne devraient pas avoir besoin d'un programme Delphi compilé, l'outil en ligne de commande HotPDF expose le même export sous la forme HotPDFCLI export-svg <pdf-file> [-o prefix] [--pages range]. Le SVG est du texte, ce qui en fait un bon partenaire pour la voie matricielle décrite dans le rendu d'une page PDF en bitmap : le bitmap montre ce à quoi la page ressemble, et le SVG montre quels objets l'ont dessinée, sous une forme qu'un diff textuel sait lire
Pourquoi un seul retournement de page casse glyphes et photographies
L'espace utilisateur PDF croît vers le haut depuis le coin inférieur gauche ; le SVG croît vers le bas depuis le coin supérieur gauche. Retourner la page entière une fois corrige chaque coordonnée et, du même geste, met en miroir chaque lettre et chaque photographie. Les deux autres incompatibilités sont plus discrètes. Le PDF porte l'état avec une pile (q l'empile, Q le dépile), tandis que le SVG laisse un élément hériter de ce qu'un groupe ancêtre a déclaré. Et le PDF exprime plusieurs choses par convention : des entiers pour les fins et jonctions de trait, une épaisseur nulle qui signifie "trait visible le plus fin", des variantes d'opérateurs qui basculent la règle d'enroulement
BuildLoadedPageSVG gère le retournement avec une seule pré-transformation de page et corrige texte et images localement. Chaque élément texte porte la chaîne pré-transformation de page × CTM × matrice de texte × matrix(1,0,0,-1,0,0). Le facteur de droite redresse les glyphes dans leur propre repère et laisse la ligne de base là où le retournement de page l'a mise. La correction étant une matrice plutôt qu'un cas particulier, les textes pivotés, en miroir et cisaillés ne demandent aucun code supplémentaire
Les images reçoivent un facteur différent. L'espace image du PDF place la première ligne d'échantillons en haut du carré unité, tandis que l'élément SVG image a son propre repère orienté vers le bas, si bien que la transformation émise est le CTM multiplié à droite par matrix(1,0,0,-1,0,1). Se tromper de signe et le contenu vectoriel d'une page est parfait pendant que chaque photographie pend à l'envers
Les pages avec une entrée /Rotate ajoutent une rotation dans un espace d'affichage orienté vers le haut, devant le retournement : (0,-1,1,0,0,W) pour 90 degrés, (-1,0,0,-1,W,H) pour 180 et (0,1,-1,0,H,0) pour 270, où W et H sont la taille de page non pivotée et le retournement utilise la hauteur du canevas pivoté. La boîte de page n'a pas non plus besoin de commencer à l'origine. Sur une page dont le crop box est [100 100 712 892], l'exportateur ramène le coin inférieur gauche à (0,0) avant de pivoter, la même étape que prend le moteur de rendu matriciel, sinon le contenu atterrit à cent unités du canevas
Matrices de texte et positions par caractère
Chaque run de texte devient un élément SVG text dont l'attribut x liste une position pour chaque caractère. Les positions s'accumulent à partir de l'avance de glyphe plus l'espacement de caractères Tc, et l'espacement de mots Tw n'est ajouté qu'après le code mono-octet 32. Un code sur deux octets qui vaudrait 32 ne reçoit pas d'espacement de mots, ce que prescrit ISO 32000-1 §9.3.3 et dont dépendent les polices à CID. Quand un glyphe tient lieu de plusieurs caractères, comme une ligature, les caractères partagent son avance afin que chacun garde une valeur x à lui
La mise à l'échelle horizontale et l'élévation du texte se plient dans la matrice de rendu du texte sous la forme [Th 0 0 1 0 Trise] × Tm, suivant §9.4.4, si bien qu'elles se mettent à l'échelle et pivotent ensemble avec une matrice de texte transformée. Les nombres de crénage à l'intérieur d'un tableau TJ sont des millièmes d'em et sont multipliés par Th comme tout autre déplacement horizontal
Deux détails XML comptent. Chaque élément text porte xml:space="preserve" ; sans lui une visionneuse effondre les suites d'espaces et la liste x se désynchronise des caractères. Et le fichier est en UTF-8, si bien que les caractères sont encodés explicitement en UTF-8 au lieu de passer par la page de code du système. Les points de code qu'XML 1.0 interdit (caractères de contrôle sous 0x20, surrogates, U+FFFE et U+FFFF) sont remplacés par U+FFFD. Le texte issu de la mise en forme des écritures complexes emprunte la même voie, le façonneur ayant déjà transformé les clusters en glyphes positionnés avant que le flux de contenu ne soit écrit
Polices nommées ou contours intégrés
Par défaut le texte nomme sa police : l'exportateur dérive une famille depuis /BaseFont et le descripteur de police et ajoute un repli générique tel que Arial, sans-serif, et la visionneuse dessine le texte avec une police installée. Cela garde les fichiers petits et le texte entièrement vivant, mais une page composée dans une police d'entreprise intégrée est dessinée dans une police de substitution sur toute machine qui ne l'a pas, dont les largeurs ne correspondent plus aux positions par caractère
Passer True pour EmbedFonts écrit les glyphes des programmes de polices intégrés sous forme de contours dans un bloc defs, partagés entre toutes leurs occurrences sur la page. Le texte original est toujours écrit par-dessus avec une opacité de remplissage nulle, de sorte qu'il reste sélectionnable et cherchable. Utilisez True chaque fois que le SVG quitte la machine qui l'a produit : une remise de maquette, une archive, un diff visuel sur un agent de CI. Utilisez le défaut quand le fichier reste dans un environnement qui a les polices et que la taille compte
procedure ExportOutlined(Pdf: THotPDF);
var
Svg: AnsiString;
Output: TFileStream;
begin
// Contours de glyphes issus des polices intégrées, texte sélectionnable par-dessus
Svg := Pdf.BuildLoadedPageSVG(0, True);
if Svg = '' then
raise Exception.Create('Page 1 could not be exported');
Output := TFileStream.Create('page-1-outlined.svg', fmCreate);
try
Output.WriteBuffer(Svg[1], Length(Svg));
finally
Output.Free;
end;
end;
Les modes de rendu sont honorés dans les deux voies. Le mode 1 trace sans remplir, le mode 2 remplit et trace, le mode 3 est invisible mais avance quand même le stylo, et les modes 4 à 7 ajoutent les glyphes au chemin de clipping. Un glyphe tracé demande une correction de plus : l'épaisseur de trait vit dans l'espace utilisateur tandis que l'élément text dessine dans l'espace texte, si bien que l'épaisseur est divisée par l'échelle de la matrice de texte. Un texte engraissé avec 2 Tr 0.25 w garde donc un contour d'un quart de point ; laissé à la valeur par défaut de SVG d'une unité, il paraîtrait lourd
Ce que l'état graphique porte dans chaque élément
Les attributs de présentation SVG ne suivent pas la portée du PDF, si bien que chaque chemin est écrit avec l'état de trait complet en vigueur à cet instant. Fin de trait 0, 1, 2 devient butt, round, square ; jonction 0, 1, 2 devient miter, round, bevel ; la limite d'onglet, le motif de tirets et la phase de tirets sont écrits quand ils sont réglés. Un motif de tirets avec une entrée négative, ou un tableau non vide sans entrée positive, est ignoré et le motif précédent reste ; un tableau vide [] rend une ligne pleine. Les mêmes valeurs peuvent arriver par un dictionnaire ExtGState, dont les clés LW, LC, LJ, ML, ca et CA sont appliquées aussi
Une épaisseur de trait nulle en PDF signifie la ligne la plus fine que le périphérique puisse tracer. La copier littéralement donne un trait invisible, et la copier comme 1 donne une ligne qui grossit à chaque pas de zoom. L'exportateur écrit stroke-width="1" avec vector-effect="non-scaling-stroke", ce qui garde le trait fin large d'environ un pixel périphérique à n'importe quel agrandissement. Les opérateurs étoilés f*, B* et b* ajoutent fill-rule="evenodd", et leurs formes simples gardent la règle d'enroulement non nul par défaut de SVG
Q restaure couleur de remplissage et de trait, opacité, épaisseur, fin, jonction, limite d'onglet, motif de tirets et phase, et l'état texte aussi. ISO 32000-1 §9.3.1 fait de l'état texte une partie de l'état graphique, si bien qu'un 2 Tr réglé à l'intérieur de q … Q ne doit pas tracer le texte qui suit le Q. Le clipping suit §8.5.4 : W ne fait que marquer le chemin, et le clip prend effet après l'opérateur de peinture, si bien que re W f remplit le rectangle d'abord et clippe ensuite. Chaque clip devient un clipPath plus un groupe englobant, et Q ferme les groupes ouverts depuis le q correspondant
Les Form XObjects se comportent comme un q … Q implicite. L'exportateur clippe une forme à son /BBox, sauvegarde l'état à l'entrée et le restaure à la sortie, si bien qu'une bordure en tirets à l'intérieur d'un tampon ne peut pas fuir dans le contenu de page qui suit. Les motifs de tuiles se projettent dans l'espace par défaut du flux de contenu qui les utilise (§8.7.2), la page ou la forme, quelle que soit la CTM au moment où le motif est peint. L'import vectoriel EMF et WMF fait tourner un modèle d'état similaire dans l'autre sens, et l'import SVG comme Form XObject couvre le voyage inverse du SVG vers le PDF
Couleur, shadings et les chaînes que comparent les tests
La couleur atteint le SVG par chaque opérateur de couleur PDF : g, rg, k et leurs formes de trait, et cs / scn avec un espace nommé depuis les ressources /ColorSpace de la page ou de la forme. Les couleurs Separation, DeviceN, ICCBased, Indexed et Lab sont résolues en RGB par le même code d'espaces colorimétriques qu'utilise le moteur de rendu de page. Sélectionner un espace avec cs part de la couleur initiale que définit §8.6.8 : noir dans les espaces périphériques, teinte 1.0 en Separation et DeviceN, index 0 en Indexed. Le SVG n'a aucune notion d'encres, si bien qu'une couleur spot arrive sous son apparence RGB et le nom d'encre reste derrière dans le PDF. Le travail d'épreuvage qui a besoin de vraies séparations appartient au modèle de peinture décrit dans le rendu des couleurs spot Separation et DeviceN
Les shadings axiaux et radiaux deviennent des dégradés SVG. La spécification laisse /Extend à [false false] par défaut, ce qui signifie que rien n'est peint avant t0 ni après t1, tandis que l'étalement pad de SVG peint les couleurs de bout vers l'extérieur. L'exportateur fait la jonction en ajoutant un arrêt entièrement transparent à chaque bout qui ne s'étend pas. Les shadings à fonction sont échantillonnés en une image à environ un échantillon par unité, et les shadings maillés sont rendus dans une image intégrée
Les couleurs hexadécimales sortent en majuscules. Un test de régression qui compare des chaînes doit attendre #FF0000, et un test écrit contre des minuscules échouera sur une sortie parfaitement correcte. Coordonnées et largeurs sont arrondies à quatre décimales et les matrices transform gardent neuf chiffres significatifs, toutes deux avec un point comme séparateur décimal, quelle que soit la locale de la machine qui exécute le test
procedure CheckRedRectangle(Pdf: THotPDF);
var
Svg: AnsiString;
begin
Svg := Pdf.BuildLoadedPageSVG(0);
// Assert est un contrôle que vous ajoutez dans votre propre test, pas une partie de l'export
Assert(Pos(AnsiString('fill="#FF0000"'), Svg) > 0,
'expected the red fill in uppercase hex');
Assert(Pos(AnsiString('xml:space="preserve"'), Svg) > 0,
'text elements keep their spaces');
end;
Un contrôle de chaîne comme celui-ci tient debout quand le PDF d'entrée est produit par votre propre code et que les couleurs attendues sont connues. Pour des pages venues de l'extérieur, comparer le SVG de deux builds entre eux attrape plus que n'importe quel attribut codé en dur. Le reste de la boîte à outils pour documents chargés, du rendu et de l'édition à l'export, est décrit sur la page du composant PDF HotPDF Delphi