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

Screen that chooses what kind of remix to work on. More...

#include <metremixtypescreen.h>

Inheritance diagram for MetRemixTypeScreen:
Collaboration diagram for MetRemixTypeScreen:

Public Member Functions

 MetRemixTypeScreen (MetRenderer *pRenderer, int nPriority)
 Construct the screen.
virtual ~MetRemixTypeScreen ()
virtual void EnterAndShow ()
 Show the screen with the buttons the game mode offers.
virtual void OnMsgScreenDismissed (const HxStr &name, int nChoice)
 Act on the answer to the low-space warning.
virtual void HandleCommand (const MetScreenCommand *pCommand)
 Act on one navigation command.
virtual void OnRepeatingSoundFinished (Rnd::Button *pButton)
 Leave for the chosen button once the selection alternation finishes.
virtual void OnExitFinished ()
 Move on once the screen has exited.
virtual void ResolveContainerViews ()
 Resolve the container views and the two button-layout views and animations.
virtual void PlayCycleLeftSound (int)
 Silence the cycle-left sound.
virtual void PlayCycleRightSound (int)
 Silence the cycle-right sound.
Public Member Functions inherited from MetScreen
 MetScreen (MetRenderer *pRenderer, int nPriority, const HxStr &name, const HxStr &directory, const HxStr &file)
 Construct a screen and start its container load.
virtual ~MetScreen ()
 Unregister from the renderer and release the container.
void DeliverCommand (const MetScreenCommand *pCommand)
 Play the sound one navigation command calls for and then act on the command.
void UpdateAnimationFrame (float flTime)
 Drive the frame of whichever animation is running and run the idle hook when none is.
void UpdateFrame (float flTime)
 Advance one screen by one frame.
virtual void PushNamedScreen (const HxStr &name)
 Bring one named screen onto the renderer's screen stack.
virtual void ActivateNamedPanel (const HxStr &name)
 Make one named screen the renderer's active panel.
virtual void OnPanelActivated ()
 Act on this screen having become the renderer's active panel.
virtual void ExitScreenByName (const HxStr &name)
 Start one named screen's exit animation.
virtual void BeginExit ()
 Start this screen's exit animation at the renderer's current time.
virtual void OnUnusedHook ()
 Do nothing.
virtual void OnKeyboardDismissed ()
 Take control back after the keyboard screen has finished.
virtual void OnDrawPass ()
 Contribute to the renderer's draw pass.
virtual void OnDestroying ()
 Release what the screen acquired, ahead of the rest of destruction.
virtual int PollContainerLoad ()
 Advance this screen's container load and resolve its views once the load finishes.
virtual void OnMsgScreenShown (const HxStr &name)
 Act on a message dialogue becoming visible.
virtual void SetShowing (int nShowing)
 Show or hide the view and every drawable the container loaded.
virtual void BeginContainerLoad (const HxStr &directory, const HxStr &file)
 Intern a container load under this screen's container name and enqueue it.
virtual void PlaySlideSound (int nSelector)
 Play the sound that accompanies sliding between screens.
virtual void PlayLeaveSound (int nSelector)
 Play the sound that accompanies departing a screen.
virtual void PlayHighSound (int nSelector)
 Play the sound that accompanies the emphasised selection.
virtual void PlayErrorSound (int nSelector)
 Play the sound that accompanies a rejected input.
virtual void UpdateIdle (float flTime)
 Advance whatever the screen updates once per frame while it is idle.
virtual void UpdateIdleAnimation (float flTime)
 Advance whatever the screen animates while it is neither entering nor exiting.
virtual void StartRepeatingSound (float flStartTime, float flInterval, Rnd::Button *pButton, int nCycles)
 Start alternating one button between its states 2 and 1.
virtual void UpdateRepeatingSound (float flTime)
 Advance the alternation that StartRepeatingSound() started.
virtual void StartEnterAnimation (float flTime)
 Rewind the enter animation and record the time it starts at.
virtual void UpdateEnterAnimation (float flTime)
 Drive the enter animation and finish it once it passes its end.
virtual void OnEnterFinished ()
 Act on the enter animation having finished.
virtual void StartExitAnimation (float flTime)
 Record the time the exit animation starts at.
virtual void UpdateExitAnimation (float flTime)
 Drive the exit animation and hide the screen once it passes its end.
virtual void Draw ()
 Draw the view.
Public Member Functions inherited from MsgSink
void * operator new (size_t nSize)
 Allocate a sink from the tagged heap under the tag "MsgSink".
void operator delete (void *pBlock)
 Release a sink to the tagged heap.
