<HTML
><HEAD
><TITLE
>GnomeAnimator</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.44"><LINK
REL="HOME"
TITLE="Gnome User Interface Library Reference Manual"
HREF="book1.html"><LINK
REL="UP"
TITLE="GNOME Widgets and Objects"
HREF="gnome-objects.html"><LINK
REL="PREVIOUS"
TITLE="GnomeAbout"
HREF="gnomeabout.html"><LINK
REL="NEXT"
TITLE="GnomeApp"
HREF="gnomeapp.html"></HEAD
><BODY
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="NAVHEADER"
><TABLE
WIDTH="100%"
BORDER="0"
BGCOLOR="#000000"
CELLPADDING="1"
CELLSPACING="0"
><TR
><TH
COLSPAN="4"
ALIGN="center"
><FONT
COLOR="#FFFFFF"
SIZE="5"
>Gnome User Interface Library Reference Manual</FONT
></TH
></TR
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomeabout.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>&#60;&#60;&#60; Previous Page</B
></FONT
></A
></TD
><TD
WIDTH="25%"
BGCOLOR="#0000C0"
ALIGN="center"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
><A
HREF="book1.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Home</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#00C000"
ALIGN="center"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
><A
HREF="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomeapp.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page &#62;&#62;&#62;</B
></FONT
></A
></TD
></TR
></TABLE
></DIV
><H1
><A
NAME="GNOMEANIMATOR"
>GnomeAnimator</A
></H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN7995"
></A
><H2
>Name</H2
>GnomeAnimator&nbsp;--&nbsp;A widget for adding simple animations to GNOME applications.</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN7998"
></A
><H2
>Synopsis</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;#include &lt;gnome.h&gt;


