1
0
mirror of https://github.com/fadden/6502bench.git synced 2024-11-13 13:10:51 +00:00
6502bench/SourceGen/Examples/README.md

34 lines
1.8 KiB
Markdown
Raw Normal View History

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: simple projects, intended for use with the tutorial in
2018-09-28 17:05:11 +00:00
the manual.
* 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
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)
* 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
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,
possibly removing some initial guesswork.