The classic library can be used with both sccz80 and zsdcc and the final binary can be made of object files generated by either compiler (though care will need to be taken around calling conventions and floating point usage).

Originally, the classic library and new library were completely different code bases, however over time they have converged with the result that the only differences are as follows:

• Classic supports many more targets and has different way of implementing the crt0 startup file
• Classic uses the same library for both sccz80 and sdcc compiles
• <stdio.h> is a different implementation that supports file io
• Classic supports multiple floating point libraries for pure sccz80 compilations
• Classic provides the cross platform libraries detailed below
• Classic tends to be tuned at link time, newlib at library build time

By default, classic builds use sccz80 as the compiler, if you wish to compile with zsdcc then you must add the option -compiler=sdcc. Classic supports the creation of final executables which are comprised of some files compiled with sccz80 and some with zsdcc.

The generic console console driver provides a uniform set of escape codes to control text positioning, attributes etc. It is integrated into <stdio.h> and if not enabled as the default can be selected with the command line --generic-console.

Multiple portable maths libraries are available in the classic library and all processors supported by z88dk can use floating point. See Classic Maths Libraries for details of their characteristics.

The ZX Spectrum, ZX81, CPC and z88 platforms additionally provide a maths library that utilises the floating point code within their ROMs. These provide a lower degree of precision (a 32 bit mantissa), the trade-off being that they use less of your application memory.

Simplified regex support is supplied for all platforms.

The classic library provides several memory allocators, the easiest way to get started is to use the auto malloc feature of the library. In this mode the crt automatically sets aside a set amount memory between the end of the program and (usually) the stack pointer for the heap. There are a number of presets available: -DAMALLOC will reserve 75% of the free memory, -DAMALLOC2 will reserve 50% of the free memory and -DAMALLOC1 will reserve 25%.

The classic library additionally provides named heap and block allocators.

The classic library supports both a 1 bit <sound.h> and a PSG <psg.h> based sound interface.

The 1 bit library defines a collection of sound effects in addition to a tone generator.

Certain targets with an AY chip additionally support WYZ Player, VortexTracker II and Arkos for playing music and sound effects.

Targets with a sn76489 have access to PSGLib.

Targets with a SAA1099 (at the moment just the SAM Coupé) have access to etracker in addition to AY emulation code that allows use of [WYZ Player].

Hardware keyboard scanning bypasses the target's ROM and directly polls the keyboard. The keyboard routines in_LookupKey and in_Keypressed handle multiple keys being pressed concurrently and as such are ideal for portable games programming. The various routines are defined in <input.h>

On ports where it is available, you can switch stdin to non-firmware reading routines using the option -pragma-redirect:fgetc_cons=fgetc_cons_inkey or the command line alias --hardware-keyboard

Targets generally support at least some form of joystick support. Polling of the joystick is exposed using the joystick() function in <games.h>

There are the following effective levels of support:

• Keyboard joysticks using ROM functions: Only a single direction can be registered at once
• Keyboard joysticks using inkey driver: Multiple directions supported
• Hardware joystick support: Multiple directions supported

A variety of drawing primitives and higher level functions are supplied by <graphics.h>.

This is an experimental library to emulate some basic behaviour fo the Xlib functions. It isn't based on the network layer as the original library, and it implements only a tiny subset of the original functions but, being based on the "monochrome graphics" library, it is portable to many of the supported targets.

The 3D Libraries include a standard set of functions for making your own 3D functions. This document is a reference for these functions. 'lib3d' includes also functions requiring a fast trigonometry approximation, e.g. to draw polygons or for "turtle graphics".

The TMS9918a/TMS9928a VDP is used by a number of targets supported by z88dk. A common library is available across all of those targets allowing both high- and low- level access to the chip.

Classic provides a library to provide graphical support for headless targets using a Tektronix 4010 terminal or emulation.

The ZX Spectrum and clones support the sp1 sprite library that provides advanced features ideal for writing performant games.

The library provides functionality to implement general purpose interrupts without having to drop down to machine code.

A simple preemptive multitasking driver is available in <threading/preempt.h> this allows multiple tasks to concurrently execute (for example a game simulation and the user interaction) without the need to implement coroutines.

The library provides ready-to-use abstract data types that implement common data structures in an optimal manner.

The classic library provides both MS-DOS emulation and Turbo C BGI Emulation to assist the porting of software.