clutter-script.h 9.08 KB
Newer Older
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20
/*
 * Clutter.
 *
 * An OpenGL based 'interactive canvas' library.
 *
 * Authored By Matthew Allum  <mallum@openedhand.com>
 *
 * Copyright (C) 2006 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
21
 * License along with this library. If not, see <http://www.gnu.org/licenses/>.
22 23
 */

24 25 26
#ifndef __CLUTTER_SCRIPT_H__
#define __CLUTTER_SCRIPT_H__

27 28 29 30
#if !defined(__CLUTTER_H_INSIDE__) && !defined(CLUTTER_COMPILATION)
#error "Only <clutter/clutter.h> can be included directly."
#endif

31
#include <clutter/clutter-types.h>
32 33 34 35 36 37 38 39

G_BEGIN_DECLS

#define CLUTTER_TYPE_SCRIPT             (clutter_script_get_type ())
#define CLUTTER_SCRIPT(obj)             (G_TYPE_CHECK_INSTANCE_CAST ((obj), CLUTTER_TYPE_SCRIPT, ClutterScript))
#define CLUTTER_IS_SCRIPT(obj)          (G_TYPE_CHECK_INSTANCE_TYPE ((obj), CLUTTER_TYPE_SCRIPT))
#define CLUTTER_SCRIPT_CLASS(klass)     (G_TYPE_CHECK_CLASS_CAST ((klass), CLUTTER_TYPE_SCRIPT, ClutterScriptClass))
#define CLUTTER_IS_SCRIPT_CLASS(klass)  (G_TYPE_CHECK_CLASS_TYPE ((klass), CLUTTER_TYPE_SCRIPT))
40
#define CLUTTER_SCRIPT_GET_CLASS(obj)   (G_TYPE_INSTANCE_GET_CLASS ((obj), CLUTTER_TYPE_SCRIPT, ClutterScriptClass))
41 42 43 44 45

typedef struct _ClutterScript           ClutterScript;
typedef struct _ClutterScriptPrivate    ClutterScriptPrivate;
typedef struct _ClutterScriptClass      ClutterScriptClass;

46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70
/**
 * ClutterScriptConnectFunc:
 * @script: a #ClutterScript
 * @object: the object to connect
 * @signal_name: the name of the signal
 * @handler_name: the name of the signal handler
 * @connect_object: the object to connect the signal to, or %NULL
 * @flags: signal connection flags
 * @user_data: user data to pass to the signal handler
 *
 * This is the signature of a function used to connect signals.  It is used
 * by the clutter_script_connect_signals_full() function.  It is mainly
 * intended for interpreted language bindings, but could be useful where the
 * programmer wants more control over the signal connection process.
 *
 * Since: 0.6
 */
typedef void (* ClutterScriptConnectFunc) (ClutterScript *script,
                                           GObject       *object,
                                           const gchar   *signal_name,
                                           const gchar   *handler_name,
                                           GObject       *connect_object,
                                           GConnectFlags  flags,
                                           gpointer       user_data);

71 72
/**
 * ClutterScriptError:
73 74 75
 * @CLUTTER_SCRIPT_ERROR_INVALID_TYPE_FUNCTION: Type function not found
 *   or invalid
 * @CLUTTER_SCRIPT_ERROR_INVALID_PROPERTY: Property not found or invalid
76 77 78 79 80 81 82 83 84 85 86 87
 * @CLUTTER_SCRIPT_ERROR_INVALID_VALUE: Invalid value
 *
 * #ClutterScript error enumeration.
 *
 * Since: 0.6
 */
typedef enum {
  CLUTTER_SCRIPT_ERROR_INVALID_TYPE_FUNCTION,
  CLUTTER_SCRIPT_ERROR_INVALID_PROPERTY,
  CLUTTER_SCRIPT_ERROR_INVALID_VALUE
} ClutterScriptError;

88 89 90 91 92 93 94
/**
 * CLUTTER_SCRIPT_ERROR:
 *
 * Error domain for the #ClutterScript errors
 *
 * Since: 0.6
 */
95
#define CLUTTER_SCRIPT_ERROR    (clutter_script_error_quark ())
96
CLUTTER_AVAILABLE_IN_ALL
97 98
GQuark clutter_script_error_quark (void);

99 100 101 102 103 104 105 106
/**
 * ClutterScript:
 *
 * The #ClutterScript structure contains only private data
 * and should be accessed using the provided API
 *
 * Since: 0.6
 */
107 108 109 110 111 112 113 114
struct _ClutterScript
{
  /*< private >*/
  GObject parent_instance;

  ClutterScriptPrivate *priv;
};

