Aller au contenu

API de script — vue d'ensemble

Imposio embarque un moteur JavaScript (l'onglet Script). Les scripts pilotent les mêmes opérations que vous faites à la main — ouvrir des documents, imposer, éditer, exporter — pour automatiser le travail répétitif et standardiser la sortie.

Exécuter un script

Ouvrez l'onglet Script, écrivez ou ouvrez un fichier .js, puis Run. Vous pouvez aussi enregistrer vos actions dans l'interface : Imposio écrit le script équivalent (les extraits de ces pages sont exactement les appels produits par l'enregistreur).

Le modèle objet

Tout part d'un seul objet global, imposio :

imposio.setUnits("mm");
var doc = imposio.open("/path/to/file.pdf");   // → un Document
doc.setImposition({ /* … */ });
var out = doc.generateImposition();            // → un nouveau Document
out.save("/path/to/out.pdf");
  • imposio — le point d'entrée : ouvrir/créer des documents, unités, utilitaires.
  • Document — l'enveloppe d'un PDF : opérations sur les pages, export, métadonnées, sécurité, inspection.
  • Imposition — réglages setImposition() et generateImposition().
  • Calque d'édition — dessiner et manipuler formes vectorielles, texte et images.
  • Exemples — scripts complets.

Unités

Les longueurs sont en millimètres par défaut. Changez l'unité pour tous les appels suivants avec imposio.setUnits() ("mm", "cm", "in", "pt").

Les valeurs de longueur acceptent soit un nombre (dans l'unité courante), soit une chaîne avec suffixe qui force l'unité :

imposio.setUnits("mm");
doc.addBlankPage(-1, 210, 297);     // mm
doc.addBlankPage(-1, "8.5in", "11in");  // unités explicites par valeur

Coordonnées

La géométrie utilise les coordonnées PDF : l'origine est le coin inférieur gauche et Y monte. Les index de page sont base 0. Les plages de pages sont des chaînes : "all", "1-5", "odd", "even", "2,4,7" (chaîne vide = toutes).

Gestion des erreurs

Les méthodes qui échouent lèvent une exception JavaScript (p. ex. valeur d'énumération invalide, ou document manquant). Encadrez les appels risqués de try { … } catch (e) { … } si vous devez gérer les échecs proprement. Les méthodes qui renvoient un Document renvoient null en cas d'échec.