CPCRSlib
CPCRSlib is a C library containing routines and functions that allow to the handling of sprites and tile-mapping in Amstrad CPC.
The library is written to be used with Z88DK compiler or with SDCC complier. CPCRSlib also incorporates keyboard routines to redefine and to detect keys, as well as general routines to change to the screen mode or the colours.
It can be found an explanation of each function/routine included in the library in http://www.amstrad.es/programacion/cpcrslib.html
Last release of the library can be downloaded at: sourceforge/cpcrslib
CPCWYZlib is included in the downloadable package of CPCRSlib. CPCWYZlib includes a music player and SFX player coded by WYZ, which can play music created with WYZTracker.
Contents
[hide]Easy installation
If starting from scratch:
- Get cpc-dev-tool-chain which sets up automatically a C or ASM compiling environment on Linux, Windows, Mac.
- Create your project. In one of your C source file, just #include "cpcrslib.h".
- Compile the project. cpc-dev-tool-chain will notice the dependency and fetch and compile cpcrslib for you.
Need sample projects to see how how to start? cpc-dev-tool-chain has a cpcrslib-all target that compiles cpcrslib sample projects.
installation
On Ubuntu Lucid Lynx :
cd cpcrslib/ z80asm -v -xcpcrslib.lib @cpcrslib.lst sudo cp cpcrslib.lib /usr/share/z88dk/lib/clibs/ sudo cp cpcrslib.h /usr/share/z88dk/include
now it should work.
Usage
A classic "Hello world" from cpcrslib :
#include "cpcrslib.h" // CPC Library
int main(void) {
cpc_PrintStr("Hello World!");
while (!cpc_AnyKeyPressed()) { }
return 0;
}
You should provide a zcc_opt.def in the source directory :
DEFINE DEFINED_myzorg defc myzorg = 16384 IF !NEED_appstartup DEFINE NEED_appstartup defc reqpag = 32 defc NEED_expanded = 1 ENDIF
Compile the contents by running the compiler, pre-processor and linker in one go by typing:
zcc +cpc -create-app -make-app -O3 -unsigned -o hello.bin hello.c -lcpcrslib -lndos -zorg=16384
you'll have a hello.cpc file ready to be run on your CPC.
Sources of projects using z88dk/SDCC and cpcrslib
- Small Games for Smart Minds by ESP Soft.
- Mariano The Dragon by ESP Soft.
- Sort'em by LuBlu Entertainment.
- Blue Angel 69 by Kevin Thacker.
- Nanako Descends to Hell by The Mojon Twins
- Nanako in Classic Japanese Monster Castle by The Mojon Twins
- Mari Stormbringer Plateform Medley #1 by The Mojon Twins
- Phantomas Thales #1: Marsport by The Mojon Twins.
- Cheril of the Bosque by The Mojon Twins.
- Lala Prologue by The Mojon Twins.
- Sir Ababol by The Mojon Twins.
- Uwol 2 by The Mojon Twins.
- TOTEMS: Columns CPC Two by ESP Soft.
