git.sur5r.net Git - cc65/blob - 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     but one
  15     of the programs run on this platform. When compiling for another platform,
  16     you will have to change the line that specifies the target system at the
  17     top of the makefile.
  18
  19
  20 List of supplied sample programs:
  21
  22 -----------------------------------------------------------------------------
  23 Name:           ascii
  24 Description:    Shows the ASCII (or ATASCII, PETSCII) codes of typed
  25                 characters. Written and contributed by Greg King
  26                 <gngking@erols.com>.
  27 Platforms:      All platforms with conio or stdio (compile time configurable).
  28
  29 -----------------------------------------------------------------------------
  30 Name:           diodemo
  31 Description:    A disc copy program written and contributed by Oliver
  32                 Schmidt, <ol.sc@web.de>. Supports single or dual disc copy.
  33 Platforms:      The program does depend on conio and dio (direct disk i/o),
  34                 so it does currently compile for the Atari and Apple ][
  35                 machines.
  36
  37 -----------------------------------------------------------------------------
  38 Name:           enumdevdir
  39 Description:    Enumerates all devices, directories and files. Written and
  40                 contributed by Oliver Schmidt, <ol.sc@web.de>.
  41 Platforms:      All systems with device enumeration and directory access
  42                 (currently the C64, the C128 and the Apple ][).
  43
  44 -----------------------------------------------------------------------------
  45 Name:           fire
  46 Description:    Another graphics demo written by groepaz/hitmen.
  47 Platforms:      The program is currently only running on the C64, but should
  48                 be portable to the C128 and CBM510 (and maybe more machines).
  49
  50 -----------------------------------------------------------------------------
  51 Name:           gunzip65
  52 Description:    A gunzip utility for 6502 based machines written by Piotr
  53                 Fusik <fox@scene.pl>.
  54 Platforms:      Runs on all platforms with file I/O (currently the Atari, the
  55                 Apple ][ and most Commodore machines).
  56
  57 -----------------------------------------------------------------------------
  58 Name:           hello
  59 Description:    A nice "Hello world" type program that uses the conio
  60                 console I/O library for output.
  61 Platforms:      Runs on all platforms that support conio, which means:
  62                 Apple ][, Atari, C16, C64, C128, CBM510, CBM610, PET, Plus/4
  63
  64 -----------------------------------------------------------------------------
  65 Name:           mandelbrot
  66 Description:    A mandelbrot demo using integer arithmetic. The demo was
  67                 written by groepaz/hitmen and converted to cc65 using TGI
  68                 graphics by Stephan Haubenthal.
  69 Platforms:      Runs on all platforms that have TGI support:
  70                 Apple ][, C64, C128, Oric Atmos, Geos and Lynx.
  71
  72 -----------------------------------------------------------------------------
  73 Name:           mousetest
  74 Description:    Tests and shows how to use the mouse.
  75 Platforms:      All systems with mouse and conio support:
  76                 C64, C128, CBM510, Atari, Apple ][
  77
  78 -----------------------------------------------------------------------------
  79 Name:           multidemo
  80 Description:    Shows how to combine multiple cc65 features incl. overlays
  81                 and extended memory drivers. Written and contributed by
  82                 Oliver Schmidt, <ol.sc@web.de>.
  83 Platforms:      All systems with an overlay linker config, disk directory
  84                 access and EMD support (currently the C64, the C128,
  85                 the Atari and the Apple ][).
  86
  87 -----------------------------------------------------------------------------
  88 Name:           nachtm
  89 Description:    Plays "Eine kleine Nachtmusik" by Wolfgang Amadeus Mozart
  90 Platforms:      All systems that have the Commodore SID (Sound Interface
  91                 Device):
  92                 C64, C128, CBM510, CBM610
  93
  94 -----------------------------------------------------------------------------
  95 Name:           overlaydemo
  96 Description:    Shows how to load overlay files from disk. Written and
  97                 contributed by Oliver Schmidt, <ol.sc@web.de>.
  98 Platforms:      All systems with an overlay linker config (currently the C64,
  99                 the C128, the Atari and the Apple ][).
 100
 101 -----------------------------------------------------------------------------
 102 Name:           plasma
 103 Description:    A fancy graphics demo written by groepaz/hitmen.
 104 Platforms:      The program needs a VIC, or a TED, so it runs on the following
 105                 systems:
 106                 C64, C128, CBM510, Plus/4
 107
 108 -----------------------------------------------------------------------------
 109 Name:           sieve
 110 Description:    Implements the "Sieve of Eratosthenes" as a way to find all
 111                 prime numbers in a specific number interval. Often used as
 112                 a benchmark program.
 113 Platforms:      All systems with conio and clock support:
 114                 Atari, C16, C64, C128, CBM510, CBM610, PET, Plus/4,
 115                 Apple ][ (without timing due to missing clock support)
 116
 117 -----------------------------------------------------------------------------
 118 Name:           tgidemo
 119 Description:    Shows some of the graphics capabilities of the "tiny graphics
 120                 interface".
 121 Platforms:      Runs on all platforms that have TGI support:
 122                 Apple ][, C64, C128, Oric Atmos, Geos and Lynx.