[build] Add a ChangeLog generation rule
[clutter-gtk] / clutter-gtk / gtk-clutter-util.h
index 0c79b07..c228a01 100644 (file)
+/* gtk-clutter-util.h: GTK+ integration utilities
+ *
+ * Copyright (C) 2008 OpenedHand
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library. If not see <http://www.fsf.org/licensing>.
+ *
+ * Authors:
+ *   Emmanuele Bassi  <ebassi@openedhand.com>
+ */
+
+#if !defined(__CLUTTER_GTK_H_INSIDE__) && !defined(CLUTTER_GTK_COMPILATION)
+#error "Only <clutter-gtk/clutter-gtk.h> can be included directly."
+#endif
+
 #ifndef __GTK_CLUTTER_UTIL_H__
 #define __GTK_CLUTTER_UTIL_H__
 
-#include <gtk/gtkwidget.h>
-#include <clutter/clutter-color.h>
+#include <gtk/gtk.h>
+#include <clutter/clutter.h>
 
 G_BEGIN_DECLS
 
-void gtk_clutter_get_fg_color   (GtkWidget    *widget,
-                                 GtkStateType  state,
-                                 ClutterColor *color);
-void gtk_clutter_get_bg_color   (GtkWidget    *widget,
-                                 GtkStateType  state,
-                                 ClutterColor *color);
-void gtk_clutter_get_text_color (GtkWidget    *widget,
-                                 GtkStateType  state,
-                                 ClutterColor *color);
-void gtk_clutter_get_base_color (GtkWidget    *widget,
-                                 GtkStateType  state,
-                                 ClutterColor *color);
-
-ClutterActor *gtk_clutter_texture_new_from_pixbuf    (GdkPixbuf   *pixbuf);
-ClutterActor *gtk_clutter_texture_new_from_stock     (GtkWidget   *widget,
-                                                      const gchar *stock_id,
-                                                      GtkIconSize  size);
-ClutterActor *gtk_clutter_texture_new_from_icon_name (GtkWidget   *widget,
-                                                      const gchar *icon_name,
-                                                      GtkIconSize  size);
+/**
+ * ClutterGtkInitError:
+ * @CLUTTER_INIT_ERROR_LAST: Placeholder
+ * @CLUTTER_INIT_ERROR_GTK: Unable to initialize GTK+
+ *
+ * Extension of the #ClutterInitError enumeration for the integration
+ * with GTK+
+ *
+ * Since: 0.8
+ */
+typedef enum {
+  CLUTTER_INIT_ERROR_LAST = CLUTTER_INIT_ERROR_INTERNAL,
+
+  CLUTTER_INIT_ERROR_GTK  = (CLUTTER_INIT_ERROR_LAST - 1)
+} ClutterGtkInitError;
+
+ClutterInitError gtk_clutter_init           (int            *argc,
+                                             char         ***argv);
+ClutterInitError gtk_clutter_init_with_args (int            *argc,
+                                             char         ***argv,
+                                             const char     *parameter_string,
+                                             GOptionEntry   *entries,
+                                             const char     *translation_domain,
+                                             GError        **error);
+
+void          gtk_clutter_get_fg_color               (GtkWidget      *widget,
+                                                      GtkStateType    state,
+                                                      ClutterColor   *color);
+void          gtk_clutter_get_bg_color               (GtkWidget      *widget,
+                                                      GtkStateType    state,
+                                                      ClutterColor   *color);
+void          gtk_clutter_get_text_color             (GtkWidget      *widget,
+                                                      GtkStateType    state,
+                                                      ClutterColor   *color);
+void          gtk_clutter_get_text_aa_color          (GtkWidget      *widget,
+                                                      GtkStateType    state,
+                                                      ClutterColor   *color);
+void          gtk_clutter_get_base_color             (GtkWidget      *widget,
+                                                      GtkStateType    state,
+                                                      ClutterColor   *color);
+void          gtk_clutter_get_light_color            (GtkWidget      *widget,
+                                                      GtkStateType    state,
+                                                      ClutterColor   *color);
+void          gtk_clutter_get_dark_color             (GtkWidget      *widget,
+                                                      GtkStateType    state,
+                                                      ClutterColor   *color);
+void          gtk_clutter_get_mid_color              (GtkWidget      *widget,
+                                                      GtkStateType    state,
+                                                      ClutterColor   *color);
+
+ClutterActor *gtk_clutter_texture_new_from_pixbuf    (GdkPixbuf      *pixbuf);
+ClutterActor *gtk_clutter_texture_new_from_stock     (GtkWidget      *widget,
+                                                      const gchar    *stock_id,
+                                                      GtkIconSize     size);
+ClutterActor *gtk_clutter_texture_new_from_icon_name (GtkWidget      *widget,
+                                                      const gchar    *icon_name,
+                                                      GtkIconSize     size);
+void          gtk_clutter_texture_set_from_pixbuf    (ClutterTexture *texture,
+                                                      GdkPixbuf      *pixbuf);
+void          gtk_clutter_texture_set_from_stock     (ClutterTexture *texture,
+                                                      GtkWidget      *widget,
+                                                      const gchar    *stock_id,
+                                                      GtkIconSize     size);
+void          gtk_clutter_texture_set_from_icon_name (ClutterTexture *texture,
+                                                      GtkWidget      *widget,
+                                                      const gchar    *icon_name,
+                                                      GtkIconSize     size);
 
 G_END_DECLS