Eine Seite eines mitgelieferten PDF, auf der Seite platziert
Nehmen Sie eine Seite eines mitgesendeten PDF und platzieren Sie sie in einem Rahmen, in ihren Proportionen, zwischen den anderen Elementen.
In einem echten PDF ansehen
Eine auf eine Briefkopfvorlage gelegte Rechnung
Eine Rechnung, über einen als PDF-Datei gelieferten Briefkopf gelegt.
Das PDF öffnen Das vollständige Beispiel ansehen
Auch zu sehen in: Eine Vorlage, deren Bereiche per Name gefüllt werden
Zusammenfassung
Sie haben bereits einen Garantieschein, einen Plan oder einen Beleg als PDF. Statt ihn neu zu erstellen, senden Sie ihn so, wie er ist. Die Seite wächst, bis sie den nächstgelegenen Rand des Rahmens erreicht, und zentriert sich im verbleibenden Platz, unverzerrt. Darum herum schreiben, zeichnen und platzieren Sie Tabellen wie gewohnt. Hat die Seite benannte Felder zum Ausfüllen, etwa wo die Adresse oder das Logo hinkommt, senden Sie die Wörter oder das Bild unter diesem Namen, und jedes landet in seinem Feld, wo auch immer die Seite landet.
Technisch
Angefordert mit
"type": "pdf_page"
Die Bytes des Quell-PDF reisen mit der Anfrage, in einem mitgelieferten Teil; der Schlüssel pdf wiederholt diesen Namen, aus demselben Bestand, aus dem die Vorlagen stammen, sodass eine mitgelieferte Datei sowohl als Seitenhintergrund als auch als platziertes Element dient. Die Seitenzahl zählt ab 1. Diese Seite wird mit den Ressourcen, die sie verwendet, in ein Form-XObject kopiert und dann im Rahmen gemalt: Sie behält ihre Proportionen, wird skaliert, bis sie Breite oder Höhe des Rahmens erreicht, und dann im Rest zentriert. Anders als eine Vorlage, die die ganze Seite unter dem Inhalt auskleidet, ist dieses Element eines unter den anderen, in einem Kasten platziert, und lässt sich daher mit Text daneben kombinieren.
Anfrageschema
Erforderliche Schlüssel: pdf, eine Zeichenkette, die den mitgelieferten Teil nennt; rect. Optional: page, eine ab eins gezählte Ganzzahl, standardmäßig 1; pages, ein Array von ab eins gezählten Ganzzahlen, standardmäßig leer für jede Seite des fertigen Dokuments; transform, sechs Zahlen; rotate, Grad gegen den Uhrzeigersinn um die Mitte des Rechtecks; layer, der Name einer deklarierten Ebene. Gegenseitige Ablehnung: transform zusammen mit rotate. Die importierte Seite behält immer ihre Proportionen: Der Einpassungsschlüssel der Bilder hat hier kein Gegenstück. from_defaults, der Name eines deklarierten Grafikzustands mit initial, ist der Zustand, aus dem die Seite gezeichnet wird: Er wird gesetzt, dann schwarze Füllung und Kontur, eine durchgezogene Linie von einem Punkt mit geraden Enden, spitzen Verbindungen und einem Gehrungsgrenzwert von zehn, und der Textzustand in Ruhe, sodass eine Seite, die auf die Anfangswerte einer Seite setzt, darin zeichnet statt in dem, was die Seite, auf der sie landet, zuletzt gesetzt hat; fehlt es, zeichnet die Seite in dem Zustand, der dort gilt, wo sie platziert wird. keep_layers, ein boolescher Wert, standardmäßig false, wobei true die Ebenen, mit denen das eigene Dokument der Seite sie markiert, zu Zeilen der Ebenenleiste dieses Dokuments macht, unter den Namen und in den Zuständen, die jenes Dokument ihnen gab. own_runs, die Bezeichnung, über die der structure-Baum die Abschnitte, die das eigene Dokument der Seite darin markiert hat, mit den imported_runs eines Knotens beansprucht, sodass eine übernommene getaggte Seite ihre Absätze, Überschriften und Abbildungen im Baum behält. fill, ein Objekt mit den Namen der Bereiche als Schlüsseln, die die eigene Datei der Seite markiert, wie page_regions sie markiert, jeder dort gefüllt, wo er landet: text mit content sowie font, font_size, color und align über denen des Bereichs; image, das ein mitgeliefertes Bild nennt; drawing, das eine deklarierte Zeichnung oder eine aus svg_drawings nennt; page, das eine Seite eines mitgelieferten PDF über pdf und page nennt und ein eigenes fill und unfilled annimmt. Die letzten drei nehmen fit und anchor an. unfilled, standardmäßig sample: Jeder Textbereich, den die Anfrage ungefüllt lässt, zeigt sein Muster; empty lässt ihn leer. Jede Füllung nimmt tag und mark an, wie ein Element: ohne sie ist das Gezeichnete Beiwerk, das ein Screenreader übergeht; mit ihnen ein nummerierter Abschnitt, den der structure-Baum beansprucht. Abgelehnt: ein Name, den kein Bereich trägt, ein Bereich einer anderen Art, jede Füllung auf einer Seite, deren Datei keine Bereiche markiert, eines von tag und mark ohne das andere.
Eine vollständige Anfrage, die ein PDF erzeugt
{
"items": [
{
"type": "pdf_page",
"pdf": "label.pdf",
"page": 1,
"boundary": "crop",
"clip": "crop",
"rect": {"llx": 72, "lly": 480, "urx": 523, "ury": 780},
"fill": {
"recipient": {"text": {"content": "Anna Keller\nSeestrasse 12\n8002 Zürich"}}
},
"unfilled": "sample"
}
]
}Bilder und importierte Seiten
Wohin als Nächstes
Jeder JSON-Schlüssel einer Anfrage, auf einer Seite Die übrigen zweiundzwanzig Dinge, die Sie zeichnen können