Skip to content

GB_load_gbs

Lior Halphon edited this page Nov 30, 2024 · 4 revisions

Definition

int GB_load_gbs(GB_gameboy_t *gb, const char *path, GB_gbs_info_t *info);

In gb.h

Description

Loads a GBS file into an emulator instance. Returns 0 on success, a positive errno value on a POSIX failure, and -1 on other failures.

In case of a failure, an error message will also be output to the log. Warning messages may be output to the log upon success.

Upon success, and if info is not NULL, the GB_gbs_info_t struct pointed by info will be filled with metadata from the GBS file.

After loading a GBS file, you must call GB_gbs_switch_track to specify the track to play. See GB_gbs_switch_track for more information.

Thread Safety

GB_load_gbs must not be called if the instance is being run in another thread, but may be called from the current one (via a callback).

See Also

Clone this wiki locally