wavelength 1.0.0
Loading...
Searching...
No Matches
SongSelList Class Reference

The list of the songs to choose from online, whose selection shows in the panel the description's pic_panel names. More...

#include <songsellist.h>

Inheritance diagram for SongSelList:
Collaboration diagram for SongSelList:

Public Member Functions

 ~SongSelList () override=default
 Destroy the object.
 SongSelList (DataArray *pData, const char *pszPanel)
 Construct the list from its script description, listing nothing.
void UpdateRow (int nRow, int nItem) override
 Fill a row with a choice, or with the short artist of a song.
void UpdateCursor () override
 Move the cursor, and show the genre and the band picture of the selected song, or the label and the arena picture of the selected choice.
void SetSongs (const std::vector< String > &songs, int nChoiceCount)
 Replace the listed items and show them.
const std::vector< String > & GetSongs () const
std::vector< String > & GetSongs ()
Public Member Functions inherited from FreqList
 ~FreqList () override=default
 Destroy the object.
 FreqList (DataArray *pData, const char *pszPanel)
 Construct the list from its script description.
void ScrollUp () override
 Select the previous item, and play the sound of the up button when the selection moved.
void ScrollDown () override
 Select the next item, and play the sound of the down button when the selection moved.
Public Member Functions inherited from UIList
 UIList (DataArray *pData, const char *pszPanel)
 Construct a list from its script description, cloning the template row once for each row.
 ~UIList () override
 Destroy the row clones and every object cloned with them.
bool DispatchPriv (Message *pMsg) override
 Pass a controller button to HandleJoypad().
void Print (PrnStream &stream) override
 Write a description of the list.
virtual void SetCursorSelected (bool bSelected)
 Give the cursor the material of the selected or of the normal state.
virtual bool HandleJoypad (JoypadInputMsg *pMsg)
 Scroll for up and down, and pass the cross button to the panel's cursor component.
RndView * CloneRow (int nRow, RndView *pTemplate)
 Clone the template row for one row.
void BuildRowCells (RndView *pRow)
 Record the cells of a row, emptying each text and hiding each mesh.
void SetCellMat (int nRow, int nColumn, RndMat *pMat)
 Show the mesh of a cell with a material.
void SetCellText (int nRow, int nColumn, const char *pszText)
 Set the text of a cell.
void SetCellFont (int nRow, int nColumn, RndFont *pFont)
 Set the font of a cell's text.
void SetRowFont (int nRow, RndFont *pFont)
 Set the font of every text of a row.
void SetSelected (int nSelected)
 Select an item, keeping the number of items.
void Refresh (int nItemCount, int nSelected)
 Set the number of items and the selection, and fill the rows.
int GetSelected () const
int GetItemCount () const
int GetRowCount () const
RndMesh * GetUpArrow () const
RndMesh * GetDownArrow () const
void SetShowUpArrow (int nShow)
void SetShowDownArrow (int nShow)
Public Member Functions inherited from UIComponent
 UIComponent (DataArray *pData)
 Construct a showing component in the normal state.
bool Dispatch (Message *pMsg) override
 Offer a message to the focused panel of the current screen, then handle it here.
virtual bool IsShowing () const
 Report whether the component is showing.
virtual void SetShowing (bool bShowing)
 Show or hide the component.
virtual const char * Text () const
 Report the text the component shows.
virtual void SetText (const char *pszText)
 Replace the text the component shows.
virtual int GetState () const
 Report the state the component shows.
virtual void SetState (int nState, bool bForce)
 Change the state the component shows.
virtual void Focus ()
 React to the panel giving the component the focus.
virtual void Unfocus ()
 React to the panel taking the focus away.
virtual void Poll (float fTime)
 Advance the component to a time.
const char * GetName () const
int GetShowing () const
Public Member Functions inherited from MsgSink
void * operator new (size_t nSize)
 Allocate a sink from the pool heaps under the tag "MsgSink".
void operator delete (void *pBlock)
 Return a sink to the pool heaps.
virtual ~MsgSink ()
void * operator new (size_t size)
 Allocate from the main heap under the name MsgSink.
void operator delete (void *mem)
 Return memory to its heap.
virtual ~MsgSink ()
 Destroy the sink.

Static Public Member Functions

static UIComponent * New (DataArray *pData, const char *pszPanel)
 Create a list from its script description.