virtual ~MsgSink ()
virtual void Dispatch (Message *pMsg)
 Accept a message.

Static Public Member Functions

static MetRemixTypeScreen * New (MetRenderer *pRenderer, int nPriority)
 Build the screen on the heap.
Static Public Member Functions inherited from MetScreen
static std::map< HxStr, MetContainerLoad * > & ContainerLoaderMap ()
 Shared table of container loads, interned under the container name.
static std::map< HxStr, MetScreenEntry > & ScreenRegistry ()
 Shared table of live screens, interned under the screen registry key.
static MetScreen * FindScreenByName (const HxStr &name)
 Resolve one screen by its registry key.
static MetScreen * FindEndScreen (MetRenderer *pRenderer, const HxStr &name)
 Resolve one end-of-game screen by its registry key, failing fatally when it is absent.
static void CreateMainMenuScreens (MetRenderer *pRenderer)
 Create the main-menu screens.
static void DestroyAllScreens ()
 Delete every registered screen and release every container loader.
static void CreateStartupScreens (MetRenderer *pRenderer)
 Create the four screens the front end needs before its containers have loaded.
static void CreateFrontEndScreens (MetRenderer *pRenderer)
 Create every remaining front-end screen, once.
static void DestroyCategory2Screens ()
 Delete and unregister every screen in category 2.
static void DestroyCategory1Screens ()
 Delete and unregister every screen in category 1.
static void DestroyNonDefaultScreens ()
 Delete and unregister every screen outside category 0, then rewind the rndMetLocAndNet zone.
static void PollContainerLoads ()
 Poll every container load that has not finished, and hide the drawables of each that does.

Additional Inherited Members

Public Attributes inherited from MetScreen
Rnd::View * mView
 The container's root view.
int mEnterPending
 Set when the screen was pushed before its container load finished.
int mActivatePending
 Set when the screen was activated as a panel before its container load finished.
float mRepeatScale
 Scale on the input auto-repeat interval.
Protected Member Functions inherited from MetScreen
virtual void DispatchPriv (Message *pMsg)
 Act on a message.
void ResolveAnimationViews ()
 Resolves the two animation views from the screen name and records the enter animation's end frame.
Protected Attributes inherited from MetScreen
float mAnimEndFrame
float mEnterStartTime
MetRenderer * mRenderer
int mExitChoice
int mAcceptsCommands
Rnd::View * mEnterAnim
std::vector< HxStr > mHelpKeys
int mViewsUnresolved
int mPlaysCommandSounds
int mShowsLoadedDrawables

Detailed Description

Screen that chooses what kind of remix to work on.

Its RTTI descriptor is at 0x00901c20. It has MetScreen as its one public non-virtual base at offset 0. The factory at 0x00369638 fixes the object at 0xa0 bytes by requesting exactly that many. The 39-entry vtable is at 0x00808760, the same length as the MetScreen table, and the class declares no new virtual.

The constructor at 0x00361d18 takes only the renderer and the load priority, and supplies smrt for the screen name, metagame/Shared for the directory, and sm_remixtype for the container. It pushes three object names into the container object-name vector that MetScreen owns, smrt_new, smrt_load, and smrt_jukebox, and then allocates a MetButtonList tagged MetButtonList into the one member below.

The destructor at 0x003696c0 restores the vptr, deletes mButtons through slot 1 of the MetButtonList table with the deleting __in_chrg value, runs the MetScreen destructor, and releases the object with the tag MsgSink.

Nine slots differ from the MetScreen table. Slots 23 and 24 sit eight bytes apart at 0x00369628 and 0x00369630 and are two-instruction jr ra stubs. The others are the destructor, 5 0x00362600, 15 0x00364478, 19 0x00362348, 30 0x00362fa0, 36 0x00363920, and 38 0x00362098.

Constructor & Destructor Documentation

◆ MetRemixTypeScreen()

MetRemixTypeScreen::MetRemixTypeScreen ( MetRenderer * pRenderer,
int nPriority )

Construct the screen.

Parameters
pRendererThe front-end renderer this screen registers on.
nPriorityThe load priority.
Ghidra address:
NTSC-U/C: 0x00361d18
Ghidra address:
PAL: 0x0038f220

◆ ~MetRemixTypeScreen()

virtual MetRemixTypeScreen::~MetRemixTypeScreen ( )
virtual
Ghidra address:
NTSC-U/C: 0x003696c0
Ghidra address:
PAL: 0x00397740

Member Function Documentation

◆ New()

