Files
AStar/README.md
T
Brian Holman 0c3f8c0324 Integrate AStar with VCC Plus disk builds and verified run
Add the vccplus-disk packaging target, project settings, playable AStar.DSK, actual MCP framebuffer screenshot and build-43 validation. Preserve upstream C sources and Makefile unchanged.
2026-11-09 23:33:13 -07:00

49 lines
1.9 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# AStar pathfinding demo
An implementation of the A* search algorithm with a rectangular-grid demonstration,
by **Pierre Sarrazin**. This repository contains version **0.1.0** with a
VCC Plus project and disk launcher.
![AStar running in VCC Plus, showing the path A B C G F J K L](docs/screenshots/running.png)
## Download and run
Download [AStar.DSK](AStar.DSK), a ready-to-run Disk BASIC image. Mount a writable
copy in drive 0 of a **512 KB CoCo 3 / 6809 / Disk BASIC** machine, then type:
```basic
LOADM"ASTAR":EXEC
```
The demonstration draws its grid and the path **A B C G F J K L**. Press any key
to finish and return to BASIC.
## Build in VCC Plus
1. Open this repository’s root folder in **Develop → C Development → Open**.
2. Select **Release**, then choose **Build Disk**.
3. Use **Show Build Products** to find `AStar.DSK` and `astar.bin` in the build
snapshot, then launch the disk with the command above.
The project selects `VCCPlus.mk`, which includes the original `Makefile` and adds
the `vccplus-disk` target. It uses VCC Plus’s bundled CMOC and disk tools.
The disk build and the illustrated run were verified through the public MCP
interface in **VCC Plus 3.5.0 build 43**, using the configuration above.
[Validation details](docs/VALIDATION.md) describe the checked behavior and limits.
## Original source
- Author: [Pierre Sarrazin](http://sarrazip.com/).
- [CMOC project index](http://sarrazip.com/dev/cmoc.html).
- [AStar 0.1.0 source archive](http://sarrazip.com/dev/astar-0.1.0.tar.gz).
- Archive SHA-256: `acd2d5e2ad709892cb7609f5e53387cbbfe7364e675abb5e4f2a5c806cd0fc7c`.
The [original README](docs/UPSTREAM_README.md) and source notices are preserved.
See [source provenance](docs/PROVENANCE.md) for the import and integration history.
## License
The upstream package and library are in the public domain, as stated in the
original README. Original author notices remain in the source.