save_pdf: add crop marks
Should satisfy #123 Needs some testing on printers but the functionality is there.
This commit is contained in:
+40
-3
@@ -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
|
||||
--------
|
||||
|
||||
Reference in New Issue
Block a user