struct      <A
HREF="gnomeanimator.html#GNOMEANIMATOR-STRUCT"
>GnomeAnimator</A
>;
enum        <A
HREF="gnomeanimator.html#GNOMEANIMATORSTATUS"
>GnomeAnimatorStatus</A
>;
enum        <A
HREF="gnomeanimator.html#GNOMEANIMATORLOOPTYPE"
>GnomeAnimatorLoopType</A
>;
struct      <A
HREF="gnomeanimator.html#GNOMEANIMATORFRAME"
>GnomeAnimatorFrame</A
>;
struct      <A
HREF="gnomeanimator.html#GNOMEANIMATORPRIVATE"
>GnomeAnimatorPrivate</A
>;
<GTKDOCLINK
HREF="GTKWIDGET"
>GtkWidget</GTKDOCLINK
>*  <A
HREF="gnomeanimator.html#GNOME-ANIMATOR-NEW-WITH-SIZE"
>gnome_animator_new_with_size</A
>    (<GTKDOCLINK
HREF="GUINT"
>guint</GTKDOCLINK
> width,
                                             <GTKDOCLINK
HREF="GUINT"
>guint</GTKDOCLINK
> height);
void        <A
HREF="gnomeanimator.html#GNOME-ANIMATOR-SET-LOOP-TYPE"
>gnome_animator_set_loop_type</A
>    (<A
HREF="gnomeanimator.html"
>GnomeAnimator</A
> *animator,
                                             <A
HREF="gnomeanimator.html#GNOMEANIMATORLOOPTYPE"
>GnomeAnimatorLoopType</A
> loop_type);
<A
HREF="gnomeanimator.html#GNOMEANIMATORLOOPTYPE"
>GnomeAnimatorLoopType</A
> <A
HREF="gnomeanimator.html#GNOME-ANIMATOR-GET-LOOP-TYPE"
>gnome_animator_get_loop_type</A
>
                                            (<A
HREF="gnomeanimator.html"
>GnomeAnimator</A
> *animator);
void        <A
HREF="gnomeanimator.html#GNOME-ANIMATOR-SET-PLAYBACK-DIRECTION"
>gnome_animator_set_playback_direction</A
>
                                            (<A
HREF="gnomeanimator.html"
>GnomeAnimator</A
> *animator,
                                             <GTKDOCLINK
HREF="GINT"
>gint</GTKDOCLINK
> playback_direction);
<GTKDOCLINK
HREF="GINT"
>gint</GTKDOCLINK
>        <A
HREF="gnomeanimator.html#GNOME-ANIMATOR-GET-PLAYBACK-DIRECTION"
>gnome_animator_get_playback_direction</A
>
                                            (<A
HREF="gnomeanimator.html"
>GnomeAnimator</A
> *animator);
<GTKDOCLINK
HREF="GBOOLEAN"
>gboolean</GTKDOCLINK
>    <A
HREF="gnomeanimator.html#GNOME-ANIMATOR-APPEND-FRAME-FROM-IMLIB-AT-SIZE"
>gnome_animator_append_frame_from_imlib_at_size</A
>
                                            (<A
HREF="gnomeanimator.html"
>GnomeAnimator</A
> *animator,
                                             <GTKDOCLINK
HREF="GDKIMLIBIMAGE"
>GdkImlibImage</GTKDOCLINK
> *image,
                                             <GTKDOCLINK
HREF="GINT"
>gint</GTKDOCLINK
> x_offset,
                                             <GTKDOCLINK
HREF="GINT"
>gint</GTKDOCLINK
> y_offset,
                                             <GTKDOCLINK
HREF="GUINT32"
>guint32</GTKDOCLINK
> interval,
                                             <GTKDOCLINK
HREF="GUINT"
>guint</GTKDOCLINK
> width,
                                             <GTKDOCLINK
HREF="GUINT"
>guint</GTKDOCLINK
> height);
<GTKDOCLINK
HREF="GBOOLEAN"
>gboolean</GTKDOCLINK
>    <A
HREF="gnomeanimator.html#GNOME-ANIMATOR-APPEND-FRAME-FROM-IMLIB"
>gnome_animator_append_frame_from_imlib</A
>
                                            (<A
HREF="gnomeanimator.html"
>GnomeAnimator</A
> *animator,
                                             <GTKDOCLINK
HREF="GDKIMLIBIMAGE"
>GdkImlibImage</GTKDOCLINK
> *image,
                                             <GTKDOCLINK
HREF="GINT"
>gint</GTKDOCLINK
> x_offset,
                                             <GTKDOCLINK
HREF="GINT"
>gint</GTKDOCLINK
> y_offset,
                                             <GTKDOCLINK
HREF="GUINT32"
>guint32</GTKDOCLINK
> interval);
<GTKDOCLINK
HREF="GBOOLEAN"
>gboolean</GTKDOCLINK
>    <A
HREF="gnomeanimator.html#GNOME-ANIMATOR-APPEND-FRAME-FROM-FILE-AT-SIZE"
>gnome_animator_append_frame_from_file_at_size</A
>
                                            (<A
HREF="gnomeanimator.html"
>GnomeAnimator</A
> *animator,
                                             const <GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
> *name,
                                             <GTKDOCLINK
HREF="GINT"
>gint</GTKDOCLINK
> x_offset,
                                             <GTKDOCLINK
HREF="GINT"
>gint</GTKDOCLINK
> y_offset,
                                             <GTKDOCLINK
HREF="GUINT32"
>guint32</GTKDOCLINK
> interval,
                                             <GTKDOCLINK
HREF="GUINT"
>guint</GTKDOCLINK
> width,
                                             <GTKDOCLINK
HREF="GUINT"
>guint</GTKDOCLINK
> height);
<GTKDOCLINK
HREF="GBOOLEAN"
>gboolean</GTKDOCLINK
>    <A
HREF="gnomeanimator.html#GNOME-ANIMATOR-APPEND-FRAME-FROM-FILE"
>gnome_animator_append_frame_from_file</A
>
                                            (<A
HREF="gnomeanimator.html"
>GnomeAnimator</A
> *animator,
                                             const <GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
> *name,
                                             <GTKDOCLINK
HREF="GINT"
>gint</GTKDOCLINK
> x_offset,
                                             <GTKDOCLINK
HREF="GINT"
>gint</GTKDOCLINK
> y_offset,
                                             <GTKDOCLINK
HREF="GUINT32"
>guint32</GTKDOCLINK
> interval);
<GTKDOCLINK
HREF="GBOOLEAN"
>gboolean</GTKDOCLINK
>    <A
HREF="gnomeanimator.html#GNOME-ANIMATOR-APPEND-FRAMES-FROM-IMLIB-AT-SIZE"
>gnome_animator_append_frames_from_imlib_at_size</A
>
                                            (<A
HREF="gnomeanimator.html"
>GnomeAnimator</A
> *animator,
                                             <GTKDOCLINK
HREF="GDKIMLIBIMAGE"
>GdkImlibImage</GTKDOCLINK
> *image,
                                             <GTKDOCLINK
HREF="GINT"
>gint</GTKDOCLINK
> x_offset,
                                             <GTKDOCLINK
HREF="GINT"
>gint</GTKDOCLINK
> y_offset,
                                             <GTKDOCLINK
HREF="GUINT32"
>guint32</GTKDOCLINK
> interval,
                                             <GTKDOCLINK
HREF="GINT"
>gint</GTKDOCLINK
> x_unit,
                                             <GTKDOCLINK
HREF="GUINT"
>guint</GTKDOCLINK
> width,
                                             <GTKDOCLINK
HREF="GUINT"
>guint</GTKDOCLINK
> height);
<GTKDOCLINK
HREF="GBOOLEAN"
>gboolean</GTKDOCLINK
>    <A
HREF="gnomeanimator.html#GNOME-ANIMATOR-APPEND-FRAMES-FROM-IMLIB"
>gnome_animator_append_frames_from_imlib</A
>
                                            (<A
HREF="gnomeanimator.html"
>GnomeAnimator</A
> *animator,
                                             <GTKDOCLINK
HREF="GDKIMLIBIMAGE"
>GdkImlibImage</GTKDOCLINK
> *image,
                                             <GTKDOCLINK
HREF="GINT"
>gint</GTKDOCLINK
> x_offset,
                                             <GTKDOCLINK
HREF="GINT"
>gint</GTKDOCLINK
> y_offset,
                                             <GTKDOCLINK
HREF="GUINT32"
>guint32</GTKDOCLINK
> interval,
                                             <GTKDOCLINK
HREF="GINT"
>gint</GTKDOCLINK
> x_unit);
<GTKDOCLINK
HREF="GBOOLEAN"
>gboolean</GTKDOCLINK
>    <A
HREF="gnomeanimator.html#GNOME-ANIMATOR-APPEND-FRAMES-FROM-FILE-AT-SIZE"
>gnome_animator_append_frames_from_file_at_size</A
>
                                            (<A
HREF="gnomeanimator.html"
>GnomeAnimator</A
> *animator,
                                             const <GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
> *name,
                                             <GTKDOCLINK
HREF="GINT"
>gint</GTKDOCLINK
> x_offset,
                                             <GTKDOCLINK
HREF="GINT"
>gint</GTKDOCLINK
> y_offset,
                                             <GTKDOCLINK
HREF="GUINT32"
>guint32</GTKDOCLINK
> interval,
                                             <GTKDOCLINK
HREF="GINT"
>gint</GTKDOCLINK
> x_unit,
                                             <GTKDOCLINK
HREF="GUINT"
>guint</GTKDOCLINK
> width,
                                             <GTKDOCLINK
HREF="GUINT"
>guint</GTKDOCLINK
> height);
<GTKDOCLINK
HREF="GBOOLEAN"
>gboolean</GTKDOCLINK
>    <A
HREF="gnomeanimator.html#GNOME-ANIMATOR-APPEND-FRAMES-FROM-FILE"
>gnome_animator_append_frames_from_file</A
>
                                            (<A
HREF="gnomeanimator.html"
>GnomeAnimator</A
> *animator,
                                             const <GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
> *name,
                                             <GTKDOCLINK
HREF="GINT"
>gint</GTKDOCLINK
> x_offset,
                                             <GTKDOCLINK
HREF="GINT"
>gint</GTKDOCLINK
> y_offset,
                                             <GTKDOCLINK
HREF="GUINT32"
>guint32</GTKDOCLINK
> interval,
                                             <GTKDOCLINK
HREF="GINT"
>gint</GTKDOCLINK
> x_unit);
<GTKDOCLINK
HREF="GBOOLEAN"
>gboolean</GTKDOCLINK
>    <A
HREF="gnomeanimator.html#GNOME-ANIMATOR-APPEND-FRAME-FROM-GNOME-PIXMAP"
>gnome_animator_append_frame_from_gnome_pixmap</A
>
                                            (<A
HREF="gnomeanimator.html"
>GnomeAnimator</A
> *animator,
                                             <A
HREF="gnomepixmap.html"
>GnomePixmap</A
> *pixmap,
                                             <GTKDOCLINK
HREF="GINT"
>gint</GTKDOCLINK
> x_offset,
                                             <GTKDOCLINK
HREF="GINT"
>gint</GTKDOCLINK
> y_offset,
                                             <GTKDOCLINK
HREF="GUINT32"
>guint32</GTKDOCLINK
> interval);
void        <A
HREF="gnomeanimator.html#GNOME-ANIMATOR-START"
>gnome_animator_start</A
>            (<A
HREF="gnomeanimator.html"
>GnomeAnimator</A
> *animator);
void        <A
HREF="gnomeanimator.html#GNOME-ANIMATOR-STOP"
>gnome_animator_stop</A
>             (<A
HREF="gnomeanimator.html"
>GnomeAnimator</A
> *animator);
<GTKDOCLINK
HREF="GBOOLEAN"
>gboolean</GTKDOCLINK
>    <A
HREF="gnomeanimator.html#GNOME-ANIMATOR-ADVANCE"
>gnome_animator_advance</A
>          (<A
HREF="gnomeanimator.html"
>GnomeAnimator</A
> *animator,
                                             <GTKDOCLINK
HREF="GINT"
>gint</GTKDOCLINK
> num);
void        <A
HREF="gnomeanimator.html#GNOME-ANIMATOR-GOTO-FRAME"
>gnome_animator_goto_frame</A
>       (<A
HREF="gnomeanimator.html"
>GnomeAnimator</A
> *animator,
                                             <GTKDOCLINK
HREF="GUINT"
>guint</GTKDOCLINK
> frame_number);
<GTKDOCLINK
HREF="GUINT"
>guint</GTKDOCLINK
>       <A
HREF="gnomeanimator.html#GNOME-ANIMATOR-GET-CURRENT-FRAME-NUMBER"
>gnome_animator_get_current_frame_number</A
>
                                            (<A
HREF="gnomeanimator.html"
>GnomeAnimator</A
> *animator);
<A
HREF="gnomeanimator.html#GNOMEANIMATORSTATUS"
>GnomeAnimatorStatus</A
> <A
HREF="gnomeanimator.html#GNOME-ANIMATOR-GET-STATUS"
>gnome_animator_get_status</A
>
                                            (<A
HREF="gnomeanimator.html"
>GnomeAnimator</A
> *animator);
void        <A
HREF="gnomeanimator.html#GNOME-ANIMATOR-SET-PLAYBACK-SPEED"
>gnome_animator_set_playback_speed</A
>
                                            (<A
HREF="gnomeanimator.html"
>GnomeAnimator</A
> *animator,
                                             <GTKDOCLINK
HREF="GDOUBLE"
>gdouble</GTKDOCLINK
> speed);
<GTKDOCLINK
HREF="GDOUBLE"
>gdouble</GTKDOCLINK
>     <A
HREF="gnomeanimator.html#GNOME-ANIMATOR-GET-PLAYBACK-SPEED"
>gnome_animator_get_playback_speed</A
>
                                            (<A
HREF="gnomeanimator.html"
>GnomeAnimator</A
> *animator);&#13;</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN8120"
></A
><H2
>Object Hierarchy</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;  <GTKDOCLINK
HREF="GTKOBJECT"
>GtkObject</GTKDOCLINK
>
   +----<GTKDOCLINK
