The PDF viewer lets you open drawings alongside your worksheets and take scaled measurements — lengths, areas and angles — straight off them, writing the results into cells. Each PDF viewer is a pane in your workspace.
Opening a PDF
- Add a PDF Viewer pane from the Add menu at the top right of the window, or from a tile's + (Add pane) button. An empty pane shows "No PDF loaded" with an Import PDF button.
- Import PDF loads a drawing from disk. Its bytes are stored inside your Timbral workspace, so the PDF — and any measurements you add — travel with the saved file.
- Each PDF pane holds one drawing. To open another alongside it, use the tile's + ▸ PDF Viewer — the new pane lands as a tab beside the first in the same tile — then Import PDF in it. Each keeps its own page, zoom, calibration and measurements, and can be dragged into a tile of its own. Double-click a tab (or right-click ▸ Rename) to rename it.
- Page rotation in the PDF is respected.
Navigating, zooming and panning
- Pages — ← / → buttons with an "N / total" readout.
- Zoom — − / + buttons with a percentage readout, plus trackpad pinch-to-zoom (or Ctrl + mouse wheel).
- Pan — toggle the ✋ Grab tool and click-drag, or without it hold Ctrl and drag, or drag with the middle mouse button.
Calibrating the scale
Before you can measure lengths or areas you must tell Timbral the drawing's scale — in Measure mode the Line, Polyline and Area tools stay greyed out until you do, and the tool rail shows "Calibrate this PDF's scale to enable measurement" with a Calibrate button that opens the menu below. The Calibrate menu, in the pane's toolbar, offers two methods:
- Known Dimension — click two points spanning something of known real length (a dimensioned wall, a scale bar), then type that length. Timbral works out the metres-per-unit from it.
- Paper Size + Scale — choose the drawing's ISO paper size (A0–A4), orientation and scale (e.g. 1:100). Timbral derives the units and warns if the PDF's actual page size doesn't match the paper you picked.
A calibrated tab shows "✓ Calibrated". Because each measurement stores its points in the drawing's own coordinates, changing the calibration later retroactively recomputes every measurement on that PDF.
Measuring
Make sure the rail on the right of the window is in Measure mode, pick a tool (hover an icon to see its name), then click points on the drawing:
| Tool | Clicks | Gives you |
|---|---|---|
| Line | 2 (finishes automatically) | length (m) |
| Polyline | 2 or more, double-click to finish | total path length (m) |
| Area | 3 or more, double-click to close | area (m²) |
| Angle | 3 (finishes automatically) | interior angle (°) — no calibration needed |
A live rubber-band preview follows the cursor; hold Shift to constrain the next segment to 15° steps, and press Esc to cancel. With Snap Lines on (the default), the cursor snaps to existing line-work in the drawing — nearby vertices and edges — with an on-screen snap indicator, so you trace real geometry precisely.
Send to Cell
This is the bridge from a drawing back into your calculations:
- Complete a measurement.
- Select the target cell in a worksheet.
- Right-click the measurement and choose Send to cell — the menu item names the cell it will write to, e.g. Send to cell Sheet 1!C10.
The measured value (e.g. 2.450 m, 15.20 m², 90.0 deg) is written into that cell and triggers a live recalculation, so a take-off feeds your calculations directly. Nothing reaches a cell until you send it — a measurement you don't send is annotation-only.
- Sending is a one-time copy. Editing or recalibrating the measurement afterwards does not change the cell, and deleting the measurement leaves the cell's value where it is. Send it again to update the cell.
- With no cell selected, Send to cell is greyed out ("Select a spreadsheet cell first").
- Timbral refuses to write into a locked cell, a cell holding a formula, or any cell of a calculation block other than a yellow input cell, and tells you why.
- A measurement in a workspace saved by an older version may still be linked to its cell and update it; right-click ▸ Detach from cell stops that.
Saved annotations
Every finished measurement and mark-up is baked into the PDF as a genuine annotation plus a label showing its value. Timbral tags its own annotations so they can be cleanly updated or re-drawn if you recalibrate. Because the PDF lives inside the workspace, these annotations are saved with your file and are there when you reopen it.
Mark-up
Alongside measurements, a PDF pane has a Mark-up mode — the toggle at the top of the side panel switches between Measure and Mark-up. Mark-up shapes are annotation only: they are never sent to a cell and carry no measured value. Under the mode switch, the measurements and mark-ups eye toggles show or hide each kind of placed object.
The tools are Polyline, Area, Rectangle, Ellipse, Triangle, Cloud (Rect), Cloud (Free), Text Box and Text + Arrow. Pick a tool, then click on the drawing to place it; Cancel (Esc) abandons a shape part-way through.
Select a placed shape to get its handles: drag a corner to resize, drag an edge or the interior to move the whole thing, and use the style panel at the foot of the rail (headed Edit Style while a shape is selected) to change stroke colour, width, opacity and fill. Font, size and bold/italic/underline for text come from the ribbon's Font group. A colour you pick for a shape also becomes that tool's colour for your next shape, and is remembered next time you open Timbral.
Press Delete (or click Delete in the style panel) to remove the selected shape. Ctrl+C / Ctrl+V copy and paste it — including into another PDF pane, or between a PDF and a Map pane: the copy lands in the pane under the pointer at the same on-screen size, and a pasted measurement is re-measured against that pane's own scale.
Right-click a shape for its menu: the layer commands Bring to Front (Ctrl+Shift+]), Bring Forward (Ctrl+]), Send Backward (Ctrl+[) and Send to Back (Ctrl+Shift+[), plus Send to cell on a measurement.
Text boxes and arrows
- A Text Box is a plate you type directly onto the drawing. Click into it and type; it grows to fit what you enter, and only ever grows, so a box you have deliberately made large stays that size. Its text colour and border colour are set separately in the side panel.
- Text + Arrow is the same box with a leader arrow. Click once for the arrow's tip, then once for the box.
- One label can point at several things at once. Hold Ctrl and click any arrow head to add another head, then drag it where it belongs — each head reaches the box on its own, so the arrows converge on one label from different angles. Hold Shift and click a head to remove that head and its shaft.
- Hovering near a head with a modifier held shows a small symbol at the cursor so you can see what a click will do: + to add a head, − to remove one, and ⊗ when only one head is left, because removing the last head removes the whole mark-up and the text in it. All of it is undoable with Ctrl+Z.
Undo and redo are scoped to the tile you are working in: Ctrl+Z with a PDF pane selected steps back through that pane's own mark-ups and never touches the spreadsheet, and vice versa. Ctrl+Y or Ctrl+Shift+Z redoes. When that pane has nothing left to undo, Ctrl+Z does nothing rather than reaching into another tile.
Exporting or copying the page
Once you've marked up a drawing, you can get it out of Timbral, measurements and all:
- Export saves the whole PDF — every page — with your annotations baked in, through a save dialog that starts next to your
.tmb. What it includes follows the measurements / mark-ups eye toggles, so the export matches what is on screen. - Copy puts the visible part of the current page on the clipboard as a PNG image, ready to paste into a report or email.
Both buttons are at the right-hand end of the PDF pane's toolbar.