save_pdf: add crop marks

Should satisfy #123

Needs some testing on printers but the functionality is there.
This commit is contained in:
Andy Meneely
2016-11-01 12:12:03 -04:00
parent f94f710040
commit 30395aee56
11 changed files with 1731 additions and 526 deletions
+40 -3
View File
@@ -1,13 +1,11 @@
save_pdf
========
Lays out the cards in range on a sheet and renders a PDF
Lays out the cards in a gride and renders a PDF.
Options
-------
file
default: ``'output.pdf'``
@@ -43,6 +41,45 @@ trim
the space around the edge of each card to trim (e.g. to cut off the bleed margin for print-and-play). Supports :doc:`/units`.
crop_marks
default: ``false``
When ``true``, draws lines in the margins as guides for cutting. Crop marks factor in the ``trim`` (if non-zero), and can also be customized via ``crop_margin_*`` options (see below). Has no effect if ``margin`` is 0.
crop_margin_bottom
default: 0
The space between the bottom edge of the (potentially trimmed) card, and the crop mark. Supports :doc:`/units`. Has no effect if ``crop_marks`` is ``false``.
crop_margin_left
default: 0
The space between the left edge of the (potentially trimmed) card, and the crop mark. Supports :doc:`/units`. Has no effect if ``crop_marks`` is ``false``.
crop_margin_right
default: ``0``
The space between the right edge of the (potentially trimmed) card, and the crop mark. Supports :doc:`/units`. Has no effect if ``crop_marks`` is ``false``.
crop_margin_top
default: ``0``
The space between the top edge of the (potentially trimmed) card, and the crop mark. Supports :doc:`/units`. Has no effect if ``crop_marks`` is ``false``.
crop_stroke_color
default: ``:black``
The color of the crop mark lines. Has no effect if ``crop_marks`` is ``false``.
crop_stroke_dash
default: ``''``
Define a dash pattern for the crop marks. This is a special string with space-separated numbers that define the pattern of on-and-off alternating strokes, measured in pixels or units. For example, ``'0.02in 0.02in'`` will be an equal on-and-off dash pattern. Supports :doc:`/units`. Has no effect if ``crop_marks`` is ``false``.
crop_stroke_width
default: ``1.5``
Width of the crop mark lines. Has no effect if ``crop_marks`` is ``false``.
Examples
--------