Une page d’un PDF fourni, posée sur la page

Reprendre une page d’un PDF envoyé avec la requête et la poser dans un cadre, à ses proportions, au milieu des autres éléments.

Le résultat dans un vrai PDF

Une facture posée sur un modèle à en-tête

Une facture posée sur un papier à en-tête fourni sous forme de fichier PDF.

Ouvrir le PDF Voir l’exemple complet

Également dans les exemples : Un modèle dont les zones se remplissent par leur nom

Résumé

Vous avez déjà un bon de garantie, un plan ou un reçu en PDF. Plutôt que de le refaire, vous l’envoyez tel quel. La page grandit jusqu’à toucher le bord le plus proche du cadre et se centre dans l’espace restant, sans être écrasée. Autour d’elle, vous continuez à écrire, à dessiner et à placer des tableaux comme d’habitude. Si la page comporte des emplacements nommés à remplir, comme celui de l’adresse ou celui du logo, vous envoyez le texte ou l’image sous ce nom, et chacun prend sa place où que la page soit posée.

Techniquement

Demandé avec "type": "pdf_page"

Les octets du PDF source voyagent avec la requête, dans une partie fournie ; la clé pdf reprend ce nom, pris dans le même vivier que les modèles de page, si bien qu’un seul fichier fourni sert à la fois de fond de page et d’élément placé. Le numéro de page compte à partir de 1. Cette page est copiée, avec les ressources qu’elle utilise, dans un XObject de forme, puis peinte dans le cadre : elle garde ses proportions, est mise à l’échelle jusqu’à toucher la largeur ou la hauteur du cadre, puis se centre dans le reste. À la différence d’un modèle de page, qui garnit toute la page sous le contenu, cet élément est un élément parmi les autres, placé dans une boîte, et se combine donc avec le texte à côté de lui.

Schéma de la requête

Clés obligatoires : pdf, une chaîne nommant la partie fournie ; rect. Facultatives : page, un entier compté à partir de 1, 1 par défaut ; pages, un tableau d’entiers comptés à partir de 1, vide par défaut, ce qui vaut toutes les pages du document fini ; transform, six nombres ; rotate, un angle en degrés, dans le sens inverse des aiguilles d’une montre, autour du centre du rectangle ; layer, le nom d’un calque déclaré. Refus croisé : transform avec rotate. La page importée garde toujours ses proportions : la clé d’ajustement des images n’a pas d’équivalent ici. from_defaults, le nom d’un état graphique déclaré avec initial, est l’état à partir duquel la page est dessinée : il est posé, puis un remplissage et un trait noirs, une ligne pleine d’un point aux bouts droits, des jonctions en onglet avec une limite d’onglet de dix, et l’état du texte au repos, si bien qu’une page qui compte sur les valeurs de départ d’une page dessine avec elles plutôt qu’avec ce que la page où elle arrive a posé en dernier ; absent, la page dessine dans l’état en vigueur là où elle est posée. keep_layers, un booléen, false par défaut ; à true, les calques dont le document d’origine marque la page deviennent des lignes du panneau des calques de ce document-ci, sous les noms et dans les états que le document d’origine leur donnait. own_runs, l’étiquette sous laquelle l’arbre de structure rattache, par les imported_runs d’un nœud, les passages que le document d’origine a marqués dans la page, si bien qu’une page balisée reprise garde dans l’arbre ses paragraphes, ses titres et ses figures. fill, un objet dont les clés sont les noms des zones que délimite le fichier d’origine de la page, au sens de page_regions, chaque zone étant remplie là où elle arrive : text avec content, et font, font_size, color et align, qui priment sur ceux de la zone ; image, qui nomme une image fournie ; drawing, qui nomme un dessin déclaré ou un dessin de svg_drawings ; page, qui nomme une page d’un PDF fourni par pdf et page, et accepte ses propres fill et unfilled. Ces trois derniers acceptent fit et anchor. unfilled, sample par défaut : chaque zone de texte que la demande ne remplit pas affiche son texte d’exemple ; empty la laisse vide. Chaque remplissage accepte tag et mark, comme un élément : sans eux, ce qu’il dessine est du décor, que les lecteurs d’écran sautent ; avec eux, c’est un passage numéroté que l’arbre de structure rattache. Refusés : un nom qu’aucune zone ne porte, une zone d’un autre type, tout remplissage d’une page dont le fichier ne délimite aucune zone, l’une des clés tag et mark sans l’autre.

Une requête entière qui crée un PDF

{
  "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"
    }
  ]
}

La ligne qui l’envoie, en trois langages

Images et pages importées

Une image posée dans un rectangle

Où aller ensuite

Toutes les clés JSON d’une requête, en une page Les vingt-deux autres choses que l’on peut dessiner

Voir les prix Voir les exemples