resonance 1.0.1
Loading...
Searching...
No Matches
MemcardUser Class Reference

Receiver notified once a memory-card task has finished. More...

#include <memcarduser.h>

Inheritance diagram for MemcardUser:

Public Member Functions

virtual ~MemcardUser ()
 Release the receiver.
virtual void OnConnectState (MemcardConnectState state, int nStatus)
 Report the state of one slot.
virtual void OnAllConnectStates ()
 Report that every slot has been enquired about.
virtual void OnMinimumSaveSpace (int nPortSlot, int nSpace)
 Report the space a save would need against the space a card has.
virtual void OnCardFormatted (int nPortSlot, int nStatus)
 Report a finished format.
virtual void OnCardUnformatted (int nPortSlot, int nStatus)
 Report a finished unformat.
virtual void OnPersonasSaved (int nPortSlot, int nStatus)
 Report a finished save of the FreQ roster.
virtual void OnRemixSaved (int nPortSlot, int nStatus)
 Report a finished save of one remix.
virtual void OnGlobalSettingsSaved (int nPortSlot, int nStatus)
 Report a finished save of the global settings.
virtual void OnJukeboxPlayListSaved (int nPortSlot, int nStatus)
 Report a finished save of a jukebox playlist.
virtual void OnRemixesListed (int nPortSlot, int nStatus)
 Report a finished listing of the saved remixes.
virtual void OnRemixLoaded (int nPortSlot, int nStatus)
 Report a finished load of one remix.
virtual void OnPersonasLoaded (int nPortSlot, int nStatus)
 Report a finished load of the FreQ roster.
virtual void OnGlobalSettingsLoaded (int nPortSlot, int nStatus)
 Report a finished load of the global settings.
virtual void OnJukeboxPlayListLoaded (int nPortSlot, int nStatus)
 Report a finished load of a jukebox playlist.
virtual void OnRemixDeleted (int nPortSlot, int nStatus)
 Report a finished deletion of one remix.
virtual void UnusedFirstReport (int nPortSlot, int nStatus)
 Do nothing.
virtual void UnusedSecondReport (int nPortSlot, int nStatus)
 Do nothing.
virtual void OnFileLoaded (int nStatus)
 Report a finished load of one file.
virtual void OnFileSaved (int nStatus)
 Report a finished save of one file.

Detailed Description

Receiver notified once a memory-card task has finished.

Its RTTI descriptor is at 0x0086f618. It has no base class and no data members. An instance is the four-byte vptr alone, and the vtable is at 0x007daf78.

The interface declares one method per MemcardTask subclass, and every body is a single jr ra. An implementation overrides only the tasks it starts. Each method is pinned to its task by the task's reporting virtual. The reporting virtual reads one fixed vtable slot of the user the task was constructed with.

Ten front-end screens derive from this interface alongside MetScreen, at offset 140 or 164, and four of the remix tasks derive from it as well, at offset 28. Each of those four runs an inner LoadFileMCT or SaveFileMCT and receives the inner task's report here.

Every method title is inferred from the task that reports through the slot. No string in the image identifies any of them. No task reports through two of the slots, and both are recorded below as unrecovered.

Constructor & Destructor Documentation

◆ ~MemcardUser()

virtual MemcardUser::~MemcardUser ( )
virtual

Release the receiver.

Occupies vtable slot 1. The body is empty.

Ghidra address:
NTSC-U/C: 0x00184448
Ghidra address:
PAL: 0x00189730

Member Function Documentation

◆ OnConnectState()

virtual void MemcardUser::OnConnectState ( MemcardConnectState state,
int nStatus )
virtual

Report the state of one slot.

Slot 2, from GetConnectStateMCT.

The state arrives by value. The slot's compiled body therefore destroys the argument's string rather than being empty like the rest.

Parameters
stateWhat the slot reported.
nStatusOne of MemcardStatus.
Ghidra address:
NTSC-U/C: 0x00184478
Ghidra address:
PAL: 0x00189760

Reimplemented in MetGlobalSettingsSaverScreen, MetMCFreqDelScreen, MetPersonaSaverScreen, and MetSaveRemix.

◆ OnAllConnectStates()

virtual void MemcardUser::OnAllConnectStates ( )
virtual

Report that every slot has been enquired about.

Slot 3, from GetAllConnectStatesMCT.

The task reports each slot through OnConnectState() as its enquiry finishes, and reports here once with no argument when the last of them is done.

Ghidra address:
NTSC-U/C: 0x001844a0
Ghidra address:
PAL: 0x00189798

Reimplemented in MetMemDetectScreen.

◆ OnMinimumSaveSpace()

virtual void MemcardUser::OnMinimumSaveSpace ( int nPortSlot,
int nSpace )
virtual

