https://github.com/organizedgrime/polyblade

Make shapes dance
https://github.com/organizedgrime/polyblade

geometry iced-rs polyhedra polyhedron polyhedron-operations rust rust-lang visualization wasm webgl webgl2 wgpu

Last synced: about 2 months ago
JSON representation

Make shapes dance

• Host: GitHub
• URL: https://github.com/organizedgrime/polyblade
• Owner: organizedgrime
• License: agpl-3.0
• Created: 2024-02-25T22:23:03.000Z (about 1 year ago)
• Default Branch: main
• Last Pushed: 2024-10-30T01:40:08.000Z (7 months ago)
• Last Synced: 2024-10-30T05:30:02.644Z (7 months ago)
• Topics: geometry, iced-rs, polyhedra, polyhedron, polyhedron-operations, rust, rust-lang, visualization, wasm, webgl, webgl2, wgpu
• Language: Rust
• Homepage: https://vera.lgbt/software/polyblade_live/index.html
• Size: 36.1 MB
• Stars: 4
• Watchers: 1
• Forks: 1
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

README

        


    


        

        Polyblade

        

            

        

         

            

        

         

            

        

    

    Cross-platform application for animating Conway Polyhedron Operations

    


    






    


        Polyblade makes it easy to visualize and interact with Polyhedra. I believe that the relationships between both primitive and complex polytopes can be more intuitively understood when experienced visually, and this software aims to demonstrate that.

        



        In particular, emphasis has been placed on making smooth animations for the transitions represented by Conway Polyhedron Notation. 

    

    


        

        Polyblade runs on WGPU and Iced.

        


        Using the PST distance algorithm for efficient all pairs shortest paths in the unweighted undirected graphs represented by polyhedra, none of the vertex position data is deterministic. Instead, this distance matrix is used to create spring forces between every node pair $v_i, v_j$ where $v_n \in G$. Proportional to their distance in the graph structure $G$, the springs inflate the polyhedron to proportional size, allowing us to visualize these strucutres even when they break convexity. 

        


    



## Installation

```cargo install polyblade```

Note that the `webgl` demo is available [here](https://vera.lgbt/software/polyblade/), but is notably less performant than native code.

### Build from source

To run this software, simply clone the repository and use `cargo run --release`.

For the `webgl` build, run `trunk serve --release`. 

        

#### Conway Roadmap

- [x] Ambo

- [x] Kis

- [x] Truncate

- [ ] Ortho

- [x] Bevel

- [x] Expand

- [ ] Snub

- [x] Join

- [ ] Zip

- [ ] Gyro

- [ ] Meta

- [ ] Needle

#### Other goals

- [x] Replace all hardcoded presets with prisms, antiprisms, and pyramids that have undergone modification.

- [ ] Implement Vertex Coloring and Edge Coloring

- [ ] Fix Fibonnaci lattice distribution for new shapes

- [ ] Tesselations / tilings using Wythoff

- [ ] "Undo" button

- [ ] Save and load animations and cycles of `Transaction`s

- [x] Schlegel diagrams

- [x] Color pickers

- [ ] Pokedex entries for polyhedra, point users to wikipedia or polytope wiki when they stumble onto a known entry

  - [x] Basic functionality

  - [ ] Switch from `RON` to `JSON`

  - [ ] Expand pokedex to include more shapes and improve overlap on isomorphic conway strings

  - [ ] Fix pokedex on WASM

- [ ] Create WASM deployment and add to website as git submodule

  - [ ] Fix `time` on web for `dual` and related transitions

  - [x] WebGL compat

  - [ ] WebGPU compat

- [x] Setup some basic CI integrations