drawlib.lines & drawlib.text

drawlib.lines renders 1D straight, curved, Bézier, elliptical-arc, and corner-filleted vector connectors with tangent-aligned arrowheads, while drawlib.text renders horizontal, rotated, multi-line, and vertical typography. Import primitives via from drawlib.lines import line, line_curved, lines, lines_curved, ... and from drawlib.text import text, text_vertical.

from drawlib.canvas import save, setup
from drawlib.lines import line, line_bezier2, line_curved, lines_curved
from drawlib.shapes import rectangle
from drawlib.styles import Colors, Styles
from drawlib.text import text, text_vertical

setup(width=120, height=58, dpi=150)

# Title header
text(
    (64, 52.0),
    "Vector Connectors & Typography Anchors",
    style=Styles.DarkBold.patch(text_size=12.2),
)

# Left vertical tier banner demonstrating text_vertical()
rectangle((9.5, 26), width=9, height=40, style=Styles.SecondaryNeutral.patch(shape_r=1.8))
text_vertical((9.5, 26), "ROUTING", style=Styles.DarkBold.patch(text_size=10.5))

# Nodes (3 Neutral + 1 PrimaryFlat Hero)
rectangle(
    (31, 38),
    width=22,
    height=11,
    style=Styles.Neutral.patch(shape_r=2.0),
    text="Ingress",
    text_style=Styles.DarkBold.patch(text_size=10.8),
)
rectangle(
    (31, 14),
    width=22,
    height=11,
    style=Styles.PrimaryNeutral.patch(shape_r=2.0),
    text="Queue",
    text_style=Styles.DarkBold.patch(text_size=10.8),
)
rectangle(
    (67, 26),
    width=24,
    height=12,
    style=Styles.PrimaryFlat.patch(shape_r=2.0),
    text="Router",
    text_style=Styles.WhiteBold.patch(text_size=11.2, text_color=Colors.White),
)
rectangle(
    (103, 26),
    width=22,
    height=12,
    style=Styles.Neutral.patch(shape_r=2.0),
    text="Replica",
    text_style=Styles.DarkBold.patch(text_size=10.8),
)

# 1. Cubic S-curve (line_bezier2)
line_bezier2(
    xy1=(42, 38),
    xy2=(55, 28),
    cp1=(48.5, 38),
    cp2=(48.5, 28),
    arrow_head="->",
    style=Styles.DarkBold,
)
text((50.5, 39.5), "bezier2", style=Styles.Dark.patch(text_size=10.0))

# 2. Filleted orthogonal path (lines_curved)
lines_curved(
    [(42, 14), (67, 14), (67, 20)],
    r=3.5,
    arrow_head="->",
    style=Styles.DarkBold.patch(line_style="dashed"),
)
text((54.5, 9.5), "lines_curved", style=Styles.Dark.patch(text_size=10.0))

# 3. Smooth arc spline (line_curved) + straight return (line)
line_curved((79, 29), (92, 29), bend=-0.32, arrow_head="->", style=Styles.DarkBold)
text((85.5, 35.2), "line_curved", style=Styles.Dark.patch(text_size=10.0))

line((92, 23), (79, 23), arrow_head="->", style=Styles.MutedDashed.patch(line_width=1.5))
text((85.5, 18.2), "line (->)", style=Styles.Dark.patch(text_size=10.0))

save()

defline(xy1, xy2, *, style, arrow_head='')#

Draw a straight 1D line segment from starting point xy1 to ending point xy2 (drawlib.lines). Customize stroke width, dash pattern, color, and filled/scaled arrowheads via style.patch(line_width=..., line_style=..., line_arrow_head_fill=..., line_arrow_head_scale=...).

def line(
    xy1: Coordinate,
    xy2: Coordinate,
    *,
    style: Style,
    arrow_head: ArrowHead = "",
) -> None

defline_arc(xy, width, height, *, style, ...)#