MetRemixTypeScreen * MetRemixTypeScreen::New ( MetRenderer * pRenderer,
int nPriority )
static

Build the screen on the heap.

The routine at 0x00385180 that creates every front-end screen is the caller.

Parameters
pRendererThe front-end renderer the screen registers on.
nPriorityThe load priority.
Returns
The new screen.
Ghidra address:
NTSC-U/C: 0x00369638
Ghidra address:
PAL: 0x003976b8

◆ EnterAndShow()

virtual void MetRemixTypeScreen::EnterAndShow ( )
virtual

Show the screen with the buttons the game mode offers.

Slot 5. A solo game offers the new, load, and jukebox buttons over the three-button view, and any other mode offers the first two over the two-button view. A pending front-end transition first brings up the gizmo and help screens and clears the loading flag in the game parameters.

Ghidra address:
NTSC-U/C: 0x00362600
Ghidra address:
PAL: 0x0038fcb0

Reimplemented from MetScreen.

◆ OnMsgScreenDismissed()

virtual void MetRemixTypeScreen::OnMsgScreenDismissed ( const HxStr & name,
int nChoice )
virtual

Act on the answer to the low-space warning.

Slot 15. Only the warn_remix_no_space dialogue is handled. Its first button, BACK, brings the help, gizmo, and remix-type screens back and makes this screen the active panel, and any other choice proceeds with the selected button.

Parameters
nameThe dialogue name.
nChoiceThe index of the button chosen.
Ghidra address:
NTSC-U/C: 0x00364478
Ghidra address:
PAL: 0x003922e8

Reimplemented from MetScreen.

◆ HandleCommand()

virtual void MetRemixTypeScreen::HandleCommand ( const MetScreenCommand * pCommand)
virtual

Act on one navigation command.

Slot 19. The two ring steps move the selection and refresh the help text, select starts the selection alternation, and back exits toward the title screen.

Parameters
pCommandThe command.
Ghidra address:
NTSC-U/C: 0x00362348
Ghidra address:
PAL: 0x0038f978

Reimplemented from MetScreen.

◆ OnRepeatingSoundFinished()

virtual void MetRemixTypeScreen::OnRepeatingSoundFinished ( Rnd::Button * pButton)
virtual

Leave for the chosen button once the selection alternation finishes.

Slot 30. The help screen is exited only when a button other than the first is selected. The European release always exits it.

Parameters
pButtonThe button whose alternation finished, which is not read.
Ghidra address:
NTSC-U/C: 0x00362fa0
Ghidra address:
PAL: 0x00390848

Reimplemented from MetScreen.

◆ OnExitFinished()

virtual void MetRemixTypeScreen::OnExitFinished ( )
virtual

Move on once the screen has exited.

Slot 36. After a back command the mode screen is brought up. The new and load buttons raise the warn_remix_no_space dialogue when a memory card is in use in a solo game and the first card slot's GlobalSettings::mCardSlots entry reports less than GlobalSettings::mMinimumFreeClusters, and otherwise proceed with the selected button. The jukebox button lists the remixes on the card and the disc with MetJukeboxTopButtonsScreen and MetHelpScreen as the screens to return to, and also loads the playlist.

The European release raises the dialogue only when GlobalSettings::mCardSlots is not empty, and formats GlobalSettings::mMinimumFreeClusters into the dialogue text. The German text also receives FirstCardSlotName() ahead of it. After a back command it also pushes the help screen.

Ghidra address:
NTSC-U/C: 0x00363920
Ghidra address:
PAL: 0x00391470

Reimplemented from MetScreen.

◆ ResolveContainerViews()

virtual void MetRemixTypeScreen::ResolveContainerViews ( )
virtual

Resolve the container views and the two button-layout views and animations.

Slot 38.

Ghidra address:
NTSC-U/C: 0x00362098
Ghidra address:
PAL: 0x0038f648

Reimplemented from MetScreen.

◆ PlayCycleLeftSound()

virtual void MetRemixTypeScreen::PlayCycleLeftSound ( int )
inlinevirtual

Silence the cycle-left sound.

Both overrides are two-instruction stubs, so each was written inline with an empty body.

Ghidra address:
NTSC-U/C: 0x00369628
Ghidra address:
PAL: 0x003976a8

Reimplemented from MetScreen.

◆ PlayCycleRightSound()

virtual void MetRemixTypeScreen::PlayCycleRightSound ( int )
inlinevirtual

Silence the cycle-right sound.

Ghidra address:
NTSC-U/C: 0x00369630
Ghidra address:
PAL: 0x003976b0

Reimplemented from MetScreen.


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