TODO

   1 - Integrate pdf-tools.cc with the rest of the code
   2 - What if an input page specifies /Rotate?
   3 - Better error messages from instantiation
   4 - page->index: use or remove
   5 - rename page->bbox to page->image_box?
   6
   7 | # Position bbox on a new paper
   8 | paper("a4")
   9 | paper(w=210mm,h=297mm,pos=(t|b|c)(l|r|c))
  10
  11 | # Scale paper to a new size
  12 | scaleto("a4")
  13 | scaleto(w=210mm,h=297mm,pos=tl)
  14
  15 | # Fit image to a paper
  16 | # If paper is given: scale image
  17 | # If no paper is given: adjust paper to image + margins
  18 | fit("a4")
  19 | fit(w=, h=)
  20 | margin= hmargin= vmargin=
  21 | lmargin= rmargin= tmargin= bmargin=
  22 | pos=
  23
  24 | # Adjust paper size
  25 | expand(10mm)
  26 | expand(h=10mm, v=20mm)
  27 | expand(l=10mm, r=10mm, t=10mm, b=10mm)
  28
  29 | # Adjust image size (in terms of margins around)
  30 | margins ... params like expand
  31
  32 cropmarks
  33         style=box       # Box around image
  34         style=cross     # Crosses in the corners
  35         style=halfcross # Half-crosses in the corners (default)
  36         pen=1pt         # Line width
  37         len=5mm         # Cross arm length
  38         dist=5mm        # Distance from border
  39
  40 book
  41         signature=<n>
  42
  43 # Crop to image box
  44 crop
  45         bleed=5mm       # Allow bleeding over the image box
  46
  47 duplex
  48         long-edge
  49
  50 | merge
  51
  52 modulo
  53         half
  54
  55 # Add an empty page after the current one
  56 add-blank
  57
  58 # Set either:
  59 #       - paper size + margins
  60 #       - scale + margins
  61 nup(hnum, vnum)
  62         paper / w / h   # Specify paper size, default=copy from 1st image
  63         + fit options (*margin, pos)
  64         crop            # Crop to image
  65         rotate=1        # Override rotation decision
  66         scale=1         # Override scaling factor
  67         tile            # Tile with copies of a single page
  68         hspace / vspace / space # Distance between tiles
  69         + cropmarks?