The ZX Spectrum library for C++

These are the documentation pages for the header files of the ZX Ecosystem library.

With this library you will be able to make your graphical C++ programs to look like
the ZX Spectrum 48K! The library provides you with the graphical, keyboard and sound interfaces that
would be in a real ZX Spectrum (and we have added mouse!).

Currently the ZX Ecosystem library is written for C++17 (and above) programs.

The main class is zxeco::ZXEco, which is defined in the The ZX Ecosystem module and
the ZXEcosystem.h file.

The zxeco::ZXEco class manages in turn all the components of the ZX Ecosystem, namely:

• The screen (The ZX Screen module).
• The keyboard (The ZX Keyboard module).
• The sound (The ZX Sound module).
• The mouse (Mouse support module).

In addition, since version 4.0, there is a set of GUI modules that provide support
for making up GUIs with dialogs, windows and a simple but quite complete widget toolkit,
including buttons, labels, lists, drop-boxes, file browsers, and more.
This is called the ZXEcosystem-GUI sublibrary.

zxecosystem.h is the only header you need to include in your source code.

For building, you can use CMAKE with the provided file; it accepts these command
line parameters:

• NO_TEST. To not prepare make files for the provided test program.
• NO_GUI. To not prepare make files that include the GUI sublibrary.

Then you must do make as long as you link against these (you must get the headers and lib files):

• SDL2 (https://www.libsdl.org/download-2.0.php).
• SDL2-image (https://www.libsdl.org/projects/SDL_image/).

All in all, the sequence in Linux would be:

• cd build
• cmake .. [-DNO_TEST=True] [-DNO_GUI=True]
• make
• [../bin/tests/test]

For downloading the library and also get further information, go to its home page.

• Development history.

Author

Juan-Antonio Fernandez-Madrigal. http://jafma.net

Date

2016-2022

Copyright

Copyright (c) 2016-2022, see LICENSE.txt and AUTHORS.txt file.

http://jafma.net

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.