Difference between revisions of "Modules/trilo/trilo scc player"
From MSX Game Library
< Modules
| Line 1: | Line 1: | ||
{{MODULE | {{MODULE | ||
| − | |name=trilo_scc_player | + | |name=trilo/trilo_scc_player |
|category=Audio | |category=Audio | ||
|dependency1= | |dependency1= | ||
Revision as of 18:34, 4 January 2024
The trilo_scc_player module lets you play music (using both PSG and SCC) and sound effects in Trilo Tracker format.
Contents
Usage
To use this module, include "trilo/trilo_scc_player.h" in your source code, and add "trilo/trilo_scc_player" to the modules list (LibModules) in your project's configuration file (project_config.js).
Music
Original TriloTracker music are in TMU format and have to be converted to ASM format first. Use tools/audio/trilo/tmucompile.bat script to generate the assembler file (the script convert TMU to ASM, then convert ASM to be supported by SDCC assembler, sdasz80).
The music have then to be add to program to be compiled together (music data format include global address, not relative ones). You can either include the ASM file music in an assembler segment, or you can use the INCLUDE_ASM() macro to include it into a C source.
Program
The current version of the module only support program on a SCC cartridge (mapped-ROM using ROM_KONAMI_SCC mapper).
SCC sound chip is visible to CPU through bank #2 (address 8000h to 9FFFh). As player have to switch this bank to SCC during playback, both the TriloTracker player and the music data must be in another bank.
Adding trilo_scc_player module in front of the modules list allow to put it in bank #0. Then, I advise you to put your music in the bank #3 (a classical bank to switch mapped-ROM segment).
Samples
See module use cases in the sample programs:
Settings
Library configuration (msxgl_config.h):
// TriloTracker options #define TRILO_USE_SFXPLAY TRUE // Add SFX playback through Trilo SCC player (ayFX + SCC format) #define TRILO_USE_TREMOLO TRUE // Add support for tremolo effect (little bit expensive) #define TRILO_USE_TAIL FALSE // Add tail to prevent volume to fall to zero
Dependencies
Dependency on other modules: None
Documentation
The trilo_scc_player module handle the playback of TriloTracker SCC musics and SFX.
Settings
- TRILO_USE_SFXPLAY: Add support for SFX playback (default: 1)
- TRILO_USE_TREMOLO: Add support for tremolo effect (default: 1)
- TRILO_USE_TAIL: Forces the volume to never go down to 0 (default: 0)
Usage
Music
Original TriloTracker music are in TMU format and have to be converted to ASM format first. Use tools/audio/trilo/tmucompile.bat script to generate the assembler file (the script convert TMU to ASM, then convert ASM to be supported by SDCC assembler, sdasz80).
The music have then to be add to program to be compiled together (music data format include global address, not relative ones). You can either include the ASM file music in an assembler segment, or you can use the INCLUDE_ASM() macro to include it into a C source.
Program
The current version of the module only support program on a SCC cartridge (mapped-ROM using ROM_KONAMI_SCC mapper).
SCC sound chip is visible to CPU through bank #2 (address 8000h to 9FFFh). As player have to switch this bank to SCC during playback, both the TriloTracker player and the music data must be in another bank.
Adding trilo_scc_player module in front of the modules list allow to put it in bank #0. Then, I advise you to put your music in the bank #3 (a classical bank to switch mapped-ROM segment).