View source for Modules/trilo/trilo scc player

The {{MOD|trilo_scc_player}} module handle the playback of [http://trilobyte-msx.com/TriloTracker/index.php/Main_Page TriloTracker] SCC musics and SFX.

== Dependencies ==
* ''None''

== Settings ==
* <tt>TRILO_USE_SFXPLAY</tt>: Add support for SFX playback (default: 1)
* <tt>TRILO_USE_TREMOLO</tt>: Add support for tremolo effect (default: 1)
* <tt>TRILO_USE_TAIL</tt>: 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 <tt>tools/audio/trilo/tmucompile.bat</tt> 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 <tt>INCLUDE_ASM()</tt> 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 <tt>[[Targets#Mapped_ROM_program|ROM_KONAMI_SCC]]</tt> 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 {{MOD|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).

== Annexe ==
* See also: Sample program {{SAMPLE|s_trilo}}

== Documentation ==
{{FRAME_DOC|trilo/trilo_scc_player}}