fractl_lib
| Crates.io | fractl_lib |
| lib.rs | fractl_lib |
| version | 0.1.0 |
| created_at | 2024-01-17 13:48:39.350044+00 |
| updated_at | 2024-01-17 13:48:39.350044+00 |
| description | Fractal renderer supporting multithreading, gpu compute and wasm |
| homepage | |
| repository | https://github.com/Shapur1234/Fractaller |
| max_upload_size | |
| id | 1102967 |
| size | 2,448,938 |
Shapur (Shapur1234)
documentation
README
Fractl
- Fractal renderer written in rust
- Singlethreaded, multithreading (using rayon) and gpu compute (using wgpu - WebGpu implementation) versions
- Supports both native targets and wasm
- Currently renders the Mandelbrot set and the Multibrot set
Screenshots
How to
- Try the live demo (Note: the web version runs on a signle thread without GPU acceleration, native version are much faster)
- Download a pre-build binary from ./bin
- Install using cargo (TODO)
Controls
| Key | Action |
|---|---|
| LeftMouseButton | Center view on cursor |
| WSAD | Move view |
| R | Reset view |
| ScrollWheel | Increase / Decrease zoom |
| O | Increase zoom |
| P | Decrease zoom |
| ArrowKey | Increase / Decrease zoom in a direction |
| T | Reset zoom |
| K | Increase percision (max iterations) |
| L | Decrease percision (max iterations) |
| M | Next fractal |
| N | Previous fractal |
| B | Next fractal coloring |
| V | Previous fractal coloring |
| U | Toggle UI |
| Y | Toggle crosshair |
| C | Increase exponent (for multi-fractals) |
| X | Decrease exponent (for multi-fractals) |
| F11 | Toggle Fullscreen |
| Escape | Exit |
Building using nix
| Package | Description | Pararelism | Floatin point percision |
|---|---|---|---|
| fractl_gui | Native gui | No | Double (f64) |
| fractl_gui-multithread | Native gui | CPU multithreading | Double (f64) |
| fractl_gui-gpu | Native gui | GPU compute shader | Single (f32) |
| fractl_gui-wasm | Web gui | No | Double (f64) |
| fractl_gui-win | Native gui crosscompiled to Winows x86_64 | No | Double (f64) |
| fractl_gui-win-multithread | Native gui crosscompiled to Winows x86_64 | CPU multithreading | Double (f64) |
| fractl_gui-win-gpu | Native gui crosscompiled to Winows x86_64 | GPU compute shader | Single (f32) |
-
To build:
nix build .#Package -
To build and run locally:
nix run .#Package -
Example:
nix run .#gui-gpu -
Or use on of the build scripts in ./script
Building using cargo
- Have rust installed, or optionally use the included dev shelle:
nix develop - Pick feautres
| Feature | Description | Notes |
|---|---|---|
| multithred | CPU multithreading | multithread and gpu cannot be enabled at the same time |
| gpu | GPU computing | multithread and gpu, gpu and f64 cannot be enabled at the same time |
| f32 | Single percision floating point numbers | f32 and f64 cannot be enabled at the same time |
| f64 | Double percision floating point numbers | f32 and f64 cannot be enabled at the same time |
- To build:
cargo build --package=fractl_gui --no-default-features --release --features "Feature1 Feature2" - To run:
cargo run --package=fractl_gui --no-default-features --release --features "Feature1 Feature2" - Example:
cargo build --package=fractl_gui --no-default-features --release --features "gpu f32"
TODO
- Add Julia set, more fractals
- F128 floating point
- Wasm WebGpu with compute shader
- Redox port