====== Importing and Playing Music ======

Just like for graphical assets, sound assets need to be stored in the ''assets/<your dir>/'' directory and require to run ''make import'' to generate the necessary files. Contrary to the graphical assets they do not need to be loaded explicitly.

There are two types of sounds that can be played on the GameTank:

  * Songs
  * Sound Effects (SFX)

===== Enabling sounds =====

Enabling sounds requires the following in C:

  * Add ''#include "music.h"'' as an include file
  * Call ''init_audio_coprocessor()'' and ''init_music()'' at the beginning of the program
  * Call ''tick_music()'' for each screen refresh

e.g.

    init_audio_coprocessor();
    init_music();
    
    while (1) {
        // start a sound
        await_draw_queue();
        sleep(1);
        flip_pages();
        tick_music();
    }

===== Songs =====

Songs are imported from MIDI files and are called using ''play_song()'', e.g.

  #include "gen/assets/music.h"
  play_song(&ASSET__music__mytune_mid, REPEAT_LOOP);

===== Sound Effects (SFX) =====

SFX are mini-sample ''.sfx'' files generated by tools such as [[https://nickgirardo.com/gt-sound-sculptor/index.html|Sound Sculptor]]

  #include "gen/assets/sfx.h"
  play_sound_effect(&ASSET__sfx__bang_sfx , 1);