a2d/desk.acc
2018-12-27 12:55:56 -08:00
..
docs Add docs explaining HR to DHR conversion process 2017-09-08 15:54:14 -07:00
inc Show Image File additions/fixes 2017-09-18 19:50:16 -07:00
orig DAs: start disassembly work on Sort Directory 2018-04-19 21:23:23 -07:00
res Restore new DAs to fixes branch 2018-12-09 20:08:57 -08:00
.gitignore build into subdirs 2018-02-21 08:04:32 -08:00
API.md Documentation updates 2018-04-27 20:40:39 -07:00
calculator.s Merge remote-tracking branch 'origin/disasm' 2018-12-24 18:23:34 -08:00
date.s Merge remote-tracking branch 'origin/disasm' 2018-12-24 18:23:34 -08:00
eyes.s Restore new DAs to fixes branch 2018-12-09 20:08:57 -08:00
Makefile Move DESKTOP.SYSTEM a.k.a. DESKTOP1 to separate directory 2018-11-05 20:14:29 -08:00
puzzle.s disasm: misc macros, constants 2018-12-24 16:00:55 -08:00
README.md Remove 'orig' files in master branch 2018-12-19 19:50:04 -08:00
run.basic.here.s RBH DA: Restore devices and reformat /RAM. Fixes #98 2018-12-27 12:55:56 -08:00
screen.dump.s Restore new DAs to fixes branch 2018-12-09 20:08:57 -08:00
show.image.file.s SIF DA: Optimize main>aux copy, use more macros 2018-12-19 18:52:33 -08:00
show.text.file.s fix unreferenced label warning 2018-12-24 18:24:11 -08:00
sort.directory.s Sort Directory DA disasm 2018-12-05 19:46:29 -08:00
TARGETS Restore new DAs to fixes branch 2018-12-09 20:08:57 -08:00
this.apple.s Restore new DAs to fixes branch 2018-12-09 20:08:57 -08:00

Disassembly of the original desk accessories:

New desk accessories:

  • Show Image File
    • Select an image file (8k Hires or 16k Double Hires), then choose this DA to preview it.
  • This Apple
    • Gives details about the computer, expanded memory, and what's in each slot.
  • Eyes
    • Eyes that follow the mouse.
  • Screen Dump
    • Dumps a screenshot to an ImageWriter II attached to a Super Serial Card in Slot 1.

See API.md for programming details

Files

  • TARGETS - lists DAs (used by makefile and other scripts)
  • Makefile - cleans/builds targets
  • *.s - source (originally generated using da65, now modified)

Build Instructions

On Unix-like systems (including Mac OS X) make all should build the desk accessory files (original and new) into out/ output with a .built suffix.

Getting The DAs Onto Your Apple II

There are a handful of approaches for getting the files on your real or virtual Apple.

Create a Disk Image

To produce a ProDOS disk image with the DA files, install and build the Cadius tool:

git clone https://github.com/mach-kernel/cadius /tmp/cadius
make -C /tmp/cadius
CADIUS=/tmp/cadius/bin/release/cadius

Then from the desk.acc/ directory, run: res/package.sh

This will generate: desk.acc/out/DeskAccessories.po

Mount this disk image in your emulator, or transfer it to a real floppy with ADTPro, then follow the install instructions below.

Mount Folder in Virtual ][

If you use Virtual ][ as your emulator, you can skip creating a disk image.

At the top level of the repo, run res/go.sh to build all targets, then run res/mount.sh. This will create a mount/ folder and the built files will automatically be copied in. Then run Virtual ][ and use the Media > Mount Folder as ProDOS Disk... menu item, then select the mount/ folder. A new ProDOS volume called /MOUNT will be available. (Tip: use the Special > Check Drives command in A2D to make it appear.)

(The res/go.sh script will helpfully run res/mount.sh automatically if the mount/ folder already exists.)

Other

If you need to copy the files some other way (e.g. via CiderPress), you need to do the following:

Transfer the .built files in the out directory, ensuring you:

  • Drop the .built suffix
  • Ensure they have ProDOS file type $F1
  • Ensure they have start address $0800
  • Ensure they have auxtype $0640 (to match the originals)

The last three are tricky, and depend on how you're copying the files.

Install Instructions

Once you have the files accessible on your Apple:

  • Copy the files into your A2.DESKTOP/DESK.ACC folder (using A2D or any other tool)
  • 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
    • Hold Open-Apple and click on each file in the desired order
    • Select Sort Directory from the Apple menu, and verify the order
    • Restart