3 `pdfstitch` does a similar job to `pdfnup` but focuses on the following features:
5 * Crop pages to a certain size
6 * Adjust the crop position per page
8 It has been created to print sewing patterns distributed as A4 or Letter PDFs on a large format printer
9 thus saving oneself the hassle of cutting and gluing individual pages.
12 `pdfstitch` is free software under the GNU AGPL version 3. See `LICENSE` for details.
16 `pdfstitch` is dedicated to the memory of Janka "marsi" Kuhfuß.
20 `pdfstitch` makes use of the following Perl modules:
22 * File::Basename (part of perl base)
24 * Getopt::Long (part of perl base)
28 On Debian, you can install them with:
30 `# apt install libfile-libmagic-perl libpdf-api2-perl libyaml-perl`
32 On FreeBSD, you can install them with:
34 `# pkg install p5-File-LibMagic p5-PDF-API2 p5-YAML`
38 1. Run `pdfstitch` on your input PDF:
40 `./pdfstitch [--genmeta] [--defaultcrop=0.9] foobar.pdf`
42 This will generate a YAML file called `foobar.pdf.stitch`. Edit this file according to the desired output.
43 This is also the default action if called with a PDF. Per default 10% (factor 0.9) is applied as crop factor.
44 You can adjust this value with the --defaultcrop parameter.
46 2. Optional: Generate a preview and/or cropped PDF:
48 `./pdfstitch --preview foobar.pdf.stitch`
50 This will generate a new PDF called `foobar-preview.pdf`.
51 It contains only the pages you select in the YAML file with each page being overlayed with a transparent box
52 showing the area the page will be cropped to.
54 `./pdfstitch --crop foobar.pdf.stitch`
56 This will generate a new PDF called `foobar-cropped.pdf`.
57 It contains only the pages you select in the YAML file with each page being cropped accordingly.
59 3. Generate the final stitched PDF:
61 `./pdfstitch --stitch foobar.pdf.stitch`
63 This will generate a single-page PDF called `foobar-stitched.pdf` with all selected pages being
64 stitched together as specified in the YAML file.
65 This is also the default action if called with just a YAML file.
69 * The output file name is based on the .stitch file name.
70 * All output files are placed in the current working directory.