gva-util

gva-util — Miscellaneous Utilities

Synopsis




gchar*              gva_choose_inpname                  (const gchar *game);
gchar*              gva_find_data_file                  (const gchar *basename);
const gchar*        gva_get_last_version                (void);
gchar*              gva_get_monospace_font_name         (void);
void                gva_get_time_elapsed                (GTimeVal *start_time,
                                                         GTimeVal *time_elapsed);

Description

Details

gva_choose_inpname ()

gchar*              gva_choose_inpname                  (const gchar *game);

Returns the name of a MAME input file for game that does not already exist. For example, given the game "pacman" the function will return the first filename that does not already exist: "pacman.inp", "pacman-1.inp", "pacman-2.inp", etc.

game : the name of a game
Returns : value: a newly-allocated input filename for game

gva_find_data_file ()

gchar*              gva_find_data_file                  (const gchar *basename);

Searches for a file named basename in a number of standard system-wide directories and returns a newly-allocated string containing the path to the first match. The string should be freed with g_free(). If no match is found the function returns NULL.

basename : the base name of the file to search for
Returns : the pathname of the first match, or NULL if no match was found

gva_get_last_version ()

const gchar*        gva_get_last_version                (void);

Returns the most recently run version of GNOME Video Arcade prior to the current run. This is used to detect GNOME Video Arcade upgrades.

Returns : the most recently run version of GNOME Video Arcade

gva_get_monospace_font_name ()

gchar*              gva_get_monospace_font_name         (void);

Returns the user's preferred fixed-width font name. The return value is a newly-allocated string and should be freed with g_free().

Returns : the name of a fixed-width font

gva_get_time_elapsed ()

void                gva_get_time_elapsed                (GTimeVal *start_time,
                                                         GTimeVal *time_elapsed);

Writes the time elapsed since start_time to time_elapsed. Set the start time by calling g_get_current_time().

start_time : a start time
time_elapsed : location to put the time elasped