# 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.
| Preset | px (w × h) | mm (w × h, ≈96 DPI) |
| ---------------------- | ------------ | ------------------- |
| `:a5` | 559 × 794 | 148 × 210 |
| `:a5_landscape` | 794 × 559 | 210 × 148 |
| `:a4` | 794 × 1123 | 210 × 297 |
| `:a4_landscape` | 1123 × 794 | 297 × 210 |
| `:letter` | 816 × 1056 | 216 × 279 (8.5"×11") |
| `:letter_landscape` | 1056 × 816 | 279 × 216 |
| `:legal` | 816 × 1344 | 216 × 356 (8.5"×14") |
| `:legal_landscape` | 1344 × 816 | 356 × 216 |
| `:square` | 600 × 600 | 159 × 159 |
For custom canvases, pass a tuple:
```elixir
Bland.figure(size: {1600, 1200})
```
## Embedding in LaTeX
With the `svg` package (handles SVG→PDF via Inkscape at compile time):
```latex
\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:
```sh
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:
```markdown
```
## Converting to PNG
Browsers, `rsvg-convert`, Inkscape, and headless Chromium all work:
```sh
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:
```sh
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`:
```elixir
Bland.figure(theme: Bland.Theme.merge(:report_1972, %{grid_stroke_width: 0.5}))
```
## A full paper-ready recipe
```elixir
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.