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.
This commit is contained in:
Brian Holman committed 2026-11-09 23:33:13 -07:00
1 parent aa048c556d
commit 0c3f8c0324
10 files changed
+211 -16

No files matched your search

+34 -16
View File
@@ -1,30 +1,48 @@
AStar: A demo of the A* search algorithm
========================================
# AStar pathfinding demo
By Pierre Sarrazin (http://sarrazip.com/).
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.
CMOC Home Page: http://sarrazip.com/dev/cmoc.html
![AStar running in VCC Plus, showing the path A B C G F J K L](docs/screenshots/running.png)
Version 0.1.0 - 202?-??-?? - First public release.
## 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:
# Introduction
```basic
LOADM"ASTAR":EXEC
```
[A\*](https://en.wikipedia.org/wiki/A*_search_algorithm)
is a graph traversal and path search algorithm.
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.
This package presents an implementation that assumes that the graph
is a rectangular grid.
## Build in VCC Plus
See `astar-demo.c` for the demo. It uses `astar.h` and `astar.c`.
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.
# Building the demo
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.
After installing CMOC, type `make`, which should build the library
(`libastar.a`) and the demo executable (`astar.bin`).
## 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`.
# License
The [original README](docs/UPSTREAM_README.md) and source notices are preserved.
See [source provenance](docs/PROVENANCE.md) for the import and integration history.
This package and library are in the public domain.
## License
The upstream package and library are in the public domain, as stated in the
original README. Original author notices remain in the source.