millfork/examples/README.md

Examples

The examples showcased here are designed to compile with a compiler built from newest sources. If you are using a release version of the compiler, consider browsing the older versions of the examples:

• for version 0.3.22

• for version 0.3.18

• for version 0.3.16

• for version 0.3.14

• for version 0.3.12

• for version 0.3.10

Cross-platform examples

• Hello world (C64/C16/PET/VIC-20/Atari/Apple II/BBC Micro/ZX Spectrum/PC-88/Armstrad CPC/MSX) – simple text output

• Fizzbuzz (C64/C16/PET/VIC-20/PET/Atari/Apple II/BBC Micro/ZX Spectrum/PC-88/Armstrad CPC/MSX/X16) – everyone's favourite programming task

• Fizzbuzz 2 (C64/C16/PET/VIC-20/PET/Atari/Apple II/BBC Micro/ZX Spectrum/PC-88/Armstrad CPC/MSX/CoCo) – an alternative, more extensible implemententation of fizzbuzz

• Fizzbuzz JP (PC-88/Japanese C64) – Fizzbuzz, but in Japanese

• Text encodings (C64/ZX Spectrum) – examples of text encoding features

• Echo (C64/C16/Apple II/ZX Spectrum/PC-88/MSX)– simple text input and output

• Calculator (C64/C16/Apple II/ZX Spectrum/PC-88/MSX) – simple numeric input and output

• Guessing game (C64/C16/Apple II/ZX Spectrum/PC-88/MSX) – a guess-a-number game

• Fire effect (C64/C16/ZX Spectrum) – a simple fire effect

• readkey test (C64/C16/PET/VIC-20/Atari/Apple II/Armstrad CPC/ZX Spectrum/PC-88) – keyboard reading test

• Screen encoding test (C64/C16) – default-to-screen encoding conversion test

• Bell (Apple II/ZX Spectrum) – a program that goes *ding!*

• Life (C64/C16/Atari/ZX Spectrum) – Conway's game of life

• Reg dump (C64/C16/ZX Spectrum/CoCo) – a program that simply prints the initial values of CPU registers

• Test suite (C64/C16/Atari/Apple II/BBC Micro/Armstrad CPC/ZX Spectrum/PC-88/CoCo) – the semi-official test-suite for Millfork

Commodore 64 examples

Graphical examples

• Rasterbar – simple rasterbar effect

• Softscrolling – soft-scrolling a single line of text

• Galencia starfield – a port of the starfield effect from the game Galencia

• Space Poker [external link] – a game made for the 2018 Reset C64 Craptastic 4KB Game Competition

Other examples

• Multifile (source code, platform definition) – how to create a program made of multiple files loaded on demand

• Panic – how panic works on C64, showing the address of where it happened

Famicom/NES examples

• NES 101 tutorial example – a port of the tutorial example from the NES 101 tutorial by Michael Martin

• MMC4 example – the same thing as above, but uses a MMC4 mapper just to test bankswitching

• Pong example – simple pong example based off pong1.asm by bunnyboy of the nintendoage.com forums

Atari Lynx examples

• Lynx demo example – a simple sprite demo

Atari 8-bit examples

• Rainbow example – simple scrolling rasterbars

• DLI example – simple display list and display list interrupt example

• Scroll example – simple horizontal scroll example

• System Off example – Programming example with ROM off

Game Boy examples

• GB test example – a partial port of the NES example, with a rudimentary experimental text output implementation

Atari 2600 examples

• Colors – simple static rasterbars

MSX examples

• Encoding test – text encoding test; displays three lines of text in three different languages, no more one of which will display correctly depending on the default font of your computer.

Commander X16 examples

• Palette – displays the default 256-colour palette.

• Balls – 16 sprites using 240 colours.

• Joy demo – simple joystick demo.