Imposition¶
setImposition(settings)¶
Применяет настройки импозиции. Объект является частичным overlay — пропущенные ключи
сохраняют текущее значение. Возвращает true; неизвестное значение enum бросает
исключение. Длины задаются в текущей единице (или строкой с суффиксом, например "6mm");
legacy-ключи …Mm/…Pt всегда в миллиметрах/пунктах.
doc.setImposition({
sheet: { preset: "SRA3", portrait: true },
layout: { type: "Booklet", cols: 2, rows: 2, order: "Z" },
cropMarks: { enabled: true },
});
sheet¶
| Ключ | Тип | Значения / примечания |
|---|---|---|
preset |
string | Пресет бумаги (задаёт размер); список ниже |
portrait |
bool | Ориентация |
width / height |
number|string | Явный размер (переопределяет пресет). Legacy: widthMm, heightMm |
Значения preset: Auto, Custom, A0–A4, B0–B3, SRA0–SRA4, Letter,
Legal, Tabloid, SuperB, ArchB, 19x25, 23x35, 25x38, 28x40 (без учёта
регистра; принимаются и псевдонимы с префиксом US).
layout¶
| Ключ | Тип | Значения / примечания |
|---|---|---|
type |
string | Тип импозиции (ниже) |
autoMode |
string | FitGridToSheet, FitSheetToGrid, Manual |
cols, rows |
int | Сетка |
order |
string | Z, N, ZReverse, NReverse |
scale |
string | Fit, Fill, None (100%) |
placedRotation |
string | Auto, 0, 90, 180, 270 |
gutterH, gutterV |
длина | Поля между ячейками (legacy gutterHMm/gutterVMm) |
spine |
длина | Корешковое поле между парами буклета (legacy spineMm) |
gutterAuto |
bool | Автоматический расчёт gutter |
marginTop, marginBottom, marginLeft, marginRight |
длина | Поля листа |
Значения type: NUp, Booklet, Section, Sequential, StepRepeat,
CutAndStack, FlipCalendar, TriFold, WallCalendar, Accordion, HalfFold,
GreetingCard.
source¶
| Ключ | Тип | Значения |
|---|---|---|
mode |
string | all, selected, range |
range |
string | Диапазон страниц при mode:"range" (например "1-8") |
cropMarks¶
| Ключ | Тип | Значения / примечания |
|---|---|---|
enabled |
bool | |
length |
длина | Длина черты (legacy lengthMm) |
offset |
длина | Расстояние от чистового формата (legacy offsetMm) |
weight |
number (pt) | Толщина черты (legacy weightPt) |
sides |
string | both, front, back, first (firstpage), last (lastpage) |
centerMarks |
bool | |
registrationMarks |
bool |
booklet¶
Скрепление скобами / брошюровка тетрадями.
| Ключ | Тип | Значения / примечания |
|---|---|---|
foldScheme |
string | 4pp, 8pp, 16pp, 16ppWide (или 4/8/16/wide) |
bindingEdge |
string | left, right |
duplexFlip |
string | short (left), long (top) |
creep |
bool | Компенсация creep |
paperCaliper |
длина | Толщина бумаги для creep (legacy paperCaliperMm) |
sheetsPerSig |
int | Листов в тетради (клеевое скрепление) |
stepRepeat¶
Step-and-repeat нескольких макетов.
| Ключ | Тип | Значения |
|---|---|---|
sides |
string | simplex, duplex |
perDesign |
string | ownSheet, equal, count |
count |
int | Копий на макет (с count) |
fill |
string | cycle, blank |
backFlip |
string | left, top (ребро переворота оборота при duplex) |
При sides: "duplex" планировщик объединяет исходные страницы в пары лицо/оборот и
создаёт листы лицо и оборот, зеркалируя позиции для физического переворота по backFlip.
sequential / cutStack¶
Двусторонние изделия для типов Sequential и Cut & Stack. Страницы объединяются в пары лицо/оборот (страница 1 = лицо, страница 2 = её оборот, …); выходные листы чередуют лицо и оборот, при нечётном числе страниц последний оборот остаётся пустым.
| Ключ | Тип | Значения |
|---|---|---|
sides |
string | simplex, duplex |
backFlip |
string | left, top (край переворота оборота) |
Дуплексный вывод (Booklet, Section, Half-fold, Tri-fold, двусторонний Step & Repeat, Flip
calendar, …) дополнительно несёт в PDF подсказку двусторонней печати
(/ViewerPreferences /Duplex): диалоги печати заранее выбирают двустороннюю печать с
правильным краем переворота.
output¶
| Ключ | Тип | Значения / примечания |
|---|---|---|
profile |
string | pdf (стандарт), rasterized (выравнивание), gs (Ghostscript) |
gsPreset |
string | prepress, printer, ebook, screen, pdfx1a, custom |
gsArgs |
string | Дополнительные аргументы Ghostscript (пресет custom) |
dpi |
int | DPI растра |
cmyk |
bool | Растеризовать в CMYK (также toCmyk) |
intent |
string|int | perceptual, relative, saturation, absolute (или 0–3) |
iccProfile |
путь | ICC-профиль CMYK (пустой = встроенный GRACoL); псевдоним cmykProfile |
rasterizer |
string | inhouse (по умолчанию) / gs |
gsRasterize |
bool | Выровнять прозрачность перед Ghostscript |
targetVersion¶
Версия PDF вывода: "1.3"–"1.7" или "latest" (по умолчанию 1.4).
generateImposition() → Document¶
Создаёт импозированный PDF из текущих настроек и возвращает как новый Document
(null + исключение в случае ошибки).
var out = doc.generateImposition();
out.save("/path/booklet_imposed.pdf", { autoIndex: true });
Полный объект настроек — см. в Примерах.