# bevy_pointcloud

**Repository Path**: nirenyang/bevy_pointcloud

## Basic Information

- **Project Name**: bevy_pointcloud
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-11-23
- **Last Updated**: 2025-11-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Bevy Point Cloud

WASM Demo site : https://rlamarche.github.io/bevy_pointcloud/

A Bevy plugin to render point clouds.

Roadmap :

- [x] Render point cloud using a shader
- [x] Compute AABB
- [ ] Add helpers for importing las/laz files 
- [ ] Add helpers for importing PLY files
- [ ] Implement rendering described in https://www.cg.tuwien.ac.at/research/publications/2016/SCHUETZ-2016-POT/SCHUETZ-2016-POT-thesis.pdf 
- [ ] Read Potree files in https://www.cg.tuwien.ac.at/research/publications/2016/SCHUETZ-2016-POT/SCHUETZ-2016-POT-thesis.pdf
- [ ] Efficiently load/unload chunks based on camera location
- [ ] ...

Takanawa Lion with multi pass rendering pipeline inspired by Potree:

![Lion Takanawa](screenshots/lion_takanawa.copc.jpg)

Takanawa Lion with multi pass rendering pipeline + Eye Dome Lighting inspired by Potree:

![Lion Takanawa](screenshots/lion_takanawa.copc-edl.jpg)



1 million random points:

![1 million random points](screenshots/random_points.jpg)

St. Anna Mountain, 33 millions points:

![St. Anna Mountain, 33 millions points](screenshots/G_Sw_Anny.jpg)


## Credits

- Rendering techniques and shaders adapted from [Potree](https://github.com/potree/potree)  
  Copyright (c) 2011-2020, Markus Schütz  
  Licensed under the BSD 2-Clause License (see THIRD_PARTY_LICENSES.md).

- Potree itself is based on prior research and open source projects.  
  Notably:
    - Multi-resolution octree algorithms developed at the Vienna University of Technology (Michael Wimmer, Claus Scheiblauer, Scanopy Project).
    - Shaders inspired by CloudCompare (EDL), plas.io (LAS/LAZ support), and other point cloud tools.

- The rendering pipeline implementation is based on Bevy's render pipelines  
  ([Bevy Engine](https://bevyengine.org), MIT or Apache-2.0).

## Acknowledgements

This project would not have been possible without the amazing work of the open-source
and research communities. In particular, I would like to acknowledge:

- [Potree](https://github.com/potree/potree) by Markus Schütz, which inspired the
  rendering techniques and some shader code used here.
- [Bevy Engine](https://bevyengine.org), whose rendering pipelines served as a
  foundation for the Rust-side implementation.
- The Vienna University of Technology (Michael Wimmer, Claus Scheiblauer) for their
  research on multi-resolution octrees in the [Scanopy Project](http://www.cg.tuwien.ac.at/research/projects/Scanopy/).
- [CloudCompare](http://www.danielgm.net/cc/) for the EDL shader approach.
- [plas.io](http://plas.io/) for early contributions to LAS/LAZ point cloud rendering.
- The broader open-source graphics and visualization community for their continuous
  contributions to point-based rendering.

Thank you to all the researchers, developers, and contributors whose work laid the
ground for this project.

## Prepare WASM Example

Run the following commands to prepare the WASM:

```
cargo build --features webgl --example simple --target wasm32-unknown-unknown  --release
wasm-bindgen --no-typescript --target web  --out-dir path/to/site/ --out-name "bevy_pointcloud"  ./target/wasm32-unknown-unknown/release/examples/simple.wasm
```

Optimize the wasm:

- Note: use the latest version of https://github.com/WebAssembly/binaryen because the one shipped with Ubuntu 24.04 make a broken WASM.

```
wasm-opt -O -ol 100 -s 100 -o bevy_pointcloud/bevy_pointcloud_bg.wasm bevy_pointcloud/bevy_pointcloud_bg.wasm
```

# Contributors

- [François Mockers](https://github.com/mockersf)