Imposition

setImposition(settings)

Aplica la configuración de imposición. El objeto es un overlay parcial — las claves omitidas mantienen su valor actual. Devuelve true; un valor de enum desconocido lanza una excepción. Las longitudes están en la unidad actual (o como cadena con sufijo, por ejemplo "6mm"); las claves legacy …Mm/…Pt están siempre en milímetros/puntos.

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

sheet

Clave	Tipo	Valores / notas
preset	string	Preset de papel (fija el tamaño); lista abajo
portrait	bool	Orientación
width / height	number|string	Tamaño explícito (sobreescribe el preset). Legacy: widthMm, heightMm

Valores preset: Auto, Custom, A0–A4, B0–B3, SRA0–SRA4, Letter, Legal, Tabloid, SuperB, ArchB, 19x25, 23x35, 25x38, 28x40 (sin distinción de mayúsculas; también se aceptan los alias con prefijo US).

layout

Clave	Tipo	Valores / notas
type	string	Tipo de imposición (abajo)
autoMode	string	FitGridToSheet, FitSheetToGrid, Manual
cols, rows	int	Cuadrícula
order	string	Z, N, ZReverse, NReverse
scale	string	Fit, Fill, None (100%)
placedRotation	string	Auto, 0, 90, 180, 270
gutterH, gutterV	longitud	Márgenes entre celdas (legacy gutterHMm/gutterVMm)
spine	longitud	Margen de lomo entre pares enfrentados del folleto (legacy spineMm)
gutterAuto	bool	Cálculo automático de gutter
marginTop, marginBottom, marginLeft, marginRight	longitud	Márgenes de hoja

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

source

Clave	Tipo	Valores
mode	string	all, selected, range
range	string	Rango de páginas con mode:"range" (por ejemplo "1-8")

cropMarks

Clave	Tipo	Valores / notas
enabled	bool
length	longitud	Longitud del trazo (legacy lengthMm)
offset	longitud	Distancia al formato terminado (legacy offsetMm)
weight	number (pt)	Grosor del trazo (legacy weightPt)
sides	string	both, front, back, first (firstpage), last (lastpage)
centerMarks	bool
registrationMarks	bool

booklet

Cosido / encuadernación en pliegos.

Clave	Tipo	Valores / notas
foldScheme	string	4pp, 8pp, 16pp, 16ppWide (o 4/8/16/wide)
bindingEdge	string	left, right
duplexFlip	string	short (left), long (top)
creep	bool	Compensación de creep
paperCaliper	longitud	Grosor de papel para el creep (legacy paperCaliperMm)
sheetsPerSig	int	Hojas anidadas por pliego (encuadernación rústica)

stepRepeat

Step-and-repeat de varios diseños.

Clave	Tipo	Valores
sides	string	simplex, duplex
perDesign	string	ownSheet, equal, count
count	int	Copias por diseño (con count)
fill	string	cycle, blank
backFlip	string	left, top (borde de volteo del dorso en duplex)

Con sides: "duplex", el planificador empareja las páginas fuente en diseños frente/dorso y produce hojas de frente y dorso, reflejando las posiciones para el volteo físico según backFlip.

sequential / cutStack

Piezas a dos caras para los tipos Sequential y Cut & Stack. Las páginas se emparejan anverso/reverso (página 1 = anverso, página 2 = su reverso, …); los pliegos de salida alternan anverso y reverso, y un número impar de páginas deja el último reverso en blanco.

Clave	Tipo	Valores
sides	string	simplex, duplex
backFlip	string	left, top (borde de volteo del reverso)

La salida dúplex (Booklet, Section, Half-fold, Tri-fold, Step & Repeat a dos caras, Flip calendar, …) lleva además en el PDF una indicación de impresión dúplex (/ViewerPreferences /Duplex): los diálogos de impresión preseleccionan la impresión a dos caras con el borde de volteo correcto.

output

Clave	Tipo	Valores / notas
profile	string	pdf (estándar), rasterized (aplanar), gs (Ghostscript)
gsPreset	string	prepress, printer, ebook, screen, pdfx1a, custom
gsArgs	string	Argumentos adicionales de Ghostscript (preset custom)
dpi	int	DPI del raster
cmyk	bool	Rasterizar en CMYK (también toCmyk)
intent	string|int	perceptual, relative, saturation, absolute (o 0–3)
iccProfile	ruta	Perfil ICC CMYK (vacío = GRACoL incorporado); alias cmykProfile
rasterizer	string	inhouse (predeterminado) / gs
gsRasterize	bool	Aplanar la transparencia antes de Ghostscript

targetVersion

Versión PDF de salida: "1.3"–"1.7", o "latest" (predeterminado 1.4).

generateImposition() → Document

Produce el PDF impuesto a partir de la configuración actual y lo devuelve como nuevo Document (null + excepción en caso de error).

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

Consulta un objeto de configuración completo en los Ejemplos.