Getting Started
IsoForge converts isometric piping drawings (PNG, JPG, or PDF) into interactive 3D models. The workflow is organized as a 6-step wizard in the Drawing → 3D tab.
- Upload — drag & drop your iso drawing or PDF.
- Calibrate — pick two known-distance points (scale) plus 6 axis points (X1·X2 / Y1·Y2 / Z1·Z2) to handle skewed or rescaled drawings.
- Detect & Edit — auto-detect line segments using a CV pipeline, then clean up with manual tools (Add / Move / Delete / Merge / Trim).
- Review — verify auto-filled dimensions, edit per-segment if needed.
- Fittings — assign fittings (elbow / tee / valve / flange / cap) at each node.
- Build — preview the wireframe, then confirm to save.
Detection Presets
Quick presets in Step 3 tune detection parameters for different drawing types:
| Preset | Use for | Threshold | Min len |
| Default | General-purpose iso drawings | 128 | 40 px |
| Clean CAD | Plant 3D / ISOGEN / SmartPlant exports | 140 | 60 px |
| Scanned | Photocopied or scanned drawings | 110 | 30 px |
| Hand-drawn | Sketches or low-quality scans | 90 | 25 px |
Manual Edit Tools (Step 3)
⌖ Select
Click any segment or node on the canvas to inspect and edit it. Default mode.
+ Add Segment
Click two points on the image — direction auto-snaps to the nearest iso axis (X / Y / Z).
↔ Move Node
Click a node to pick it up, then click the new position. All connected segments follow.
⤳ Merge Nearby
Re-clusters endpoints with a slightly larger radius — collapses duplicate nodes.
Keyboard Shortcuts
| Enter | Advance to next wizard step |
| Esc | Cancel current edit mode / step back |
| Del / Backspace | Delete selected segment or node |
| + / − | Zoom canvas |
| 0 | Reset zoom & pan |
| Mouse wheel | Zoom around cursor |
| Shift + drag | Pan the canvas |
3D Model Tab
Once a model is built, the Model tab provides:
- 3D Transform — rotate / translate the model around X · Y · Z. Bake to JSON applies the transform to node coordinates permanently.
- Custom Labels — attach text annotations to any node (equipment tags, instruments, inspection points).
- Quick rotations — one-click +90° rotations and Z-flip for fast alignment.
Export
The Export tab outputs:
- JSON — IsoForge native format for re-import or programmatic processing.
- PCF (Piping Component File) — Hexagon ISOGEN / Autodesk Plant 3D compatible, with default ANSI SKEYs.
- PNG — viewport snapshot for documentation.
Tips for Best Results
- Use drawings at ≥ 150 DPI for reliable line detection.
- If detection misses pipes on a skewed drawing, calibrate the actual axis angles in Step 2 §②.
- Cleaning up auto-detection (Trim < 30 px, Merge nearby) before reviewing dimensions saves time.
- Set the line tag, pipe size and color in Step 5 before building to avoid editing JSON later.
About
IsoForge is a client-side web application built with Three.js and pdf.js.
All processing happens in your browser — no images or models leave your machine.
Version 0.4.4 · production prototype