nCine::Backends::OgcStorage namespace

Storage of the GameCube that is not the disc — the SD cards in a memory-card slot or in the serial port under the console.

libfat mounts every FAT volume it finds as a device of its own: an SD2SP2 adapter in serial port 2 as "sd:", and an SD Gecko in memory-card slot A or B as "carda:" or "cardb:". This mounts them and reports which came up, and where the loader found the executable, which is all a platform backend can usefully say about them — where the game keeps its files, and whether it prefers them to the disc, is decided in ContentResolver::InitializePaths(). The disc itself is OgcDvd, the memory cards are OgcMemoryCard.

Functions

void Initialize(const char* bootPath)
Mounts the FAT volumes and records the path the executable was loaded from.
auto GetMountedDevices() -> Death::Containers::ArrayView<const Death::Containers::StringView>
Mount points of the FAT volumes that came up, as.
auto GetBootDirectory() -> Death::Containers::StringView
The directory the executable was loaded from, with its trailing separator.
auto GetGameId() -> Death::Containers::StringView
Game ID of the disc made for this build, see NCINE_GAMECUBE_GAME_ID.
void HaltWithMessage(const char* message)
Shows a message on the boot console and stops there.

Function documentation

void nCine::Backends::OgcStorage::Initialize(const char* bootPath)

Mounts the FAT volumes and records the path the executable was loaded from.

Parameters
bootPath The first argument the executable was started with, or nullptr — a loader started from an SD card passes the path of the executable there, a console that booted the disc passes nothing

Death::Containers::ArrayView<const Death::Containers::StringView> nCine::Backends::OgcStorage::GetMountedDevices()

Mount points of the FAT volumes that came up, as.

"sd:/", "carda:/", ...

Death::Containers::StringView nCine::Backends::OgcStorage::GetBootDirectory()

The directory the executable was loaded from, with its trailing separator.

Empty when no path was passed, or when it is not on one of GetMountedDevices().

void nCine::Backends::OgcStorage::HaltWithMessage(const char* message)

Shows a message on the boot console and stops there.

For the one failure the game cannot start past - no content anywhere it looks. The boot console is still on the screen at that point, the renderer does not exist yet.