Author: mvac7 [mvac7303b@gmail.com]
Architecture: MSX
Format: C Object (SDCC .rel)
Programming language: C and Z80 assembler
Open Source library with basic functions to work with the TMS9918A video processor.
It uses the functions from the MSX BIOS, so it is designed to create applications in ROM format.
Use them for developing MSX applications using Small Device C Compiler (SDCC) cross compiler.
In the source code (\examples), you can find applications for testing and learning purposes.
If you need specific functions to manage Sprites, you can use any of the following libraries:
- SPRITES Small - Basic functions for managing Sprites. It is more compact so it takes up less space in our application.
- SPRITES - It includes the same functions as the Small version and adds to access specific parameters (positioning, color, pattern, visibility and EarlyClock).
- SPRITES 1/2 - Same as SPRITES but in the G3 screen mode (V9938), it treats the color parameters in a simplified way. Assign the color parameters and EarlyClock to all the lines of the Sprites.
- SPRITES DUMP (In development) - Uses a buffer in RAM that has to be dumped in each interruption. Includes a Sprite Flicker, to allow viewing up to 8 sprites per line.
You also have the VDP PRINT MSX SDCC Library, with functions for display text strings in the graphic modes of the TMS9918A (G1 and G2).
This library is part of the MSX fR3eL Project.
Enjoy it!
- v1.2 (22/12/2020) Conversion to source in C and added Sprite initialization functions.
- v1.1 (14/02/2014)
- v1.0 (11/02/2014)
- Small Device C Compiler (SDCC) v3.9 http://sdcc.sourceforge.net/
- Hex2bin v2.5 http://hex2bin.sourceforge.net/
I want to give a special thanks to all those who freely share their knowledge with the MSX developer community.
- Avelino Herrera > WEB
- Nerlaska > Blog
- Marq/Lieves!Tuore > Marq Lieves!Tuore
- Fubukimaru > Blog
- Andrear > Blog
- Ramones > MSXblog - MSXbanzai
- Sapphire/Z80ST > WEB
- Fernando García > youTube
- Eric Boez > gitHub
- MSX Assembly Page > WEB
- Portar MSX Tech Doc > WEB
- MSX Resource Center > WEB
- Karoshi MSX Community (RIP 2007-2020)
- BlueMSX emulator >> WEB
- OpenMSX emulator >> WEB
- Meisei emulator >> ?
- void SCREEN(char) - Sets the display mode of the screen.
- void SetSpritesSize(char size) - Set size type for the sprites.
- void SetSpritesZoom(boolean zoom) - Set zoom type for the sprites.
- void COLOR(char, char, char) - Specifies the ink, foreground and background colors.
- void VPOKE(unsigned int, char) - Writes a byte to the video RAM.
- char VPEEK(unsigned int) - Reads data from the video RAM.
- void FillVRAM(unsigned int, unsigned int, char) - Fill a large area of the VRAM of the same byte.
- void CopyToVRAM(unsigned int, unsigned int, unsigned int) - Block transfer from memory to VRAM.
- void CopyFromVRAM(unsigned int, unsigned int, unsigned int) - Block transfer from VRAM to memory.
- void SetVDP(char, char) - Writes a value in VDP registers.