System¶

Description¶

System is a virtual platform-abstraction layer. It provides screen dimensions, file-system paths, virtual keyboard control, fullscreen management, persistent key-value storage, and optional SDK integrations (AdMob, CrazyGames). You access it via System::instance() in C++ or the global System table in Lua.

Each target platform provides its own concrete System subclass; the engine injects the correct implementation at startup.

#include "Doriax.h"
using namespace doriax;

int screenW = System::instance().getScreenWidth();
int screenH = System::instance().getScreenHeight();
Log::print("Screen: %dx%d", screenW, screenH);

local w = System.getScreenWidth()
local h = System.getScreenHeight()
Log.print("Screen: " .. w .. "x" .. h)

Methods¶

Method details¶

getScreenWidth / getScreenHeight¶

• virtual int getScreenWidth() = 0
• virtual int getScreenHeight() = 0

Physical screen (window) dimensions in pixels. These may differ from Engine::canvasWidth / canvasHeight when a scaling mode other than NATIVE is active.

int w = System::instance().getScreenWidth();
int h = System::instance().getScreenHeight();

local w = System.getScreenWidth()
local h = System.getScreenHeight()

getSampleCount¶

• virtual int getSampleCount()

Returns the MSAA sample count configured for the current graphics backend (e.g. 1, 2, or 4). Useful when creating render targets that must match the main framebuffer.

showVirtualKeyboard¶

• virtual void showVirtualKeyboard(std::wstring text = L"")

Displays the platform's on-screen keyboard with text as the initial input buffer. Has no effect on desktop platforms. On iOS/Android, raises the software keyboard and fires Engine::onCharInput for each key typed.

System::instance().showVirtualKeyboard(L"Enter name");

System.showVirtualKeyboard("Enter name")

hideVirtualKeyboard¶

• virtual void hideVirtualKeyboard()

Dismisses the on-screen keyboard.

isFullscreen / requestFullscreen / exitFullscreen¶

• virtual bool isFullscreen()
• virtual void requestFullscreen()
• virtual void exitFullscreen()

Query and control fullscreen mode. On desktop platforms, requestFullscreen() typically toggles borderless fullscreen; on web, it requests the Fullscreen API. Has no effect on mobile (always fullscreen).

Whether a desktop build starts fullscreen is a project setting (see Project Workflow — Window); exitFullscreen() restores the window size configured there.

if (!System::instance().isFullscreen()) {
    System::instance().requestFullscreen();
}

if not System.isFullscreen() then
    System.requestFullscreen()
end

Window control¶

• virtual bool isWindowMaximized()
• virtual void maximizeWindow()
• virtual void restoreWindow()
• virtual void setWindowSize(int width, int height)
• virtual bool isWindowResizable()
• virtual void setWindowResizable(bool resizable)
• virtual void setWindowTitle(const std::string& title)

Control the OS window of desktop builds at runtime. maximizeWindow()/restoreWindow() toggle the maximized state, setWindowSize() resizes the window in screen coordinates (while fullscreen it instead updates the size restored by exitFullscreen()), and setWindowTitle() changes the title-bar text. The initial values come from the project's Window settings.

Note that setWindowSize() takes window coordinates while getScreenWidth/getScreenHeight report framebuffer pixels — on HiDPI/scaled displays these differ by the content scale, so the two do not round-trip 1:1.

Platform support: fully implemented on GLFW-based desktop builds (generated desktop projects and Linux exports). Windows/macOS Sokol exports support only setWindowTitle() — the other calls are no-ops there. On web, setWindowTitle() sets the browser tab title and the rest are no-ops. All are no-ops on mobile.

System::instance().setWindowTitle("My Game — Level 2");
System::instance().setWindowSize(1600, 900);
if (!System::instance().isWindowMaximized()) {
    System::instance().maximizeWindow();
}

System.setWindowTitle("My Game — Level 2")
System.setWindowSize(1600, 900)
if not System.isWindowMaximized() then
    System.maximizeWindow()
end

quit¶

• virtual void quit()

Closes the application. The shutdown happens after the current frame ends, so it is safe to call from a button callback or any other script code, and Engine::onShutdown still runs before the app goes away.

Platform support: desktop builds close the window, web stops the render loop and shuts the engine down (writing pending user data to IndexedDB first — the browser tab itself stays open), and Android finishes the activity. On iOS it is a no-op and logs a warning, since apps are not supposed to terminate themselves.

Running a scene with Play in the editor stops play instead of closing the editor, so a quit button can be tested there.

void UI_MainMenu::onButtonClickQuit() {
    System::instance().quit();
}

function UI_MainMenu:onButtonClickQuit()
    System.quit()
end

getDirSeparator¶

• virtual char getDirSeparator()

Returns the platform path directory separator: '/' on Unix/macOS/iOS/Android/Web, '\\' on Windows.

getAssetPath¶

• virtual std::string getAssetPath()

Returns the root path for read-only assets bundled with the project: the project's assets directory in the editor, and the assets folder beside the executable in an exported build. Prepend this to asset file names when opening files directly from C++. In Lua and the high-level C++ loaders (setTexture, etc.), paths are automatically resolved relative to the asset root.

std::string path = System::instance().getAssetPath() + "textures/sprite.png";

getUserDataPath¶

• virtual std::string getUserDataPath()

Returns a writable per-user data directory (Documents on iOS, internal storage on Android, %AppData% on Windows, ~/.local/share on Linux). Use for save files and configuration.

std::string savePath = System::instance().getUserDataPath() + "save.dat";

getLuaPath¶

• virtual std::string getLuaPath()

Returns the base path prepended when Lua require() looks for script modules and when a ScriptComponent entry is loaded: the project's Lua directory in the editor, and the lua folder beside the executable in an exported build.

getShaderPath¶

• virtual std::string getShaderPath()

Returns the directory holding compiled .sdat shader binaries, and the root for shader:// paths: the project's shaders folder in the editor, and assets/shaders beside the executable in an exported build. The folder name is fixed, not configurable.

Persistent key–value storage¶

The system exposes a simple cross-platform persistent store backed by NSUserDefaults (iOS/macOS), SharedPreferences (Android), localStorage (Web), and a JSON file (desktop/Linux/Windows).

Getters return the stored value or defaultValue if the key does not exist:

Setters write or update a value:

removeKey deletes a stored entry:

• virtual void removeKey(const char* key)

System& sys = System::instance();

// Save high score
sys.setIntegerForKey("highScore", score);

// Load with default 0
int best = sys.getIntegerForKey("highScore", 0);

-- Preferences are exposed to Lua through UserSettings (not System).
UserSettings.setIntegerForKey("highScore", score)
local best = UserSettings.getIntegerForKey("highScore", 0)

AdMob integration¶

The following methods are available on Android and iOS when the Google AdMob SDK is linked. They are no-ops on other platforms.

AdMobRating¶

• General — Suitable for all audiences.
• ParentalGuidance — Parental guidance suggested.
• Teen — Suitable for teens.
• MatureAudience — Mature content.

CrazyGames integration¶

Methods for the CrazyGames web SDK. Only active on HTML5 builds.