Paper Output

BLAND emits SVG. SVG prints beautifully on any modern printer, embeds cleanly into LaTeX (\includegraphics{figure.svg} with the svg package), pastes into Word and Pages, and renders at any DPI without resampling.

Canvas sizes

Canvas size is set via :size on Bland.figure/1. All presets are in pixels at 96 DPI — which is the browser default and matches the assumptions of most SVG-to-PDF tools.

For custom canvases, pass a tuple:

Bland.figure(size: {1600, 1200})

Embedding in LaTeX

With the svg package (handles SVG→PDF via Inkscape at compile time):

\usepackage{svg}
...
\begin{figure}[t]
  \centering
  \includesvg[width=0.8\textwidth]{figures/damped_oscillation.svg}
  \caption{Response of a second-order system.}
\end{figure}

If you'd rather ship a PDF in your repo instead of re-running Inkscape on every build, convert offline:

rsvg-convert -f pdf -o damped.pdf damped.svg
# or
inkscape damped.svg --export-type=pdf --export-filename=damped.pdf

Embedding in Markdown / GitHub README

GitHub renders SVG directly. Drop the file into the repo and reference it like a PNG:

![Damped oscillation](figures/damped.svg)

Converting to PNG

Browsers, rsvg-convert, Inkscape, and headless Chromium all work:

rsvg-convert -w 2400 -o damped.png damped.svg          # 2x hi-DPI
inkscape damped.svg --export-type=png --export-filename=damped.png --export-dpi=300

On macOS, Quick Look can also thumbnail an SVG:

qlmanage -t -s 1200 -o . damped.svg  # produces damped.svg.png

Printing

Most browsers will print an SVG one-to-one if you set the document size correctly. BLAND emits width and height attributes on <svg> so the print box comes out the size you asked for. When embedding in a PDF from LaTeX or similar, always pass width=\textwidth or an explicit mm size rather than relying on the document's own pixel dimensions.

DPI and stroke weight

The default theme uses a 1.2 px series stroke, 1.0 px axis stroke, and 0.4 px grid stroke. On a 300 DPI printer those translate to about 0.1 mm (grid), 0.25 mm (axes), and 0.3 mm (series) — which lines up with typical pen-set drafting weights (0.1 → H3, 0.25 → H2, 0.3 → HB).

If your printer is dropping the grid at 600+ DPI, bump :grid_stroke_width to 0.5:

Bland.figure(theme: Bland.Theme.merge(:report_1972, %{grid_stroke_width: 0.5}))

A full paper-ready recipe

fig =
  Bland.figure(
    size: :a4_landscape,
    theme: Bland.Theme.merge(:report_1972, %{
      # Slightly thicker for photocopy survival
      grid_stroke_width: 0.5,
      series_stroke_width: 1.4
    }),
    title: "Figure 3.2 — Thermal response"
  )
  |> Bland.axes(xlabel: "time [min]", ylabel: "T [°C]")
  |> Bland.line(ts, temperatures, label: "measured")
  |> Bland.line(ts, model,        label: "model", stroke: :dashed)
  |> Bland.legend(position: :top_right)
  |> Bland.title_block(
    project:   "Thermal Qualification",
    title:     "Fig. 3.2",
    drawn_by:  "JM",
    checked_by:"RK",
    date:      Date.utc_today() |> Date.to_iso8601(),
    scale:     "1:1",
    sheet:     "12 of 40",
    rev:       "B"
  )

Bland.write!(fig, "figures/fig_3_2.svg")

That file will print identically on your laser printer, the departmental copier, and whatever machine the journal uses to reproduce the paper a decade from now.