105 lines
3.0 KiB
Markdown
105 lines
3.0 KiB
Markdown
# Pathfinding demo
|
|
|
|
This is a demo of pathfinding on a 2D grid. It consists of 2 main parts:
|
|
|
|
* python notes and implementation
|
|
* jupyter notebook file: [`python/pathfinding_demo.ipynb`](./python/pathfinding_demo.ipynb)
|
|
* standalone python script: [`./python/pathfinding_demo.py`](./python/pathfinding_demo.py)
|
|
* C++ interactive demo: [`cpp`](./cpp/)
|
|
|
|
## Python
|
|
|
|
Plots a path from one end of the map to the other. Black tiles represent low-cost path, white tiles have high-cost.
|
|
|
|
|
|
|
|
### Standalone script
|
|
|
|
Run `python pathfinding_demo.py`. Requires numpy and matplotlib to be installed.
|
|
|
|
### Jupyter notebook
|
|
|
|
Contains the same demo as the standalone script and some notes. Since Github supports Jupyter Notebooks now, you can go [directly to the file](./python/pathfinding_demo.ipynb).
|
|
|
|
## C++
|
|
|
|
Interactive demo of entities moving on a simple map with terrains of varying cost. Draw left-mouse button over entities to select them, right-mouse button to send them to selected destination. Simple collision checks are implemented.
|
|
|
|
Uses some C++20 features. Latest generated architecture drawing is available in [`docs/diagrams/class_diagram.svg`](./docs/diagrams/class_diagram.svg)
|
|
|
|
|
|
|
|
### Windows
|
|
|
|
#### Dependencies
|
|
|
|
* `vcpkg` needs to be installed and `VCPKG_ROOT` set. See the [installation instructions](https://learn.microsoft.com/en-us/vcpkg/get_started/get-started?pivots=shell-powershell).
|
|
* Visual Studio with Desktop development with C++ workload (or MSVC Build Tools)
|
|
|
|
#### Build
|
|
|
|
Run "Developer Command Prompt for VS 20xx":
|
|
|
|
```cmd
|
|
cmake --preset=vcpkg
|
|
cmake --build build
|
|
```
|
|
|
|
Run the `pathfinding.exe` binary in the `build` folder.
|
|
|
|
### Linux
|
|
|
|
#### Dependencies
|
|
|
|
* SDL3
|
|
* SDL3-image
|
|
* GLEW
|
|
* gtest
|
|
|
|
e.g. on Archlinux:
|
|
|
|
```
|
|
pacman -S glew sdl3 sdl3_image gtest
|
|
```
|
|
|
|
Optional dependencies for generating class and include diagrams:
|
|
|
|
* plantuml
|
|
* [clang-uml](https://github.com/bkryza/clang-uml)
|
|
|
|
clang-uml needs to be either installed from [AUR](https://aur.archlinux.org/packages/clang-uml) or built manually
|
|
|
|
#### Build
|
|
|
|
```bash
|
|
cmake -B build
|
|
cmake --build build -j 16
|
|
```
|
|
|
|
Optionally you can also use options:
|
|
|
|
* `-DCMAKE_EXPORT_COMPILE_COMMANDS=ON` to enable compile database export (needed for class diagram generation)
|
|
* `-DCMAKE_C_COMPILER=clang -DCMAKE_CXX_COMPILER=clang++` to use clang
|
|
|
|
```
|
|
cmake -B build -DCMAKE_EXPORT_COMPILE_COMMANDS=O -DCMAKE_C_COMPILER=clang -DCMAKE_CXX_COMPILER=clang++
|
|
```
|
|
|
|
Run the `pathfinding` binary in the `build` folder.
|
|
|
|
#### Generate architecture diagrams
|
|
|
|
Build with `-DCMAKE_EXPORT_COMPILE_COMMANDS=ON`. Then in the root folder run:
|
|
|
|
```
|
|
clang-uml
|
|
plantuml -tsvg docs/diagrams/*.puml
|
|
```
|
|
|
|
The resulting svg files are located in [docs/diagrams/](./docs/diagrams/).
|
|
|
|
## Acknowledgments
|
|
|
|
Entity sprite comes from the Bomberman game, taken from [archive.org](https://archive.org/details/bombermansprites/Custom%20Edited%20-%20Bomberman%20Customs%20-%20Bomberman%20Super%20Bomberman%202-Style.png)
|
|
|