Ein in einem Rechteck platziertes Bild
Platzieren Sie ein mitgeliefertes Foto oder Logo in einem Rahmen, randvoll gestreckt oder in seinen eigenen Proportionen.
In einem echten PDF ansehen
Ein Foto, das genau so hineingeht, wie es aus der Kamera kam, und eines mit durchsichtigen Teilen, das sie behält, jedes auf einer Seite in seiner eigenen Größe.
Das PDF öffnen Das vollständige Beispiel ansehen
Auch zu sehen in: Eine Galerie der Bildformate · Ein in ein Rechteck eingepasstes Bild · Jedes Bild, das ein Scanner in eine Datei gelegt hat
Zusammenfassung
Ihr Foto oder Ihr Logo reist mit der Anfrage und setzt sich in den Rahmen, auf den Sie zeigen. Den Rahmen randvoll zu füllen passt zu einem Hintergrund; die ursprüngliche Form zu behalten und im verbleibenden Platz zu zentrieren passt zu einem Porträt oder einem Produkt, das randvolles Füllen stauchen würde. Dasselbe Bild kann an mehreren Stellen dienen, klein in einer Ecke und groß auf einer anderen Seite, ohne zweimal gesendet zu werden.
Technisch
Angefordert mit
"type": "image"
Die Bildbytes reisen mit der Anfrage, in einem mitgelieferten Teil des multipart/form-data-Bodys; der Schlüssel image wiederholt diesen Namen. Es ist derselbe Bestand mitgelieferter Teile, aus dem die Vorlagen stammen, sodass mehrere Elemente dasselbe Bild in verschiedenen Größen und an verschiedenen Stellen zeichnen, bei einem Upload und einer Kopie in der fertigen Datei. Dieser Teil wird als Bild-XObject geschrieben — DCTDecode für ein JPEG, FlateDecode für ein PNG oder ein BMP, mit einer SMask, wo das Bild durchsichtig ist — und mit Do im Rahmen gemalt. Der Rahmen ist ein Rechteck in Punkt; die Einpassung sagt, ob das Bild dieses Rechteck füllt oder seine Proportionen behält. Das Element nimmt dieselben Platzierungseinstellungen an wie die anderen: gewählte Seiten, Matrix, Drehung und Ebene.
Anfrageschema
Erforderliche Schlüssel: image, eine Zeichenkette, die den mitgelieferten Teil nennt; rect. Optional: fit, entweder ein Modus allein oder ein Objekt. Der Modus ist stretch (Standard, das Bild füllt das Rechteck), contain (es behält seine Proportionen und wird im verbleibenden Raum zentriert), cover (es behält seine Proportionen und deckt das Rechteck ganz ab, wobei clip das Überstehende fernhält), natural (seine eigene Größe, unabhängig vom Rechteck) oder shrink_to_fit (wie contain, außer dass ein bereits kleineres Bild in seiner eigenen Größe bleibt). Das Objekt nimmt mode an (standardmäßig stretch); anchor, wo das bemessene Bild sitzt, einer der Werte bottom_left, bottom, bottom_right, left, center (Standard), right, top_left, top, top_right oder zwei Bruchteile [x, y] von 0 bis 1, vom linken Rand und von unten gezählt; margin, Punkt, die vor dem Einpassen von jeder Seite abgezogen werden, standardmäßig 0; turn, wie weit das Bild beim Einsetzen gedreht wird, standardmäßig aufrecht; mirror, einer der Werte neither (Standard), left_to_right, top_to_bottom oder both; clip, ein boolescher Wert, standardmäßig false, ob das über den Kasten Hinausragende von der Seite ferngehalten wird. clip_to_path, ein boolescher Wert, standardmäßig false, ob das Bild innerhalb seines Pfads gehalten wird: des clipping_path, den sein images-Eintrag angibt, oder sonst des Pfads, den seine eigene Datei enthält, des Umrisses, den ein Bildbearbeitungsprogramm in einem JPEG oder TIFF speichert, wenn es ein Bild freistellt; ein Bild ohne beides wird vollständig gezeichnet. pages, ein Array von ab eins gezählten Ganzzahlen, standardmäßig leer für jede Seite; 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. Ein Bildname, den die Anfrage nicht mitliefert, führt zu 400.
Eine vollständige Anfrage, die ein PDF erzeugt
{
"items": [
{
"type": "image",
"image": "logo.png",
"rect": {"llx": 72, "lly": 660, "urx": 192, "ury": 780},
"fit": {
"mode": "contain",
"anchor": "top_left",
"turn": "upright",
"mirror": "neither"
}
}
]
}Bilder und importierte Seiten
Eine Seite eines mitgelieferten PDF, auf der Seite platziert
Wohin als Nächstes
Jeder JSON-Schlüssel einer Anfrage, auf einer Seite Die übrigen zweiundzwanzig Dinge, die Sie zeichnen können