Repository navigation
Explorer
python fw.py serve --port 8765 --out-dir out --openA WebGL2 explorer on 127.0.0.1 only; any other host is refused. Drag to pan, wheel or pinch to zoom, shift-click to pick a Julia c. Formula, iterations and a cosine palette sit in the side panel. The URL hash holds the whole view, so the address is a share link. A precision box warns when float32 nears its limit. Since 0.5.0 the page keeps zooming past it: it posts the view to the server's loopback POST /orbit endpoint, gets the Decimal reference orbit back and draws it with the same double-float deep shader as render --route browser. Pan and zoom keep the centre as exact decimal strings, so share links stay exact at any depth. /orbit refuses views needing more than 200,000 iterations. Render exact asks the server for a NumPy (or perturbation) PNG of the same view, and Export writes a recipe JSON to the out folder. Since 0.7.0 the panel has a rotation control (the [ and ] keys turn the view), and stop palettes travel in the share hash as ps=. Since 0.11.0, while a new orbit is pending the page redraws at once from the last exact orbit at one pixel per 4x4 block, then swaps in the exact frame; a newer pan or zoom aborts the stale request. The first redraw went from 24-42 ms to 3-6 ms. /audio is the live audio page described in Video and audio.
The same export from the command line, from a share URL or its hash:
python fw.py export "#f=mandelbrot&cx=-0.75&cy=0&w=3&it=200" -o shared.jsonwrote shared.json
The hash needs f= set to one of mandelbrot, julia, burning-ship, tricorn or multibrot.
Renders with headless Edge (or Chrome) through Playwright and the explorer's shader:
python fw.py render julia-rabbit -o rabbit_b.png --size 160x90 --route browserwrote rabbit_b.png and rabbit_b.json (browser route)
The browser computes in float32. Views too deep for it (width under 1e-3 of the coordinate, or a pixel under 1e-6 of it) go to NumPy with a note. The Burning Ship is the least exact family in float32. Mandelbrot and quadratic Julia views go to the GPU deep route below instead (since 0.3.0).
Since 0.3.0, --route browser with --deep, a view width under 1e-12, or a Mandelbrot or quadratic Julia view too deep for plain float32 runs perturbation in a WebGL2 shader: a Decimal reference orbit sent as a float texture, scaled deltas, rebasing. It reaches width 1e-60; deeper views go to the CPU route. Since 0.5.0 the deltas are double-float (pairs of float32) by default. deep.json here is the seahorse recipe with its width set to 1e-20:
python fw.py render deep.json -o gdeep.png --size 160x90 --route browserdeep: rebased 14400 pixels, gpu 9 ms
wrote gdeep.png and gdeep.json (browser deep route)
The recipe records "route": "browser-perturbation" and "precision": "decimal+double-float". --gpu-precision float32 selects the faster 0.3.0 shader (decimal+float32):
python fw.py render deep.json -o gdeep32.png --size 160x90 --route browser --gpu-precision float32How exact it is: at 512 px, escape counts in dense boundary areas differ from the float64 CPU route on 0.1-1% of pixels with double-float and 3.5-19% with float32, for 0.24-0.30 s against 0.18-0.25 s a frame. The CPU route is about 250 times slower. Use the CPU route (no --route browser) when exact counts matter.
zoom --route browser renders every frame this way; see Video and audio.
This wiki describes fractalwright 0.11.0 and was last updated on 2026-11-15. MIT licensed. Report problems in the issues.
Using it
- Getting started
- Commands
- Video and audio
- Explorer
- Generative
- Neighbours and 3D
- Recipe format
- Works with
- FAQ
- Versions (0.11.0)
Contributing
Elsewhere