1 files changed, 76 insertions, 0 deletions

diff --git a/src/include/gnunet_gtk.h b/src/include/gnunet_gtk.h
index f340f03f..67caaf1b 100644
--- a/src/include/gnunet_gtk.h
+++ b/src/include/gnunet_gtk.h
@@ -254,6 +254,82 @@ void
 GNUNET_GTK_main_loop_quit (struct GNUNET_GTK_MainLoop *ml);
 
 
+/* ******************** animations ******************* */
+
+
+/**
+ * Handle for an animation.  Each animation file should only
+ * be loaded once and can then be used in multiple tree views.
+ */
+struct GNUNET_FS_AnimationContext;
+
+
+/**
+ * Handle to a tree view (and column) that contains animations.
+ * Whenever an animation is added to a tree view, this module
+ * must be told about the tree view and column for the animations
+ * to work.
+ */
+struct GNUNET_FS_AnimationTreeViewHandle;
+
+
+/**
+ * Create an animation context.  Usually animation contexts are
+ * created during the startup of the application and kept around
+ * until shutdown.
+ *
+ * @param filename name of the file with the animation to show
+ * @return context to use to get the animated pixbuf, NULL on error
+ */
+struct GNUNET_FS_AnimationContext *
+GNUNET_GTK_animation_context_create (const char *filename);
+
+
+/**
+ * Destroy an animation context.  Should only be called after the
+ * respective pixbufs are no longer needed.
+ *
+ * @param ac animation context to destroy.
+ */
+void
+GNUNET_GTK_animation_context_destroy (struct GNUNET_FS_AnimationContext *ac);
+
+
+/**
+ * Obtain the animated pixbuf from an animation context.  Note
+ * that the pixbuf will only properly work within GtkTreeViews
+ * where the column with the image has been registered using
+ * GNUNET_GTK_animation_tree_view_register.
+ *
+ * @param ac animation context to query
+ * @return pixbuf of the AC, NULL on error loading the pixbuf
+ */
+GdkPixbuf *
+GNUNET_GTK_animation_context_get_pixbuf (struct GNUNET_FS_AnimationContext *ac);
+
+
+/**
+ * Register a tree view column with the animation subsystem.  This
+ * column may contain animated pixbufs and thus needs to be periodically
+ * redrawn.
+ *
+ * @param tv tree view to register
+ * @param image_col column in the tree view with the animated pixbufs
+ * @return handle to unregister the tree view later
+ */
+struct GNUNET_FS_AnimationTreeViewHandle *
+GNUNET_GTK_animation_tree_view_register (GtkTreeView *tv,
+                                         GtkTreeViewColumn *image_col);
+
+
+/**
+ * Unregister a tree view, it no longer needs to be updated.
+ *
+ * @param atv tree view to unregister
+ */
+void
+GNUNET_GTK_animation_tree_view_unregister (struct GNUNET_FS_AnimationTreeViewHandle *atv);
+
 
 #endif
 /* end of gnunet_gtk.h */