Report the space a save would need against the space a card has.

Slot 4, from MinimumSaveSpaceMCT.

The second argument is the task's measurement rather than its status. This slot is the only one that does not receive a MemcardStatus.

The European release adds nSkipWarning and nCampaign. MinimumSaveSpaceMCT passes two members that only its constructor writes, with zero. Their titles are inferred from MetMemDetectScreen::OnMinimumSaveSpace(), the one override that reads them.

Parameters
nPortSlotThe packed port and slot.
nSpaceThe measurement.
nSkipWarningNon-zero to show no space warning at all. European release only.
nCampaign1 to warn against the smaller campaign requirement. European release only.
Ghidra address:
NTSC-U/C: 0x001844a8
Ghidra address:
PAL: 0x001897a0

Reimplemented in MetMemDetectScreen.

◆ OnCardFormatted()

virtual void MemcardUser::OnCardFormatted ( int nPortSlot,
int nStatus )
virtual

Report a finished format.

Slot 5, from FormatCardMCT when it was requested to format.

Parameters
nPortSlotThe packed port and slot.
nStatusOne of MemcardStatus.
Ghidra address:
NTSC-U/C: 0x001844b0
Ghidra address:
PAL: 0x001897a8

Reimplemented in MetGlobalSettingsSaverScreen, MetMemDetectScreen, MetPersonaSaverScreen, MetRemixManager, and MetSaveRemix.

◆ OnCardUnformatted()

virtual void MemcardUser::OnCardUnformatted ( int nPortSlot,
int nStatus )
virtual

Report a finished unformat.

Slot 6, from FormatCardMCT when it was requested to unformat.

Parameters
nPortSlotThe packed port and slot.
nStatusOne of MemcardStatus.
Ghidra address:
NTSC-U/C: 0x001844b8
Ghidra address:
PAL: 0x001897b0

◆ OnPersonasSaved()

virtual void MemcardUser::OnPersonasSaved ( int nPortSlot,
int nStatus )
virtual

Report a finished save of the FreQ roster.

Slot 7, from SavePersonasMCT.

Parameters
nPortSlotThe packed port and slot.
nStatusOne of MemcardStatus.
nKilobytesSaveFileMCT::mKilobytes, the kilobytes the card lacked when nStatus is kMemcardStatusCardFull. European release only.
Ghidra address:
NTSC-U/C: 0x001844c0
Ghidra address:
PAL: 0x001897b8

Reimplemented in MetPersonaSaverScreen.

◆ OnRemixSaved()

virtual void MemcardUser::OnRemixSaved ( int nPortSlot,
int nStatus )
virtual

Report a finished save of one remix.

Slot 8, from SaveRemixMCT.

Parameters
nPortSlotThe packed port and slot.
nStatusOne of MemcardStatus.
nKilobytesSaveFileMCT::mKilobytes, the kilobytes the card lacked when nStatus is kMemcardStatusCardFull. European release only.
Ghidra address:
NTSC-U/C: 0x001844c8
Ghidra address:
PAL: 0x001897c0

Reimplemented in MetSaveRemix.

◆ OnGlobalSettingsSaved()

virtual void MemcardUser::OnGlobalSettingsSaved ( int nPortSlot,
int nStatus )
virtual

Report a finished save of the global settings.

Slot 9, from SaveGlobalSettingsMCT.

Parameters
nPortSlotThe packed port and slot.
nStatusOne of MemcardStatus.
nKilobytesSaveFileMCT::mKilobytes, the kilobytes the card lacked when nStatus is kMemcardStatusCardFull. European release only.
Ghidra address:
NTSC-U/C: 0x001844d0
Ghidra address:
PAL: 0x001897c8

Reimplemented in MetGlobalSettingsSaverScreen.

◆ OnJukeboxPlayListSaved()

virtual void MemcardUser::OnJukeboxPlayListSaved ( int nPortSlot,
int nStatus )
virtual

Report a finished save of a jukebox playlist.

Slot 10, from SaveJukeboxPlayListMCT.

Parameters
nPortSlotThe packed port and slot.
nStatusOne of MemcardStatus.
nKilobytesSaveFileMCT::mKilobytes, the kilobytes the card lacked when nStatus is kMemcardStatusCardFull. European release only.
Ghidra address:
NTSC-U/C: 0x001844d8
Ghidra address:
PAL: 0x001897d0

Reimplemented in MetRemixManager.

◆ OnRemixesListed()

virtual void MemcardUser::OnRemixesListed ( int nPortSlot,
int nStatus )
virtual

Report a finished listing of the saved remixes.

Slot 11, from ListRemixesMCT.

