Skip to content

Commit 76caf38

Browse files
committed
Add readme
1 parent 08c3390 commit 76caf38

3 files changed

Lines changed: 47 additions & 0 deletions

File tree

Readme.md

Lines changed: 47 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,47 @@
1+
**pdftilecut** lets you sub-divide a PDF page(s) into smaller pages so you
2+
can print them on small form printers. This operation is sometimes called
3+
*posterizing* (related to printing large posters on home printers) and
4+
*[tile cropping](http://www.imagemagick.org/Usage/crop/#crop_tile)*.
5+
6+
# Installation
7+
8+
Latest statically linked binaries [are available on releases
9+
page](https://github.com/oxplot/pdftilecut/releases).
10+
11+
# Features
12+
13+
* Statically compiled Go binaries with no OS dependencies.
14+
* Multi page PDF support. Each page can be of arbitrary size.
15+
* Each output page has appropriate PDF bleed and trim boxes set (so you
16+
can give it to a printing house and get back correctly trimmed pages).
17+
* Print marks to assist with accurate trimming and arranging.
18+
* Small increase in output size.
19+
20+
# Usage
21+
22+
We want to print `mars.pdf` from the [beautiful NASA
23+
posters](https://www.jpl.nasa.gov/visions-of-the-future/)
24+
collection, which comes in 20x30 inch size, on A4 papers:
25+
26+
```sh
27+
$ pdftilecut -tile-size A4 -in mars.pdf -out mars_a4.pdf
28+
```
29+
30+
Below on the left is the orignal poster, and two of its tiles on the
31+
right:
32+
33+
![Poster before and after](/img/example.png?raw=true "Poster before and
34+
after")
35+
36+
The header contains the orignal page number and a tile reference for
37+
easier arranging:
38+
39+
![Tile heading](/img/heading.png?raw=true "Tile heading")
40+
41+
# Credits
42+
43+
The amazing [QPDF library](https://github.com/qpdf/qpdf) is used to
44+
parse and write back modified PDF files. QPDF relies on
45+
[libz](https://www.zlib.net) and
46+
[libjpeg](https://github.com/libjpeg-turbo). Library sources are not
47+
included in this repo and must be downloaded separately.

img/example.png

43.7 KB
Loading

img/heading.png

7.75 KB
Loading

0 commit comments

Comments
 (0)