This is a non-exhaustive list of changes I've found to be needed when porting Tunernome. They should cut down on time required to port modes from 2023. If porting from pre-2023, check out this similar list I made last year.

Changes that involve re-design

mm.font has been removed. The closest font is logbook.font which is 3 pixels smaller in height. Arrows and symbol wsgs need to be updated for the smaller font too.
Accel, touch, and button callbacks no longer exist. Instead, checks must be done in the main loop function. This can be used to more easily adapt button callbacks to the new standard:

buttonEvt_t evt = {0};

while (checkButtonQueueWrapper(&evt))

{

// If processing menu buttons:

tunernome->menu = menuButton(tunernome->menu, evt);

// OR, if processing mode buttons:

tunernomeButtonCb(&evt);

}

...

// The rest of your mainLoop function

buttonEvt_t
A button event containing the button that triggered the event, whether it was pressed or released,...
Definition hdw-btn.h:117

menuButton
menu_t * menuButton(menu_t *menu, buttonEvt_t evt)
This must be called to pass button event from the Swadge mode to the menu. If a button is passed here...
Definition menu.c:791

checkButtonQueueWrapper
bool checkButtonQueueWrapper(buttonEvt_t *evt)
Service the queue of button events that caused interrupts This only returns a single event,...
Definition swadge2024.c:740

Things that need to be changed in mode header files

Add #include "swadge2024.h"
Naming conventions changed from mode_tunernome.h to tunernome.h. Don't forget to change your header guard names too:

_MODE_TUNERNOME_H_

_TUNERNOME_H_

Things that need to be added to enterMode() and exitMode() functions

tunernome->menuRenderer = initMenuManiaRenderer(NULL, NULL, NULL);
deinitMenuManiaRenderer(tunernome->renderer);

Things that need to be intelligently deleted

tunernome->disp

Things that need to be intelligently changed or replaced

The buzzer and song player have been replaced by a speaker and MIDI file player. The songs will remain as .midi or .mid files in assets/, but will now be accessible from the swadge as .mid files, rather than .sng files. The main changes modes will need to make due to this are replacing song_t with midiFile_t, and changing the name used to load the file from file.sng to file.mid. The other major change is that the shouldLoop property of song_t has no equivalent in MIDI songs. Instead, looping is enabled or disabled through the boolean midiPlayer_t::loop field.

Old	New
`modeTunernome`	`tunernomeMode`
`drawText(tunernome->disp,`	`drawText(`
`fillDisplayArea(tunernome->disp,`	`fillDisplayArea(`
`drawWsg(tunernome->disp,`	`drawWsg(`
`plotLine(tunernome->disp,`	`drawLine(`
`plotCircleQuadrants(tunernome->disp,`	`drawCircleQuadrants(`
`plotCircleFilled(tunernome->disp,`	`drawCircleFilled(`
`plotCircle(tunernome->disp,`	`drawCircle(`
`plotRect(tunernome->disp,`	`plotRect(`
`tunernome->disp->clearPx();`	`clearPxTft();`
`tunernome->disp->w`	`TFT_WIDTH`
`tunernome->disp->h`	`TFT_HEIGHT`
`ibm_vga8.h`	`ibm_vga8.height`
`mm.h`	`mm.height`
`radiostars.h`	`radiostars.height`
`loadFont(const char* name, font_t* font)`	`loadFont(const char* name, font_t* font, bool spiRam)`
`bool loadWsg(char* name, wsg_t* wsg)`	`bool loadWsg(char* name, wsg_t* wsg, bool spiRam)`
`menu->selectedRow`	`menu->currentItem`
`menu->rows`	`menu->items`
`initMeleeMenu(modeTunernome.modeName, &(tunernome->mm), tunernomeMainMenuCb);`	`initMenu(tunernomeMode.modeName, tunernomeMainMenuCb);`
`tunernomeMenuCb(const char* opt)`	`mainMenuCb(const char* label, bool selected, uint32_t settingVal)`
`drawMeleeMenu(tunernome->menu);`	`drawMenuMania(tunernome->menu, tunernome->renderer, elapsedUs);`
`loadSong(const char* name, song_t* song)`	`loadMidiFile(const char* name, midiFile_t* midi, bool useSpiRam)`
`freeSong(song_t* song)`	`unloadMidiFile(midiFile_t* midi)`

Things that can be find/replaced

Old	New
`swadgeMode`	`swadgeMode_t`
`NUM_LEDS`	`CONFIG_NUM_LEDS`
`#include "embeddednf.h"`	`#include "embeddedNf.h"`
`#include "embeddedout.h"`	`#include "embeddedOut.h"`
`embeddednf_data`	`embeddedNf_data`
`embeddedout_data`	`embeddedOut_data`
`FIXBPERO`	`FIX_B_PER_O`
`FIXBINS`	`FIX_BINS`
`UP`	`PB_UP`
`DOWN`	`PB_DOWN`
`LEFT`	`PB_LEFT`
`RIGHT`	`PB_RIGHT`
`BTN_A`	`PB_A`
`BTN_B`	`PB_B`
`START`	`PB_START`
`SELECT`	`PB_SELECT`
`buzzer_play_sfx(`	`bzrPlaySfx(`
`buzzer_play_bgm(`	`soundPlayBgm(`
`buzzer_stop(`	`soundStop(`
`incMicGain()`	`incMicGainSetting()`
`decMicGain()`	`decMicGainSetting()`
`getMicGain()`	`getMicGainSetting()`
`setMicGain()`	`setMicGainSetting()`
`setAndSaveLedBrightness(`	`setLedBrightnessSetting(`
`getTestModePassed(`	`getTestModePassedSetting(`
`setTestModePassed(`	`setTestModePassedSetting(`
`meleeMenu_t`	`menu_t`
`deinitMeleeMenu(`	`deinitMenu(`
`modeMainMenu`	`mainMenuMode`