Overview
rex::ReXApp is the base class for recompiled Xbox 360 applications in the ReXGlue SDK. It handles all boilerplate setup including runtime initialization, window creation, ImGui integration, module launching, and shutdown. Consumer projects inherit from this class and optionally override virtual hooks for customization.
Constructor
protected:
ReXApp(ui::WindowedAppContext& ctx,
std::string_view name,
PPCImageInfo ppc_info,
std::string_view usage = "[game_directory]");
ctx
ui::WindowedAppContext&
required
Windowed application context
Application name identifier
PPC image layout information (code base, size, function mappings)
usage
std::string_view
default:"[game_directory]"
Command-line usage string for help text
Virtual Hooks
These methods can be overridden in subclasses to customize application behavior:
OnPreSetup
virtual void OnPreSetup(RuntimeConfig& config);
Runtime::Setup(). Override to modify backend configuration.
Runtime configuration that can be modified before setup
OnPostSetup
virtual void OnPostSetup();
OnCreateDialogs
virtual void OnCreateDialogs(ui::ImGuiDrawer* drawer);
ImGui drawer instance to register custom dialogs with
OnShutdown
virtual void OnShutdown();
virtual void OnConfigurePaths(PathConfig& paths);
Path configuration with defaults that can be modified
Accessor Methods
These protected methods provide access to core components for subclass use:
runtime
Runtime* runtime() const;
window
ui::Window* window() const;
imgui_drawer
ui::ImGuiDrawer* imgui_drawer() const;
game_data_root
const std::filesystem::path& game_data_root() const;
user_data_root
const std::filesystem::path& user_data_root() const;
update_data_root
const std::filesystem::path& update_data_root() const;
Example: Subclassing ReXApp
The generated main.cpp from rexglue init or rexglue migrate creates a subclass like this:
class MyApp : public rex::ReXApp {
public:
using rex::ReXApp::ReXApp;
static std::unique_ptr<rex::ui::WindowedApp> Create(
rex::ui::WindowedAppContext& ctx) {
return std::unique_ptr<MyApp>(new MyApp(ctx, "my_app",
{PPC_CODE_BASE, PPC_CODE_SIZE, PPC_IMAGE_BASE,
PPC_IMAGE_SIZE, PPCFuncMappings}));
}
protected:
// Override virtual hooks as needed
void OnPreSetup(RuntimeConfig& config) override {
// Customize runtime configuration
}
void OnCreateDialogs(ui::ImGuiDrawer* drawer) override {
// Add custom UI dialogs
}
void OnConfigurePaths(PathConfig& paths) override {
// Adjust data paths if needed
paths.user_data_root = "/custom/save/location";
}
};
REX_DEFINE_APP(my_app, MyApp::Create)
See Also