Une écriture de secours pour les signes rares

En mots de tous les jours

Écrit pour tout le monde. Il dit ce que cela pose sur une feuille de papier, et ne vous demande rien de plus.

Une écriture ne contient pas tous les signes du monde. Une belle écriture de texte peut très bien ignorer l'alphabet grec, un idéogramme ou un symbole de monnaie rare. Plutôt que de laisser un trou, on met plusieurs écritures à la suite : la première dessine ce qu'elle sait dessiner, et pour le reste on passe à la suivante. Le lecteur, lui, voit un texte complet.

Pour un développeur

Écrit pour celui qui écrit le programme appelant : le modèle, les unités, et les réglages qui portent le poids.

font_chains déclare une police composée de plusieurs autres, sous son propre nom : un caractère est dessiné par la première police de la chaîne qui porte une forme pour lui. Chaque police de la chaîne reste utilisable telle quelle par ailleurs. Les maillons se cherchent parmi les polices embarquées, celles du client, celles de la bibliothèque, et parmi les polices que la requête déclare elle-même : les quatorze faces normalisées, les programmes Type 1, les lettres dessinées.

Chaque clé, avec son défaut

La référence : quelles clés sont obligatoires, lesquelles sont facultatives, ce que vaut chacune par défaut et quelles combinaisons le serveur décline.

font_chains — tableau, facultatif, vide par défaut.
font_chains[].name — chaîne, obligatoire. Le nom sous lequel les éléments écrivent avec la chaîne.
font_chains[].faces — tableau de chaînes, obligatoire, au moins deux noms. Les polices qui la composent, dans l'ordre où un caractère leur est proposé. Une chaîne d'un seul nom est refusée.

Un nom de maillon désigne une police embarquée, une police du client, une police de la bibliothèque, ou une police que la requête déclare : standard_fonts, type1_fonts, type3_fonts. Les polices que la requête déclare sont chargées avant les chaînes, si bien qu'une chaîne peut s'appuyer dessus.

Une requête entière qui le dessine

Envoyez ceci tel quel et un PDF revient. Rien n'en a été retiré.

{
  "standard_fonts": [
    { "name": "sans", "face": "helvetica" },
    { "name": "signs", "face": "symbol" }
  ],
  "font_chains": [
    { "name": "text_and_signs", "faces": ["sans", "signs"] }
  ],
  "items": [
    {
      "type": "text",
      "rect": { "llx": 60, "lly": 740, "urx": 535, "ury": 765 },
      "content": ["Angle α = 30 degrees"],
      "font": "text_and_signs",
      "font_size": 14
    }
  ]
}

La ligne qui l'envoie, en trois langages

Les lettres

Emporter sa police dans le document Les anciens programmes de police Type 1 Les quatorze écritures que tout lecteur possède Les finesses typographiques d'une écriture Une écriture dont vous dessinez les lettres

Où aller ensuite

Chaque clé d'une requête, en une page Les trente-deux autres réglages d'une requête

Voir les prix Voir les exemples

Glossaire

bibliothèque PDF: Un logiciel que vos propres programmes utilisent pour écrire des documents PDF. Il n'a ni fenêtre ni bouton : votre programme lui dit quoi dessiner, et il rend le fichier fini. Ce site l'appelle aussi le moteur, c'est la même chose sous un autre nom. Le serveur est un second programme, qui contient le moteur et répond à qui lui demande un document par le réseau ; et le service de rendu, c'est ce serveur quand il tourne sur nos machines plutôt que sur les vôtres.
police: Le dessin de chaque lettre, de chaque chiffre et de chaque signe qu'un document écrit, rangé dans un fichier à part. Un PDF emporte à l'intérieur de lui-même les polices dans lesquelles il est composé : c'est pour cela qu'il s'ouvre à l'identique sur une machine qui ne les a jamais eues. Sans elles, un lecteur en met une autre à la place, et la mise en page bouge.
requête: Un appel au service : vous envoyez ce que le document doit dire, et vous recevez le document. Votre facture compte ces appels, un par document. Le nombre de pages d'un document n'est jamais compté.
police Type 1: La forme la plus ancienne d'un fichier de police, encore employée quand une taille de caractère précise n'a jamais existé autrement. Un document emporte le fichier tel qu'il a été fourni.

Tous les mots que le site explique