2018-09-28 17:05:11 +00:00
|
|
|
# SourceGen Examples #
|
|
|
|
|
|
|
|
|
|
These are some sample projects you can play with. The binaries are
|
|
|
|
|
accompanied by the original source code, so you can compare the SourceGen
|
|
|
|
|
project to the original.
|
|
|
|
|
|
|
|
|
|
* Tutorial: a simple project, intended for use with the tutorial in
|
|
|
|
|
the manual.
|
|
|
|
|
* A2-lz4fh: two functions for unpacking a simplified form of LZ4 compression.
|
2018-09-30 22:10:08 +00:00
|
|
|
One is 6502, the other is 65816. This is pretty straightforward.
|
2018-09-28 17:05:11 +00:00
|
|
|
[(Full project)](https://github.com/fadden/fhpack)
|
|
|
|
|
* A2-Amper-fdraw: 6502 code that provides an Applesoft BASIC interface
|
|
|
|
|
to a machine-language graphics library. The public interface of the
|
2018-09-30 22:10:08 +00:00
|
|
|
graphics library is defined in a .sym65 file. This example has multiple
|
|
|
|
|
entry points in a jump table, and requires a bit more effort.
|
2018-09-28 17:05:11 +00:00
|
|
|
[(Full project)](https://github.com/fadden/fdraw)
|
|
|
|
|
* A2-Zippy: a program for controlling an Apple IIgs CPU accelerator card.
|
|
|
|
|
65816 sources, with a little bit of ProDOS 8 and IIgs toolbox usage.
|
2018-09-30 22:10:08 +00:00
|
|
|
Demonstrates how extension scripts are used during analysis.
|
2018-09-28 17:05:11 +00:00
|
|
|
[(Full project)](https://fadden.com/apple2/misc.html#zippy)
|
2018-09-30 22:10:08 +00:00
|
|
|
* A2-HP-CDA: HardPressed Classic Desk Accessory. This is 65816 code
|
|
|
|
|
in OMF loader format, which SourceGen doesn't support, so it's a little
|
|
|
|
|
rough. (This is chiefly here to answer the question, "what does it look
|
|
|
|
|
like when you disassemble OMF binaries?")
|
|
|
|
|
[(Full project)](https://fadden.com/apple2/hardpressed.html)
|
2018-09-28 17:05:11 +00:00
|
|
|
|
|
|
|
|
(You may be wondering why some of the example files have filenames with
|
|
|
|
|
things like "#061d60" in them. It's a method of preserving the file type
|
2018-09-30 22:10:08 +00:00
|
|
|
for Apple II files used by some utilities. The potential advantage for
|
|
|
|
|
disassembly is that the file type often determines the load address,
|
2018-09-28 17:05:11 +00:00
|
|
|
possibly removing some initial guesswork.)
|