115 116 117 118 119 120 121 122 123 124 125
/**
 * ClutterScriptClass:
 * @get_type_from_name: virtual function used to map a type name
 *   to a #GType. This function should only be overridden by
 *   language bindings in order to map native types to #GType.
 *   The default implementation is equivalent to g_type_from_name()
 *
 * The #ClutterScriptClass structure contains only private data
 *
 * Since: 0.6
 */
126 127 128 129 130
struct _ClutterScriptClass
{
  /*< private >*/
  GObjectClass parent_class;

131 132 133 134 135
  /*< public >*/
  GType (* get_type_from_name) (ClutterScript *script,
                                const gchar   *type_name);

  /*< private >*/
136 137 138 139 140 141 142 143 144 145 146
  /* padding, for future expansion */
  void (*_clutter_reserved1) (void);
  void (*_clutter_reserved2) (void);
  void (*_clutter_reserved3) (void);
  void (*_clutter_reserved4) (void);
  void (*_clutter_reserved5) (void);
  void (*_clutter_reserved6) (void);
  void (*_clutter_reserved7) (void);
  void (*_clutter_reserved8) (void);
};

147
CLUTTER_AVAILABLE_IN_ALL
148 149
GType clutter_script_get_type (void) G_GNUC_CONST;

150
CLUTTER_AVAILABLE_IN_ALL
151
ClutterScript * clutter_script_new                      (void);
152
CLUTTER_AVAILABLE_IN_ALL
153 154 155
guint           clutter_script_load_from_file           (ClutterScript             *script,
                                                         const gchar               *filename,
                                                         GError                   **error);
156
CLUTTER_AVAILABLE_IN_ALL
157 158 159 160
guint           clutter_script_load_from_data           (ClutterScript             *script,
                                                         const gchar               *data,
                                                         gssize                     length,
                                                         GError                   **error);
161
CLUTTER_AVAILABLE_IN_1_10
162 163 164
guint           clutter_script_load_from_resource       (ClutterScript             *script,
                                                         const gchar               *resource_path,
                                                         GError                   **error);
165

166
CLUTTER_AVAILABLE_IN_ALL
167 168
GObject *       clutter_script_get_object               (ClutterScript             *script,
                                                         const gchar               *name);
169
CLUTTER_AVAILABLE_IN_ALL
170 171 172
gint            clutter_script_get_objects              (ClutterScript             *script,
                                                         const gchar               *first_name,
                                                         ...) G_GNUC_NULL_TERMINATED;
173
CLUTTER_AVAILABLE_IN_ALL
174
GList *         clutter_script_list_objects             (ClutterScript             *script);
175
CLUTTER_AVAILABLE_IN_ALL
176 177
void            clutter_script_unmerge_objects          (ClutterScript             *script,
                                                         guint                      merge_id);
178
CLUTTER_AVAILABLE_IN_ALL
179 180
void            clutter_script_ensure_objects           (ClutterScript             *script);

181
CLUTTER_DEPRECATED_IN_1_12
182 183
void            clutter_script_add_states               (ClutterScript             *script,
                                                         const gchar               *name,
184
                                                         ClutterState              *state);
185 186

CLUTTER_DEPRECATED_IN_1_12
187 188
ClutterState *  clutter_script_get_states               (ClutterScript             *script,
                                                         const gchar               *name);
189

190
CLUTTER_AVAILABLE_IN_ALL
191 192
void            clutter_script_connect_signals          (ClutterScript             *script,
                                                         gpointer                   user_data);
193
CLUTTER_AVAILABLE_IN_ALL
194 195 196 197
void            clutter_script_connect_signals_full     (ClutterScript             *script,
                                                         ClutterScriptConnectFunc   func,
                                                         gpointer                   user_data);

198
CLUTTER_AVAILABLE_IN_ALL
199 200 201
void            clutter_script_add_search_paths         (ClutterScript             *script,
                                                         const gchar * const        paths[],
                                                         gsize                      n_paths);
202
CLUTTER_AVAILABLE_IN_ALL
203 204
gchar *         clutter_script_lookup_filename          (ClutterScript             *script,
                                                         const gchar               *filename) G_GNUC_MALLOC;
205
CLUTTER_AVAILABLE_IN_ALL
206 207 208
GType           clutter_script_get_type_from_name       (ClutterScript             *script,
                                                         const gchar               *type_name);

209 210 211 212 213 214
CLUTTER_AVAILABLE_IN_1_10
void            clutter_script_set_translation_domain   (ClutterScript             *script,
                                                         const gchar               *domain);
CLUTTER_AVAILABLE_IN_1_10
const gchar *   clutter_script_get_translation_domain   (ClutterScript             *script);

215
CLUTTER_AVAILABLE_IN_ALL
216
const gchar *   clutter_get_script_id                   (GObject                   *gobject);
217

218 219 220
G_END_DECLS

#endif /* __CLUTTER_SCRIPT_H__ */