Ein gängiger Weg, in PDF eine Überschrift zu setzen, ist /F1 1 Tf 10 0 0 10 72 700 Tm (Total) Tj ( due) Tj: Schriftgröße 1 und die echte Größe in der Textmatrix. Füttert man damit einen handgestrickten PDF-zu-SVG-Konverter, landet der zweite Tj-Lauf oft fast auf dem ersten. Angenommen, die fünf Glyphen von "Total" haben im Mittel ein halbes em; dann soll der Textursprung um 2,5 Textraum-Einheiten wandern, was die Matrix in 25 Punkt übersetzt. Ein Konverter, der 2,5 direkt auf die Matrix-Translation addiert, bewegt den Stift ein Zehntel des Wegs, und " due" druckt über das Wort davor
ISO 32000-1 §9.4.4 sagt ausdrücklich, dass Verschiebungen im Textraum durch die Textmatrix laufen, die Aktualisierung ist also e += tx*a und f += tx*b, niemals eine schlichte Addition auf e. Das ist eine von vielen Stellen, an denen PDF-Zustand im exakten Moment des Schreibens eines Elements in SVG-Attribute übertragen werden muss — der Rest des Artikels geht sie alle durch
Eine geladene Seite mit BuildLoadedPageSVG exportieren
HotPDF exportiert jede Seite eines geladenen Dokuments als eigenständige SVG-1.1-Datei. THotPDF.BuildLoadedPageSVG nimmt einen nullbasierten Seitenindex entgegen und liefert das ganze Dokument als AnsiString, oder einen leeren String, wenn sich die Seite nicht exportieren lässt; SaveLoadedPageAsSVG schreibt dasselbe Markup in eine Datei und gibt bei Fehlschlag False zurück. Beide haben eine Überladung mit einem EmbedFonts-Flag, das weiter unten behandelt wird
Seine Größe zieht die exportierte Seite aus der Crop-Box. Breite und Höhe werden in Punkt geschrieben, und der viewBox nutzt PDF-Nutzereinheiten, eine Einheit im SVG ist also eine Einheit im PDF. Pfade, Textläufe, Image-XObjects, Inline-Bilder, Shadings, Kachelmuster, Clipping-Pfade, Type-3-Glyphen und verschachtelte Form-XObjects schaffen es alle in die Ausgabe, und Rasterinhalt reist als base64-PNG-Daten-URI in der Datei
var
Pdf: THotPDF;
I: Integer;
begin
Pdf := THotPDF.Create(nil);
try
if Pdf.LoadFromFile('statements.pdf', '') <= 0 then
Exit; // LoadFromFile gibt die Seitenanzahl zurück
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;
Für Build-Pipelines, die kein kompiliertes Delphi-Programm brauchen sollen, exponiert das HotPDF-Kommandozeilenwerkzeug denselben Export als HotPDFCLI export-svg <pdf-file> [-o prefix] [--pages range]. SVG ist Text, was es zum guten Partner des Rasterwegs aus dem Artikel zum Rendern einer PDF-Seite in eine Bitmap macht: Die Bitmap zeigt, wie die Seite aussieht, das SVG zeigt, welche Objekte sie gezeichnet haben — in einer Form, die ein Text-Diff lesen kann
Warum eine einzelne Seitenspiegelung Glyphen und Fotografien zerstört
Der PDF-Nutzerraum wächst von der unteren linken Ecke nach oben; SVG wächst von der oberen linken Ecke nach unten. Die ganze Seite einmal zu spiegeln repariert jede Koordinate und spiegelt im selben Zug jeden Buchstaben und jede Fotografie. Die anderen beiden Diskrepanzen sind leiser. PDF organisiert Zustand über einen Stack (q legt ab, Q holt zurück), während SVG ein Element erben lässt, was eine Vorfahren-Gruppe deklariert hat. Und PDF drückt einiges per Konvention aus: Ganzzahlen für Linienabschlüsse und -verbindungen, eine Breite null, die die "dünnste sichtbare Linie" bedeutet, Operator-Varianten, die die Windungsregel umschalten
BuildLoadedPageSVG erledigt die Spiegelung mit einer Seiten-Vortransformation und korrigiert Text und Bilder lokal. Jedes Textelement trägt die Kette Seiten-Vortransformation × CTM × Textmatrix × matrix(1,0,0,-1,0,0). Der rechte Faktor richtet die Glyphen in ihrem eigenen Frame wieder auf und lässt die Basislinie dort, wo die Seitenspiegelung sie hingelegt hat. Weil die Korrektur eine Matrix ist und kein Sonderfall, brauchen gedrehter, gespiegelter und gescherter Text keinen Extra-Code
Bilder bekommen einen anderen Faktor. Der PDF-Bildraum legt die erste Abtastzeile an den oberen Rand des Einheitsquadrats, während das SVG-image-Element seinen eigenen y-nach-unten-Frame hat, die ausgegebene Transformation ist also die CTM, rechtsmultipliziert mit matrix(1,0,0,-1,0,1). Vorzeichen verwechselt, und der Vektorinhalt einer Seite ist perfekt, während jede Fotografie kopfüber hängt
Seiten mit einem /Rotate-Eintrag schieben eine Rotation im y-nach-oben-Anzeigeraum vor die Spiegelung: (0,-1,1,0,0,W) für 90 Grad, (-1,0,0,-1,W,H) für 180 und (0,1,-1,0,H,0) für 270, wobei W und H die unrotierte Seitengröße sind und die Spiegelung die Höhe der rotierten Canvas nutzt. Die Seitenbox muss auch nicht im Ursprung beginnen. Auf einer Seite mit der Crop-Box [100 100 712 892] verlegt der Exporteur die untere linke Ecke vor dem Rotieren nach (0,0) — derselbe Schritt wie beim Raster-Renderer —, sonst landet der Inhalt hundert Einheiten neben der Canvas
Textmatrizen und Positionen je Zeichen
Jeder Textlauf wird zu einem SVG-text-Element, dessen x-Attribut für jedes Zeichen eine Position listet. Die Positionen akkumulieren aus dem Glyphenvorschub plus der Zeichenabstand-Weite Tc, und Wortabstand Tw kommt nur nach dem Single-Byte-Code 32 dazu. Ein Zwei-Byte-Code, der zufällig 32 ergibt, bekommt keinen Wortabstand — genau so schreibt es ISO 32000-1 §9.3.3 vor, und genau darauf bauen CID-keyed Schriften. Steht ein Glyph für mehrere Zeichen, wie bei einer Ligatur, teilen sich die Zeichen seinen Vorschub, sodass jedes trotzdem einen eigenen x-Wert bekommt
Horizontale Skalierung und Textanhebung werden gemäß §9.4.4 in die Text-Render-Matrix eingerechnet, als [Th 0 0 1 0 Trise] × Tm, sodass sie mit einer transformierten Textmatrix mit skalieren und rotieren. Kerning-Zahlen in einem TJ-Array sind Tausendstel eines em und werden wie jede andere horizontale Bewegung mit Th multipliziert
Zwei XML-Details sind wichtig. Jedes text-Element trägt xml:space="preserve"; ohne das schrumpft ein Viewer Lauf aufeinanderfolgender Leerzeichen, und die x-Liste gerät außer Takt mit den Zeichen. Und die Datei ist UTF-8, Zeichen werden also explizit als UTF-8 kodiert statt durch die System-Codepage zu laufen. Codepunkte, die XML 1.0 verbietet (Steuerzeichen unter 0x20, Surrogate, U+FFFE und U+FFFF), werden durch U+FFFD ersetzt. Text aus dem Shaping komplexer Schriften nimmt denselben Weg, denn der Shaper hat Cluster bereits in positionierte Glyphen verwandelt, bevor der Content-Stream geschrieben wird
Benannte Schriften oder eingebettete Outlines
Standardmäßig nennt der Text seine Schrift: Der Exporteur leitet eine Familie aus /BaseFont und dem Font-Descriptor ab und ergänzt einen generischen Fallback wie Arial, sans-serif, der Viewer zeichnet den Text mit einer installierten Schrift. Das hält Dateien klein und den Text voll lebendig, aber eine Seite in einer eingebetteten Firmenschrift wird auf jeder Maschine ohne sie in einer Ersatzschrift ausgegeben, deren Breiten nicht mehr zu den Positionen je Zeichen passen
True für EmbedFonts schreibt die Glyphen eingebetteter Font-Programme als Outlines in einen defs-Block, geteilt zwischen allen Vorkommen auf der Seite. Der Originaltext wird obendrauf weiterhin mit null Fülldeckkraft geschrieben, also selektierbar und durchsuchbar. True nehmen, wann immer das SVG die Maschine verlässt, die es erzeugt hat: eine Design-Übergabe, ein Archiv, ein visueller Diff auf einem CI-Agent. Den Default nehmen, wenn die Datei in einer Umgebung mit den Schriften bleibt und Größe zählt
procedure ExportOutlined(Pdf: THotPDF);
var
Svg: AnsiString;
Output: TFileStream;
begin
// Glyphumrisse aus den eingebetteten Schriften, selektierbarer Text obendrauf
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;
Render-Moden werden in beiden Pfaden beachtet. Modus 1 stricht ohne Füllung, Modus 2 füllt und stricht, Modus 3 ist unsichtbar, schiebt den Stift aber trotzdem weiter, und die Moden 4 bis 7 nehmen die Glyphen in den Clipping-Pfad auf. Ein gestrichener Glyph braucht noch eine Korrektur: Die Linienbreite lebt im Nutzerraum, während das text-Element im Textraum zeichnet, also wird die Breite durch den Skalierfaktor der Textmatrix geteilt. Mit 2 Tr 0.25 w fett gesetzter Text behält deshalb eine Viertelpunkt-Kontur; auf dem SVG-Default von einer Einheit belassen, würde er plump wirken
Was der Grafikzustand in jedes Element hinüberträgt
SVG-Präsentationsattribute folgen nicht dem PDF-Scoping, jeder Pfad wird also mit dem vollen Strichzustand geschrieben, der in diesem Moment gilt. Linienabschluss 0, 1, 2 wird zu butt, round, square; Linienverbindung 0, 1, 2 wird zu miter, round, bevel; Gehrungsgrenze, Strichmuster und Strichphase werden bei gesetztem Wert geschrieben. Ein Strichmuster mit negativem Eintrag, oder ein nichtleeres Array ohne positiven Eintrag, wird ignoriert und das bisherige Muster bleibt; ein leeres Array [] stellt die durchgezogene Linie wieder her. Dieselben Werte können über ein ExtGState-Dictionary ankommen, dessen Schlüssel LW, LC, LJ, ML, ca und CA ebenso angewendet werden
Eine Linienbreite null bedeutet in PDF die dünnste Linie, die das Gerät zeichnen kann. Wörtlich kopiert gibt sie einen unsichtbaren Strich, als 1 kopiert eine Linie, die mit jedem Zoomschritt wächst. Der Exporteur schreibt stroke-width="1" zusammen mit vector-effect="non-scaling-stroke", was die Haarlinie bei jeder Vergrößerung etwa einen Gerätepixel breit hält. Die Stern-Operatoren f*, B* und b* ergänzen fill-rule="evenodd", ihre schlichten Formen behalten den SVG-Default des Nonzero-Windings
Q stellt Füll- und Strichfarbe, Deckkraft, Linienbreite, Abschluss, Verbindung, Gehrungsgrenze, Strichmuster und -phase wieder her, und auch den Textzustand. ISO 32000-1 §9.3.1 macht den Textzustand zum Teil des Grafikzustands, ein innerhalb von q … Q gesetztes 2 Tr darf den Text nach dem Q also nicht striken. Clipping folgt §8.5.4: W markiert nur den Pfad, und der Clip greift erst nach dem Zeichenoperator, re W f füllt das Rechteck also zuerst und clippt danach. Jeder Clip wird zu einem clipPath plus einer umschließenden Gruppe, und Q schließt die Gruppen, die seit dem passenden q geöffnet wurden
Form-XObjects verhalten sich wie ein implizites q … Q. Der Exporteur clippt eine Form auf ihre /BBox, sichert den Zustand beim Eintritt und stellt ihn beim Austritt wieder her, ein gestrichelter Rahmen in einem Stempel kann also nicht in den nachfolgenden Seiteninhalt durchsickern. Kachelmuster mappen auf den Default-Raum des Content-Streams, der sie nutzt (§8.7.2), die Seite oder die Form, unabhängig von der CTM im Moment des Malens. Der EMF- und WMF-Vektorimport fährt dasselbe Zustandsmodell in die Gegenrichtung, und der SVG-Import als Form-XObject bedient die Rückreise von SVG nach PDF
Farbe, Shadings und die Strings, die Tests vergleichen
Farbe erreicht das SVG über jeden PDF-Farboperator: g, rg, k und ihre Strichformen, dazu cs / scn mit einem benannten Raum aus den /ColorSpace-Ressourcen von Seite oder Form. Separation-, DeviceN-, ICCBased-, Indexed- und Lab-Farben löst derselbe Farbraum-Code nach RGB auf, den auch der Seiten-Renderer nutzt. Eine Raumwahl mit cs startet bei der Anfangsfarbe, die §8.6.8 definiert: Schwarz in den Geräte-Räumen, Tonwert 1.0 in Separation und DeviceN, Index 0 in Indexed. SVG kennt keine Schmuckfarben, eine Spot-Farbe kommt also als ihr RGB-Aussehen an, der Farbname bleibt im PDF zurück. Proofing-Arbeit, die echte Separationen braucht, gehört in das Mal-Modell, das der Artikel zum Rendern von Separation- und DeviceN-Spot-Farben beschreibt
Axiale und radiale Shadings werden zu SVG-Gradients. Die Spezifikation defaultet /Extend auf [false false], vor t0 oder nach t1 wird also nichts gemalt, während das pad-Spread des SVG die Endfarben nach außen weitermalt. Der Exporteur überbrückt das, indem er an jedes Ende, das nicht extendet, einen volltransparenten Stop setzt. Funktionsbasierte Shadings werden mit rund einer Abtastung pro Einheit in ein Bild gesampelt, Mesh-Shadings werden in ein eingebettetes Bild gerendert
Hex-Farben kommen in Großbuchstaben heraus. Ein Regressionstest, der Strings vergleicht, muss #FF0000 erwarten; ein gegen Kleinschreibung geschriebener Test scheitert an einer tadellos korrekten Ausgabe. Koordinaten und Breiten werden auf vier Dezimalstellen gerundet, und transform-Matrizen behalten neun signifikante Stellen, beide mit Punkt als Dezimaltrenner, ganz gleich, welche Locale die Maschine hat, auf der der Test läuft
procedure CheckRedRectangle(Pdf: THotPDF);
var
Svg: AnsiString;
begin
Svg := Pdf.BuildLoadedPageSVG(0);
// Assert ist eine Prüfung, die Sie in Ihrem eigenen Test ergänzen, nicht Teil des Exports
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;
Ein String-Check wie dieser hält, wenn das Eingabe-PDF aus eigenem Code stammt und die erwarteten Farben bekannt sind. Bei Seiten von außen fängt der Vergleich der SVGs zweier Builds mehr als jedes hart kodierte Attribut. Der Rest des Werkzeugzeugs für geladene Dokumente, vom Rendern und Bearbeiten bis zum Export, ist auf der HotPDF-Delphi-PDF-Komponentenseite beschrieben