https://github.com/lobis/fractal-explorer
A simple Julia Set and Mandelbrot interactive explorer built using Rust. It can run as a desktop application or on the web. Web demo available at https://lobis.github.io/fractal-explorer/
https://github.com/lobis/fractal-explorer
fractal fractal-rendering gpu interactive-visualizations rust wasm webassembly wgpu
Last synced: about 2 months ago
JSON representation
A simple Julia Set and Mandelbrot interactive explorer built using Rust. It can run as a desktop application or on the web. Web demo available at https://lobis.github.io/fractal-explorer/
- Host: GitHub
- URL: https://github.com/lobis/fractal-explorer
- Owner: lobis
- Created: 2022-08-07T19:43:25.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2024-12-01T08:01:27.000Z (7 months ago)
- Last Synced: 2025-04-19T07:46:38.498Z (about 2 months ago)
- Topics: fractal, fractal-rendering, gpu, interactive-visualizations, rust, wasm, webassembly, wgpu
- Language: Rust
- Homepage: https://lobis.github.io/fractal-explorer/
- Size: 170 KB
- Stars: 18
- Watchers: 1
- Forks: 0
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
README
# [Fractal Explorer](https://lobis.github.io/fractal-explorer/)
[](https://github.com/lobis/fractal-explorer/actions/workflows/rust.yml)
A simple [Julia](https://en.wikipedia.org/wiki/Julia_set) and [Mandelbrot](https://en.wikipedia.org/wiki/Mandelbrot_set) Set explorer built using [Rust](https://www.rust-lang.org/). This was created as a learning project and is based on [this great tutorial](https://sotrh.github.io/learn-wgpu/).
The explorer can be run as a standalone desktop application (should work for Windows, Linux and MacOS) or as a web application for which a [demo is available](https://lobis.github.io/fractal-explorer/).
## [✨ Live Demo](https://lobis.github.io/fractal-explorer/)
## 🤓 Usage
* **Mouse Left Click**: Toggle Julia set *c* parameter selection.
* **Mouse Cursor Position**: Select Julia set _c_ parameter.
* **Mouse Wheel | Trackpad | Up & Down Arroy Keys**: Zoom on cursor position.
* **Mouse Right Click**: Hold and drag to translate fractal.
* **J | M Keys**: Toggle between Julia and Mandelbrot sets.
## ⚙️ Build
To build the executable run:
```
cargo build --release
```
There is a Windows executable available as an artifact of the v0.1.0 release which can be downloaded [here](https://github.com/lobis/fractal-explorer/releases/download/v0.1.0/fractal-explorer-app.exe). Please always be very careful when downloading executable files from the internet.
## 🌐 Web
To build the web application run the following command. You may need to install `wasm-pack` via `cargo install wasm-pack`.
```
wasm-pack build --target web --out-dir public/pkg
```
All files related to the static site will be placed under `public` with `index.html` the entrypoint. You can server the site locally using `python3 -m http.server` and then navigating to `http://localhost:8000`.
```
python -m http.server 8000 --bind 127.0.0.1 --directory public
```