>gnome-score

gnome-score

Name

gnome-score -- Tracking score for games

Synopsis


#include <gnome.h>


gint        gnome_score_init                (const gchar *gamename);
gint        gnome_score_log                 (gfloat score,
                                             gchar *level,
                                             gboolean higher_to_lower_score_order);

Description

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.

Details

gnome_score_init ()

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.


gnome_score_log ()

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.