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 with GNU make. It works out of the box on
  10     Linux and similar systems. If you're using Windows, you will have to
  11     compile 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
  27                 configurable).
  28
  29 -----------------------------------------------------------------------------
  30 Name:           fire
  31 Description:    Another graphics demo written by groepaz/hitmen.
  32 Platforms:      The program is currently only running on the C64, but should
  33                 be portable to the C128 and CBM510 (and maybe more machines).
  34
  35 -----------------------------------------------------------------------------
  36 Name:           hello
  37 Description:    A nice "Hello world" type program that uses the conio
  38                 console I/O library for output.
  39 Platforms:      Runs on all platforms that support conio, which means:
  40                 Apple ][, Atari, C16, C64, C128, CBM510, CBM610, PET, Plus/4
  41
  42 -----------------------------------------------------------------------------
  43 Name:           mousedemo
  44 Description:    Shows how to use the mouse.
  45 Platforms:      All systems with mouse and conio support:
  46                 Atari (untested), C64, C128 and CBM510
  47
  48 -----------------------------------------------------------------------------
  49 Name:           nachtm
  50 Description:    Plays "Eine kleine Nachtmusik" by Wolfgang Amadeus Mozart
  51 Platforms:      All systems that have the Commodore SID (Sound Interface
  52                 Device):
  53                 C64, C128, CBM510, CBM610
  54
  55 -----------------------------------------------------------------------------
  56 Name:           plasma
  57 Description:    A fancy graphics demo written by groepaz/hitmen.
  58 Platforms:      The program needs a VIC, so it runs on the following systems:
  59                 C64, C128, CBM510
  60
  61 -----------------------------------------------------------------------------
  62 Name:           sieve
  63 Description:    Implements the "Sieve of Eratosthenes" as a way to find all
  64                 prime numbers in a specific number interval. Often used as
  65                 a benchmark program.
  66 Platforms:      All systems with conio and clock support:
  67                 Atari, C16, C64, C128, CBM510, CBM610, PET, Plus/4
  68 -----------------------------------------------------------------------------
  69 Name:           tgidemo
  70 Description:    Shows some of the graphics capabilities of the "tiny graphics
  71                 interface".
  72 Platforms:      Runs on all platforms that have TGI support:
  73                 C64
  74