<HTML
><HEAD
><TITLE
>gnome-scores - "High Scores" Widget</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.44"><LINK
REL="HOME"
TITLE="Gnome Developers' Information"
HREF="book1.html"><LINK
REL="UP"
TITLE="GNOME User Interface library."
HREF="libgnomeui.html"><LINK
REL="PREVIOUS"
TITLE="gnome-properties"
HREF="gnome-properties.html"><LINK
REL="NEXT"
TITLE="gnome-session"
HREF="gnome-session.html"></HEAD
><BODY
><DIV
CLASS="NAVHEADER"
><TABLE
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TH
COLSPAN="3"
ALIGN="center"
>Gnome Developers' Information</TH
></TR
><TR
><TD
WIDTH="10%"
ALIGN="left"
VALIGN="bottom"
><A
HREF="gnome-properties.html"
>Prev</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
>Chapter 6. GNOME User Interface library.</TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="gnome-session.html"
>Next</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><DIV
CLASS="SECT1"
><H1
CLASS="SECT1"
><A
NAME="GNOME-SCORES"
>gnome-scores - "High Scores" Widget</A
></H1
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="AEN854"
>Author(s)</A
></H2
><P
>Horacio J. Peņa &#60;horape@compendium.com.ar&#62;</P
><P
>This is free software (under the terms of the GNU LGPL)&#13;</P
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="AEN858"
>Description</A
></H2
><P
>A specialized widget to display "High Scores" for games. It's
very integrated with the gnome-score stuff so you only need to
call one function to do all the work...</P
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="AEN861"
>Usage</A
></H2
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>Use the gnome_scores_display.The other functions are going to be
  discontinued...(ok, i should add pixmap support to * _display
		  before)</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="GNOME-SCORES-DISPLAY"
