Appendix C
Source shelf and further reading
Take the examples with you. Every program here can be studied offline, including its original source.
Read the original tool manuals
The library includes Pierre Sarrazin's complete CMOC 0.1.101 manual, the complete LWTools 4.25 manual, and the bundled tools' command-line help. Use these for exact compiler, assembler and linker options; this book remains the guide to VCC Plus's C workspace and APIs. The references identify the tool versions, preserve the authors' notices and provide original source downloads. They are searchable through Ask the Manuals and a project's MCP manual tools.
Get a working copy
- Earth or Mars is the single-file Hello World starter. Cargo Count is its companion experiment. For either, create a new Hello World project, replace the text in main.c with the example, save and build. Keep the filename expected by the Makefile.
- Save the complete Hello Disk project. Expand the ZIP in Finder and choose Open in C Development to select the HelloDisk directory that contains the Makefile. This is the same source supplied by New → Hello Disk. Its word list, header and generator travel with it. Build the disk before choosing Launch Disk.
- Save Planet Survey. Read a planet record across two sectors, then split its name, traits and orbit number. The project includes the editable text file and the recipe that packs it onto the disk.
- Read yesterday’s log and add a return trip. Save returntrip.c to record Earth and Mars on successive launches and retry a protected save.
- Send a flight report to the TP-10. Save flightreport.c to send Earth and Mars observations to Printer Output while keeping the crew’s prompt on the CoCo display.
- Exchange a flight recording with BASIC. Save Flight Recorder in C, then try its tape with the BASIC reader. The BASIC writer supplies fresh observations for the return flight.
- Keep a field log as you fly. Save fieldlog.c to write two observations and read the first one back before ending the flight.
- Save Planet Expedition. Build a practice SDC card with a program disk and two landing reports, then swap planets from C.
- Rescue an interrupted atlas save. Save atlasbackup.c and try restarting between the two disk renames on a practice copy.
- Planet Atlas. Save atlas.c to read a destination in decimal or hexadecimal, jump to its disk record and mark it so the next trip remembers your visit.
- Give Zora a voice. Save announcer.c to store a custom pronunciation, repeat a crew message and trigger a fading tone from a joystick.
- Read the Descent Computer. Save descent.c to turn two radar readings into a signed descent speed and a time to touchdown.
- Steer the Stereo Flyby. Save flyby.c to fly a ship while Orchestra-90 repeats a two-note stereo beacon.
- Fly the page-flipping lander with the right joystick or WASD. Save lander.c for the graphics exercise.
- Launch a survey probe with a joystick button. Save probe.c to try the press, charge and release exercise.
- Give the probe a second landscape. Save ridge.c to switch between two terrain maps held in banked RAM.
- Save Talking Planet Lander. Open the expanded project for the two-cartridge landing exercise. The Makefile and sources travel together.
- Save Mission Recorder. Open the expanded project to mark a sector, save its flight report and send a verified copy to the printer.
- Choose a library for a job has the individual experiments and their library settings. Each source link saves a personal copy. Opening a link in the native reader leaves the decision to build or run with you.
When reading the standalone HTML in a browser, the same files sit beside this page in the examples folder. If your browser displays C as text, use its download command or copy the file from that folder in Finder.
If you came from BASIC, compare the single-key C starter with the BASIC planet menu. To carry a finished image to another machine, use the six-word handoff.
Bibliography
- Sarrazin, Pierre. The CMOC C-like 6809-targeting cross-compiler. Version 0.1.101, November 16, 2026. See “C Language Features,” “The standard library,” “Floating-point arithmetic,” “Detecting stack overflows at run time,” and “Calling convention.” Use the manual with the headers from the same edition.
- Sarrazin, Pierre. decbfile, 0.1.13. Header and sector-file examples. The caller-owned drive table, file handle and logical sector numbers explain the three different things passed to the open and read calls.
- Sarrazin, Pierre. BGraph, 0.1.9; BControl, 0.1.6; BSound, 0.1.4. Libraries and accompanying header documentation. See the drawer, joystick and player interfaces used in the optional experiments.
- Sarrazin, Pierre. WydeAlloc, 0.1.0; HiresTxt, 0.5.1; AStar, 0.1.0; CardGame, 0.1.15; Ebitor, 0.1.1. Source distributions and public headers. See each distribution's acknowledgments and the installed notices for additional contributors.
- Sarrazin, Pierre. autostart.c. Version 0.1.2, 2018. See also Schrag, Roger. “A Special Use For The DOS Command.” The Rainbow, November 1984, p. 140. The generated Hello Disk uses an adapted startup command with the loader.
- Lindner, tim. CoCo SDC User Guide. Fourth version, February 2023, ch. 7, pp. 28–33. Hardware and software by Darren Atkinson. See the card directory and image commands.
- Spectral Associates. Disk BASIC Unravelled II. Revised by Walter K. Zydhek, December 26, 1999. See appendix B, pp. B10–B11, and program listing LC71E and LC79D for the Disk BASIC routines that record and reload the file allocation table.
- Color Computer Disk BASIC Quick Reference Guide. InterTAN Canada Ltd., 1987, pp. 3–9. Compare the directory, binary load and disk error entries with the commands the friend uses at the end of the book.
- Tandy Corporation. Orchestra-90 CC Stereo Music Synthesizer with Percussion for Tandy Color Computer. Special Composer’s Edition, 1983, catalog 26-3143, pp. 66–68 and appendix E, p. 103. See the original stereo instrument used here as a pair of digital-to-analog converters.
- Tandy Corporation. Color Computer Speech/Sound Cartridge Owner’s Manual. 1984, pp. 12–14, 17–23, 26–29, 35–36. The stored speech and sound commands and allophone chart underpin Mission Announcer.
- Tandy Corporation. Color Computer 3 Service Manual, section V, figure 5-7, “MMU Block Diagram.” See how a CPU address selects a block of physical RAM.
- Spectral Associates. Color BASIC Unravelled II. Revised by Walter K. Zydhek, 1999, “Console Input/Output,” pp. 13–14. The cassette buffer explains how a stream of characters travels between BASIC and tape in blocks.
- Tandy Corporation. Tandy Color Computer 3 BASIC Quick Reference Guide. 1986, commands, pp. 2–17. For the BASIC counterparts of the CoCo 3 screen routines.
The Color Computer Archive preserves historical documentation that informed this book. The lessons and teaching programs here were written for VCC Plus.
Credits and toolchain editions
The VCC Plus manual prose and original instructional images are © 2026 Brian K. Holman. The examples retain their source notices. CMOC, its runtime, the companion libraries, the disk driver and the guest firmware have separate histories and terms. Licenses & Notices in VCC Plus identifies the components supplied in your edition.
Several of the companion libraries and the selected ROM-backed decbfile core carry public-domain dedications. WydeAlloc and Ebitor carry GPL-3.0-or-later. The original VCC Plus SDC, banked-memory, joystick input, GIME graphics, Speech/Sound, Orchestra-90 and C compatibility libraries, and the Talking Planet Lander, Planet Survey, Planet Expedition and Mission Recorder examples, also carry GPL-3.0-or-later. CMOC's compiler and individual runtime files have their own notices. The ROM-backed disk library calls the resident Disk BASIC firmware. The optional standalone disk driver includes separately identified Disk BASIC-derived material. Neither path transfers rights in that firmware. Artwork credits.