Draw an open elliptical or circular arc stroke centered at xy = (cx, cy) (drawlib.lines). Angles follow standard Cartesian degrees counter-clockwise from the positive X-axis (0° = East, 90° = North).

def line_arc(
    xy: Coordinate,
    width: PosFloat,
    height: PosFloat,
    *,
    style: Style,
    angle_start: Angle = 0,
    angle_end: Angle = 180,
    angle: Angle = 0,
    arrow_head: ArrowHead = "",
    ccw: bool = True,
) -> None

defline_bezier1(xy1, xy2, cp, *, style, arrow_head='')#

Draw a quadratic Bézier curve from xy1 to xy2 pulled toward a single control point cp (drawlib.lines). Note that cp is the third positional parameter after xy1 and xy2.

def line_bezier1(
    xy1: Coordinate,
    xy2: Coordinate,
    cp: Coordinate,
    *,
    style: Style,
    arrow_head: ArrowHead = "",
) -> None

defline_bezier2(xy1, xy2, cp1, cp2, *, style, arrow_head='')#

Draw a cubic Bézier curve (such as smooth S-curves between ports) from xy1 to xy2 using two control points cp1 and cp2 (drawlib.lines). Note the positional order (xy1, xy2, cp1, cp2).

def line_bezier2(
    xy1: Coordinate,
    xy2: Coordinate,
    cp1: Coordinate,
    cp2: Coordinate,
    *,
    style: Style,
    arrow_head: ArrowHead = "",
) -> None

defline_curved(xy1, xy2, *, style, bend=0, arrow_head='')#

Draw a circular arc spline between xy1 and xy2 controlled by a scalar curvature factor bend (drawlib.lines). Positive bend bulges left relative to travel from xy1 to xy2; negative bend bulges right.

def line_curved(
    xy1: Coordinate,
    xy2: Coordinate,
    *,
    style: Style,
    bend: Bend = 0,
    arrow_head: ArrowHead = "",
) -> None

deflines(xys, *, style, arrow_head='')#

Draw a multi-segment polyline through an ordered sequence of 2 or more vertices xys (drawlib.lines). Consecutive duplicate vertices and redundant collinear midpoints are automatically sanitized before rendering.

def lines(
    xys: Coordinates,
    *,
    style: Style,
    arrow_head: ArrowHead = "",
) -> None

deflines_bezier(xy, path_points, *, style, arrow_head='')#

Draw an arbitrary multi-segment path starting at xy and chaining straight segments (x, y), quadratic Bézier segments ((cp_x, cp_y), (x, y)), and cubic Bézier segments ((cp1_x, cp1_y), (cp2_x, cp2_y), (x, y)) (drawlib.lines).

def lines_bezier(
    xy: Coordinate,
    path_points: PathPoints,
    *,
    style: Style,
    arrow_head: ArrowHead = "",
) -> None

deflines_curved(xys, r, *, style, arrow_head='')#

Draw a multi-point polyline through xys with automatic quadratic Bézier corner rounding of fillet radius r at each interior turn (drawlib.lines). Ensure r is smaller than half the shortest segment length in xys.

def lines_curved(
    xys: Coordinates,
    r: PosFloat,
    *,
    style: Style,
    arrow_head: ArrowHead = "",
) -> None

deftext(xy, text, *, style)#

Draw single-line or \n-delimited multi-line horizontal (or style.angle-rotated) text anchored at xy (drawlib.text). By default (halign="center", valign="center"), xy = (cx, cy) is the geometric center of the text block; customize font size, font family, alignment, rotation, line spacing, and background framing via style.patch(...).

def text(
    xy: Coordinate,
    text: str,
    *,
    style: Style,
) -> None

deftext_vertical(xy, text, *, style)#

Draw top-to-bottom vertically stacked glyphs anchored at xy (drawlib.text). By default (valign="center"), xy = (cx, cy) is the center of the vertical column; halign is automatically enforced as "center" so glyph centerlines stay aligned.

def text_vertical(
    xy: Coordinate,
    text: str,
    *,
    style: Style,
) -> None