line

Draw a line from x1,y1 to x2,y2.

Options

All of these options support arrays and singleton expansion (except for range). See Squib Thinks in Arrays for deeper explanation.

x1

default: 0

the x-coordinate to place. Supports Unit Conversion and XYWH Shorthands.

y1

default: 0

the y-coordinate to place. Supports Unit Conversion and XYWH Shorthands.

x2

default: 50

the x-coordinate to place. Supports Unit Conversion and XYWH Shorthands.

y2

default: 50

the y-coordinate to place. Supports Unit Conversion and XYWH Shorthands.

fill_color

default: '#0000' (fully transparent)

the color or gradient to fill with. See Specifying Colors & Gradients.

stroke_color

default: :black

the color with which to stroke the outside of the shape. See Specifying Colors & Gradients.

stroke_width

default: 2

the width of the outside stroke. Supports Unit Conversion.

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).

dash

default: '' (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 Unit Conversion.

cap

default: :butt

Define how the end of the stroke is drawn. Options are :square, :butt, and :round (or string equivalents of those).

join

default: :mitre

Specifies how to render the junction of two lines when stroking. Options are :mitre, :round, and :bevel.

range

default: :all

the range of cards over which this will be rendered. See Using range to specify cards

layout

default: nil

entry in the layout to use as defaults for this command. See Layouts are Squib’s Best Feature.

Examples