Author: mvac7 [mvac7303b@gmail.com]
Architecture: MSX
Format: C Object (SDCC .rel)
Programming language: C and Z80 assembler
Open Source library with functions to directly access to Sprites of the TMS9918A.
Provides a set of functions for displaying Sprites, both fully (PUTSPRITE) and specific (positioning, color, pattern, visibility and EarlyClock).
Contains the PUTSPRITE function similar to that of MSX BASIC.
It is complemented with the VDP TMS9918A MSX Library, necessary for the initialization of the screen (screen and sprites mode).
It does not use the MSX BIOS, so it is suitable for creating applications for MSX-DOS and 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.
This library is part of the MSX fR3eL Project.
Enjoy it!
- v1.0 (04/05/2019) <>
- Small Device C Compiler (SDCC) v3.9 http://sdcc.sourceforge.net/
- Hex2bin v2.5 http://hex2bin.sourceforge.net/
- VDP TMS9918A MSX SDCC Library
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 >> ?
This library provides functions to facilitate the use of Sprites of the TMS9918A and is supported by the library VDP_TMS9918A_Lib, necessary for the initialization of the graphic modes and for the writing / reading of the VRAM.
It is designed for the creation of applications for MSX-DOS (.COM). It can be used for the development of ROMs, but I recommend the use of libraries based on the BIOS (VDP_TMS9918A_MSXROM_Lib and VDP_SPRITES_MSXROM_Lib), since they are lighter, thereby gaining more space for our software.
It is not useful for graphic mode G3 (screen 4), V9938 or higher, since it does not write in the color table of the sprites when a color is assigned or for the Early Clock. I have projected a specific library for this purpose.
- void PUTSPRITE(char plane, char x, char y, char color, char pattern) - Displays the sprite pattern.
- void SetSpritePattern(char plane, char pattern) - Assign a pattern to a sprite plane.
- void SetSpriteColor(char plane, char color) - Assign a color to a sprite plane.
- void SetSpritePosition(char plane, char x, char y) - Assigns the position coordinates of a sprite plane.
- void SetSpriteVisible(char plane, boolean state) - Hides or shows a sprite plane.
- void SetEarlyClock(char plane) - Apply the Early Clock of a sprite plane. Move 32 points to the left the X position of the sprite.
- void UnsetEarlyClock(char plane) - Disables the Early Clock. Restore the position of a sprite plane.