>gnome_scores_display - Does all the work of displaying the best scores.</A
></H2
><DIV
CLASS="FUNCSYNOPSIS"
><P
></P
><CODE
CLASS="FUNCDEF"
> void <B
CLASS="FSFUNC"
>gnome_scores_display</B
></CODE
>(gchar *<VAR
CLASS="PDPARAM"
>title</VAR
>, gchar *<VAR
CLASS="PDPARAM"
>app_name</VAR
>, gchar *<VAR
CLASS="PDPARAM"
>level</VAR
>, int <VAR
CLASS="PDPARAM"
>pos</VAR
>);<P
></P
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="AEN877"
>Description</A
></H3
><P
>It calls gnome_score_get_notables to retrieve the info,
creates the window, and show it.&#13;</P
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="AEN880"
>Returns</A
></H3
><P
>Doesn't return nothing</P
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="AEN883"
>Usage</A
></H3
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>pos = gnome_score_log (score, level, TRUE);
gnome_scores_display (_ ("Mi game"), "migame", level, pos);</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="AEN886"
>Parameters</A
></H3
><P
></P
><UL
><LI
><P
>gchar *<TT
CLASS="PARAMETER"
><I
>title</I
></TT
></P
><P
>Title.</P
></LI
><LI
><P
>gchar *<TT
CLASS="PARAMETER"
><I
>app_name</I
></TT
></P
><P
>Name of the application, as in
gnome_score_init.</P
></LI
><LI
><P
>gchar *<TT
CLASS="PARAMETER"
><I
>level</I
></TT
></P
><P
>Level of the game or NULL.</P
></LI
><LI
><P
>int <TT
CLASS="PARAMETER"
><I
>pos</I
></TT
></P
><P
>Position in the top ten of the
current player, as returned by
gnome_score_log.</P
></LI
></UL
></DIV
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="GNOME-SCORES-NEW"
>gnome_scores_new - Creates the high-scores window.</A
></H2
><DIV
CLASS="FUNCSYNOPSIS"
><P
></P
><CODE
CLASS="FUNCDEF"
> GtkWidget *<B
CLASS="FSFUNC"
>gnome_scores_new</B
></CODE
>(guint <VAR
CLASS="PDPARAM"
>n_scores</VAR
>, gchar **<VAR
CLASS="PDPARAM"
>names</VAR
>, gfloat *<VAR
CLASS="PDPARAM"
>scores</VAR
>, time_t *<VAR
CLASS="PDPARAM"
>times</VAR
>, guint <VAR
CLASS="PDPARAM"
>clear</VAR
>);<P
></P
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="AEN920"
>Description</A
></H3
><P
>Creates the high-scores window.</P
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="AEN923"
>Parameters</A
></H3
><P
></P
><UL
><LI
><P
>guint <TT
CLASS="PARAMETER"
><I
>n_scores</I
></TT
></P
><P
>Number of positions.</P
></LI
><LI
><P
>gchar **<TT
CLASS="PARAMETER"
><I
>names</I
></TT
></P
><P
>Names of the players.</P
></LI
><LI
><P
>gfloat *<TT
CLASS="PARAMETER"
><I
>scores</I
></TT
></P
><P
>Scores</P
></LI
><LI
><P
>time_t *<TT
CLASS="PARAMETER"
><I
>times</I
></TT
></P
><P
>Time in which the scores were done</P
></LI
><LI
><P
>guint <TT
CLASS="PARAMETER"
><I
>clear</I
></TT
></P
><P
>Add a "Clear" Button?</P
></LI
></UL
></DIV
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="GNOME-SCORES-SET-LOGO-LABEL"
>gnome_scores_set_logo_label - Creates a label to be the logo</A
></H2
><DIV
CLASS="FUNCSYNOPSIS"
><P
></P
><CODE
CLASS="FUNCDEF"
> void <B
CLASS="FSFUNC"
>gnome_scores_set_logo_label</B
></CODE
>(GnomeScores *<VAR
CLASS="PDPARAM"
>gs</VAR
>, gchar *<VAR
CLASS="PDPARAM"
>txt</VAR
>, gchar *<VAR
CLASS="PDPARAM"
>font</VAR
>, GdkColor *<VAR
CLASS="PDPARAM"
>color</VAR
>);<P
></P
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="AEN959"
>Description</A
></H3
><P
>Creates a label to be the logo</P
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="AEN962"
>Parameters</A
></H3
><P
></P
><UL
><LI
><P
>GnomeScores *<TT
CLASS="PARAMETER"
><I
>gs</I
></TT
></P
><P
>GNOME Scores widget.</P
></LI
><LI
><P
>gchar *<TT
CLASS="PARAMETER"
><I
>txt</I
></TT
></P
><P
>Text in the label.</P
></LI
><LI
><P
>gchar *<TT
CLASS="PARAMETER"
><I
>font</I
></TT
></P
><P
>Font to use in the label.</P
></LI
><LI
><P
>GdkColor *<TT
CLASS="PARAMETER"
><I
>color</I
></TT
></P
><P
>Color to use in the label.</P
></LI
></UL
></DIV
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="GNOME-SCORES-SET-LOGO-PIXMAP"
>gnome_scores_set_logo_pixmap - Creates a pixmap to be the logo</A
></H2
><DIV
CLASS="FUNCSYNOPSIS"
><P
></P
><CODE
CLASS="FUNCDEF"
> void <B
CLASS="FSFUNC"
>gnome_scores_set_logo_pixmap</B
></CODE
>(GnomeScores *<VAR
CLASS="PDPARAM"
>gs</VAR
>, gchar *<VAR
CLASS="PDPARAM"
>logo</VAR
>);<P
></P
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="AEN990"
>Description</A
></H3
><P
>Creates a pixmap to be the logo</P
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="AEN993"
>Parameters</A
></H3
><P
></P
><UL
><LI
><P
>GnomeScores *<TT
CLASS="PARAMETER"
><I
>gs</I
></TT
></P
><P
>GNOME Scores widget.</P
></LI
><LI
><P
>gchar *<TT
CLASS="PARAMETER"
><I
>logo</I
></TT
></P
><P
>Name of the .xpm.</P
></LI
></UL
></DIV
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="GNOME-SCORES-SET-LOGO-WIDGET"
>gnome_scores_set_logo_widget - Set an arbitrary widget to be the logo.</A
></H2
><DIV
CLASS="FUNCSYNOPSIS"
><P
></P
><CODE
CLASS="FUNCDEF"
> void <B
CLASS="FSFUNC"
>gnome_scores_set_logo_widget</B
></CODE
>(GnomeScores *<VAR
CLASS="PDPARAM"
>gs</VAR
>, GtkWidget *<VAR
CLASS="PDPARAM"
>w</VAR
>);<P
></P
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="AEN1013"
>Description</A
></H3
><P
>Set an arbitrary widget to be the logo.</P
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="AEN1016"
>Parameters</A
></H3
><P
></P
><UL
><LI
><P
>GnomeScores *<TT
CLASS="PARAMETER"
><I
>gs</I
></TT
></P
><P
>GNOME Scores widget.</P
></LI
><LI
><P
>GtkWidget *<TT
CLASS="PARAMETER"
><I
>w</I
></TT
></P
><P
>Widget to be used as logo.</P
></LI
></UL
></DIV
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="GNOME-SCORES-SET-COLOR"
>gnome_scores_set_color - Set the color of one entry.</A
></H2
><DIV
CLASS="FUNCSYNOPSIS"
><P
></P
><CODE
CLASS="FUNCDEF"
> void <B
CLASS="FSFUNC"
>gnome_scores_set_color</B
></CODE
>(GnomeScores *<VAR
CLASS="PDPARAM"
>gs</VAR
>, guint <VAR
CLASS="PDPARAM"
>pos</VAR
>, GdkColor *<VAR
CLASS="PDPARAM"
>col</VAR
>);<P
></P
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="AEN1038"
>Description</A
></H3
><P
>Set the color of one entry.</P
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="AEN1041"
>Parameters</A
></H3
><P
></P
><UL
><LI
><P
>GnomeScores *<TT
CLASS="PARAMETER"
><I
>gs</I
></TT
></P
><P
>GNOME Scores widget.</P
></LI
><LI
><P
>guint <TT
CLASS="PARAMETER"
><I
>pos</I
></TT
></P
><P
>Entry to be changed.</P
></LI
><LI
><P
>GdkColor *<TT
CLASS="PARAMETER"
><I
>col</I
></TT
></P
><P
>Color.</P
></LI
></UL
></DIV
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="GNOME-SCORES-SET-DEF-COLOR"
>gnome_scores_set_def_color - Set the default color of the entries.</A
></H2
><DIV
CLASS="FUNCSYNOPSIS"
><P
></P
><CODE
CLASS="FUNCDEF"
> void <B
CLASS="FSFUNC"
>gnome_scores_set_def_color</B
></CODE
>(GnomeScores *<VAR
CLASS="PDPARAM"
>gs</VAR
>, GdkColor *<VAR
CLASS="PDPARAM"
>col</VAR
>);<P
></P
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="AEN1065"
>Description</A
></H3
><P
>Set the default color of the entries.</P
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="AEN1068"
>Parameters</A
></H3
><P
></P
><UL
><LI
><P
>GnomeScores *<TT
CLASS="PARAMETER"
><I
>gs</I
></TT
></P
><P
>GNOME Scores widget.</P
></LI
><LI
><P
>GdkColor *<TT
CLASS="PARAMETER"
><I
>col</I
></TT
></P
><P
>Color.</P
></LI
></UL
></DIV
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="GNOME-SCORES-SET-COLORS"
>gnome_scores_set_colors - Set the color of all the entries.</A
></H2
><DIV
CLASS="FUNCSYNOPSIS"
><P
></P
><CODE
CLASS="FUNCDEF"
> void <B
CLASS="FSFUNC"
>gnome_scores_set_colors</B
></CODE
>(GnomeScores *<VAR
CLASS="PDPARAM"
>gs</VAR
>, GdkColor *<VAR
CLASS="PDPARAM"
>col</VAR
>);<P
></P
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="AEN1088"
>Description</A
></H3
><P
>Set the color of all the entries.</P
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="AEN1091"
>Parameters</A
></H3
><P
></P
><UL
><LI
><P
>GnomeScores *<TT
CLASS="PARAMETER"
><I
>gs</I
></TT
></P
><P
>Not Descripted.</P
></LI
><LI
><P
>GdkColor *<TT
CLASS="PARAMETER"
><I
>col</I
></TT
></P
><P
>Array of colors.</P
></LI
></UL
></DIV
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="GNOME-SCORES-SET-LOGO-LABEL-TITLE"
>gnome_scores_set_logo_label_title - Creates a label to be the logo</A
></H2
><DIV
CLASS="FUNCSYNOPSIS"
><P
></P
><CODE
CLASS="FUNCDEF"
> void <B
CLASS="FSFUNC"
>gnome_scores_set_logo_label_title</B
></CODE
>(GnomeScores *<VAR
CLASS="PDPARAM"
>gs</VAR
>, gchar *<VAR
CLASS="PDPARAM"
>txt</VAR
>);<P
></P
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="AEN1111"
>Description</A
></H3
><P
>Creates a label to be the logo</P
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="AEN1114"
>Parameters</A
></H3
><P
></P
><UL
><LI
><P
>GnomeScores *<TT
CLASS="PARAMETER"
><I
>gs</I
></TT
></P
><P
>GNOME Scores widget.</P
></LI
><LI
><P
>gchar *<TT
CLASS="PARAMETER"
><I
>txt</I
></TT
></P
><P
>Name of the logo.</P
></LI
></UL
></DIV
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="GNOME-SCORES-SET-CURRENT-PLAYER"
>gnome_scores_set_current_player - Set the index of the current player in top ten.</A
></H2
><DIV
CLASS="FUNCSYNOPSIS"
><P
></P
><CODE
CLASS="FUNCDEF"
> void <B
CLASS="FSFUNC"
>gnome_scores_set_current_player</B
></CODE
>(GnomeScores *<VAR
CLASS="PDPARAM"
>gs</VAR
>, gint <VAR
CLASS="PDPARAM"
>i</VAR
>);<P
></P
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="AEN1134"
>Description</A
></H3
><P
>Set the index of the current player in top ten.</P
></DIV
><DIV
CLASS="SECT3"
><H3
CLASS="SECT3"
><A
NAME="AEN1137"
>Parameters</A
></H3
><P
></P
><UL
><LI
><P
>GnomeScores *<TT
CLASS="PARAMETER"
><I
>gs</I
></TT
></P
><P
>GNOME Scores widget.</P
></LI
><LI
><P
>gint <TT
CLASS="PARAMETER"
><I
>i</I
></TT
></P
><P
>Index of the current(from 0 to 9).</P
></LI
></UL
></DIV
></DIV
></DIV
><DIV
CLASS="NAVFOOTER"
><HR
ALIGN="LEFT"
WIDTH="100%"><TABLE
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><A
HREF="gnome-properties.html"
>Prev</A
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="book1.html"
>Home</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><A
HREF="gnome-session.html"
>Next</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>gnome-properties</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="libgnomeui.html"
>Up</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>gnome-session</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>