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.
|
|
|
|
|
2019-10-19 17:10:26 +00:00
|
|
|
* Tutorial: simple projects, intended for use with the tutorial in
|
2018-09-28 17:05:11 +00:00
|
|
|
the manual.
|
2019-10-08 17:44:49 +00:00
|
|
|
* Scripts: extension script samples.
|
2018-09-28 17:05:11 +00:00
|
|
|
* 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
|
2019-10-19 17:10:26 +00:00
|
|
|
entry points in a jump table, and is used to demonstrate address table
|
|
|
|
formatting in the advanced tutorial.
|
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)
|
2020-07-11 04:22:18 +00:00
|
|
|
* A2-HP-CDA: HardPressed Classic Desk Accessory. This original binary is
|
|
|
|
in 65816 code in OMF loader format, which was then prepared with
|
|
|
|
SourceGen's OMF conversion tool. (Try loading the "#b90100" file
|
|
|
|
into the disassembler to see why.)
|
2018-09-30 22:10:08 +00:00
|
|
|
[(Full project)](https://fadden.com/apple2/hardpressed.html)
|
2018-09-28 17:05:11 +00:00
|
|
|
|
2020-07-11 04:22:18 +00:00
|
|
|
You may be wondering why some of the example files have filenames with
|
2018-09-28 17:05:11 +00:00
|
|
|
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,
|
2020-07-11 04:22:18 +00:00
|
|
|
possibly removing some initial guesswork.
|