mate-score

mate-score — Tracking best scores for games

Synopsis

#include <libmate/libmate.h>

gint                mate_score_init                    (const gchar *gamename);
gint                mate_score_log                     (gfloat score,
                                                         const gchar *level,
                                                         gboolean higher_to_lower_score_order);
gint                mate_score_get_notable             (const gchar *gamename,
                                                         const gchar *level,
                                                         gchar ***names,
                                                         gfloat **scores,
                                                         time_t **scoretimes);

Description

The routines in this module provide a simple way to keep track of users' scores in a game.

In order to acommodate file ownership permissions, the game application should be installed setgid games and the scoretable should only be writable by the games group. The program should call mate_score_init() as soon as possible inside the main() routine. This will open a pair of pipes to a child process which can read and write the score table and then will drop the group privileges of the main program back to the user's normal group id.

Details

mate_score_init ()

gint                mate_score_init                    (const gchar *gamename);

Warning

mate_score_init is deprecated and should not be used in newly-written code.

MATE games should call this routine as the first statement in main() if they have been installed setgid to the "games" group. It performs the intialization required to later record information in the scores table and then drops the groups privileges.

`gamename` :	Identifies the game name.
Returns :	`0` on success, returns `-1` on failure.

mate_score_log ()

gint                mate_score_log                     (gfloat score,
                                                         const gchar *level,
                                                         gboolean higher_to_lower_score_order);

Warning

mate_score_log is deprecated and should not be used in newly-written code.

Logs a score entry for the user. You should call this every time a game ends. This function takes care of working out whether the user's score made it into the ten best scores and, if so, records it in the table.

`score` :	The score achieved by the user in this game
`level` :	The level on which the score was obtained
`higher_to_lower_score_order` :	Set to `TRUE` if high scores are better than low scores.
Returns :	`0` on failure and the number of bytes written otherwise.

mate_score_get_notable ()

gint                mate_score_get_notable             (const gchar *gamename,
                                                         const gchar *level,
                                                         gchar ***names,
                                                         gfloat **scores,
                                                         time_t **scoretimes);

Warning

mate_score_get_notable is deprecated and should not be used in newly-written code.

Fetches the most notable players on gamename at level level.

`gamename` :	The name of the game we want to fetch information from.
`level` :	The level for which we want to pull information.
`names` :	An array of strings is returned at the address pointed here
`scores` :	An array of gfloats is returned at the address pointed here
`scoretimes` :	An array of time_t is returned at the address pointed here
Returns :	The number of scores returned. The `names`, `scores` and `scoretime` pointers point to regions that were allocated with `g_malloc()` with the contents.

			MATE Library Reference Manual
Top \| Description