Imposition¶
setImposition(settings)¶
Applique les réglages d'imposition. L'objet est un overlay partiel — les clés omises
gardent leur valeur actuelle. Renvoie true ; une valeur d'énumération inconnue lève une
exception. Les longueurs sont dans l'unité courante (ou en chaîne suffixée comme "6mm") ;
les clés legacy …Mm/…Pt sont toujours en millimètres/points.
doc.setImposition({
sheet: { preset: "SRA3", portrait: true },
layout: { type: "Booklet", cols: 2, rows: 2, order: "Z" },
cropMarks: { enabled: true },
});
sheet¶
| Clé | Type | Valeurs / notes |
|---|---|---|
preset |
string | Préréglage papier (fixe la taille) ; liste ci-dessous |
portrait |
bool | Orientation |
width / height |
number|string | Taille explicite (écrase le préréglage). Legacy : widthMm, heightMm |
Valeurs preset : Auto, Custom, A0–A4, B0–B3, SRA0–SRA4, Letter,
Legal, Tabloid, SuperB, ArchB, 19x25, 23x35, 25x38, 28x40 (insensible à la
casse ; les alias préfixés US sont aussi acceptés).
layout¶
| Clé | Type | Valeurs / notes |
|---|---|---|
type |
string | Type d'imposition (ci-dessous) |
autoMode |
string | FitGridToSheet, FitSheetToGrid, Manual |
cols, rows |
int | Grille |
order |
string | Z, N, ZReverse, NReverse |
scale |
string | Fit, Fill, None (100%) |
placedRotation |
string | Auto, 0, 90, 180, 270 |
gutterH, gutterV |
longueur | Blancs entre cellules (legacy gutterHMm/gutterVMm) |
spine |
longueur | Blanc de reliure livret entre paires en regard (legacy spineMm) |
gutterAuto |
bool | Calcul automatique des blancs |
marginTop, marginBottom, marginLeft, marginRight |
longueur | Marges de feuille |
Valeurs type : NUp, Booklet, Section, Sequential, StepRepeat, CutAndStack,
FlipCalendar, TriFold, WallCalendar, Accordion, HalfFold, GreetingCard.
source¶
| Clé | Type | Valeurs |
|---|---|---|
mode |
string | all, selected, range |
range |
string | Plage de pages avec mode:"range" (p. ex. "1-8") |
cropMarks¶
| Clé | Type | Valeurs / notes |
|---|---|---|
enabled |
bool | |
length |
longueur | Longueur du trait (legacy lengthMm) |
offset |
longueur | Distance au format fini (legacy offsetMm) |
weight |
number (pt) | Épaisseur de trait (legacy weightPt) |
sides |
string | both, front, back, first (firstpage), last (lastpage) |
centerMarks |
bool | |
registrationMarks |
bool |
booklet¶
Piqûre à cheval / reliure en cahiers.
| Clé | Type | Valeurs / notes |
|---|---|---|
foldScheme |
string | 4pp, 8pp, 16pp, 16ppWide (ou 4/8/16/wide) |
bindingEdge |
string | left, right |
duplexFlip |
string | short (left), long (top) |
creep |
bool | Compensation de chasse (creep) |
paperCaliper |
longueur | Épaisseur papier pour la chasse (legacy paperCaliperMm) |
sheetsPerSig |
int | Feuilles emboîtées par cahier (dos carré collé) |
stepRepeat¶
Amalgame de plusieurs visuels.
| Clé | Type | Valeurs |
|---|---|---|
sides |
string | simplex, duplex |
perDesign |
string | ownSheet, equal, count |
count |
int | Copies par visuel (avec count) |
fill |
string | cycle, blank |
backFlip |
string | left, top (bord de retournement du verso en duplex) |
Avec sides: "duplex", le planificateur apparie les pages sources en visuels recto/verso et
produit feuilles recto et verso, en miroitant les positions pour le retournement physique
selon backFlip.
sequential / cutStack¶
Pièces recto-verso pour les types Sequential et Cut & Stack. Les pages se groupent par paires recto/verso (page 1 = recto, page 2 = son verso, …) ; les feuilles de sortie alternent recto et verso, et un nombre impair de pages laisse le dernier verso vierge.
| Clé | Type | Valeurs |
|---|---|---|
sides |
string | simplex, duplex |
backFlip |
string | left, top (bord de retournement du verso) |
La sortie duplex (Booklet, Section, Half-fold, Tri-fold, Step & Repeat recto-verso, Flip
calendar, …) porte en outre une indication d'impression duplex dans le PDF
(/ViewerPreferences /Duplex) : les boîtes de dialogue d'impression présélectionnent le
recto-verso avec le bon bord de retournement.
output¶
| Clé | Type | Valeurs / notes |
|---|---|---|
profile |
string | pdf (standard), rasterized (aplatir), gs (Ghostscript) |
gsPreset |
string | prepress, printer, ebook, screen, pdfx1a, custom |
gsArgs |
string | Arguments Ghostscript supplémentaires (préréglage custom) |
dpi |
int | DPI du raster |
cmyk |
bool | Rasteriser en CMJN (aussi toCmyk) |
intent |
string|int | perceptual, relative, saturation, absolute (ou 0–3) |
iccProfile |
chemin | Profil ICC CMJN (vide = GRACoL embarqué) ; alias cmykProfile |
rasterizer |
string | inhouse (défaut) / gs |
gsRasterize |
bool | Aplatir la transparence avant Ghostscript |
targetVersion¶
Version cible du PDF de sortie : "1.3"–"1.7", ou "latest" (défaut 1.4).
generateImposition() → Document¶
Produit le PDF imposé à partir des réglages courants et le renvoie comme nouveau Document
(null + exception en cas d'erreur).
var out = doc.generateImposition();
out.save("/path/booklet_imposed.pdf", { autoIndex: true });
Voir un objet de réglages complet enregistré dans les Exemples.