HREF="GTKWIDGET"
>GtkWidget</GTKDOCLINK
>
         +----GnomeAnimator</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN8125"
></A
><H2
>Description</H2
><P
><SPAN
CLASS="TYPE"
>GnomeAnimator</SPAN
> is a widget that is able to play simple
animations in the GTK+ event loop.</P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN8129"
></A
><H2
>Details</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN8131"
></A
><H3
><A
NAME="GNOMEANIMATOR-STRUCT"
></A
>struct GnomeAnimator</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>struct GnomeAnimator;</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN8136"
></A
><H3
><A
NAME="GNOMEANIMATORSTATUS"
></A
>enum GnomeAnimatorStatus</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>typedef enum
{
    GNOME_ANIMATOR_STATUS_STOPPED,
    GNOME_ANIMATOR_STATUS_RUNNING
} GnomeAnimatorStatus;</PRE
></TD
></TR
></TABLE
><P
>This enumeration is used to determine if the animator object is running or
not. Use <TT
CLASS="FUNCTION"
><A
HREF="gnomeanimator.html#GNOME-ANIMATOR-GET-STATUS"
>gnome_animator_get_status</A
>()</TT
> to
retrieve it.</P
><P
></P
><UL
><LI
><P
>      <TT
CLASS="LITERAL"
>GNOME_ANIMATOR_STATUS_STOPPED</TT
>: The value used 
      when the GnomeAnimator object is not running.
    </P
></LI
><LI
><P
><TT
CLASS="LITERAL"
>GNOME_ANIMATOR_STATUS_RUNNING</TT
>: The value used
		when the GnomeAnimator object is running.
	</P
></LI
></UL
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN8150"
></A
><H3
><A
NAME="GNOMEANIMATORLOOPTYPE"
></A
>enum GnomeAnimatorLoopType</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>typedef enum
{
    /* No loop: after the last (first) frame is played, the animation
       is stopped.  */
    GNOME_ANIMATOR_LOOP_NONE,

    /* After the last (first) frame is played, restart from the first
       (last) frame.  */
    GNOME_ANIMATOR_LOOP_RESTART,

    /* After the last (first) frame is played, the playback direction
       is reversed.  */
    GNOME_ANIMATOR_LOOP_PING_PONG
} GnomeAnimatorLoopType;</PRE
></TD
></TR
></TABLE
><P
>This enumeration is used to set the type of animation loop desired in the
GnomeAnimator object.</P
><P
></P
><UL
><LI
><P
><TT
CLASS="LITERAL"
>GNOME_ANIMATOR_LOOP_NONE</TT
>: Do not use a loop in
		the animation. When the animation is played, it will not
		repeat when it is completed.</P
