]> git.sur5r.net Git - cc65/blob - samples/README
Moved the 'process' files from 'geos-cbm' to 'geos-common' which are believed to...
[cc65] / samples / README
1
2 This directory contains sample programs for the cc65 compiler.
3
4 Below is a short description for each of the programs together with a list of
5 the supported platforms.
6
7 Please note:
8
9   * The supplied makefile needs GNU make. It works out of the box on Linux
10     and similar systems. If you're using Windows, you will have to compile
11     the programs manually.
12
13   * The makefile specifies the C64 as the default target platform, because all
14     of the programs run on this platform. When compiling for another platform,
15     you will have to change the line that specifies the target system at the
16     top of the makefile.
17
18
19 List of supplied sample programs:
20
21 -----------------------------------------------------------------------------
22 Name:           ascii
23 Description:    Shows the ASCII (or ATASCII, PETSCII) codes of typed
24                 characters. Written and contributed by Greg King
25                 <gngking@erols.com>.
26 Platforms:      All platforms with conio or stdio (compile time configurable).
27
28 -----------------------------------------------------------------------------
29 Name:           diodemo
30 Description:    A disc copy program written and contributed by Oliver
31                 Schmidt, <ol.sc@web.de>. Supports single or dual disc copy.
32 Platforms:      The program does depend on conio and dio (direct disk i/o),
33                 so it does currently compile for the Atari and Apple ][
34                 machines.
35
36 -----------------------------------------------------------------------------
37 Name:           fire
38 Description:    Another graphics demo written by groepaz/hitmen.
39 Platforms:      The program is currently only running on the C64, but should
40                 be portable to the C128 and CBM510 (and maybe more machines).
41
42 -----------------------------------------------------------------------------
43 Name:           gunzip65
44 Description:    A gunzip utility for 6502 based machines written by Piotr
45                 Fusik <fox@scene.pl>.
46 Platforms:      Runs on all platforms with file I/O (currently the Atari, the
47                 Apple ][ and most Commodore machines).
48
49 -----------------------------------------------------------------------------
50 Name:           hello
51 Description:    A nice "Hello world" type program that uses the conio
52                 console I/O library for output.
53 Platforms:      Runs on all platforms that support conio, which means:
54                 Apple ][, Atari, C16, C64, C128, CBM510, CBM610, PET, Plus/4
55
56 -----------------------------------------------------------------------------
57 Name:           mandelbrot
58 Description:    A mandelbrot demo using integer arithmetic. The demo was
59                 written by groepaz/hitmen and converted to cc65 using TGI
60                 graphics by Stephan Haubenthal.
61 Platforms:      Runs on all platforms that have TGI support:
62                 Apple ][, C64, C128, Oric Atmos, Geos and Lynx.
63
64 -----------------------------------------------------------------------------
65 Name:           mousedemo
66 Description:    Shows how to use the mouse.
67 Platforms:      All systems with mouse and conio support:
68                 C64, C128, CBM510, Atari, Apple ][
69
70 -----------------------------------------------------------------------------
71 Name:           nachtm
72 Description:    Plays "Eine kleine Nachtmusik" by Wolfgang Amadeus Mozart
73 Platforms:      All systems that have the Commodore SID (Sound Interface
74                 Device):
75                 C64, C128, CBM510, CBM610
76
77 -----------------------------------------------------------------------------
78 Name:           plasma
79 Description:    A fancy graphics demo written by groepaz/hitmen.
80 Platforms:      The program needs a VIC, or a TED, so it runs on the following
81                 systems:
82                 C64, C128, CBM510, Plus/4
83
84 -----------------------------------------------------------------------------
85 Name:           sieve
86 Description:    Implements the "Sieve of Eratosthenes" as a way to find all
87                 prime numbers in a specific number interval. Often used as
88                 a benchmark program.
89 Platforms:      All systems with conio and clock support:
90                 Atari, C16, C64, C128, CBM510, CBM610, PET, Plus/4,
91                 Apple ][ (without timing due to missing clock support)
92
93 -----------------------------------------------------------------------------
94 Name:           tgidemo
95 Description:    Shows some of the graphics capabilities of the "tiny graphics
96                 interface".
97 Platforms:      Runs on all platforms that have TGI support:
98                 Apple ][, C64, C128, Oric Atmos, Geos and Lynx.
99