Parameters
nPortSlotThe packed port and slot.
nStatusOne of MemcardStatus.
Ghidra address:
NTSC-U/C: 0x001844e0
Ghidra address:
PAL: 0x001897d8

Reimplemented in MetRemixManager, and MetSaveRemix.

◆ OnRemixLoaded()

virtual void MemcardUser::OnRemixLoaded ( int nPortSlot,
int nStatus )
virtual

Report a finished load of one remix.

Slot 12, from LoadRemixMCT.

Parameters
nPortSlotThe packed port and slot.
nStatusOne of MemcardStatus.
Ghidra address:
NTSC-U/C: 0x001844e8
Ghidra address:
PAL: 0x001897e0

Reimplemented in MetRemixDelScreen, and MetRemixManager.

◆ OnPersonasLoaded()

virtual void MemcardUser::OnPersonasLoaded ( int nPortSlot,
int nStatus )
virtual

Report a finished load of the FreQ roster.

Slot 13, from LoadPersonasMCT.

Parameters
nPortSlotThe packed port and slot.
nStatusOne of MemcardStatus.
Ghidra address:
NTSC-U/C: 0x001844f0
Ghidra address:
PAL: 0x001897e8

Reimplemented in MetLocPickCharScreen, MetMCFreqDelScreen, MetMemDetectScreen, and MetPersonaSaverScreen.

◆ OnGlobalSettingsLoaded()

virtual void MemcardUser::OnGlobalSettingsLoaded ( int nPortSlot,
int nStatus )
virtual

Report a finished load of the global settings.

Slot 14, from LoadGlobalSettingsMCT.

Parameters
nPortSlotThe packed port and slot.
nStatusOne of MemcardStatus.
Ghidra address:
NTSC-U/C: 0x001844f8
Ghidra address:
PAL: 0x001897f0

Reimplemented in MetMemDetectScreen.

◆ OnJukeboxPlayListLoaded()

virtual void MemcardUser::OnJukeboxPlayListLoaded ( int nPortSlot,
int nStatus )
virtual

Report a finished load of a jukebox playlist.

Slot 15, from LoadJukeboxPlayListMCT.

Parameters
nPortSlotThe packed port and slot.
nStatusOne of MemcardStatus.
Ghidra address:
NTSC-U/C: 0x00184500
Ghidra address:
PAL: 0x001897f8

Reimplemented in MetRemixManager.

◆ OnRemixDeleted()

virtual void MemcardUser::OnRemixDeleted ( int nPortSlot,
int nStatus )
virtual

Report a finished deletion of one remix.

Slot 16, from DeleteRemixMCT.

Parameters
nPortSlotThe packed port and slot.
nStatusOne of MemcardStatus.
Ghidra address:
NTSC-U/C: 0x00184508
Ghidra address:
PAL: 0x00189800

Reimplemented in MetRemixDelScreen.

◆ UnusedFirstReport()

virtual void MemcardUser::UnusedFirstReport ( int nPortSlot,
int nStatus )
virtual

Do nothing.

Slot 17. No task in the image reports through this slot and no subclass overrides it. Its purpose and argument list cannot be established. The two arguments are declared to match every neighbouring slot.

Parameters
nPortSlotThe packed port and slot.
nStatusOne of MemcardStatus.
Ghidra address:
NTSC-U/C: 0x00184510
Ghidra address:
PAL: 0x00189808

◆ UnusedSecondReport()

virtual void MemcardUser::UnusedSecondReport ( int nPortSlot,
int nStatus )
virtual

Do nothing.

Slot 18. Recorded on the same evidence as UnusedFirstReport().

Parameters
nPortSlotThe packed port and slot.
nStatusOne of MemcardStatus.
Ghidra address:
NTSC-U/C: 0x00184518
Ghidra address:
PAL: 0x00189810

◆ OnFileLoaded()

virtual void MemcardUser::OnFileLoaded ( int nStatus)
virtual

Report a finished load of one file.

Slot 19, from LoadFileMCT.

The slot receives the status alone, without a port and slot. Only the two inner file tasks report this way.

Parameters
nStatusOne of MemcardStatus.
Ghidra address:
NTSC-U/C: 0x00184520
Ghidra address:
PAL: 0x00189818

Reimplemented in DeleteRemixMCT, ListRemixesMCT, LoadRemixMCT, and SaveRemixMCT.

◆ OnFileSaved()

virtual void MemcardUser::OnFileSaved ( int nStatus)
virtual

Report a finished save of one file.

Slot 20, from SaveFileMCT.

Parameters
nStatusOne of MemcardStatus.
Ghidra address:
NTSC-U/C: 0x00184528
Ghidra address:
PAL: 0x00189820

Reimplemented in DeleteRemixMCT, and SaveRemixMCT.


The documentation for this class was generated from the following file: