Vai al contenuto

Imposition

setImposition(settings)

Applica le impostazioni di imposizione. L'oggetto è un overlay parziale — le chiavi omesse mantengono il valore corrente. Restituisce true; un valore di enum sconosciuto lancia un'eccezione. Le lunghezze sono nell'unità corrente (o come stringa con suffisso, es. "6mm"); le chiavi legacy …Mm/…Pt sono sempre in millimetri/punti.

doc.setImposition({
  sheet:  { preset: "SRA3", portrait: true },
  layout: { type: "Booklet", cols: 2, rows: 2, order: "Z" },
  cropMarks: { enabled: true },
});

sheet

Chiave Tipo Valori / note
preset string Preset carta (imposta la dimensione); lista sotto
portrait bool Orientamento
width / height number|string Dimensione esplicita (sovrascrive il preset). Legacy: widthMm, heightMm

Valori preset: Auto, Custom, A0–A4, B0–B3, SRA0–SRA4, Letter, Legal, Tabloid, SuperB, ArchB, 19x25, 23x35, 25x38, 28x40 (case-insensitive; sono accettati anche gli alias con prefisso US).

layout

Chiave Tipo Valori / note
type string Tipo di imposizione (sotto)
autoMode string FitGridToSheet, FitSheetToGrid, Manual
cols, rows int Griglia
order string Z, N, ZReverse, NReverse
scale string Fit, Fill, None (100%)
placedRotation string Auto, 0, 90, 180, 270
gutterH, gutterV lunghezza Margini tra celle (legacy gutterHMm/gutterVMm)
spine lunghezza Margine di rilegatura tra le coppie affrontate degli opuscoli (legacy spineMm)
gutterAuto bool Calcolo automatico dei margini
marginTop, marginBottom, marginLeft, marginRight lunghezza Margini del foglio

Valori type: NUp, Booklet, Section, Sequential, StepRepeat, CutAndStack, FlipCalendar, TriFold, WallCalendar, Accordion, HalfFold, GreetingCard.

source

Chiave Tipo Valori
mode string all, selected, range
range string Intervallo di pagine con mode:"range" (es. "1-8")

cropMarks

Chiave Tipo Valori / note
enabled bool
length lunghezza Lunghezza del tratto (legacy lengthMm)
offset lunghezza Distanza dal formato finito (legacy offsetMm)
weight number (pt) Spessore del tratto (legacy weightPt)
sides string both, front, back, first (firstpage), last (lastpage)
centerMarks bool
registrationMarks bool

booklet

Punto metallico / rilegatura in segnature.

Chiave Tipo Valori / note
foldScheme string 4pp, 8pp, 16pp, 16ppWide (o 4/8/16/wide)
bindingEdge string left, right
duplexFlip string short (left), long (top)
creep bool Compensazione del creep
paperCaliper lunghezza Spessore carta per il creep (legacy paperCaliperMm)
sheetsPerSig int Fogli nidificati per segnatura (brossura)

stepRepeat

Step-and-repeat di più grafiche.

Chiave Tipo Valori
sides string simplex, duplex
perDesign string ownSheet, equal, count
count int Copie per grafica (con count)
fill string cycle, blank
backFlip string left, top (bordo di voltatura per il verso in duplex)

Con sides: "duplex", il pianificatore abbina le pagine sorgente in grafiche fronte/retro e produce i fogli recto e verso, specchiando le posizioni per la voltatura fisica in base a backFlip.

sequential / cutStack

Pezzi fronte-retro per i tipi Sequential e Cut & Stack. Le pagine si accoppiano fronte/retro (pagina 1 = fronte, pagina 2 = il suo retro, …); i fogli di output alternano fronte e retro, e un numero dispari di pagine lascia l'ultimo retro vuoto.

Chiave Tipo Valori
sides string simplex, duplex
backFlip string left, top (bordo di ribaltamento del retro)

L'output duplex (Booklet, Section, Half-fold, Tri-fold, Step & Repeat fronte-retro, Flip calendar, …) porta inoltre nel PDF un suggerimento di stampa duplex (/ViewerPreferences /Duplex): le finestre di stampa preselezionano il fronte-retro con il bordo di ribaltamento corretto.

output

Chiave Tipo Valori / note
profile string pdf (standard), rasterized (appiattimento), gs (Ghostscript)
gsPreset string prepress, printer, ebook, screen, pdfx1a, custom
gsArgs string Argomenti Ghostscript aggiuntivi (preset custom)
dpi int DPI del raster
cmyk bool Rasterizza in CMYK (anche toCmyk)
intent string|int perceptual, relative, saturation, absolute (o 0–3)
iccProfile percorso Profilo ICC CMYK (vuoto = GRACoL incorporato); alias cmykProfile
rasterizer string inhouse (predefinito) / gs
gsRasterize bool Appiattisce la trasparenza prima di Ghostscript

targetVersion

Versione PDF di output: "1.3"–"1.7", o "latest" (predefinito 1.4).

generateImposition() → Document

Produce il PDF imposto dalle impostazioni correnti e lo restituisce come nuovo Document (null + eccezione in caso di errore).

var out = doc.generateImposition();
out.save("/path/booklet_imposed.pdf", { autoIndex: true });

Vedi un oggetto di impostazioni completo negli Esempi.