Vignesh Suresh
82 lines
2.9 KiB
Markdown
82 lines
2.9 KiB
Markdown
# wired3d viewer
|
|
|
|
Interactive 3D viewer for the Beckhoff 5-axis metal-DED NC toolpaths produced by
|
|
`stl_slicer.py`. It reads the machine NC dialect and renders a self-contained,
|
|
offline-capable HTML page: a 3D toolpath scene (rapid moves + per-layer welds),
|
|
an A/B tilt-angle chart, a statistics table, layer isolation, and a
|
|
progressive-reveal print animation.
|
|
|
|
## Layout
|
|
|
|
```
|
|
visualizer/
|
|
├── pyproject.toml # package metadata + the `wired3d` console script
|
|
├── README.md
|
|
├── wired3d_viewer/ # the Python package
|
|
│ ├── __init__.py # lightweight; no heavy imports
|
|
│ ├── __main__.py # CLI: `python -m wired3d_viewer view|serve`
|
|
│ ├── parser.py # NC dialect reader (standard library only)
|
|
│ ├── viewer.py # NC Plotly figure builder + HTML writer
|
|
│ ├── server.py # NC drag-and-drop local web front end
|
|
│ ├── stl_viewer.py # STL mesh figure builder + HTML writer
|
|
│ ├── server2.py # STL drag-and-drop local web front end
|
|
│ └── assets/
|
|
│ └── wired3d.avif # logo, embedded into the HTML as a data URI
|
|
```
|
|
|
|
## Install
|
|
|
|
```bash
|
|
pip install -e . # installs plotly + numpy and the `wired3d` command
|
|
```
|
|
|
|
The package runs fine without installing too — just call the modules directly
|
|
(see below). Only `viewer`/`server` need `plotly` + `numpy`; `parser` is pure
|
|
standard library.
|
|
|
|
## Usage
|
|
|
|
Render an NC file to a standalone HTML viewer:
|
|
|
|
```bash
|
|
python -m wired3d_viewer view path/to/part.nc # writes <stem>_viewer.html
|
|
wired3d view path/to/part.nc # same, if installed
|
|
```
|
|
|
|
Start the drag-and-drop web front end (drop an `.nc` file or a folder onto the
|
|
page):
|
|
|
|
```bash
|
|
python -m wired3d_viewer serve # http://127.0.0.1:8765
|
|
python -m wired3d_viewer serve 9000 # custom port
|
|
wired3d serve # same, if installed
|
|
```
|
|
|
|
### STL mesh viewer ("server 2")
|
|
|
|
View a raw `.stl` part in 3D *before* slicing — rotate/zoom with the mouse. Once
|
|
a part is loaded a **Slice & Visualize** button (with layer-height / infill
|
|
inputs) runs `stl_slicer` and shows the resulting toolpath with the NC viewer on
|
|
the same page; "Back to mesh" flips back. (Per-coordinate direction vectors are
|
|
the next feature and are not drawn yet.)
|
|
|
|
```bash
|
|
python -m wired3d_viewer view-stl path/to/part.stl # writes <stem>_stl_viewer.html
|
|
python -m wired3d_viewer serve-stl # http://127.0.0.1:8766
|
|
python -m wired3d_viewer serve-stl 9001 # custom port
|
|
wired3d view-stl part.stl / wired3d serve-stl # same, if installed
|
|
```
|
|
|
|
Parse only (no visualisation, no third-party deps):
|
|
|
|
```python
|
|
from wired3d_viewer.parser import parse_nc, summarise
|
|
summarise(parse_nc("part.nc"))
|
|
```
|
|
|
|
Run the parser self-test:
|
|
|
|
```bash
|
|
python -m wired3d_viewer.parser
|
|
```
|