Static Public Member Functions inherited from UIList
static UIComponent * New (DataArray *pData, const char *pszPanel)
 Create a list from its script description.
Static Public Member Functions inherited from UIComponent
static void Init (DataArray *pConfig)
 Read the parameters of the flash a button shows when it is chosen.

Additional Inherited Members

Public Types inherited from UIComponent
enum  State { kStateNormal = 0 , kStateSelected = 1 , kStateDisabled = 2 }
 The state a component shows, the values of mState and the index UIStyle selects with. More...
Static Public Attributes inherited from UIList
static constexpr int kKeepSelection = -99999
 The value of Refresh()'s selection that keeps the selected item.
Protected Attributes inherited from UIList
UIStyle * mStyle
int mItemCount
int mRowCount
int mColumnCount
int mCursorRow
int mSelected
int mRowPitch
std::list< std::vector< Cell > > mRowCells
std::vector< RndView * > mRows
std::vector< RndText * > mTextCells
const char * mPanelName
RndMesh * mCursor
RndMesh * mUpArrow
RndMesh * mDownArrow
Transform mCursorXfm
int mShowUpArrow
int mShowDownArrow
Protected Attributes inherited from UIComponent
const char * mName
int mShowing
int mState
Static Protected Attributes inherited from UIComponent
static int sNumFlashes
 Number of times a chosen button flashes before it reports the choice.
static float sSelectedMs
 Milliseconds of each flash a chosen button spends in the selected state.
static float sNormalMs
 Milliseconds of each flash a chosen button spends in the normal state.

Detailed Description

The list of the songs to choose from online, whose selection shows in the panel the description's pic_panel names.

The first items are choices other than a song (host_random, host_custom, or search_all), and the rest are songs. The RTTI records the class as deriving from FreqList. Its vtable is at 0x003cf8e0. The destructor is compiler-generated and has no declaration here.

Constructor & Destructor Documentation

◆ ~SongSelList()

SongSelList::~SongSelList ( )
overridedefault

Destroy the object.

Ghidra address:
NTSC-U/C: 0x0035ff98
Ghidra address:
PAL: 0x003ce4b0

◆ SongSelList()

SongSelList::SongSelList ( DataArray * pData,
const char * pszPanel )

Construct the list from its script description, listing nothing.

Parameters
pDataThe script description.
pszPanelThe name of the panel the list belongs to.
Ghidra address:
NTSC-U/C: 0x0019b178
Ghidra address:
PAL: 0x001a2eb0

Member Function Documentation

◆ New()

UIComponent * SongSelList::New ( DataArray * pData,
const char * pszPanel )
inlinestatic

Create a list from its script description.

The metagame registers the routine for the component type song_list_comp.

Parameters
pDataThe script description.
pszPanelThe name of the panel the list belongs to.
Returns
The new list.
Ghidra address:
NTSC-U/C: 0x003600e8
Ghidra address:
PAL: 0x003ce600

◆ UpdateRow()

void SongSelList::UpdateRow ( int nRow,
int nItem )
overridevirtual

Fill a row with a choice, or with the short artist of a song.

Parameters
nRowThe row.
nItemThe item.
Ghidra address:
NTSC-U/C: 0x0019b250
Ghidra address:
PAL: 0x001a2f88

Reimplemented from UIList.

◆ UpdateCursor()

void SongSelList::UpdateCursor ( )
overridevirtual

Move the cursor, and show the genre and the band picture of the selected song, or the label and the arena picture of the selected choice.

Ghidra address:
NTSC-U/C: 0x0019b2f8
Ghidra address:
PAL: 0x001a3030

Reimplemented from UIList.

◆ SetSongs()

void SongSelList::SetSongs ( const std::vector< String > & songs,
int nChoiceCount )

Replace the listed items and show them.

Parameters
songsThe localised choices, then the songs.
nChoiceCountThe number of choices ahead of the songs.
Ghidra address:
NTSC-U/C: 0x0019b1e0
Ghidra address:
PAL: 0x001a2f18

◆ GetSongs() [1/2]

const std::vector< String > & SongSelList::GetSongs ( ) const
inline
Returns
The localised choices, then the songs.

◆ GetSongs() [2/2]

std::vector< String > & SongSelList::GetSongs ( )
inline
Returns
The localised choices, then the songs.

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