PCSX2 Documentation/The PCSX2 Program Flow

The following article is a very general overview of the flow of the PCSX2 application.

AppMain.cpp - this is where the fun begins!

There is a lot that happens under the hood with wxWidgets. We don't need to worry about that. All we need to worry about is this this line of code in AppMain.cpp. <source lang="cpp">IMPLEMENT_APP(Pcsx2App)</source> This macro tells the wxWidgets framework that we want to fire up Pcsx2App. Easy, right?

Pcsx2App - the part we care about

So where does Pcsx2App live? Well, the declarations are in the header file App.h and the definitions are in a few different files. But let's first take a look at this line in the header file: <source lang=cpp> class Pcsx2App : public wxAppWithHelpers{} </source> You can see here that the Pcsx2App class is an extension of the wxAppWithHelpers class. WxWidgets applications are defined as classes, which are instantiated into an object when we start the program. Pcsx2App contains methods that wxWidgets is going to call upon at various times. So what gets called when we fire up Pcsx2App? That would be the OnInit() method which is defined in AppInit.cpp. There's all kinds of crazy stuff happening here, but what we really care about is this line: <source lang="cpp"> if( m_UseGUI ) OpenMainFrame(); </source>

WxWidgets Frames

In addition to Application classes, there are also Frame classes. So when we call the OpenMainFrame function, what happens? Take a look at this code:

/pcsx2/gui/AppInit.cpp

<source lang="cpp"> // In /pcsx2/gui/AppInit.cpp

void Pcsx2App::OpenMainFrame() { if( AppRpc_TryInvokeAsync( &Pcsx2App::OpenMainFrame ) ) return;

if( GetMainFramePtr() != NULL ) return;

MainEmuFrame* mainFrame = new MainEmuFrame( NULL, pxGetAppName() );

... } </source>

Here we're creating an instance of the MainEmuFrame class. That class contains members for all the cool GUI elements, buttons, menus, stuff like that. So let's take a step further. Suppose we want to boot up a game. When we select Boot DVD in the pcsx2 menus, we are calling upon this function here:

<source lang="cpp"> // In /pcsx2/gui/MainMenuClicks.cpp

void MainEmuFrame::_DoBootCdvd() </source>