Bland.Svg (Elixir Technical Drawing v0.3.0)

Low-level SVG element builders.

Each builder returns an iodata fragment. The renderer composes fragments and only flattens to a binary at the very end, which keeps large plots cheap to construct.

The helpers in this module do not know about data or scales — they speak only in pixel coordinates. Use Bland.Scale.project/2 first, then pass the result in here.

Summary

Renders a keyword list or map of attributes into an SVG attribute string suffix (" k1=\"v1\" k2=\"v2\""). Underscores in keys are converted to hyphens so stroke_width: 1 becomes stroke-width="1".

circle(cx, cy, r, attrs \\ [])

Circle with center and radius.

defs(body)

Defs block — for <pattern>, <marker>, <clipPath> etc.

document(width, height, body)

Wraps a %Bland.Figure{}-sized viewBox around a body of SVG fragments.

escape(s)

XML-escapes a string for safe insertion into element text or attribute values.

g(attrs, body)

Group element with attributes.

line(x1, y1, x2, y2, attrs \\ [])

Line from (x1,y1) to (x2,y2).

num(v)

Formats a numeric value with up to 3 decimals, trimming trailing zeros.

path(d, attrs \\ [])

General path from an SVG d string.

polygon(points, attrs \\ [])

Polygon from a list of {x, y} tuples.

polyline(points, attrs \\ [])

Polyline from a list of {x, y} tuples.

rect(x, y, w, h, attrs \\ [])

Rectangle.

text(x, y, content, attrs \\ [])

Text element. content is written literally — escape it with escape/1 if it may contain user input.

Types

attrs()

@type attrs() :: Enumerable.t()

iodata_frag()

@type iodata_frag() :: iodata()

Functions

attrs(attrs)

@spec attrs(attrs()) :: iodata()