></LI
><LI
><P
><TT
CLASS="LITERAL"
>GNOME_ANIMATOR_LOOP_RESTART</TT
>: After the animation
		is played, loop back to the beginning of the animation and
		replay it. If the animation is playing forward, the loop
		will return to the first frame; if it is being played
		backward, the loop will return to the last frame in the
		sequence.</P
></LI
><LI
><P
><TT
CLASS="LITERAL"
>GNOME_ANIMATOR_LOOP_PING_PONG</TT
>: When the animation
		sequence is completed, the playback direction is reversed.
		</P
></LI
></UL
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN8165"
></A
><H3
><A
NAME="GNOMEANIMATORFRAME"
></A
>struct GnomeAnimatorFrame</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>struct GnomeAnimatorFrame;</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN8170"
></A
><H3
><A
NAME="GNOMEANIMATORPRIVATE"
></A
>struct GnomeAnimatorPrivate</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>struct GnomeAnimatorPrivate;</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN8175"
></A
><H3
><A
NAME="GNOME-ANIMATOR-NEW-WITH-SIZE"
></A
>gnome_animator_new_with_size ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><GTKDOCLINK
HREF="GTKWIDGET"
>GtkWidget</GTKDOCLINK
>*  gnome_animator_new_with_size    (<GTKDOCLINK
HREF="GUINT"
>guint</GTKDOCLINK
> width,
                                             <GTKDOCLINK
HREF="GUINT"
>guint</GTKDOCLINK
> height);</PRE
></TD
></TR
></TABLE
><P
>Creates a new animator widget of the specified size.</P
><P
>Create a GnomeAnimator object of the specified size.</P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>width</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> pixel width of animator widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>height</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> pixel height of animator widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Pointer to new animator widget.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN8201"
></A
><H3
><A
NAME="GNOME-ANIMATOR-SET-LOOP-TYPE"
></A
>gnome_animator_set_loop_type ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_animator_set_loop_type    (<A
HREF="gnomeanimator.html"
>GnomeAnimator</A
> *animator,
                                             <A
HREF="gnomeanimator.html#GNOMEANIMATORLOOPTYPE"
>GnomeAnimatorLoopType</A
> loop_type);</PRE
></TD
></TR
></TABLE
><P
>Sets desired animation loop type.  Available loop
types are <TT
CLASS="LITERAL"
>GNOME_ANIMATOR_LOOP_NONE</TT
> (play animation once only),
<TT
CLASS="LITERAL"
>GNOME_ANIMATOR_LOOP_RESTART</TT
> (play animation over and over again),
and <TT
CLASS="LITERAL"
>GNOME_ANIMATOR_LOOP_PING_PONG</TT
> (play animation over and over
again, reversing the playing direction every time.)</P
><P
>Sets the type of loop the animator will use.</P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>animator</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Animator widget to be updated</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>loop_type</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Type of animation loop desired</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN8225"
></A
><H3
><A
NAME="GNOME-ANIMATOR-GET-LOOP-TYPE"
></A
>gnome_animator_get_loop_type ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF="gnomeanimator.html#GNOMEANIMATORLOOPTYPE"
>GnomeAnimatorLoopType</A
> gnome_animator_get_loop_type
                                            (<A
HREF="gnomeanimator.html"
>GnomeAnimator</A
> *animator);</PRE
></TD
></TR
></TABLE
><P
>Obtains current animator loop type.  Available loop
types are <TT
CLASS="LITERAL"
>GNOME_ANIMATOR_LOOP_NONE</TT
> (play animation once only),
<TT
CLASS="LITERAL"
>GNOME_ANIMATOR_LOOP_RESTART</TT
> (play animation over and over again),
and <TT
CLASS="LITERAL"
>GNOME_ANIMATOR_LOOP_PING_PONG</TT
> (play animation over and over
again, reversing the playing direction every time.)</P
><P
>Determine the type of loop being used on the animator object.</P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>animator</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Animator widget to be queried</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Loop type.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN8249"
></A
><H3
><A
NAME="GNOME-ANIMATOR-SET-PLAYBACK-DIRECTION"
></A
>gnome_animator_set_playback_direction ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_animator_set_playback_direction
                                            (<A
HREF="gnomeanimator.html"
>GnomeAnimator</A
> *animator,
                                             <GTKDOCLINK
HREF="GINT"
>gint</GTKDOCLINK
> playback_direction);</PRE
></TD
></TR
></TABLE
><P
>Sets direction (forwards or backwards) to play the
animation.  If <TT
CLASS="PARAMETER"
><I
>playback_direction</I
></TT
> is a positive number, the
animation is played from the first to the last frame.  If
<TT
CLASS="PARAMETER"
><I
>playback_direction</I
></TT
> is negative, the animation is played from the
last to the first frame.</P
><P
>Set the direction the animation should be played back. Setting a positive
value will cause the animator to play forward; a negative value will cause
it to play backward.</P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>animator</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Animator widget to be updated</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>playback_direction</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Direction animation should be played.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN8272"
></A
><H3
><A
NAME="GNOME-ANIMATOR-GET-PLAYBACK-DIRECTION"
></A
>gnome_animator_get_playback_direction ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><GTKDOCLINK
HREF="GINT"
>gint</GTKDOCLINK
>        gnome_animator_get_playback_direction
                                            (<A
HREF="gnomeanimator.html"
>GnomeAnimator</A
> *animator);</PRE
></TD
></TR
></TABLE
><P
>Returns the current playing direction (forwards or
backwards) for the animation.  If the returned value is a positive
number, the animation is played from the first to the last frame.
If it is negative, the animation is played from the last to the
first frame.</P
><P
>Determines the direction of playback.</P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>animator</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Animator widget to be updated</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Positive or negative number indicating direction.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN8293"
></A
><H3
><A
NAME="GNOME-ANIMATOR-APPEND-FRAME-FROM-IMLIB-AT-SIZE"
></A
>gnome_animator_append_frame_from_imlib_at_size ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><GTKDOCLINK
HREF="GBOOLEAN"
>gboolean</GTKDOCLINK
>    gnome_animator_append_frame_from_imlib_at_size
                                            (<A
HREF="gnomeanimator.html"
>GnomeAnimator</A
> *animator,
                                             <GTKDOCLINK
HREF="GDKIMLIBIMAGE"
>GdkImlibImage</GTKDOCLINK
> *image,
                                             <GTKDOCLINK
HREF="GINT"
>gint</GTKDOCLINK
> x_offset,
                                             <GTKDOCLINK
HREF="GINT"
>gint</GTKDOCLINK
> y_offset,
                                             <GTKDOCLINK
HREF="GUINT32"
>guint32</GTKDOCLINK
> interval,
                                             <GTKDOCLINK
HREF="GUINT"
>guint</GTKDOCLINK
> width,
                                             <GTKDOCLINK
HREF="GUINT"
>guint</GTKDOCLINK
> height);</PRE
></TD
></TR
></TABLE
><P
>Adds frame contained within a &amp;GdkImlibImage image at
the end of the current animation.  If <TT
CLASS="PARAMETER"
><I
>width</I
></TT
> and <TT
CLASS="PARAMETER"
><I
>height</I
></TT
> are
different from the actual <TT
CLASS="PARAMETER"
><I
>image</I
></TT
> size, the image is scaled
proportionally.  The frame display interval is <TT
CLASS="PARAMETER"
><I
>interval</I
></TT
> is divided
by the playback speed.</P
><P
>Append a frame from a GdkImlibImage to the GnomeAnimator object and render
it.</P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>animator</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Animator widget to be updated</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>image</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Image to be added to animator</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>x_offset</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> horizontal offset of frame within animator widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>y_offset</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> vertical offset of frame within animator widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>interval</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Number of milliseconds to delay before showing next frame</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>width</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> pixel width of frame</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>height</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> pixel height of frame</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> <TT
CLASS="LITERAL"
>TRUE</TT
> if append succeeded.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN8349"
></A
><H3
><A
NAME="GNOME-ANIMATOR-APPEND-FRAME-FROM-IMLIB"
></A
>gnome_animator_append_frame_from_imlib ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><GTKDOCLINK
HREF="GBOOLEAN"
>gboolean</GTKDOCLINK
>    gnome_animator_append_frame_from_imlib
                                            (<A
HREF="gnomeanimator.html"
>GnomeAnimator</A
> *animator,
                                             <GTKDOCLINK
HREF="GDKIMLIBIMAGE"
>GdkImlibImage</GTKDOCLINK
> *image,
                                             <GTKDOCLINK
HREF="GINT"
>gint</GTKDOCLINK
> x_offset,
                                             <GTKDOCLINK
HREF="GINT"
>gint</GTKDOCLINK
> y_offset,
                                             <GTKDOCLINK
HREF="GUINT32"
>guint32</GTKDOCLINK
> interval);</PRE
></TD
></TR
></TABLE
><P
>Adds frame contained within a &amp;GdkImlibImage image at
the end of the current animation.  The frame display interval is
<TT
CLASS="PARAMETER"
><I
>interval</I
></TT
> is divided by the playback speed.</P
><P
>Adds frame contained within a GdkImlibImage image at the end of the
current animation.  The frame display interval is divided by the playback
speed.</P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>animator</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Animator widget to be updated</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>image</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Image to be added to animator</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>x_offset</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> horizontal offset of frame within animator widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>y_offset</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> vertical offset of frame within animator widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>interval</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Number of milliseconds to delay before showing next frame</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> <TT
CLASS="LITERAL"
>TRUE</TT
> if append succeeded.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN8392"
></A
><H3
><A
NAME="GNOME-ANIMATOR-APPEND-FRAME-FROM-FILE-AT-SIZE"
></A
>gnome_animator_append_frame_from_file_at_size ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><GTKDOCLINK
HREF="GBOOLEAN"
>gboolean</GTKDOCLINK
>    gnome_animator_append_frame_from_file_at_size
                                            (<A
HREF="gnomeanimator.html"
>GnomeAnimator</A
> *animator,
                                             const <GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
> *name,
                                             <GTKDOCLINK
HREF="GINT"
>gint</GTKDOCLINK
> x_offset,
                                             <GTKDOCLINK
HREF="GINT"
>gint</GTKDOCLINK
> y_offset,
                                             <GTKDOCLINK
HREF="GUINT32"
>guint32</GTKDOCLINK
> interval,
                                             <GTKDOCLINK
HREF="GUINT"
>guint</GTKDOCLINK
> width,
                                             <GTKDOCLINK
HREF="GUINT"
>guint</GTKDOCLINK
> height);</PRE
></TD
></TR
></TABLE
><P
>Adds frame from the given file to the end of the
current animation.  If <TT
CLASS="PARAMETER"
><I
>width</I
></TT
> and <TT
CLASS="PARAMETER"
><I
>height</I
></TT
> are different from the
actual <TT
CLASS="PARAMETER"
><I
>image</I
></TT
> size, the image is scaled proportionally.  The frame
display interval is <TT
CLASS="PARAMETER"
><I
>interval</I
></TT
> divided by the playback speed.</P
><P
>Appends a frame from a file to a GnomeAnimator widget. If the specified
width and height variables are different from the actual size of the
image, it is scaled proportionally. The frame display interval is
<TT
CLASS="PARAMETER"
><I
>interval</I
></TT
> divided by the playback speed.</P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>animator</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Animator widget to be updated</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>name</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> File path of image to be added to animator</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>x_offset</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> horizontal offset of frame within animator widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>y_offset</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> vertical offset of frame within animator widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>interval</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Number of milliseconds to delay before showing next frame</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>width</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> pixel width of frame</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>height</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> pixel height of frame</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> <TT
CLASS="LITERAL"
>TRUE</TT
> if append succeeded.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN8449"
></A
><H3
><A
NAME="GNOME-ANIMATOR-APPEND-FRAME-FROM-FILE"
></A
>gnome_animator_append_frame_from_file ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><GTKDOCLINK
HREF="GBOOLEAN"
>gboolean</GTKDOCLINK
>    gnome_animator_append_frame_from_file
                                            (<A
HREF="gnomeanimator.html"
>GnomeAnimator</A
> *animator,
                                             const <GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
> *name,
                                             <GTKDOCLINK
HREF="GINT"
>gint</GTKDOCLINK
> x_offset,
                                             <GTKDOCLINK
HREF="GINT"
>gint</GTKDOCLINK
> y_offset,
                                             <GTKDOCLINK
HREF="GUINT32"
>guint32</GTKDOCLINK
> interval);</PRE
></TD
></TR
></TABLE
><P
>Adds frame from the given file to the end of the
current animation.  The frame display interval is <TT
CLASS="PARAMETER"
><I
>interval</I
></TT
> divided
by the playback speed.</P
><P
>Append a frame from a given file to a GnomeAnimator widget. The frame
display interval is <TT
CLASS="PARAMETER"
><I
>interval</I
></TT
> divided by the playback speed.</P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>animator</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Animator widget to be updated</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>name</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> File path of image to be added to animator</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>x_offset</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> horizontal offset of frame within animator widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>y_offset</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> vertical offset of frame within animator widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>interval</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Number of milliseconds to delay before showing next frame</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> <TT
CLASS="LITERAL"
>TRUE</TT
> if append succeeded.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN8493"
></A
><H3
><A
NAME="GNOME-ANIMATOR-APPEND-FRAMES-FROM-IMLIB-AT-SIZE"
></A
>gnome_animator_append_frames_from_imlib_at_size ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><GTKDOCLINK
HREF="GBOOLEAN"
>gboolean</GTKDOCLINK
>    gnome_animator_append_frames_from_imlib_at_size
                                            (<A
HREF="gnomeanimator.html"
>GnomeAnimator</A
> *animator,
                                             <GTKDOCLINK
HREF="GDKIMLIBIMAGE"
>GdkImlibImage</GTKDOCLINK
> *image,
                                             <GTKDOCLINK
HREF="GINT"
>gint</GTKDOCLINK
> x_offset,
                                             <GTKDOCLINK
HREF="GINT"
>gint</GTKDOCLINK
> y_offset,
                                             <GTKDOCLINK
HREF="GUINT32"
>guint32</GTKDOCLINK
> interval,
                                             <GTKDOCLINK
HREF="GINT"
>gint</GTKDOCLINK
> x_unit,
                                             <GTKDOCLINK
HREF="GUINT"
>guint</GTKDOCLINK
> width,
                                             <GTKDOCLINK
HREF="GUINT"
>guint</GTKDOCLINK
> height);</PRE
></TD
></TR
></TABLE
><P
>Adds multiple frames contained within a &amp;GdkImlibImage
image at the end of the current animation.  Each frame within the
image should be next to one another in a single, horizontal row.
If <TT
CLASS="PARAMETER"
><I
>width</I
></TT
> and <TT
CLASS="PARAMETER"
><I
>height</I
></TT
> are different from the actual frame size, the
image is scaled proportionally.  The frame display interval is
<TT
CLASS="PARAMETER"
><I
>interval</I
></TT
> divided by the playback speed.</P
><P
>Appends multiple frames contained within a GdkImlibImage image to a
GnomeAnimator widget. Each frame within the image should be next to one
another in a single, horizontal row.  If <TT
CLASS="PARAMETER"
><I
>width</I
></TT
> and/or <TT
CLASS="PARAMETER"
><I
>height</I
></TT
> are
different from the actual size of the frame, the image will be scaled
proportionally.  The frame display interval is <TT
CLASS="PARAMETER"
><I
>interval</I
></TT
> divided by the
playback speed.</P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>animator</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Animator widget to be updated</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>image</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Image containing frames to be added to animator</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>x_offset</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> horizontal offset of a frame within animator widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>y_offset</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> vertical offset of a frame within animator widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>interval</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Number of milliseconds to delay before showing next frame</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>x_unit</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> pixel width of a single frame</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>width</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> pixel width of frame</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>height</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> pixel height of frame</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> <TT
CLASS="LITERAL"
>TRUE</TT
> if append succeeded.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN8556"
></A
><H3
><A
NAME="GNOME-ANIMATOR-APPEND-FRAMES-FROM-IMLIB"
></A
>gnome_animator_append_frames_from_imlib ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><GTKDOCLINK
HREF="GBOOLEAN"
>gboolean</GTKDOCLINK
>    gnome_animator_append_frames_from_imlib
                                            (<A
HREF="gnomeanimator.html"
>GnomeAnimator</A
> *animator,
                                             <GTKDOCLINK
HREF="GDKIMLIBIMAGE"
>GdkImlibImage</GTKDOCLINK
> *image,
                                             <GTKDOCLINK
HREF="GINT"
>gint</GTKDOCLINK
> x_offset,
                                             <GTKDOCLINK
HREF="GINT"
>gint</GTKDOCLINK
> y_offset,
                                             <GTKDOCLINK
HREF="GUINT32"
>guint32</GTKDOCLINK
> interval,
                                             <GTKDOCLINK
HREF="GINT"
>gint</GTKDOCLINK
> x_unit);</PRE
></TD
></TR
></TABLE
><P
>Adds multiple frames contained within a &amp;GdkImlibImage
image to the end of the current animation.  Each frame within the
image should be next to one another in a single, horizontal row.
The frame display interval is <TT
CLASS="PARAMETER"
><I
>interval</I
></TT
> divided by the
playbackspeed.</P
><P
>Append multiple frames contained within a GdkImlibImage image to the end
of a GnomeAnimator widget. Each frame within the image should be next to
one another in a single, horizontal row.  The frame display interval is
<TT
CLASS="PARAMETER"
><I
>interval</I
></TT
> divided by the playback speed.</P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>animator</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Animator widget to be updated</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>image</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Image containing frames to be added to animator</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>x_offset</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> horizontal offset of a frame within animator widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>y_offset</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> vertical offset of a frame within animator widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>interval</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Number of milliseconds to delay before showing next frame</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>x_unit</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> pixel width of a single frame</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> <TT
CLASS="LITERAL"
>TRUE</TT
> if append succeeded.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN8605"
></A
><H3
><A
NAME="GNOME-ANIMATOR-APPEND-FRAMES-FROM-FILE-AT-SIZE"
></A
>gnome_animator_append_frames_from_file_at_size ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><GTKDOCLINK
HREF="GBOOLEAN"
>gboolean</GTKDOCLINK
>    gnome_animator_append_frames_from_file_at_size
                                            (<A
HREF="gnomeanimator.html"
>GnomeAnimator</A
> *animator,
                                             const <GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
> *name,
                                             <GTKDOCLINK
HREF="GINT"
>gint</GTKDOCLINK
> x_offset,
                                             <GTKDOCLINK
HREF="GINT"
>gint</GTKDOCLINK
> y_offset,
                                             <GTKDOCLINK
HREF="GUINT32"
>guint32</GTKDOCLINK
> interval,
                                             <GTKDOCLINK
HREF="GINT"
>gint</GTKDOCLINK
> x_unit,
                                             <GTKDOCLINK
HREF="GUINT"
>guint</GTKDOCLINK
> width,
                                             <GTKDOCLINK
HREF="GUINT"
>guint</GTKDOCLINK
> height);</PRE
></TD
></TR
></TABLE
><P
>Adds multiple frames contained within a single image
file to the end of the current animation.  Each frame within the
image should be next to one another in a single, horizontal row.
If <TT
CLASS="PARAMETER"
><I
>width</I
></TT
> and <TT
CLASS="PARAMETER"
><I
>height</I
></TT
> are different from the actual frame size, the
image is scaled proportionally.  The frame display interval is
<TT
CLASS="PARAMETER"
><I
>interval</I
></TT
> divided by the playback speed.</P
><P
>Load and render an image containing multiple frames, and append those
frames to the animator widget. Each frame within the image should be
next to one another in a single, horizontal row. If <TT
CLASS="PARAMETER"
><I
>width</I
></TT
> and/or <TT
CLASS="PARAMETER"
><I
>height</I
></TT
>
are different from the actual frame size, the image is scaled
proportionally.  The frame display interval is <TT
CLASS="PARAMETER"
><I
>interval</I
></TT
> divided by the
playback speed.&#13;</P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>animator</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Animator widget to be updated</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>name</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> File path to image containing frames to be added to animator</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>x_offset</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> horizontal offset of a frame within animator widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>y_offset</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> vertical offset of a frame within animator widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>interval</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Number of milliseconds to delay before showing next frame</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>x_unit</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> pixel width of a single frame</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>width</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> pixel width of frame</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>height</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> pixel height of frame</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> <TT
CLASS="LITERAL"
>TRUE</TT
> if append succeeded.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN8668"
></A
><H3
><A
NAME="GNOME-ANIMATOR-APPEND-FRAMES-FROM-FILE"
></A
>gnome_animator_append_frames_from_file ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><GTKDOCLINK
HREF="GBOOLEAN"
>gboolean</GTKDOCLINK
>    gnome_animator_append_frames_from_file
                                            (<A
HREF="gnomeanimator.html"
>GnomeAnimator</A
> *animator,
                                             const <GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
> *name,
                                             <GTKDOCLINK
HREF="GINT"
>gint</GTKDOCLINK
> x_offset,
                                             <GTKDOCLINK
HREF="GINT"
>gint</GTKDOCLINK
> y_offset,
                                             <GTKDOCLINK
HREF="GUINT32"
>guint32</GTKDOCLINK
> interval,
                                             <GTKDOCLINK
HREF="GINT"
>gint</GTKDOCLINK
> x_unit);</PRE
></TD
></TR
></TABLE
><P
>Adds multiple frames contained within a single image file
to the end of the current animation.  Each frame within the image
should be next to one another in a single, horizontal row.
The frame display interval is <TT
CLASS="PARAMETER"
><I
>interval</I
></TT
> divided by the playback_speed.</P
><P
>Load and render an image containing multiple frames, and append those
frames to the animator widget. Each frame within the image should be
next to one another in a single, horizontal row. The frame display
interval is <TT
CLASS="PARAMETER"
><I
>interval</I
></TT
> divided by the playback speed.</P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>animator</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Animator widget to be updated</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>name</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> File path to image containing frames to be added to animator</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>x_offset</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> horizontal offset of a frame within animator widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>y_offset</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> vertical offset of a frame within animator widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>interval</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Number of milliseconds to delay before showing next frame</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>x_unit</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> pixel width of a single frame</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> <TT
CLASS="LITERAL"
>TRUE</TT
> if append succeeded.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN8717"
></A
><H3
><A
NAME="GNOME-ANIMATOR-APPEND-FRAME-FROM-GNOME-PIXMAP"
></A
>gnome_animator_append_frame_from_gnome_pixmap ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><GTKDOCLINK
HREF="GBOOLEAN"
>gboolean</GTKDOCLINK
>    gnome_animator_append_frame_from_gnome_pixmap
                                            (<A
HREF="gnomeanimator.html"
>GnomeAnimator</A
> *animator,
                                             <A
HREF="gnomepixmap.html"
>GnomePixmap</A
> *pixmap,
                                             <GTKDOCLINK
HREF="GINT"
>gint</GTKDOCLINK
> x_offset,
                                             <GTKDOCLINK
HREF="GINT"
>gint</GTKDOCLINK
> y_offset,
                                             <GTKDOCLINK
HREF="GUINT32"
>guint32</GTKDOCLINK
> interval);</PRE
></TD
></TR
></TABLE
><P
>Adds frame contained within a &amp;GnomePixmap image to
the end of the current animation.  The frame display interval is
<TT
CLASS="PARAMETER"
><I
>interval</I
></TT
> divided by the playback speed.</P
><P
>Appends a frame from a GnomePixmap image to the animator widget.  The
frame display interval is <TT
CLASS="PARAMETER"
><I
>interval</I
></TT
> divided by the playback speed.</P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>animator</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Animator widget to be updated</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>pixmap</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> GNOME pixmap to be added to animator</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>x_offset</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> horizontal offset of frame within animator widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>y_offset</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> vertical offset of frame within animator widget</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>interval</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Number of milliseconds to delay before showing next frame</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> <TT
CLASS="LITERAL"
>TRUE</TT
> if append succeeded.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN8761"
></A
><H3
><A
NAME="GNOME-ANIMATOR-START"
></A
>gnome_animator_start ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_animator_start            (<A
HREF="gnomeanimator.html"
>GnomeAnimator</A
> *animator);</PRE
></TD
></TR
></TABLE
><P
>Initiate display of animated frames.</P
><P
>Begin animating the widget.</P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>animator</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Animator widget to be started</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN8777"
></A
><H3
><A
NAME="GNOME-ANIMATOR-STOP"
></A
>gnome_animator_stop ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_animator_stop             (<A
HREF="gnomeanimator.html"
>GnomeAnimator</A
> *animator);</PRE
></TD
></TR
></TABLE
><P
>Halts display of animated frames.  The current frame
in the animation will remain in the animator widget.</P
><P
>Stop an animator that is running.</P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>animator</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Animator widget to be stopped</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN8793"
></A
><H3
><A
NAME="GNOME-ANIMATOR-ADVANCE"
></A
>gnome_animator_advance ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><GTKDOCLINK
HREF="GBOOLEAN"
>gboolean</GTKDOCLINK
>    gnome_animator_advance          (<A
HREF="gnomeanimator.html"
>GnomeAnimator</A
> *animator,
                                             <GTKDOCLINK
HREF="GINT"
>gint</GTKDOCLINK
> num);</PRE
></TD
></TR
></TABLE
><P
>Advance the animator <TT
CLASS="PARAMETER"
><I
>num</I
></TT
> frames.  If <TT
CLASS="PARAMETER"
><I
>num</I
></TT
> is
positive, use the specified <TT
CLASS="PARAMETER"
><I
>playback_direction</I
></TT
>; if it is negative,
go in the opposite direction.  After the call, the animator is in
the same state it would be if it had actually executed the specified
number of iterations.</P
><P
>Advance the animator widget <TT
CLASS="PARAMETER"
><I
>num</I
></TT
> frames.  If <TT
CLASS="PARAMETER"
><I
>num</I
></TT
> is positive, use the
specified <TT
CLASS="PARAMETER"
><I
>playback_direction</I
></TT
>; if it is negative, go in the opposite
direction.  After the call, the animator is in the same state it would be
if it had actually executed the sppecified number of iterations.&#13;</P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>animator</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Animator widget to be updated</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>num</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Number of frames to advance by</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>  <TT
CLASS="LITERAL"
>TRUE</TT
> if the animator is now stopped.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN8826"
></A
><H3
><A
NAME="GNOME-ANIMATOR-GOTO-FRAME"
></A
>gnome_animator_goto_frame ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_animator_goto_frame       (<A
HREF="gnomeanimator.html"
>GnomeAnimator</A
> *animator,
                                             <GTKDOCLINK
HREF="GUINT"
>guint</GTKDOCLINK
> frame_number);</PRE
></TD
></TR
></TABLE
><P
>Jump to the specified <TT
CLASS="PARAMETER"
><I
>frame_number</I
></TT
> and display it.</P
><P
>Jump to the specified frame.  If <TT
CLASS="PARAMETER"
><I
>num_frame</I
></TT
> is greater than the total
number of frames, no action is taken.</P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>animator</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Animator widget to be updated</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>num_frame</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>Frame number to be made current.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN8849"
></A
><H3
><A
NAME="GNOME-ANIMATOR-GET-CURRENT-FRAME-NUMBER"
></A
>gnome_animator_get_current_frame_number ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><GTKDOCLINK
HREF="GUINT"
>guint</GTKDOCLINK
>       gnome_animator_get_current_frame_number
                                            (<A
HREF="gnomeanimator.html"
>GnomeAnimator</A
> *animator);</PRE
></TD
></TR
></TABLE
><P
>Obtains current frame number from animator widget.</P
><P
>Determine the current frame number of the animator widget.</P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>animator</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Animator widget to be queried</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Current frame number.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN8870"
></A
><H3
><A
NAME="GNOME-ANIMATOR-GET-STATUS"
></A
>gnome_animator_get_status ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF="gnomeanimator.html#GNOMEANIMATORSTATUS"
>GnomeAnimatorStatus</A
> gnome_animator_get_status
                                            (<A
HREF="gnomeanimator.html"
>GnomeAnimator</A
> *animator);</PRE
></TD
></TR
></TABLE
><P
>Obtains current status from animator widget.  Possible
return values include <TT
CLASS="LITERAL"
>GNOME_ANIMATOR_STATUS_STOPPED</TT
> and
<TT
CLASS="LITERAL"
>GNOME_ANIMATOR_STATUS_RUNNING</TT
>.</P
><P
>Obtain the current status from the animator widget.</P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>animator</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Animator widget to be queried</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Status constant.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN8893"
></A
><H3
><A
NAME="GNOME-ANIMATOR-SET-PLAYBACK-SPEED"
></A
>gnome_animator_set_playback_speed ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_animator_set_playback_speed
                                            (<A
HREF="gnomeanimator.html"
>GnomeAnimator</A
> *animator,
                                             <GTKDOCLINK
HREF="GDOUBLE"
>gdouble</GTKDOCLINK
> speed);</PRE
></TD
></TR
></TABLE
><P
>Sets the playback speed.  The delay between every
frame is divided by this value before being used.  As a
consequence, higher values give higher playback speeds.</P
><P
>Sets the playback speed.  The delay between every frame is divided by this
value before being used.  As a consequence, higher values give higher
playback speeds.</P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>animator</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Animator widget to be updated</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>speed</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Rate multiplier for playback speed</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN8914"
></A
><H3
><A
NAME="GNOME-ANIMATOR-GET-PLAYBACK-SPEED"
></A
>gnome_animator_get_playback_speed ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><GTKDOCLINK
HREF="GDOUBLE"
>gdouble</GTKDOCLINK
>     gnome_animator_get_playback_speed
                                            (<A
HREF="gnomeanimator.html"
>GnomeAnimator</A
> *animator);</PRE
></TD
></TR
></TABLE
><P
>Returns the current playback speed.</P
><P
>Obtain the current playback speed.</P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>animator</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Animator widget to be queried</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> &amp;double indicating the playback speed.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
></DIV
><DIV
CLASS="NAVFOOTER"
><BR
CLEAR="all"><BR><TABLE
WIDTH="100%"
BORDER="0"
BGCOLOR="#000000"
CELLPADDING="1"
CELLSPACING="0"
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomeabout.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>&#60;&#60;&#60; Previous Page</B
></FONT
></A
></TD
><TD
WIDTH="25%"
BGCOLOR="#0000C0"
ALIGN="center"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
><A
HREF="book1.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Home</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#00C000"
ALIGN="center"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
><A
HREF="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomeapp.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page &#62;&#62;&#62;</B
></FONT
></A
></TD
></TR
><TR
><TD
COLSPAN="2"
ALIGN="left"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>GnomeAbout</B
></FONT
></TD
><TD
COLSPAN="2"
ALIGN="right"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>GnomeApp</B
></FONT
></TD
></TR
></TABLE
></DIV
></BODY
></HTML
>