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 |
||
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 |