What is MSXgl?

From MSX Game Library

Revision as of 23:12, 13 January 2022 by Aoineko (talk | contribs)

MSXGL is a Game Library wrote in C and targeting MSX computers.

The goal of this library is to offer to C programmers, the whole set of functionalities to create a game with high performances.
EvenEven if a C program can never be as efficient as a program written entirely in assembler, the goal is to try to get as close as possible.

To achieve this goal, the library is dynamically compiled to allow the user to configure the functionalities to best suit his needs.
Also, the most expensive features are written in assembler.

The other goal was to create a library that could be totally independent of the BIOS. This makes it much easier to use the 16K of page 0.
The library also provides interrupt handling code to create ROMs that always remain on page 0.

The Build Tool allows in 1 click to create a final program for a large number of formats:

  • Plain ROM from 8K to 64K (interrupt handler can be install in page 0),
  • Mapped ROM from 64K to 4096K (ASCII-8, ASCII-16, Konami and Konami SCC mappers),
  • MSX-DOS 1 or 2 binary program,
  • BASIC binary program.

The library supports the following devices: VDP (TMS9918 and V9938), PSG (AY-3-8910), Keyboard/Joystick, ROM mapper, slot manager, and Real Time Clock (RP-5C01).

Here are also the supported audio formats:

  • PT3 (Vortex Tracker II)
  • ayFX
  • VGM (AY-3-8910 only)
  • PCM-Encoder (aka. Crystal clean PCM 8bit samples on the poor PSG)

Many thanks to the members of the MSX Ressource Center and MSX Village who have been very helpful.

The library is distribute under Creative Commons BY-SA license. Tools or sources from other authors could use other free license.


Directories

πŸ“ engine MSXgl library
β”œβ”€πŸ“ content Data ready to include (font, math table)
β”œβ”€πŸ“ datasrc Data source
β”œβ”€πŸ“ doc Documentation
β”œβ”€πŸ“ lib
β”œβ”€πŸ“ script Build Tool scripts
β””β”€πŸ“ src Library sources (.c and .h)
πŸ“ projects ...
β”œβ”€πŸ“ samples Sample programs (VDP, PSG, Sprite, ...)
β”œβ”€πŸ“ targets Samples to test all target (ROM, DOS)
β””β”€πŸ“ template Template sample (can be use as base to create a new program)
πŸ“ tools ...
β”œβ”€πŸ“ audio
β”œβ”€πŸ“ build
β””β”€πŸ“ sdcc