Apple-2gs-SW/mrbuffer
1
0
Fork 0
mirror of https://github.com/mach-kernel/mrbuffer.git synced 2024-11-21 14:31:12 +00:00
Code Issues Projects Releases Wiki Activity
f6f5b4684c
mrbuffer/README.md
David Stancu f6f5b4684c rename project
2018-02-04 20:06:37 -05:00

3.2 KiB
Raw Blame History

mrbuffer

Apple IIgs simple lowres buffer text editor. Written in 65816 assembly. The commit history will show a different name; I had originally intended to write a pong game but found editing text a more suitable vehicle for learning the quirks of writing code for the GS.

Getting Started

Requirements

  • Some *nix flavor. Please don't open issues if you are using Windows.
  • GNU build tools (autoconf, gcc, etc.)
  • Basic understanding of C/C++ build issues, since you'll likely face some.
  • An Apple IIGS emulator of your flavor + the appropriate ROM (which you will have to source for yourself)
    • The assemble script uses gsplus

Building

There are two scripts here which will get all the tools needed to assemble the game.

./build_env.sh # to grab utils
./assemble.sh  # to assemble the game

The assemble script runs the assembly source through Merlin32, then changes the ProDOS file kind to S16, an executable format that is used for GS/OS applications. _FileInformation.txt is what cadius uses to manage the ProDOS metadata for each record (since obviously this information can't be mapped to your computer's filesystem).

References

There are a lot of good materials out there: here is what I used to make this game.