the10thwiz/cc65
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Added new program descriptions to the list.

Browse Source
This commit is contained in:
Greg King
2019-10-11 10:48:56 -04:00
parent 216105f6df
commit 39b10f9599
1 changed files with 48 additions and 32 deletions
Download Patch File Download Diff File Expand all files Collapse all files

80
samples/README
View File

@@ -1,19 +1,20 @@
This directory contains sample programs for the cc65 compiler. This directory contains sample programs for the cc65 compiler.
Below is a short description for each of the programs together with a list of Below is a short description for each of the programs, together with a list
the supported platforms. of the supported platforms.
Please note: Please note:
* The supplied makefile needs GNU make. It works out of the box on Linux * The supplied makefile needs GNU make. It works out of the box on Linux and
and similar systems. If you're using Windows, consider installing Cygwin. similar systems. If you're using Windows, then consider installing Cygwin
or MSys2.
* The makefile specifies the C64 as the default target system, because all * The makefile specifies the C64 as the default target system because all
but one of the programs run on this platform. When compiling for another but three of the programs run on that platform. When compiling for another
system, you will have to change the line that specifies the target system system, you will have to change the line that specifies the target system
at the top of the makefile, specify the system with SYS=<target> on the at the top of the makefile, specify the system with SYS=<target> on the
make command line or set a SYS env var. make command line, or set a SYS environment variable.
List of supplied sample programs: List of supplied sample programs:
@@ -22,87 +23,95 @@ List of supplied sample programs:
Name: ascii Name: ascii
Description: Shows the ASCII (or ATASCII, PETSCII) codes of typed Description: Shows the ASCII (or ATASCII, PETSCII) codes of typed
characters. Written and contributed by Greg King characters. Written and contributed by Greg King
<gngking@erols.com>. <greg.king5@verizon.com>.
Platforms: All platforms with conio or stdio (compile time configurable). Platforms: All platforms with conio or stdio (compile time configurable).
-----------------------------------------------------------------------------
Name: atari2600hello
Description: A "Hello world" type program.
Platforms: Runs on only the Atari 2600 Video Console System.
----------------------------------------------------------------------------- -----------------------------------------------------------------------------
Name: diodemo Name: diodemo
Description: A disc copy program written and contributed by Oliver Description: A disc copy program written and contributed by Oliver
Schmidt, <ol.sc@web.de>. Supports single or dual disc copy. Schmidt, <ol.sc@web.de>. Supports single or dual disc copy.
Platforms: The program does depend on conio and dio (direct disk i/o), Platforms: The program does depend on conio and dio (direct disk i/o),
so it does currently compile for the Atari and Apple ][ so it currently does compile for only the Atari and Apple ][
machines. machines.
----------------------------------------------------------------------------- -----------------------------------------------------------------------------
Name: enumdevdir Name: enumdevdir
Description: Enumerates all devices, directories and files. Written and Description: Enumerates all devices, directories, and files. Written and
contributed by Oliver Schmidt, <ol.sc@web.de>. contributed by Oliver Schmidt, <ol.sc@web.de>.
Platforms: All systems with device enumeration and directory access Platforms: All systems with device enumeration and directory access
(currently the C64, the C128 and the Apple ][). (currently the Commodore machines, the Commander X16,
and the Apple ][).
----------------------------------------------------------------------------- -----------------------------------------------------------------------------
Name: fire Name: fire
Description: Another graphics demo written by groepaz/hitmen. Description: Another graphics demo written by groepaz/hitmen.
Platforms: The program is currently only running on the C64, but should Platforms: The program currently is running on only the C64, but should
be portable to the C128 and CBM510 (and maybe more machines). be portable to the C128 and CBM510 (and maybe more machines).
----------------------------------------------------------------------------- -----------------------------------------------------------------------------
Name: gunzip65 Name: gunzip65
Description: A gunzip utility for 6502 based machines written by Piotr Description: A gunzip utility for 6502-based machines, written by Piotr
Fusik <fox@scene.pl>. Fusik <fox@scene.pl>.
Platforms: Runs on all platforms with file I/O (currently the Atari, the Platforms: Runs on all platforms with file I/O (currently the Atari, the
Apple ][ and most Commodore machines). Apple ][, Commodore machines, and the Commander X16).
----------------------------------------------------------------------------- -----------------------------------------------------------------------------
Name: hello Name: hello
Description: A nice "Hello world" type program that uses the conio Description: A nice "Hello world" type program that uses the conio
console I/O library for output. console I/O library for output.
Platforms: Runs on all platforms that support conio, which means: Platforms: Runs on all platforms that support conio, which means:
Apple ][, Atari, C16, C64, C128, CBM510, CBM610, PET, Plus/4 Apple ][, Atari, Commodore machines, Commander X16,
Creativision, Gamate, NES.
----------------------------------------------------------------------------- -----------------------------------------------------------------------------
Name: mandelbrot Name: mandelbrot
Description: A mandelbrot demo using integer arithmetic. The demo was Description: A mandelbrot demo using integer arithmetic. The demo was
written by groepaz/hitmen and converted to cc65 using TGI written by groepaz/hitmen, and converted to cc65 using TGI
graphics by Stephan Haubenthal. graphics by Stephan Haubenthal.
Platforms: Runs on all platforms that have TGI support: Platforms: Runs on all platforms that have TGI support:
Apple ][, C64, C128, Oric Atmos, Geos and Lynx. Apple ][, Atari, C64, C128, Oric Atmos and Telestrat, GEOS,
NES, and Lynx.
----------------------------------------------------------------------------- -----------------------------------------------------------------------------
Name: mousedemo Name: mousedemo
Description: Shows how to use the mouse. Description: Shows how to use the mouse.
Platforms: All systems with mouse and conio support: Platforms: All systems with mouse and conio support:
C64, C128, CBM510, Atari, Apple ][ C64, C128, CBM510, Atari, Apple ][.
----------------------------------------------------------------------------- -----------------------------------------------------------------------------
Name: multidemo Name: multidemo
Description: Shows how to combine multiple cc65 features incl. overlays Description: Shows how to combine multiple cc65 features incl. overlays
and extended memory drivers. Written and contributed by and extended memory drivers. Written and contributed by
Oliver Schmidt, <ol.sc@web.de>. Oliver Schmidt, <ol.sc@web.de>.
Platforms: All systems with an overlay linker config, disk directory Platforms: All systems with an overlay linker config., disk directory
access and EMD support (currently the C64, the C128, access, and EMD support (currently the C64, the C128,
the Atari and the Apple ][). the Atari, and the Apple ][).
----------------------------------------------------------------------------- -----------------------------------------------------------------------------
Name: nachtm Name: nachtm
Description: Plays "Eine kleine Nachtmusik" by Wolfgang Amadeus Mozart Description: Plays "Eine kleine Nachtmusik" by Wolfgang Amadeus Mozart.
Platforms: All systems that have the Commodore SID (Sound Interface Platforms: All systems that have the Commodore SID (Sound Interface
Device): Device):
C64, C128, CBM510, CBM610 C64, C128, CBM510, CBM610.
----------------------------------------------------------------------------- -----------------------------------------------------------------------------
Name: overlaydemo Name: overlaydemo
Description: Shows how to load overlay files from disk. Written and Description: Shows how to load overlay files from disk. Written and
contributed by Oliver Schmidt, <ol.sc@web.de>. contributed by Oliver Schmidt, <ol.sc@web.de>.
Platforms: All systems with an overlay linker config (currently the C64, Platforms: All systems with an overlay linker config. (currently the C64,
the C128, the Atari and the Apple ][). the C128, the Atari, and the Apple ][).
----------------------------------------------------------------------------- -----------------------------------------------------------------------------
Name: plasma Name: plasma
Description: A fancy graphics demo written by groepaz/hitmen. Description: A fancy graphics demo written by groepaz/hitmen.
Platforms: The program needs a VIC, or a TED, so it runs on the following Platforms: The program needs a VIC-II or a TED, so it runs on the following
systems: systems:
C64, C128, CBM510, Plus/4 C64, C128, CBM510, Plus/4.
----------------------------------------------------------------------------- -----------------------------------------------------------------------------
Name: sieve Name: sieve
@@ -110,12 +119,19 @@ Description: Implements the "Sieve of Eratosthenes" as a way to find all
prime numbers in a specific number interval. Often used as prime numbers in a specific number interval. Often used as
a benchmark program. a benchmark program.
Platforms: All systems with conio and clock support: Platforms: All systems with conio and clock support:
Atari, C16, C64, C128, CBM510, CBM610, PET, Plus/4, Atari, Commodore machines (VIC-20 needs memory expansion),
Apple ][ (without timing due to missing clock support) Commander X16, Apple ][ (without timing due to missing clock
support).
-----------------------------------------------------------------------------
Name: supervisionhello
Description: A "Hello world" type program.
Platforms: Runs on only the Watara Supervision game console.
----------------------------------------------------------------------------- -----------------------------------------------------------------------------
Name: tgidemo Name: tgidemo
Description: Shows some of the graphics capabilities of the "tiny graphics Description: Shows some of the graphics capabilities of the "Tiny Graphics
interface". Interface".
Platforms: Runs on all platforms that have TGI support: Platforms: Runs on all platforms that have TGI support:
Apple ][, C64, C128, Oric Atmos, Geos and Lynx. Apple ][, Atari, C64, C128, Oric Atmos and Telestrat, GEOS,
NES, and Lynx.