# Copyright 2011-2024 Louis Paternault
#
# This file is part of pdfimpose.
#
# Pdfimpose is free software: you can redistribute it and/or modify
# it under the terms of the GNU Affero General Public License as published by
# the Free Software Foundation, either version 3 of the License, or
# (at your option) any later version.
#
# Pdfimpose is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU Affero General Public License for more details.
#
# You should have received a copy of the GNU Affero General Public License
# along with pdfimpose. If not, see <https://www.gnu.org/licenses/>.
"""Cut as invidual pages, stack and wire bind.
Use this schema if you want to print several source pages on each destination page,
and your booklet is to be wire-bound.
To use this schema:
- print your imposed PDF file, two-sided;
- cut the sheets to separate the pages (you must get one page per page);
- stack the resulting stacks onto each other;
- bind.
"""
import dataclasses
import itertools
import numbers
import papersize
from ... import pdf
from .. import Matrix, Page, cards, size2signature
[docs]
@dataclasses.dataclass
class WireImpositor(cards.CardsImpositor):
"""Perform imposition of source files, with the 'wire' schema."""
def base_matrix(self, total):
"""Yield a single matrix.
This matrix contains the arrangement of source pages on the output pages.
"""
repeat = total // (2 * self.signature[0] * self.signature[1])
recto, verso = (
[[None for _ in range(self.signature[1])] for _ in range(self.signature[0])]
for _ in range(2)
)
for i, coord in enumerate(itertools.product(*map(range, self.signature))):
x, y = coord
recto[x][y] = Page(
2 * i * repeat,
top=self.omargin.top if y == 0 else self.imargin / 2,
bottom=(
self.omargin.bottom
if y == self.signature[1] - 1
else self.imargin / 2
),
left=self.omargin.left if x == 0 else self.imargin / 2,
right=(
self.omargin.right
if x == self.signature[0] - 1
else self.imargin / 2
),
)
verso[self.signature[0] - x - 1][y] = Page(
2 * i * repeat + 1,
top=self.omargin.top if y == 0 else self.imargin / 2,
bottom=(
self.omargin.bottom
if y == self.signature[1] - 1
else self.imargin / 2
),
left=(
self.omargin.left
if x == self.signature[0] - 1
else self.imargin / 2
),
right=self.omargin.right if x == 0 else self.imargin / 2,
)
yield Matrix(recto)
yield Matrix(verso)
def matrixes(self, pages: int):
assert pages % (2 * self.signature[0] * self.signature[1]) == 0
yield from self.stack_matrixes(
list(self.base_matrix(pages)),
repeat=pages // (2 * self.signature[0] * self.signature[1]),
step=2,
)
[docs]
def impose(
files, output, *, imargin=0, omargin=0, last=0, mark=None, signature=None, size=None
):
# pylint: disable=too-many-arguments
"""Perform imposition of source files into an output file, to be cut and "wire bound".
:param list[str] files: List of source files (as strings or :class:`io.BytesIO` streams).
If empty, reads from standard input.
:param str output: List of output file.
:param float omargin: Output margin, in pt. Can also be a :class:`Margins` object.
:param float imargin: Input margin, in pt.
:param int last: Number of last pages (of the source files) to keep at the
end of the output document. If blank pages were to be added to the
source files, they would be added before those last pages.
:param list[str] mark: List of marks to add.
Only crop marks are supported (`mark=['crop']`); everything else is silently ignored.
:param tuple[int] signature: Layout of source pages on output pages.
For instance, ``(2, 3)`` means that each output page will contain
2 columns and 3 rows of source pages. Incompatible with option `size`.
:param str|tuple[float] size: Size of the output page.
Signature is computed to fit the page. This option is incompatible with `signature`.
"""
if mark is None:
mark = []
files = pdf.Reader(files)
if signature is None:
if isinstance(size, str):
size = tuple(float(dim) for dim in papersize.parse_papersize(size))
signature, omargin = size2signature(
size,
sourcesize=files.size,
imargin=imargin,
omargin=omargin,
)
WireImpositor(
imargin=imargin,
omargin=omargin,
last=last,
mark=mark,
signature=signature,
).impose(files, output)