2006-05-29 04:59:36 -04:00
|
|
|
/*
|
|
|
|
|
* 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
|
2010-03-01 07:56:10 -05:00
|
|
|
* License along with this library. If not, see <http://www.gnu.org/licenses/>.
|
|
|
|
|
*
|
|
|
|
|
*
|
2006-05-29 04:59:36 -04:00
|
|
|
*/
|
|
|
|
|
|
2010-03-01 06:12:16 -05:00
|
|
|
#ifndef __CLUTTER_PRIVATE_H__
|
|
|
|
|
#define __CLUTTER_PRIVATE_H__
|
2006-05-29 04:59:36 -04:00
|
|
|
|
|
|
|
|
#include <glib.h>
|
|
|
|
|
|
2010-06-03 07:56:17 -04:00
|
|
|
#include <glib/gi18n-lib.h>
|
|
|
|
|
|
2011-05-16 11:04:27 -04:00
|
|
|
#include <cogl-pango/cogl-pango.h>
|
2008-12-22 08:24:52 -05:00
|
|
|
|
2007-03-22 14:21:59 -04:00
|
|
|
#include "clutter-backend.h"
|
2010-04-08 05:55:15 -04:00
|
|
|
#include "clutter-effect.h"
|
2008-04-04 11:02:11 -04:00
|
|
|
#include "clutter-event.h"
|
2007-05-16 05:08:30 -04:00
|
|
|
#include "clutter-feature.h"
|
2008-03-07 12:34:40 -05:00
|
|
|
#include "clutter-id-pool.h"
|
2010-06-07 16:34:36 -04:00
|
|
|
#include "clutter-layout-manager.h"
|
2009-05-07 14:07:21 -04:00
|
|
|
#include "clutter-master-clock.h"
|
2010-06-21 10:42:20 -04:00
|
|
|
#include "clutter-settings.h"
|
2008-04-04 11:02:11 -04:00
|
|
|
#include "clutter-stage.h"
|
2007-03-22 14:21:59 -04:00
|
|
|
|
2006-07-06 Emmanuele Bassi <ebassi@openedhand.com>
Big rework of the actor management semantics: now ClutterActor
objects behave like GtkObjects - that is they have an initial
"floating" reference that gets "sunk" when they are added to
a ClutterGroup. This makes a group responsible of de-allocating
each actor inside it, so you just have to destroy the group to
get every child actor destroyed. Also, now you can do:
clutter_group_add (group, clutter_video_texture_new ());
without having to care about reference counting and explicit
unreffing.
* clutter/clutter-private.h: Add private flags setter and
getter macros.
* clutter/clutter-actor.h:
* clutter/clutter-actor.c: Clean up; inherit from GInitiallyUnowned;
add a "visible" property; add the "destroy", "show" and "hide"
signals to ClutterActorClass.
(clutter_actor_show), (clutter_actor_hide): Refactor a bit; emit
the "show" and "hide" signals.
(clutter_actor_set_property), (clutter_actor_get_property),
(clutter_actor_class_init): Implement the "visible" property; add
signals.
(clutter_actor_finalize): Do not leak the actor's name, if it is
set.
(clutter_actor_dispose): Emit the "destroy" signal here.
(clutter_actor_init): Sink the initial floating flag if needed.
(clutter_actor_destroy): Add a function to explicitely destroy
a ClutterActor.
(clutter_actor_set_parent), (clutter_actor_get_parent),
(clutter_actor_unparent): Make set_parent require a valid parent;
add unparent; check on get_parent; ref_sink the actor when
setting its parent and unref it when unsetting it. Probably we'll
need a function that does reparenting as unparent+set_parent in
a single shot.
* clutter/clutter-group.h:
* clutter/clutter-group.c (clutter_group_dispose),
(clutter_group_finalize), (clutter_group_add),
(clutter_group_remove): Make the group destroy its children when
disposing it; clean up, and use the newly-available
clutter_actor_unparent().
* clutter/clutter-stage.h:
* clutter/clutter-stage.c (clutter_stage_init): ClutterStage is
a top-level actor; clean up.
* clutter/clutter-video-texture.h:
* clutter/clutter-video-texture.c: Clean up.
* examples/super-oh.c:
* examples/test.c:
* examples/video-player.c:
* examples/test-text.c:
* examples/video-cube.c: Remove the g_object_unref() call, as the
ClutterStage object is destroyed on clutter_main_quit().
2006-07-06 13:52:57 -04:00
|
|
|
G_BEGIN_DECLS
|
|
|
|
|
|
2009-11-23 11:07:16 -05:00
|
|
|
typedef struct _ClutterMainContext ClutterMainContext;
|
2009-11-20 10:35:40 -05:00
|
|
|
|
2010-10-08 10:21:57 -04:00
|
|
|
#define CLUTTER_REGISTER_VALUE_TRANSFORM_TO(TYPE_TO,func) { \
|
|
|
|
|
g_value_register_transform_func (g_define_type_id, TYPE_TO, func); \
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
#define CLUTTER_REGISTER_VALUE_TRANSFORM_FROM(TYPE_FROM,func) { \
|
|
|
|
|
g_value_register_transform_func (TYPE_FROM, g_define_type_id, func); \
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
#define CLUTTER_REGISTER_INTERVAL_PROGRESS(func) { \
|
|
|
|
|
clutter_interval_register_progress_func (g_define_type_id, func); \
|
|
|
|
|
}
|
|
|
|
|
|
2010-07-21 11:10:46 -04:00
|
|
|
#define CLUTTER_PRIVATE_FLAGS(a) (((ClutterActor *) (a))->private_flags)
|
|
|
|
|
#define CLUTTER_SET_PRIVATE_FLAGS(a,f) (CLUTTER_PRIVATE_FLAGS (a) |= (f))
|
|
|
|
|
#define CLUTTER_UNSET_PRIVATE_FLAGS(a,f) (CLUTTER_PRIVATE_FLAGS (a) &= ~(f))
|
|
|
|
|
|
|
|
|
|
#define CLUTTER_ACTOR_IS_TOPLEVEL(a) ((CLUTTER_PRIVATE_FLAGS (a) & CLUTTER_IS_TOPLEVEL) != FALSE)
|
|
|
|
|
#define CLUTTER_ACTOR_IS_INTERNAL_CHILD(a) ((CLUTTER_PRIVATE_FLAGS (a) & CLUTTER_INTERNAL_CHILD) != FALSE)
|
|
|
|
|
#define CLUTTER_ACTOR_IN_DESTRUCTION(a) ((CLUTTER_PRIVATE_FLAGS (a) & CLUTTER_IN_DESTRUCTION) != FALSE)
|
|
|
|
|
#define CLUTTER_ACTOR_IN_REPARENT(a) ((CLUTTER_PRIVATE_FLAGS (a) & CLUTTER_IN_REPARENT) != FALSE)
|
|
|
|
|
#define CLUTTER_ACTOR_IN_PAINT(a) ((CLUTTER_PRIVATE_FLAGS (a) & CLUTTER_IN_PAINT) != FALSE)
|
|
|
|
|
#define CLUTTER_ACTOR_IN_RELAYOUT(a) ((CLUTTER_PRIVATE_FLAGS (a) & CLUTTER_IN_RELAYOUT) != FALSE)
|
|
|
|
|
#define CLUTTER_STAGE_IN_RESIZE(a) ((CLUTTER_PRIVATE_FLAGS (a) & CLUTTER_IN_RESIZE) != FALSE)
|
|
|
|
|
|
2011-02-18 11:53:58 -05:00
|
|
|
#define CLUTTER_PARAM_READABLE (G_PARAM_READABLE | G_PARAM_STATIC_STRINGS)
|
|
|
|
|
#define CLUTTER_PARAM_WRITABLE (G_PARAM_WRITABLE | G_PARAM_STATIC_STRINGS)
|
|
|
|
|
#define CLUTTER_PARAM_READWRITE (G_PARAM_READABLE | G_PARAM_WRITABLE | G_PARAM_STATIC_STRINGS)
|
|
|
|
|
|
|
|
|
|
/* automagic interning of a static string */
|
|
|
|
|
#define I_(str) (g_intern_static_string ((str)))
|
|
|
|
|
|
|
|
|
|
/* mark all properties under the "Property" context */
|
|
|
|
|
#ifdef ENABLE_NLS
|
|
|
|
|
#define P_(String) (_clutter_gettext ((String)))
|
|
|
|
|
#else
|
|
|
|
|
#define P_(String) (String)
|
|
|
|
|
#endif
|
|
|
|
|
|
2011-07-11 20:02:43 -04:00
|
|
|
/* This is a replacement for the nearbyint function which always rounds to the
|
|
|
|
|
* nearest integer. nearbyint is apparently a C99 function so it might not
|
|
|
|
|
* always be available but also it seems in glibc it is defined as a function
|
|
|
|
|
* call so this macro could end up faster anyway. We can't just add 0.5f
|
|
|
|
|
* because it will break for negative numbers. */
|
|
|
|
|
#define CLUTTER_NEARBYINT(x) ((int) ((x) < 0.0f ? (x) - 0.5f : (x) + 0.5f))
|
|
|
|
|
|
2007-08-13 16:48:01 -04:00
|
|
|
typedef enum {
|
2010-07-21 11:10:46 -04:00
|
|
|
CLUTTER_ACTOR_UNUSED_FLAG = 0,
|
2007-08-13 16:48:01 -04:00
|
|
|
|
2010-07-21 11:10:46 -04:00
|
|
|
CLUTTER_IN_DESTRUCTION = 1 << 0,
|
|
|
|
|
CLUTTER_IS_TOPLEVEL = 1 << 1,
|
|
|
|
|
CLUTTER_IN_REPARENT = 1 << 2,
|
actor: Add internal child flag
ClutterActor checks, when destroying and reparenting, if the parent
actor implements the Container interface, and automatically calls the
remove() method to perform a clean removal.
Actors implementing Container, though, might have internal children;
that is, children that are not added through the Container API. It is
already possible to iterate through them using the Container API to
avoid breaking invariants - but calling clutter_actor_destroy() on
these children (even from the Container implementation, and thus outside
of Clutter's control) will either lead to leaks or to segmentation
faults.
Clutter needs a way to distinguish a clutter_actor_set_parent() done on
an internal child from one done on a "public" child; for this reason, a
push/pop pair of functions should be available to Actor implementations
to mark the section where they wish to add internal children:
➔ clutter_actor_push_internal ();
...
clutter_actor_set_parent (child1, parent);
clutter_actor_set_parent (child2, parent);
...
➔ clutter_actor_pop_internal ();
The set_parent() call will automatically set the newly added
INTERNAL_CHILD private flag on each child, and both
clutter_actor_destroy() and clutter_actor_unparent() will check for the
flag before deciding whether to call the Container's remove method.
2009-12-18 18:20:04 -05:00
|
|
|
|
|
|
|
|
/* Used to avoid recursion */
|
2010-09-07 08:10:55 -04:00
|
|
|
CLUTTER_IN_PAINT = 1 << 3,
|
actor: Add internal child flag
ClutterActor checks, when destroying and reparenting, if the parent
actor implements the Container interface, and automatically calls the
remove() method to perform a clean removal.
Actors implementing Container, though, might have internal children;
that is, children that are not added through the Container API. It is
already possible to iterate through them using the Container API to
avoid breaking invariants - but calling clutter_actor_destroy() on
these children (even from the Container implementation, and thus outside
of Clutter's control) will either lead to leaks or to segmentation
faults.
Clutter needs a way to distinguish a clutter_actor_set_parent() done on
an internal child from one done on a "public" child; for this reason, a
push/pop pair of functions should be available to Actor implementations
to mark the section where they wish to add internal children:
➔ clutter_actor_push_internal ();
...
clutter_actor_set_parent (child1, parent);
clutter_actor_set_parent (child2, parent);
...
➔ clutter_actor_pop_internal ();
The set_parent() call will automatically set the newly added
INTERNAL_CHILD private flag on each child, and both
clutter_actor_destroy() and clutter_actor_unparent() will check for the
flag before deciding whether to call the Container's remove method.
2009-12-18 18:20:04 -05:00
|
|
|
|
|
|
|
|
/* Used to avoid recursion */
|
2010-09-07 08:10:55 -04:00
|
|
|
CLUTTER_IN_RELAYOUT = 1 << 4,
|
actor: Add internal child flag
ClutterActor checks, when destroying and reparenting, if the parent
actor implements the Container interface, and automatically calls the
remove() method to perform a clean removal.
Actors implementing Container, though, might have internal children;
that is, children that are not added through the Container API. It is
already possible to iterate through them using the Container API to
avoid breaking invariants - but calling clutter_actor_destroy() on
these children (even from the Container implementation, and thus outside
of Clutter's control) will either lead to leaks or to segmentation
faults.
Clutter needs a way to distinguish a clutter_actor_set_parent() done on
an internal child from one done on a "public" child; for this reason, a
push/pop pair of functions should be available to Actor implementations
to mark the section where they wish to add internal children:
➔ clutter_actor_push_internal ();
...
clutter_actor_set_parent (child1, parent);
clutter_actor_set_parent (child2, parent);
...
➔ clutter_actor_pop_internal ();
The set_parent() call will automatically set the newly added
INTERNAL_CHILD private flag on each child, and both
clutter_actor_destroy() and clutter_actor_unparent() will check for the
flag before deciding whether to call the Container's remove method.
2009-12-18 18:20:04 -05:00
|
|
|
|
|
|
|
|
/* Used by the stage if resizing is an asynchronous operation (like on
|
|
|
|
|
* X11) to delay queueing relayouts until we got a notification from the
|
|
|
|
|
* event handling
|
|
|
|
|
*/
|
2010-09-07 08:10:55 -04:00
|
|
|
CLUTTER_IN_RESIZE = 1 << 5,
|
actor: Add internal child flag
ClutterActor checks, when destroying and reparenting, if the parent
actor implements the Container interface, and automatically calls the
remove() method to perform a clean removal.
Actors implementing Container, though, might have internal children;
that is, children that are not added through the Container API. It is
already possible to iterate through them using the Container API to
avoid breaking invariants - but calling clutter_actor_destroy() on
these children (even from the Container implementation, and thus outside
of Clutter's control) will either lead to leaks or to segmentation
faults.
Clutter needs a way to distinguish a clutter_actor_set_parent() done on
an internal child from one done on a "public" child; for this reason, a
push/pop pair of functions should be available to Actor implementations
to mark the section where they wish to add internal children:
➔ clutter_actor_push_internal ();
...
clutter_actor_set_parent (child1, parent);
clutter_actor_set_parent (child2, parent);
...
➔ clutter_actor_pop_internal ();
The set_parent() call will automatically set the newly added
INTERNAL_CHILD private flag on each child, and both
clutter_actor_destroy() and clutter_actor_unparent() will check for the
flag before deciding whether to call the Container's remove method.
2009-12-18 18:20:04 -05:00
|
|
|
|
|
|
|
|
/* a flag for internal children of Containers */
|
2010-09-07 08:10:55 -04:00
|
|
|
CLUTTER_INTERNAL_CHILD = 1 << 6
|
2007-08-13 16:48:01 -04:00
|
|
|
} ClutterPrivateFlags;
|
|
|
|
|
|
2011-02-09 07:55:25 -05:00
|
|
|
/*
|
|
|
|
|
* ClutterMainContext:
|
|
|
|
|
*
|
|
|
|
|
* The shared state of Clutter
|
|
|
|
|
*/
|
2006-06-05 Emmanuele Bassi <ebassi@openedhand.com>
* clutter-color.h:
* clutter-color.c: Reimplement ClutterColor as a boxed type;
add convenience API for color handling, like: add, subtract,
shade, HSL color-space conversion, packing and unpacking.
* clutter-private.h: Update ClutterMainContext, and export the
main context pointer here.
* clutter-rectangle.h:
* clutter-rectangle.c: Update the color-related code; make
clutter_rectangle_new() and empty constructor and provide
clutter_rectangle_new_with_color(); provide color setter
and getter API.
* clutter-label.h:
* clutter-label.c: Rename the "font" property to "font-name";
update the color-related code to the new ClutterColor object;
rename clutter_label_new() to clutter_label_new_with_text(),
and add setters and getters for the properties.
* clutter-marshal.list: Add VOID:OBJECT and VOID:BOXED marshallers
generators.
* clutter-stage.h:
* clutter-stage.c: Rework the API: provide a default constructor
for a singleton object, named clutter_stage_get_default(), which
supercedes the clutter_stage() function in clutter-main; provide
new events: button-press-event, button-release-event,
key-press-event and key-release-event; update the color-related
code;
(clutter_stage_snapshot): Allow negative width and height when
taking a snapshot (meaning: use full width/height).
(clutter_stage_get_element_at_pos): Rename clutter_stage_pick().
* clutter-element.c (clutter_element_paint): Clean up the
stage and color related code.
* clutter-event.h:
* clutter-event.c: Add generic ClutterAnyEvent type; add
clutter_event_new(), clutter_event_copy() and clutter_event_free();
make ClutterEvent a boxed type.
* clutter-main.h:
* clutter-main.c: Remove clutter_stage(); add clutter_main_quit(),
for cleanly quitting from clutter_main(); add multiple mainloops
support; allocate the ClutterCntx instead of adding it to the
stack; re-work the ClutterEvent dispatching.
* clutter-group.c (clutter_group_add), (clutter_group_remove): Keep
a reference on the element when added to a ClutterGroup.
* examples/rects.py
* examples/test.c:
* examples/test-text.c:
* examples/video-cube.c:
* examples/super-oh.c:
* examples/test-video.c: Update.
2006-06-05 09:38:31 -04:00
|
|
|
struct _ClutterMainContext
|
2006-05-29 04:59:36 -04:00
|
|
|
{
|
2011-02-09 07:55:25 -05:00
|
|
|
/* the main windowing system backend */
|
|
|
|
|
ClutterBackend *backend;
|
2008-09-23 03:03:35 -04:00
|
|
|
|
2011-02-09 07:55:25 -05:00
|
|
|
/* the main event queue */
|
|
|
|
|
GQueue *events_queue;
|
2008-09-23 03:03:35 -04:00
|
|
|
|
2011-02-09 07:55:25 -05:00
|
|
|
/* timer used to print the FPS count */
|
|
|
|
|
GTimer *timer;
|
2007-08-13 16:48:01 -04:00
|
|
|
|
2011-02-09 07:55:25 -05:00
|
|
|
ClutterPickMode pick_mode;
|
2008-03-28 18:50:55 -04:00
|
|
|
|
2011-02-09 07:55:25 -05:00
|
|
|
/* mapping between reused integer ids and actors */
|
|
|
|
|
ClutterIDPool *id_pool;
|
2007-10-08 12:18:33 -04:00
|
|
|
|
2011-02-09 07:55:25 -05:00
|
|
|
/* default FPS; this is only used if we cannot sync to vblank */
|
|
|
|
|
guint frame_rate;
|
2007-11-15 12:08:48 -05:00
|
|
|
|
2011-02-09 07:55:25 -05:00
|
|
|
/* actors with a grab on all devices */
|
|
|
|
|
ClutterActor *pointer_grab_actor;
|
|
|
|
|
ClutterActor *keyboard_grab_actor;
|
2007-12-18 05:49:29 -05:00
|
|
|
|
2011-02-18 10:44:17 -05:00
|
|
|
/* stack of actors with shaders during paint */
|
2011-02-09 07:55:25 -05:00
|
|
|
GSList *shaders;
|
2008-05-13 19:02:45 -04:00
|
|
|
|
|
|
|
|
/* fb bit masks for col<->id mapping in picking */
|
2011-02-09 07:55:25 -05:00
|
|
|
gint fb_r_mask;
|
|
|
|
|
gint fb_g_mask;
|
|
|
|
|
gint fb_b_mask;
|
|
|
|
|
gint fb_r_mask_used;
|
|
|
|
|
gint fb_g_mask_used;
|
|
|
|
|
gint fb_b_mask_used;
|
2008-05-13 19:02:45 -04:00
|
|
|
|
2011-02-09 07:55:25 -05:00
|
|
|
PangoContext *pango_context; /* Global Pango context */
|
|
|
|
|
CoglPangoFontMap *font_map; /* Global font map */
|
2008-06-23 05:55:42 -04:00
|
|
|
|
2009-11-12 17:33:15 -05:00
|
|
|
ClutterEvent *current_event;
|
2009-02-14 06:38:16 -05:00
|
|
|
guint32 last_event_time;
|
2009-03-21 16:39:32 -04:00
|
|
|
|
2011-02-09 07:55:25 -05:00
|
|
|
/* list of repaint functions installed through
|
|
|
|
|
* clutter_threads_add_repaint_func()
|
|
|
|
|
*/
|
2009-03-30 08:49:03 -04:00
|
|
|
GList *repaint_funcs;
|
2011-09-01 12:12:46 -04:00
|
|
|
guint last_repaint_id;
|
2010-06-21 10:42:20 -04:00
|
|
|
|
2011-02-09 07:55:25 -05:00
|
|
|
/* main settings singleton */
|
2010-06-21 10:42:20 -04:00
|
|
|
ClutterSettings *settings;
|
2011-02-09 07:55:25 -05:00
|
|
|
|
|
|
|
|
/* boolean flags */
|
|
|
|
|
guint is_initialized : 1;
|
|
|
|
|
guint motion_events_per_actor : 1;
|
|
|
|
|
guint defer_display_setup : 1;
|
|
|
|
|
guint options_parsed : 1;
|
2006-06-05 Emmanuele Bassi <ebassi@openedhand.com>
* clutter-color.h:
* clutter-color.c: Reimplement ClutterColor as a boxed type;
add convenience API for color handling, like: add, subtract,
shade, HSL color-space conversion, packing and unpacking.
* clutter-private.h: Update ClutterMainContext, and export the
main context pointer here.
* clutter-rectangle.h:
* clutter-rectangle.c: Update the color-related code; make
clutter_rectangle_new() and empty constructor and provide
clutter_rectangle_new_with_color(); provide color setter
and getter API.
* clutter-label.h:
* clutter-label.c: Rename the "font" property to "font-name";
update the color-related code to the new ClutterColor object;
rename clutter_label_new() to clutter_label_new_with_text(),
and add setters and getters for the properties.
* clutter-marshal.list: Add VOID:OBJECT and VOID:BOXED marshallers
generators.
* clutter-stage.h:
* clutter-stage.c: Rework the API: provide a default constructor
for a singleton object, named clutter_stage_get_default(), which
supercedes the clutter_stage() function in clutter-main; provide
new events: button-press-event, button-release-event,
key-press-event and key-release-event; update the color-related
code;
(clutter_stage_snapshot): Allow negative width and height when
taking a snapshot (meaning: use full width/height).
(clutter_stage_get_element_at_pos): Rename clutter_stage_pick().
* clutter-element.c (clutter_element_paint): Clean up the
stage and color related code.
* clutter-event.h:
* clutter-event.c: Add generic ClutterAnyEvent type; add
clutter_event_new(), clutter_event_copy() and clutter_event_free();
make ClutterEvent a boxed type.
* clutter-main.h:
* clutter-main.c: Remove clutter_stage(); add clutter_main_quit(),
for cleanly quitting from clutter_main(); add multiple mainloops
support; allocate the ClutterCntx instead of adding it to the
stack; re-work the ClutterEvent dispatching.
* clutter-group.c (clutter_group_add), (clutter_group_remove): Keep
a reference on the element when added to a ClutterGroup.
* examples/rects.py
* examples/test.c:
* examples/test-text.c:
* examples/video-cube.c:
* examples/super-oh.c:
* examples/test-video.c: Update.
2006-06-05 09:38:31 -04:00
|
|
|
};
|
|
|
|
|
|
2010-11-06 16:00:39 -04:00
|
|
|
/* shared between clutter-main.c and clutter-frame-source.c */
|
|
|
|
|
typedef struct
|
|
|
|
|
{
|
|
|
|
|
GSourceFunc func;
|
|
|
|
|
gpointer data;
|
|
|
|
|
GDestroyNotify notify;
|
|
|
|
|
} ClutterThreadsDispatch;
|
|
|
|
|
|
|
|
|
|
gboolean _clutter_threads_dispatch (gpointer data);
|
|
|
|
|
void _clutter_threads_dispatch_free (gpointer data);
|
|
|
|
|
|
2011-06-20 08:53:09 -04:00
|
|
|
ClutterMainContext * _clutter_context_get_default (void);
|
2011-09-01 12:12:46 -04:00
|
|
|
void _clutter_context_lock (void);
|
|
|
|
|
void _clutter_context_unlock (void);
|
2011-06-20 08:53:09 -04:00
|
|
|
gboolean _clutter_context_is_initialized (void);
|
|
|
|
|
PangoContext * _clutter_context_create_pango_context (void);
|
|
|
|
|
PangoContext * _clutter_context_get_pango_context (void);
|
|
|
|
|
ClutterPickMode _clutter_context_get_pick_mode (void);
|
|
|
|
|
void _clutter_context_push_shader_stack (ClutterActor *actor);
|
|
|
|
|
ClutterActor * _clutter_context_pop_shader_stack (ClutterActor *actor);
|
|
|
|
|
ClutterActor * _clutter_context_peek_shader_stack (void);
|
|
|
|
|
guint32 _clutter_context_acquire_id (gpointer key);
|
|
|
|
|
void _clutter_context_release_id (guint32 id_);
|
|
|
|
|
gboolean _clutter_context_get_motion_events_enabled (void);
|
2011-02-09 07:55:25 -05:00
|
|
|
|
Eliminate G_CONST_RETURN
The G_CONST_RETURN define in GLib is, and has always been, a bit fuzzy.
We always used it to conform to the platform, at least for public-facing
API.
At first I assumed it has something to do with brain-damaged compilers
or with weird platforms where const was not really supported; sadly,
it's something much, much worse: it's a define that can be toggled at
compile-time to remove const from the signature of public API. This is a
truly terrifying feature that I assume was added in the past century,
and whose inception clearly had something to do with massive doses of
absynthe and opium — because any other explanation would make the
existence of such a feature even worse than assuming drugs had anything
to do with it.
Anyway, and pleasing the gods, this dubious feature is being
removed/deprecated in GLib; see bug:
https://bugzilla.gnome.org/show_bug.cgi?id=644611
Before deprecation, though, we should just remove its usage from the
whole API. We should especially remove its usage from Cally's internals,
since there it never made sense in the first place.
2011-06-07 10:49:20 -04:00
|
|
|
const gchar *_clutter_gettext (const gchar *str);
|
2010-06-03 07:56:17 -04:00
|
|
|
|
2010-03-17 13:28:20 -04:00
|
|
|
gboolean _clutter_feature_init (GError **error);
|
2007-05-16 05:08:30 -04:00
|
|
|
|
2008-05-13 19:02:45 -04:00
|
|
|
/* Picking code */
|
2011-04-11 09:11:39 -04:00
|
|
|
guint _clutter_pixel_to_id (guchar pixel[4]);
|
|
|
|
|
void _clutter_id_to_color (guint id,
|
|
|
|
|
ClutterColor *col);
|
|
|
|
|
ClutterActor * _clutter_get_actor_by_id (ClutterStage *stage,
|
|
|
|
|
guint32 actor_id);
|
2008-05-13 19:02:45 -04:00
|
|
|
|
2007-10-02 10:03:36 -04:00
|
|
|
/* use this function as the accumulator if you have a signal with
|
|
|
|
|
* a G_TYPE_BOOLEAN return value; this will stop the emission as
|
|
|
|
|
* soon as one handler returns TRUE
|
|
|
|
|
*/
|
2008-04-04 11:02:11 -04:00
|
|
|
gboolean _clutter_boolean_handled_accumulator (GSignalInvocationHint *ihint,
|
|
|
|
|
GValue *return_accu,
|
|
|
|
|
const GValue *handler_return,
|
|
|
|
|
gpointer dummy);
|
2007-10-02 10:03:36 -04:00
|
|
|
|
2009-03-30 08:49:03 -04:00
|
|
|
void _clutter_run_repaint_functions (void);
|
|
|
|
|
|
2010-09-17 07:09:56 -04:00
|
|
|
void _clutter_constraint_update_allocation (ClutterConstraint *constraint,
|
|
|
|
|
ClutterActor *actor,
|
|
|
|
|
ClutterActorBox *allocation);
|
|
|
|
|
|
2010-06-07 16:34:36 -04:00
|
|
|
GType _clutter_layout_manager_get_child_meta_type (ClutterLayoutManager *manager);
|
|
|
|
|
|
2011-02-18 11:53:58 -05:00
|
|
|
void _clutter_util_fully_transform_vertices (const CoglMatrix *modelview,
|
|
|
|
|
const CoglMatrix *projection,
|
2011-02-01 11:51:58 -05:00
|
|
|
const float *viewport,
|
2011-02-18 11:53:58 -05:00
|
|
|
const ClutterVertex *vertices_in,
|
|
|
|
|
ClutterVertex *vertices_out,
|
|
|
|
|
int n_vertices);
|
2010-08-16 10:53:28 -04:00
|
|
|
|
2011-02-01 11:51:58 -05:00
|
|
|
typedef struct _ClutterPlane
|
|
|
|
|
{
|
|
|
|
|
CoglVector3 v0;
|
|
|
|
|
CoglVector3 n;
|
|
|
|
|
} ClutterPlane;
|
|
|
|
|
|
2011-02-01 13:32:08 -05:00
|
|
|
typedef enum _ClutterCullResult
|
|
|
|
|
{
|
|
|
|
|
CLUTTER_CULL_RESULT_UNKNOWN,
|
|
|
|
|
CLUTTER_CULL_RESULT_IN,
|
|
|
|
|
CLUTTER_CULL_RESULT_OUT,
|
|
|
|
|
CLUTTER_CULL_RESULT_PARTIAL
|
|
|
|
|
} ClutterCullResult;
|
|
|
|
|
|
2006-07-06 Emmanuele Bassi <ebassi@openedhand.com>
Big rework of the actor management semantics: now ClutterActor
objects behave like GtkObjects - that is they have an initial
"floating" reference that gets "sunk" when they are added to
a ClutterGroup. This makes a group responsible of de-allocating
each actor inside it, so you just have to destroy the group to
get every child actor destroyed. Also, now you can do:
clutter_group_add (group, clutter_video_texture_new ());
without having to care about reference counting and explicit
unreffing.
* clutter/clutter-private.h: Add private flags setter and
getter macros.
* clutter/clutter-actor.h:
* clutter/clutter-actor.c: Clean up; inherit from GInitiallyUnowned;
add a "visible" property; add the "destroy", "show" and "hide"
signals to ClutterActorClass.
(clutter_actor_show), (clutter_actor_hide): Refactor a bit; emit
the "show" and "hide" signals.
(clutter_actor_set_property), (clutter_actor_get_property),
(clutter_actor_class_init): Implement the "visible" property; add
signals.
(clutter_actor_finalize): Do not leak the actor's name, if it is
set.
(clutter_actor_dispose): Emit the "destroy" signal here.
(clutter_actor_init): Sink the initial floating flag if needed.
(clutter_actor_destroy): Add a function to explicitely destroy
a ClutterActor.
(clutter_actor_set_parent), (clutter_actor_get_parent),
(clutter_actor_unparent): Make set_parent require a valid parent;
add unparent; check on get_parent; ref_sink the actor when
setting its parent and unref it when unsetting it. Probably we'll
need a function that does reparenting as unparent+set_parent in
a single shot.
* clutter/clutter-group.h:
* clutter/clutter-group.c (clutter_group_dispose),
(clutter_group_finalize), (clutter_group_add),
(clutter_group_remove): Make the group destroy its children when
disposing it; clean up, and use the newly-available
clutter_actor_unparent().
* clutter/clutter-stage.h:
* clutter/clutter-stage.c (clutter_stage_init): ClutterStage is
a top-level actor; clean up.
* clutter/clutter-video-texture.h:
* clutter/clutter-video-texture.c: Clean up.
* examples/super-oh.c:
* examples/test.c:
* examples/video-player.c:
* examples/test-text.c:
* examples/video-cube.c: Remove the g_object_unref() call, as the
ClutterStage object is destroyed on clutter_main_quit().
2006-07-06 13:52:57 -04:00
|
|
|
G_END_DECLS
|
|
|
|
|
|
2010-10-21 07:16:05 -04:00
|
|
|
#endif /* __CLUTTER_PRIVATE_H__ */
|