You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 

111 lines
2.9 KiB

cut_zone
--------
Draw a rounded rectangle set in from the edges of the card to indicate the bleed area.
This method is a wrapper around :doc:`/dsl/rect`, with its own defaults.
Options
^^^^^^^
.. include:: /args/expansion.rst
margin
default: '0.125in'
The distance from the edge of the card to the cut zone. Supports :doc:`/units`.
width
default: ``width - margin`` (the width of the deck minus the margin)
the width of the box. Supports :doc:`/units`.
height
default: ``height - margin`` (the height of the deck minus the margin)
the height of the box. Supports :doc:`/units`.
fill_color
default: ``'#0000'`` (fully transparent)
the color or gradient to fill with. See :doc:`/colors`.
stroke_color
default: ``:blue``
the color with which to stroke the outside of the shape. See :doc:`/colors`.
stroke_width
default: ``1.0``
the width of the outside stroke. Supports :doc:`/units`.
stroke_strategy
default: ``:fill_first``
Specify whether the stroke is done before (thinner) or after (thicker) filling the shape.
Must be either ``:fill_first`` or ``:stroke_first`` (or their string equivalents).
join
default: ``:mitre``
Specifies how to render the junction of two lines when stroking. Options are ``:mitre``, ``:round``, and ``:bevel``.
dash
default: ``'3 3'`` (no dash pattern set)
Define a dash pattern for the stroke. 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`.
cap
default: ``:butt``
Define how the end of the stroke is drawn. Options are ``:square``, ``:butt``, and ``:round`` (or string equivalents of those).
x
default: ``margin`` (whatever the margin was set to)
the x-coordinate to place, relative to the upper-left corner of the card and moving right as it increases. Supports :doc:`/units`and :doc:`/shorthands`.
y
default: ``margin`` (whatever the margin was set to)
the y-coordinate to place, relative to the upper-left corner of the card and moving downward as it increases. Supports :doc:`/units`and :doc:`/shorthands`.
.. include:: /args/range.rst
.. include:: /args/layout.rst
angle
default: 0
the angle at which to rotate the rectangle about it's upper-left corner
x_radius
default: ``0.125in``
The x radius of the rounded corners. Supports :doc:`/units`.
y_radius
default: ``0.125in``
The y radius of the rounded corners. Supports :doc:`/units`.
radius
default: ``nil``
The x and y radius of the rounded corners. If specified, overrides x_radius and y_radius. Supports :doc:`/units`.
Examples
^^^^^^^^
.. literalinclude:: ../../samples/shapes/_proofs.rb
:linenos:
.. raw:: html
<img src="../shapes/proof_poker_00_expected.png" width=600 class="figure">
<img src="../shapes/proof_tiny_00_expected.png" width=600 class="figure">