API Reference: Key Classes

Detailed documentation of the most important C++ classes in Mobile Eggbert. For enum types, see Enumerations.

Decor

File: include/WindowsPhoneSpeedyBlupi/Decor.hpp, src/WindowsPhoneSpeedyBlupi/Decor.cpp (~9400+ lines)

The core of the entire game simulation. Owns the world grid, all moving objects, the player character, physics, collision, AI, camera, rendering, and win/loss detection.

Player State Fields

Key Methods

World Grid

struct Cellule { short icon; };

Cellule m_decor[100][100];     // base tile layer
Cellule m_bigDecor[100][100];  // secondary decorative layer

Game1

File: include/WindowsPhoneSpeedyBlupi/Game1.hpp, src/WindowsPhoneSpeedyBlupi/Game1.cpp

The top-level XNA game class. Inherits CNA's Game base. Owns all subsystems, drives the phase state machine, handles button callbacks (WM_BUTTON*), and the cheat system.

Lifecycle

Initialize()   → platform/window setup
LoadContent()  → sprite sheets, sounds, level data
Update()       → input, phase state machine, game logic
Draw()         → SpriteBatch rendering pass

Phase Transitions

Game1::SetPhase(Phase p) centralizes all side-effects of phase changes: asset loading, InputPad reconfiguration, fade animations. Never set the phase field directly — always call SetPhase().

Button Dispatching

UI button presses arrive as named ButtonGlyph enum values to Game1::HandleButton(ButtonGlyph), which dispatches to the appropriate handler based on the current phase.

Pixmap / IPixmap

File: include/WindowsPhoneSpeedyBlupi/Pixmap.hpp, IPixmap.hpp

IPixmap is the interface. Pixmap is the concrete implementation using CNA's SpriteBatch.

Channel Management

17 named channels (1–17) each correspond to a loaded texture. Key operations:

• LoadChannel(PixmapChannel, path) — load a PNG into a channel
• DrawIcon(channel, icon, x, y, …) — draw a sprite cell
• SetScrollOffset(x, y) — set camera scroll position

Sound / ISound

File: include/WindowsPhoneSpeedyBlupi/Sound.hpp, ISound.hpp

Manages 93 WAV slots via CNA's audio layer (SDL3_mixer). Volume and stereo balance are controlled via per-channel tables in Sound.cpp.

Key Operations

• PlaySound(SoundChannel, x) — play a sound with automatic panning based on screen X position
• StopAll() — stop all audio (called on phase transitions)
• SetMasterVolume(float) — global volume control

InputPad

File: include/WindowsPhoneSpeedyBlupi/InputPad.hpp, src/WindowsPhoneSpeedyBlupi/InputPad.cpp

Abstracts touch, keyboard, and accelerometer input into the two values Decor needs: a Direction and a KeyPressFlags bitmask.

Input Sources

• Touch: on-screen buttons (PlayJump, PlayAction, PlayDown, D-pad)
• Keyboard: arrow keys → Direction, Z/X/C or Space → Jump/Fire/Down
• Accelerometer: tilt → Direction (optional, toggle in settings)

InputPad is reconfigured on each phase transition (e.g., touch buttons are hidden during menus, shown during Play).

GameData

File: include/WindowsPhoneSpeedyBlupi/GameData.hpp, src/WindowsPhoneSpeedyBlupi/GameData.cpp

Manages a flat 640-byte binary array persisted to disk (or IndexedDB on web). Three gamer slots of 210 bytes each, plus a 10-byte header.

Key Accessors

Serialized/deserialized via Worlds::ReadGameData() / Worlds::WriteGameData(). See Data Formats: Save Data for the full layout.

Worlds

File: include/WindowsPhoneSpeedyBlupi/Worlds.hpp, src/WindowsPhoneSpeedyBlupi/Worlds.cpp

Handles all file I/O for level data and save data.

Key Operations

Tables

File: include/WindowsPhoneSpeedyBlupi/Tables.hpp, src/WindowsPhoneSpeedyBlupi/Tables.cpp

Two static data structures:

1. Animation table — 2911 entries mapping (BlupiAction, phase) → (channel, icon, nextPhase). Drives all character animation without per-action branching in Decor.
2. Cheat code list — 22 string entries used by Game1::CheatAction().

struct TableEntry {
    PixmapChannel channel;
    short         icon;
    short         nextPhase;
};

extern const TableEntry AnimTable[2911];
extern const char* CheatCodes[22];

Text

File: include/WindowsPhoneSpeedyBlupi/Text.hpp, src/WindowsPhoneSpeedyBlupi/Text.cpp

Bitmap font renderer using icons/text.png (32×32 px cells, PixmapChannel::Text). Used to render level names, score displays, and HUD text.

TinyPoint

File: include/WindowsPhoneSpeedyBlupi/TinyPoint.hpp

Simple 2D integer point. Standard (x, y) field order.

struct TinyPoint {
    int x;
    int y;
};

TinyRect

File: include/WindowsPhoneSpeedyBlupi/TinyRect.hpp

struct TinyRect {
    int Left;
    int Right;   // ← NOT Top
    int Top;     // ← NOT Right
    int Bottom;

    TinyRect(int left, int right, int top, int bottom);
};