Settings & Configuration

Table of Contents

• Creating default settings
• Modifying settings
• Per-subsystem default helpers
• Querying the active settings

FPL is configured through a single fplSettings structure, which is passed to fplPlatformInit() .
It groups all configuration into one container with a sub-structure for each subsystem:

Field	Type	Configures
window	fplWindowSettings	Window title, size, position, style, callbacks
video	fplVideoSettings	Video backend (OpenGL, Vulkan, Software), vsync
audio	fplAudioSettings	Audio backend, format, device, buffer sizes
input	fplInputSettings	Input backends, gamepad detection frequency
console	fplConsoleSettings	Console subsystem configuration
memory	fplMemorySettings	Custom memory allocator configuration

Creating default settings

You should never use an uninitialized fplSettings structure. FPL provides two ways to obtain a fully populated default configuration.

Use fplMakeDefaultSettings() to get a settings structure by value:

fplSettings settings = fplMakeDefaultSettings();

Or use fplSetDefaultSettings() to reset an existing structure in place:

fplSettings settings;
fplSetDefaultSettings(&settings);

Note

Neither function changes the active settings - they only fill the structure. The settings only take effect when passed to fplPlatformInit() .

Modifying settings

After creating the defaults, change only the fields you care about, then pass the structure into fplPlatformInit() .

fplSettings settings = fplMakeDefaultSettings();
fplCopyString("My Game", settings.window.title, fplArrayCount(settings.window.title));
settings.window.windowSize.width = 1280;
settings.window.windowSize.height = 720;
 
if (fplPlatformInit(fplInitFlags_All, &settings)) {
    // ...
    fplPlatformRelease();
}

See Initialization with custom settings for the full initialization workflow.

Per-subsystem default helpers

If you only want to reset a single subsystem, FPL provides dedicated helper functions:

Function	Resets
fplSetDefaultWindowSettings()	fplWindowSettings
fplSetDefaultVideoSettings()	fplVideoSettings
fplSetDefaultAudioSettings()	fplAudioSettings
fplSetDefaultInputSettings()	fplInputSettings
fplSetDefaultConsoleSettings()	fplConsoleSettings

fplVideoSettings videoSettings;
fplSetDefaultVideoSettings(&videoSettings);

Querying the active settings

Once the platform is initialized, you can retrieve the currently active configuration by calling fplGetCurrentSettings() .
It returns a read-only pointer to the fplSettings used by FPL.

const fplSettings *current = fplGetCurrentSettings();
fplConsoleFormatOut("Window size: %dx%d\n",
    current->window.windowSize.width, current->window.windowSize.height);

Note

Modifying the returned structure has no effect on the running platform. Settings are applied at fplPlatformInit() time only.