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.
49 lines
1.9 KiB
Markdown
49 lines
1.9 KiB
Markdown
# 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.
|
||
|
||

|
||
|
||
## 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.
|