Samples

Here is a list of sample programs supplied with MSXgl to demonstrate the use of the library's various functions.

To try out the different samples, simply open a command line in the MSXgl/projects/samples/ directory and run:

• build.bat s_game (Windows)
• ./build.sh s_game (Linux & macOS)

Replace "s_game" with the name of the sample you want to try out (sample's .c file extension is not needed).

Note: Samples use a system to overwrites the project configuration (project_config.js) with a sample-specific configuration file (e.g. s_game.js). This makes it possible to have several projects in the same directory.

This is not necessary for a stand-alone project. See how to create a new program.

Core

Hello World

Program showing the minimal code needed to display a text.

• File: s_hello.c
• State: ✔️ Functional

32K

BIOS

Program showing the use of default BIOS functions.

• Showcased modules:
  • bios (code)
• File: s_bios.c
• State: ✔️ Functional

32K

Clock

Program showing the use of the MSX 2's Real Time Clock (Ricoh RP-5C01) to get current time and save/load data from CMOS memory.

• Showcased modules:
  • clock (code)
• File: s_clock.c
• State: ✔️ Functional

32K

PSG

Program showing the use of direct control over PSG sound chip.

• Showcased modules:
  • psg (code)
• File: s_psg.c
• State: ✔️ Functional

32K

System

Program showing the retrieval of system information.

• File: s_sys.c
• State: ✔️ Functional

32K

Render

Draw

Program showing the use of Draw module with the MSX 2 bitmap screen modes.

• Showcased modules:
  • vdp (code)
  • draw (code)
• File: s_draw.c
• State: ✔️ Functional

32K

Graph Mode 3

Program showing the use of Screen 4 (aka Graph mode 3) with various configuration (including unofficial MSX configurations like "Screen 1.5").

• Showcased modules:
  • vdp (code)
• File: s_gm3.c
• State: ✔️ Functional

32K

Print

Program showing the use of graphical print features (bitmap, sprite, effects, etc.).

• Showcased modules:
  • print (code)
• File: s_print.c
• State: ✔️ Functional

32K

Sprite Mode 1

Program showing the use of sprite mode 1 and a Sprite Attribute Table flip method to reduce sprite disappearance.

• Showcased modules:
  • vdp (code)
• File: s_sm1.c
• State: ✔️ Functional

32K

Sprite Mode 2

Program showing the use of sprite mode 2 and split screen to change VDP setting during screen rendering.

• Showcased modules:
  • vdp (code)
• File: s_sprite.c
• State: ✔️ Functional

32K

Software Sprite

Program showing the use of software sprite for all bitmap modes using VDP commands.

• Showcased modules:
  • vdp (code)
• File: s_swsprt.c
• State: ✔️ Functional

32K

Software Tile

Program showing the use of software tile mode for MSX 2 bitmap modes (only Screen 5 & 8 has been tested).

• Showcased modules:
  • vdp (code)
• File: s_swtile.c
• State: ✔️ Functional

32K

Text

Program showing the use of print module with text modes (all MSX 1 and MSX 2 text/tiled mode).

• Showcased modules:
  • print (code)
• File: s_text.c
• State: ✔️ Functional

32K

VDP Command

Program showing the use of VDP command to draw several effect in all bitmap modes.

• Showcased modules:
  • vdp (code)
• File: s_vdpcmd.c
• State: ✔️ Functional

32K

Target format

Boot Disk

Program showing the use boot disk target format. The program will be start from disk without going through MSX-DOS but allow to use BDOS function.

• Showcased modules:
  • dos (code)
• File: s_dos0.c
• State: ❓ Partially functional

BOOT

MSX-DOS

Program showing the use of MSX-DOS 1 routines to load and display image from file.

• Showcased modules:
  • dos (code)
• File: s_dos.c
• State: ✔️ Functional

MSX-DOS

MSX-DOS 2

Program showing the use of various MSX-DOS 2 routines to load and display image, get disk information or handle mapped memory.

• Showcased modules:
  • dos (code)
  • dos_mapper (code)
• File: s_dos2.c
• State: ✔️ Functional

MSX-DOS 2

Mapped ROM

Program showing usage of mapped ROM and segments switching.

• File: s_mapper.c
• State: ✔️ Functional

ASCII8 128K

Utilities

BASIC USR

Program showing the creation of binary to be load and used from BASIC.

• Showcased modules:
  • basic_usr (code)
• File: s_usr.c
• State: ✔️ Functional

BIN (USR)

Compressor

Program showing the use of several compression algorithms (RLEp, Bitbuster 1 & 2, ZX0 and Pletter).

• Showcased modules:
  • compress (code)
  • compress/bitbuster (code)
  • compress/bitbuster2 (code)
  • compress/zx0 (code)
  • compress/pletter (code)
• File: s_zip.c
• State: ✔️ Functional

MSX-DOS

Game

Program showing the use of Game and Game pawn modules. The Game module offers state management while Game pawn allows to manage characters (display, animation, movement, collision, etc.)

• Showcased modules:
  • game (code)
  • game_pawn (code)
• File: s_game.c
• State: ✔️ Functional

32K

Math

Program showing the use of mathematics pre-computed tables, pseudo-random generator and quick-computation functions.

• Showcased modules:
  • math (code)
• File: s_math.c
• State: ✔️ Functional

32K

Scrolling

Program showing the use of multi-directionnal tile-based scrolling and screen adjust register for smooth scrolling.

• Showcased modules:
  • vdp (code)
  • scroll (code)
• File: s_scroll.c
• State: ✔️ Functional

32K

Devices

Joystick

Program showing the use of joystick and input manager.

• Showcased modules:
  • input (code)
  • input_manager (code)
• File: s_joystk.c
• State: ✔️ Functional

32K

Keyboard

Program showing the use of keyboard and input manager.

• Showcased modules:
  • input (code)
  • input_manager (code)
• File: s_keybrd.c
• State: ✔️ Functional

32K

Mouse

Program showing the use of mouse device and universal port (joystick port) device detection.

• Showcased modules:
  • input (code)
• File: s_mouse.c
• State: ✔️ Functional

32K

Ninja Tap

Program showing the use of NinjaTap device to connect up to 8 joysticks on one MSX machine.

• Showcased modules:
  • device/ninjatap (code)
• File: s_ntap.c
• State: ✔️ Functional

32K

ObsoNET

Program showing the use of ObsoNET cartridge using network stack.

• Showcased modules:
  • network/obsonet (code)
• File: s_onet.c
• State: ❓ Partially functional

16K

PAC

Program showing the use of PAC or FM-PAC to load/save data into SRAM.

• Showcased modules:
  • device/pac (code)
• File: s_pac.c
• State: ✔️ Functional

32K

V9990

Program showing the use of Yamaha V9990 based video cartridge.

• Showcased modules:
  • v9990 (code)
• File: s_v9990.c
• State: ✔️ Functional

32K

Audio Format

Arkos

Program showing the use of Arkos Tracker II's replayers.

• Showcased modules:
  • arkos/akg_player (code)
  • arkos/akm_player (code)
  • arkos/aky_player (code)
• File: s_arkos.c
• State: ✔️ Functional

ASCII8 128K

ayFX

Program showing the use of ayFX's replayer.

• Showcased modules:
  • ayfx/ayfx_player (code)
• File: s_ayfx.c
• State: ✔️ Functional

32K

lVGM

Program showing the use of light-VGM's replayer (PSG).

• Showcased modules:
  • lvgm/lvgm_player (code)
• File: s_lvgm.c
• State: ✔️ Functional

32K

PCM-Encoder

Program showing the use of the PCM Encoder's replayer (aka. Crystal clean PCM 8bit samples on the poor PSG).

• Showcased modules:
  • pcm/pcmenc (code)
• File: s_pcmenc.c
• State: ✔️ Functional

32K

PCM Play

Program showing the use of the PCM Play's replayer.

• Showcased modules:
  • pcm/pcmplay (code)
• File: s_pcmplay.c
• State: ✔️ Functional

32K

PT3

Program showing the use of Vortex Tracker II's replayer.

• Showcased modules:
  • pt3/pt3_player (code)
• File: s_pt3.c
• State: ✔️ Functional

32K

Trilo Tracker SCC

Program showing the use of Trilo Tracker SCC's replayer.

• Showcased modules:
  • trilo/trilo_scc_player (code)
• File: s_trilo.c
• State: ✔️ Functional

KONAMI 128K

VGM

Program showing the use of VGM's replayer (PSG, SCC, MSX-Music, MSX-Audio).

• Showcased modules:
  • vgm/vgm_player (code)
• File: s_vgm.c
• State: ✔️ Functional

ASCII16 256K

WYZ

Program showing the use of WYZ Tracker's replayer (version 0.3).

• Showcased modules:
  • wyz/wyz_player (code)
• File: s_wyz.c
• State: ✔️ Functional

32K

WYZ2

Program showing the use of WYZ Tracker's replayer (version 0.3 47d).

• Showcased modules:
  • wyz/wyz_player2 (code)
• File: s_wyz2.c
• State: ✔️ Functional

32K