gnome-score

Gnome Library Reference Manual
<<< Previous Page	Home	Up	Next Page >>>

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.

<<< Previous Page	Home	Up	Next Page >>>
gnome-remote		gnome-sound