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