1
2This directory contains sample programs for the cc65 compiler.
3
4Below is a short description for each of the programs, together with a list
5of the supported platforms.
6
7Please note:
8
9 * The supplied makefile needs GNU make. It works out of the box on Linux and
10 similar systems. If you're using Windows, then consider installing Cygwin
11 or MSys2.
12
13 * The makefile specifies the C64 as the default target system because all
14 but three of the programs run on that platform. When compiling for another
15 system, you will have to change the line that specifies the target system
16 at the top of the makefile, specify the system with SYS=<target> on the
17 make command line, or set a SYS environment variable.
18
19 * Use "make disk" to build a disk image with all sample programs.
20
21List of supplied sample programs:
22
23-----------------------------------------------------------------------------
24Name: ascii
25Description: Shows the ASCII (or ATASCII, PETSCII) codes of typed
26 characters. Written and contributed by Greg King
27 <greg.king5@verizon.com>.
28Platforms: All platforms with conio or stdio (compile time configurable).
29
30-----------------------------------------------------------------------------
31Name: atari2600hello
32Description: A "Hello world" type program.
33Platforms: Runs on only the Atari 2600 Video Console System.
34
35-----------------------------------------------------------------------------
36Name: diodemo
37Description: A disc copy program written and contributed by Oliver
38 Schmidt, <ol.sc@web.de>. Supports single or dual disc copy.
39Platforms: The program does depend on conio and dio (direct disk i/o),
40 so it currently does compile for only the Atari and Apple ][
41 machines.
42
43-----------------------------------------------------------------------------
44Name: enumdevdir
45Description: Enumerates all devices, directories, and files. Written and
46 contributed by Oliver Schmidt, <ol.sc@web.de>.
47Platforms: All systems with device enumeration and directory access
48 (currently the Commodore machines, the Commander X16,
49 and the Apple ][).
50
51-----------------------------------------------------------------------------
52Name: fire
53Description: Another graphics demo written by groepaz/hitmen.
54Platforms: The program currently is running on only the C64, but should
55 be portable to the C128 and CBM510 (and maybe more machines).
56
57-----------------------------------------------------------------------------
58Name: gunzip65
59Description: A gunzip utility for 6502-based machines, written by Piotr
60 Fusik <fox@scene.pl>.
61Platforms: Runs on all platforms with file I/O (currently the Atari, the
62 Apple ][, Commodore machines, and the Commander X16).
63
64-----------------------------------------------------------------------------
65Name: hello
66Description: A nice "Hello world" type program that uses the conio
67 console I/O library for output.
68Platforms: Runs on all platforms that support conio, which means:
69 Apple ][, Atari, Commodore machines, Commander X16,
70 Creativision, Gamate, NES.
71
72-----------------------------------------------------------------------------
73Name: mandelbrot
74Description: A mandelbrot demo using integer arithmetic. The demo was
75 written by groepaz/hitmen, and converted to cc65 using TGI
76 graphics by Stephan Haubenthal.
77Platforms: Runs on all platforms that have TGI support:
78 Apple ][, Atari, C64, C128, Oric Atmos and Telestrat, GEOS,
79 NES, and Lynx.
80
81-----------------------------------------------------------------------------
82Name: mousedemo
83Description: Shows how to use the mouse.
84Platforms: All systems with mouse and conio support:
85 C64, C128, CBM510, Atari, Apple ][.
86
87-----------------------------------------------------------------------------
88Name: multidemo
89Description: Shows how to combine multiple cc65 features incl. overlays
90 and extended memory drivers. Written and contributed by
91 Oliver Schmidt, <ol.sc@web.de>.
92Platforms: All systems with an overlay linker config., disk directory
93 access, and EMD support (currently the C64, the C128,
94 the Atari, and the Apple ][).
95
96-----------------------------------------------------------------------------
97Name: nachtm
98Description: Plays "Eine kleine Nachtmusik" by Wolfgang Amadeus Mozart.
99Platforms: All systems that have the Commodore SID (Sound Interface
100 Device):
101 C64, C128, CBM510, CBM610.
102
103-----------------------------------------------------------------------------
104Name: overlaydemo
105Description: Shows how to load overlay files from disk. Written and
106 contributed by Oliver Schmidt, <ol.sc@web.de>.
107Platforms: All systems with an overlay linker config. (currently the C64,
108 the C128, the Atari, and the Apple ][).
109
110-----------------------------------------------------------------------------
111Name: plasma
112Description: A fancy graphics demo written by groepaz/hitmen.
113Platforms: The program needs a VIC-II or a TED, so it runs on the following
114 systems:
115 C64, C128, CBM510, Plus/4.
116
117-----------------------------------------------------------------------------
118Name: sieve
119Description: Implements the "Sieve of Eratosthenes" as a way to find all
120 prime numbers in a specific number interval. Often used as
121 a benchmark program.
122Platforms: All systems with conio and clock support:
123 Atari, Commodore machines (VIC-20 needs memory expansion),
124 Commander X16, Apple ][ (without timing due to missing clock
125 support).
126
127-----------------------------------------------------------------------------
128Name: supervisionhello
129Description: A "Hello world" type program.
130Platforms: Runs on only the Watara Supervision game console.
131
132-----------------------------------------------------------------------------
133Name: tgidemo
134Description: Shows some of the graphics capabilities of the "Tiny Graphics
135 Interface".
136Platforms: Runs on all platforms that have TGI support:
137 Apple ][, Atari, C64, C128, Oric Atmos and Telestrat, GEOS,
138 NES, and Lynx.
139