Changes

'''CPCRSlib''' is a [[:Category:C|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|Z88DK]] compileror with [[SDCC|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.

Last release of the library can be downloaded at: [http://codesourceforge.google.comnet/pprojects/cpcrslib/downloads/list code.google.com/psourceforge/cpcrslib/downloads/list]

[[CPCWYZlib|CPCWYZlib]] is included in the downloadable package of CPCRSlib. CPCWYZlib includes a music player and SFX player coded by the WYZ, which can play music created with [[WYZTracker|WYZTracker]].

== Easy installation ==  If starting from scratch: # Get [https://github.com/cpcitor/cpc-dev-tool-chain cpc&#45;dev&#45;tool&#45;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 [https://github.com/cpcitor/cpc-dev-tool-chain/blob/master/documentation/how_to_install.md#user-content-build-a-project compiles cpcrslib sample projects]. == installation == On Ubuntu Lucid Lynx : <pre>cd cpcrslib/z80asm -v -xcpcrslib.lib @cpcrslib.lstsudo cp cpcrslib.lib /usr/share/z88dk/lib/clibs/sudo cp cpcrslib.h /usr/share/z88dk/include</pre> now it should work. == Usage == A classic "Hello world" from cpcrslib : <pre>#include "cpcrslib.h" // CPC Library int main(void) { cpc_PrintStr("Hello World!"); while (!cpc_AnyKeyPressed()) { } return 0;}</pre> You should provide a zcc_opt.def in the source directory : <pre> DEFINE DEFINED_myzorg defc myzorg = 16384 IF !NEED_appstartup DEFINE NEED_appstartup defc reqpag = 32 defc NEED_expanded = 1ENDIF</pre> Compile the contents by running the compiler, pre-processor and linker in one go by typing: <pre>zcc +cpc -create-app -make-app -O3 -unsigned -o hello.bin hello.c -lcpcrslib -lndos -zorg=16384</pre> you'll have a hello.cpc file ready to be run on your CPC. == Sources of projects using z88dk/SDCC and cpcrslib == *[http://espsoft.blogspot.com.es/2015/08/small-games-for-smart-minds.html Small Games for Smart Minds] by ESP Soft.*[http://espsoft.blogspot.com.es/2015/08/mariano-dragon-capers-in-cityland.html Mariano The Dragon] by ESP Soft.*[[Sort'em]] by LuBlu Entertainment.*[http://cpcfreak.cpc-live.com/ Blue Angel 69] by Kevin Thacker.*[https://cpcrulez.fr/GamesTest/nanako_descends_to_hell.htm Nanako Descends to Hell] by The Mojon Twins*[https://cpcrulez.fr/GamesTest/nanako_in_classic_japanese_monster_castle.htm Nanako in Classic Japanese Monster Castle] by The Mojon Twins*[https://cpcrulez.fr/GamesTest/platformer_medley_block_1.htm Mari Stormbringer Plateform Medley #1] by The Mojon Twins*[http://www.mojontwins.com/?page_id=171 Phantomas Thales #1: Marsport] by The Mojon Twins.*[http://www.mojontwins.com/juegos_mojonos/cheril-of-the-bosque-cpc/ Cheril of the Bosque] by The Mojon Twins.*[http://www.mojontwins.com/juegos_mojonos/lala-prologue-cpc/ Lala Prologue] by The Mojon Twins.*[http://www.mojontwins.com/juegos_mojonos/sir-ababol-cpc/ Sir Ababol] by The Mojon Twins.*[http://www.mojontwins.com/juegos_mojonos/uwol-2-cpc/ Uwol 2] by The Mojon Twins.*[http://espsoft.blogspot.com.es/2015/08/totems-columns-cpc-two.html TOTEMS: Columns CPC Two] by ESP Soft. == See also == [[CPCtelera]] [[Category:Programming]] [[Category:C]][[Category:CrossDev]]