mirror of
https://github.com/mi57730/a2d.git
synced 2024-07-15 14:28:53 +00:00
68 lines
2.2 KiB
Markdown
68 lines
2.2 KiB
Markdown
Disassembly of the desk accessories:
|
|
|
|
* [Show Text File](show.text.file.s) - in progress! 95% complete
|
|
* [Calculator](calculator.s) - in progress! 99% complete
|
|
* [Date](date.s) - in progress! 99% complete
|
|
* [Puzzle](puzzle.s) - in progress! 99% complete
|
|
* Sort Directory - _not started_
|
|
|
|
New desk accessories:
|
|
* [Show Image File](show.image.file.s) - complete!
|
|
* [This Apple](this.apple.s) - complete!
|
|
|
|
## Desk Accessory Details
|
|
|
|
* Loaded at $800 through (at least) $14FF
|
|
* Copy themselves from Main into Aux memory (same location)
|
|
* Can call into ProDOS MLI and MGTK/A2D entry points ($4000, etc)
|
|
* See [API.md](API.md) for programming details
|
|
|
|
## Files
|
|
|
|
* `Makefile` - cleans/builds targets
|
|
* `orig/*.bin` - original binary (type $F1, start $800)
|
|
* `*.s` - source (originally generated using da65, now modified)
|
|
|
|
## Build Instructions
|
|
|
|
On Unix-like systems (including Mac OS X) `make all` should build
|
|
build the desk accessory files (original and new) into `out/`
|
|
output with a `.$F1` suffix, representing the $F1 file type required.
|
|
|
|
For the original DAs, the `.F1` and `.bin` files can be compared
|
|
using `diff` to ensure that no changes have been introduced by the
|
|
disassembly process.
|
|
|
|
|
|
## Install Instructions
|
|
|
|
Transfer the `.$F1` files to your Apple (real or virtual) ensuring you:
|
|
|
|
* Drop the suffix
|
|
* Replace `.` in the name with spaces
|
|
* Ensure they have ProDOS file type `$F1`
|
|
* Ensure they have start address `$800`
|
|
|
|
The last two are tricky, and depend on how you're copying the files.
|
|
My process is to use Virtual ][ on my Mac and mount a folder as a
|
|
ProDOS drive; I copy one of the original DAs into the folder which
|
|
gives it the $F1 filetype as a suffix and start address as an invisible
|
|
resource stream. I then unmount the folder, overwrite the DA with
|
|
a newly built one, and remount the folder.
|
|
|
|
This is done by the `res/go.sh` script.
|
|
|
|
Finally:
|
|
|
|
* Drop the files into your `A2.DESKTOP\DESK.ACC` folder
|
|
* Restart so A2D picks up the new DA
|
|
|
|
Tips:
|
|
|
|
* You can use the Sort Directory DA to order the files, which controls
|
|
the menu order:
|
|
* Open the `A2.DESKTOP\DESK.ACC` folder
|
|
* Press Open-Apple and click on each file in the desired order
|
|
* Select Sort Directory from the Apple menu, and verify the order
|
|
* Restart
|