How do track and patterns work?

adekto · January 23, 2018, 6:05am

sound api is very undocumented and i really have no clue what anything is

im assuming track and pattern need a array of some sort of structured uint16_t data but i cant make out what the format is.
all i get is some static noise

im trying to playback sound from flash not sd

jonne · January 23, 2018, 1:28pm

I am so close to making a major update to this.

But if you choose to use PROJ_GBSOUND you can use 100% Gamebuino classic tracks, notes, patterns etc. (PROJ_ENABLE_SYNTH can not be used at the same time, and should be set to zero)

Reference to Gamebuino classic pattern/track structure can be found here:

uXe · January 9, 2020, 12:20pm

…hitting a wall on this - any old school Gamebuino coders here able to help decipher what the contents of these sound pattern arrays mean?!

github.com

Rodot/Super-Crate-Buino/blob/master/Super-Crate-Buino/Super-Crate-Buino.ino#L84


const __FlashStringHelper* popupText;


int toScreenX(int x) {
return x / SCALE - cameraX;
}


int toScreenY(int y) {
return y / SCALE - cameraY;
}


///////////////////////////////////////////// SOUNDS


const uint16_t player_damage_sound[] PROGMEM = {0x0045, 0x564, 0x0000};
const uint16_t revolver_sound[] PROGMEM = {0x0045, 0x7049, 0x17C, 0x784D, 0x42C, 0x0000};
const uint16_t grenade_sound[] PROGMEM = {0x0045, 0x012C, 0x0000};
const uint16_t machinegun_sound[] PROGMEM = {0x0045, 0x140, 0x8141, 0x7849, 0x788D, 0x52C, 0x0000};
const uint16_t rocket_sound[] PROGMEM = {0x8045, 0x8001, 0x8889, 0x3C5C, 0x0000};
const uint16_t blast_sound[] PROGMEM = {0x0045, 0x7849, 0x784D, 0xA28, 0x0000};
const uint16_t power_up_sound[] PROGMEM = {0x0005, 0x140, 0x150, 0x15C, 0x170, 0x180, 0x16C, 0x154, 0x160, 0x174, 0x184, 0x14C, 0x15C, 0x168, 0x17C, 0x18C, 0x0000};
const uint16_t enemy_death_sound[] PROGMEM = {0x0045, 0x184, 0x0000};
const uint16_t jump_sound[] PROGMEM = {0x0005, 0x7049, 0x884D, 0x354, 0x0000};

Pharap · January 10, 2020, 11:44pm

I can’t help, but I’d like to point out this is why I advocate using enumerations and structs to store sound data if possible rather than going for pure unsigned integers.

Apparently they realised this in time for the Meta:

This may be of use to you:

github.com

Gamebuino/Gamebuino-Classic/blob/ab82e57ec2efd280f7ad193be81ec8b88fd38c0b/utility/Sound.cpp#L146


}


void Sound::changePatternSet(const uint16_t* const* patterns, uint8_t channel){
#if(NUM_CHANNELS > 0)
	if(channel>=NUM_CHANNELS)
		return;
	patternSet[channel] = (uint16_t**)patterns;
#endif
}


void Sound::playPattern(const uint16_t* pattern, uint8_t channel){
#if(NUM_CHANNELS > 0)
	if(channel>=NUM_CHANNELS)
		return;
	stopPattern(channel);
	patternData[channel] = (uint16_t*)pattern;
	patternCursor[channel] = 0;
	patternIsPlaying[channel] = true;
	noteVolume[channel] = 9;
	//reinit commands
	volumeSlideStepDuration[channel] = 0;

github.com

Gamebuino/Gamebuino-Classic/blob/ab82e57ec2efd280f7ad193be81ec8b88fd38c0b/utility/Sound.cpp#L179


}


void Sound::changeInstrumentSet(const uint16_t* const* instruments, uint8_t channel){
#if(NUM_CHANNELS > 0)
	if(channel>=NUM_CHANNELS)
		return;
	instrumentSet[channel] = (uint16_t**)instruments;
#endif
}


void Sound::updatePattern(uint8_t i){
#if(NUM_CHANNELS > 0)
	if(i>=NUM_CHANNELS)
		return;
	if(patternIsPlaying[i]){
		if(noteDuration[i]==0){//if the end of the previous note is reached
			
			uint16_t data = pgm_read_word(patternCursor[i] + patternData[i]);
			
			if(data == 0){ //end of the pattern reached
				if(patternLooping[i] == true){

uXe · January 11, 2020, 6:33am

Yeah… it looks like decoding all of those bit shifts in updatePattern would lead to some enlightenment?