Gnome Library Reference Manual | |||
---|---|---|---|
<<< Previous Page | Home | Up | Next Page >>> |
#include <gnome.h> gint gnome_score_init (const gchar *gamename); gint gnome_score_log (gfloat score, gchar *level, gboolean higher_to_lower_score_order); |
The routines in this module provide a simple way for games to keep track of the user's score in a game.
The programmer needs to call gnome_score_init() with the name of the game prior to accessing any of the other gnome_score functions. gnome_score_log() should then be called every time the user ends a round. To get a list of the most notable scores, you call the gnome_score_get_notable() routine.
gint gnome_score_init (const gchar *gamename); |
GNOME Games should call this routine as the first statement in main() if they have been installed setgid to the games() group.
gamename : | Identifies the game name. |
Returns : | 0 on success, returns -1 on failure. group privileges are dropped regardless of the status returned. |
gint gnome_score_log (gfloat score, gchar *level, gboolean higher_to_lower_score_order); |
Logs a score entry for the user.
score : | the score achieved by the user in this game |
level : | level on which the score was obtained |
higher_to_lower_score_order : | biggers is better or not |
Returns : | 0 on failure or the status from the gnome-score helper program. |