| Top |
| gchar * | gva_choose_inpname () |
| gchar * | gva_find_data_file () |
| GvaDebugFlags | gva_get_debug_flags () |
| const gchar * | gva_get_last_version () |
| gchar * | gva_get_monospace_font_name () |
| GSettings * | gva_get_settings () |
| SoupSession * | gva_get_soup_session () |
| void | gva_get_time_elapsed () |
| const gchar * | gva_get_user_data_dir () |
| void | gva_help_display () |
| void | gva_save_window_state () |
| gchar * | gva_search_collate_key () |
| gboolean | gva_spawn_with_pipes () |
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.
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.
GvaDebugFlags
gva_get_debug_flags (void);
Returns a set of bit flags indicating what kinds of debugging messages are enabled through the GVA_DEBUG environment variable.
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.
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().
GSettings *
gva_get_settings (void);
Returns the GSettings object loaded with the schema for GNOME Video Arcade.
SoupSession *
gva_get_soup_session (void);
Returns a SoupSessionAsync configured to cache responses.
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().
const gchar *
gva_get_user_data_dir (void);
Returns the directory where user-specific application data is stored. The function also creates the directory the first time it is called.
void gva_help_display (GtkWindow *parent,const gchar *link_id);
Opens the user documentation to the section given by link_id
, or to the
table of contents if link_id
is NULL. If the user documentation cannot
be opened, it presents a dialog describing the error. The dialog is set
as transient to parent
if parent
is NULL.
void gva_save_window_state (GtkWindow *window,const gchar *width_key,const gchar *height_key,const gchar *maximized_key,const gchar *x_key,const gchar *y_key);
Writes the dimensions, position and maximize state of window
to the
given GSettings keys. If a key name argument is NULL, the function
will skip writing a value to that setting.
window |
a GtkWindow |
|
width_key |
name of the window width integer setting, or |
|
height_key |
name of the window height integer setting, or |
|
maximized_key |
name of the window maximized boolean setting, or |
|
x_key |
name of the window X-position integer setting, or |
|
y_key |
name of the window Y-position integer setting, or |
gchar *
gva_search_collate_key (const gchar *string);
Converts a string into a collation key that can be compared with other
collation keys produced by the same function using strcmp().
Specifically, the function filters out spaces and punctuation from string
for easier comparison with what a human is likely to type in an interactive
search. e.g. Typing "mspacman" will match "Ms. Pac-Man".
gboolean gva_spawn_with_pipes (const gchar *command_line,GPid *child_pid,gint *standard_input,gint *standard_output,gint *standard_error,GError **error);
Convenience function that passes command_line
to g_shell_parse_argv(),
and passes the resulting argument list to g_spawn_async_with_pipes().
If an error occurs, it results FALSE and sets error
.
command_line |
a command line |
|
child_pid |
return location for child process ID, or |
|
standard_input |
return location for file descriptor to write to child's
stdin, or |
|
standard_output |
return location for file descriptor to write to child's
stdout, or |
|
standard_error |
return location for file descriptor to write to child's
stderr, or |
|
error |
return location for a GError, or |