2006-05-29 08:59:36 +00: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
|
|
|
|
|
* License along with this library; if not, write to the
|
|
|
|
|
* Free Software Foundation, Inc., 59 Temple Place - Suite 330,
|
|
|
|
|
* Boston, MA 02111-1307, USA.
|
|
|
|
|
*/
|
|
|
|
|
|
|
|
|
|
#ifndef _HAVE_CLUTTER_MAIN_H
|
|
|
|
|
#define _HAVE_CLUTTER_MAIN_H
|
|
|
|
|
|
2006-06-13 13:17:45 +00:00
|
|
|
#include <clutter/clutter-actor.h>
|
2006-05-29 08:59:36 +00:00
|
|
|
#include <clutter/clutter-stage.h>
|
|
|
|
|
|
2006-07-24 21:15:19 +00:00
|
|
|
G_BEGIN_DECLS
|
|
|
|
|
|
2008-06-25 16:46:42 +00:00
|
|
|
/**
|
|
|
|
|
* CLUTTER_INIT_ERROR:
|
|
|
|
|
*
|
|
|
|
|
* #GError domain for #ClutterInitError
|
|
|
|
|
*/
|
2006-11-21 Emmanuele Bassi <ebassi@openedhand.com>
* configure.ac: Enable debug messages also when
--enable-debug is set to "minimum".
* clutter/Makefile.am:
* clutter/clutter-debug.h: Move all debugging macros inside
this private header; make all debug macros depend on the
CLUTTER_ENABLE_DEBUG compile time define, controlled by
the --enable-debug configure switch; add G_LOG_DOMAIN define.
* clutter/clutter-main.c: Clean up the debug stuff; add
command line argument parsing using GOption; the debug
messages now are triggered like this:
CLUTTER_DEBUG=section:section:... clutter-app
or like this:
clutter-app --clutter-debug=section:section:...
where "section" is one of the sections listed in clutter-main.c,
or "all", for all sections; each section is bound to a flag,
which can be used to define a domain when adding a debug note
using the CLUTTER_NOTE() macro; the old CLUTTER_DBG() macro is
just a wrapper around that, under the CLUTTER_DEBUG_MISC domain;
CLUTTER_NOTE() is used like this:
CLUTTER_NOTE (DOMAIN, log-function);
where log function is g_printerr(), g_message(), g_warning(),
g_critical() or directly g_log() - for instance:
CLUTTER_NOTE (PANGO, g_warning ("Cache miss: %d", glyph));
will print the warning only if the "pango" flag has been
set to the CLUTTER_DEBUG envvar or passed to the --clutter-debug
command line argument.
similar to CLUTTER_SHOW_FPS, there's also the --clutter-show-fps
command line switch; also, the --display and --screen command
line switches have been added: the first overrides the DISPLAY
envvar and the second controls the X screen used by Clutter to
get the root window on the display.
* clutter/clutter-main.h:
* clutter/clutter-main.c: Add extended support for GOption
in Clutter; use clutter_init_with_args() to let Clutter
parse your own command line arguments; use instead
clutter_get_option_group() to get the GOptionGroup used by
Clutter if you want to do the parsing yourself with
g_option_context_parse(). The init sequence has been verified,
updated and moved into common functions where possible.
* clutter/pango/pangoclutter-render.c:
* clutter/*.c: Include "clutter-debug.h" where needed; use
CLUTTER_NOTE() instead of CLUTTER_DBG().
* examples/super-oh.c: Use the new clutter_init_with_args()
function, and add a --num-hands command line switch to
the SuperOH example code controlling the number of hands at
runtime.
2006-11-21 21:27:53 +00:00
|
|
|
#define CLUTTER_INIT_ERROR (clutter_init_error_quark ())
|
2006-05-29 08:59:36 +00:00
|
|
|
|
2007-08-07 14:03:58 +00:00
|
|
|
/**
|
|
|
|
|
* ClutterInitError:
|
|
|
|
|
* @CLUTTER_INIT_SUCCESS: Initialisation successful
|
|
|
|
|
* @CLUTTER_INIT_ERROR_UNKNOWN: Unknown error
|
|
|
|
|
* @CLUTTER_INIT_ERROR_THREADS: Thread initialisation failed
|
|
|
|
|
* @CLUTTER_INIT_ERROR_BACKEND: Backend initialisation failed
|
|
|
|
|
* @CLUTTER_INIT_ERROR_INTERNAL: Internal error
|
|
|
|
|
*
|
|
|
|
|
* Error conditions returned by clutter_init() and clutter_init_with_args().
|
|
|
|
|
*
|
|
|
|
|
* Since: 0.2
|
|
|
|
|
*/
|
2006-09-15 12:30:15 +00:00
|
|
|
typedef enum {
|
|
|
|
|
CLUTTER_INIT_SUCCESS = 1,
|
2007-08-07 14:03:58 +00:00
|
|
|
CLUTTER_INIT_ERROR_UNKNOWN = 0,
|
2006-09-15 12:30:15 +00:00
|
|
|
CLUTTER_INIT_ERROR_THREADS = -1,
|
2007-01-23 20:29:11 +00:00
|
|
|
CLUTTER_INIT_ERROR_BACKEND = -2,
|
2007-03-22 18:21:59 +00:00
|
|
|
CLUTTER_INIT_ERROR_INTERNAL = -3
|
2006-09-15 12:30:15 +00:00
|
|
|
} ClutterInitError;
|
|
|
|
|
|
2006-11-21 Emmanuele Bassi <ebassi@openedhand.com>
* configure.ac: Enable debug messages also when
--enable-debug is set to "minimum".
* clutter/Makefile.am:
* clutter/clutter-debug.h: Move all debugging macros inside
this private header; make all debug macros depend on the
CLUTTER_ENABLE_DEBUG compile time define, controlled by
the --enable-debug configure switch; add G_LOG_DOMAIN define.
* clutter/clutter-main.c: Clean up the debug stuff; add
command line argument parsing using GOption; the debug
messages now are triggered like this:
CLUTTER_DEBUG=section:section:... clutter-app
or like this:
clutter-app --clutter-debug=section:section:...
where "section" is one of the sections listed in clutter-main.c,
or "all", for all sections; each section is bound to a flag,
which can be used to define a domain when adding a debug note
using the CLUTTER_NOTE() macro; the old CLUTTER_DBG() macro is
just a wrapper around that, under the CLUTTER_DEBUG_MISC domain;
CLUTTER_NOTE() is used like this:
CLUTTER_NOTE (DOMAIN, log-function);
where log function is g_printerr(), g_message(), g_warning(),
g_critical() or directly g_log() - for instance:
CLUTTER_NOTE (PANGO, g_warning ("Cache miss: %d", glyph));
will print the warning only if the "pango" flag has been
set to the CLUTTER_DEBUG envvar or passed to the --clutter-debug
command line argument.
similar to CLUTTER_SHOW_FPS, there's also the --clutter-show-fps
command line switch; also, the --display and --screen command
line switches have been added: the first overrides the DISPLAY
envvar and the second controls the X screen used by Clutter to
get the root window on the display.
* clutter/clutter-main.h:
* clutter/clutter-main.c: Add extended support for GOption
in Clutter; use clutter_init_with_args() to let Clutter
parse your own command line arguments; use instead
clutter_get_option_group() to get the GOptionGroup used by
Clutter if you want to do the parsing yourself with
g_option_context_parse(). The init sequence has been verified,
updated and moved into common functions where possible.
* clutter/pango/pangoclutter-render.c:
* clutter/*.c: Include "clutter-debug.h" where needed; use
CLUTTER_NOTE() instead of CLUTTER_DBG().
* examples/super-oh.c: Use the new clutter_init_with_args()
function, and add a --num-hands command line switch to
the SuperOH example code controlling the number of hands at
runtime.
2006-11-21 21:27:53 +00:00
|
|
|
GQuark clutter_init_error_quark (void);
|
|
|
|
|
|
2008-06-25 16:46:42 +00:00
|
|
|
/**
|
|
|
|
|
* CLUTTER_PRIORITY_REDRAW:
|
|
|
|
|
*
|
|
|
|
|
* Priority of the redraws.
|
|
|
|
|
*
|
|
|
|
|
* Since: 0.8
|
|
|
|
|
*/
|
|
|
|
|
#define CLUTTER_PRIORITY_REDRAW (G_PRIORITY_DEFAULT + 10)
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* CLUTTER_PRIORITY_TIMELINE:
|
|
|
|
|
*
|
|
|
|
|
* Priority of the timelines.
|
|
|
|
|
*
|
|
|
|
|
* Since: 0.8
|
|
|
|
|
*/
|
|
|
|
|
#define CLUTTER_PRIORITY_TIMELINE (G_PRIORITY_DEFAULT + 30)
|
|
|
|
|
|
2007-08-08 10:20:14 +00:00
|
|
|
/* Initialisation */
|
|
|
|
|
void clutter_base_init (void);
|
2006-11-21 Emmanuele Bassi <ebassi@openedhand.com>
* configure.ac: Enable debug messages also when
--enable-debug is set to "minimum".
* clutter/Makefile.am:
* clutter/clutter-debug.h: Move all debugging macros inside
this private header; make all debug macros depend on the
CLUTTER_ENABLE_DEBUG compile time define, controlled by
the --enable-debug configure switch; add G_LOG_DOMAIN define.
* clutter/clutter-main.c: Clean up the debug stuff; add
command line argument parsing using GOption; the debug
messages now are triggered like this:
CLUTTER_DEBUG=section:section:... clutter-app
or like this:
clutter-app --clutter-debug=section:section:...
where "section" is one of the sections listed in clutter-main.c,
or "all", for all sections; each section is bound to a flag,
which can be used to define a domain when adding a debug note
using the CLUTTER_NOTE() macro; the old CLUTTER_DBG() macro is
just a wrapper around that, under the CLUTTER_DEBUG_MISC domain;
CLUTTER_NOTE() is used like this:
CLUTTER_NOTE (DOMAIN, log-function);
where log function is g_printerr(), g_message(), g_warning(),
g_critical() or directly g_log() - for instance:
CLUTTER_NOTE (PANGO, g_warning ("Cache miss: %d", glyph));
will print the warning only if the "pango" flag has been
set to the CLUTTER_DEBUG envvar or passed to the --clutter-debug
command line argument.
similar to CLUTTER_SHOW_FPS, there's also the --clutter-show-fps
command line switch; also, the --display and --screen command
line switches have been added: the first overrides the DISPLAY
envvar and the second controls the X screen used by Clutter to
get the root window on the display.
* clutter/clutter-main.h:
* clutter/clutter-main.c: Add extended support for GOption
in Clutter; use clutter_init_with_args() to let Clutter
parse your own command line arguments; use instead
clutter_get_option_group() to get the GOptionGroup used by
Clutter if you want to do the parsing yourself with
g_option_context_parse(). The init sequence has been verified,
updated and moved into common functions where possible.
* clutter/pango/pangoclutter-render.c:
* clutter/*.c: Include "clutter-debug.h" where needed; use
CLUTTER_NOTE() instead of CLUTTER_DBG().
* examples/super-oh.c: Use the new clutter_init_with_args()
function, and add a --num-hands command line switch to
the SuperOH example code controlling the number of hands at
runtime.
2006-11-21 21:27:53 +00:00
|
|
|
ClutterInitError clutter_init (int *argc,
|
|
|
|
|
char ***argv);
|
|
|
|
|
ClutterInitError clutter_init_with_args (int *argc,
|
|
|
|
|
char ***argv,
|
|
|
|
|
char *parameter_string,
|
|
|
|
|
GOptionEntry *entries,
|
|
|
|
|
char *translation_domain,
|
|
|
|
|
GError **error);
|
|
|
|
|
GOptionGroup * clutter_get_option_group (void);
|
|
|
|
|
|
2007-08-08 10:20:14 +00:00
|
|
|
/* Mainloop */
|
|
|
|
|
void clutter_main (void);
|
|
|
|
|
void clutter_main_quit (void);
|
|
|
|
|
gint clutter_main_level (void);
|
2007-03-22 18:21:59 +00:00
|
|
|
|
2008-03-28 22:50:55 +00:00
|
|
|
void clutter_redraw (ClutterStage *stage);
|
2007-03-22 18:21:59 +00:00
|
|
|
|
2008-01-23 11:08:39 +00:00
|
|
|
void clutter_do_event (ClutterEvent *event);
|
|
|
|
|
|
2007-08-08 10:20:14 +00:00
|
|
|
/* Debug utility functions */
|
|
|
|
|
gboolean clutter_get_debug_enabled (void);
|
|
|
|
|
gboolean clutter_get_show_fps (void);
|
|
|
|
|
gulong clutter_get_timestamp (void);
|
2007-05-16 15:00:41 +00:00
|
|
|
|
2007-08-08 10:20:14 +00:00
|
|
|
/* Threading functions */
|
|
|
|
|
void clutter_threads_init (void);
|
|
|
|
|
void clutter_threads_enter (void);
|
|
|
|
|
void clutter_threads_leave (void);
|
|
|
|
|
void clutter_threads_set_lock_functions (GCallback enter_fn,
|
|
|
|
|
GCallback leave_fn);
|
|
|
|
|
guint clutter_threads_add_idle (GSourceFunc func,
|
|
|
|
|
gpointer data);
|
|
|
|
|
guint clutter_threads_add_idle_full (gint priority,
|
|
|
|
|
GSourceFunc func,
|
|
|
|
|
gpointer data,
|
|
|
|
|
GDestroyNotify notify);
|
|
|
|
|
guint clutter_threads_add_timeout (guint interval,
|
|
|
|
|
GSourceFunc func,
|
|
|
|
|
gpointer data);
|
|
|
|
|
guint clutter_threads_add_timeout_full (gint priority,
|
|
|
|
|
guint interval,
|
|
|
|
|
GSourceFunc func,
|
|
|
|
|
gpointer data,
|
|
|
|
|
GDestroyNotify notify);
|
2008-04-17 16:50:23 +00:00
|
|
|
guint clutter_threads_add_frame_source (guint interval,
|
|
|
|
|
GSourceFunc func,
|
|
|
|
|
gpointer data);
|
|
|
|
|
guint clutter_threads_add_frame_source_full
|
|
|
|
|
(gint priority,
|
|
|
|
|
guint interval,
|
|
|
|
|
GSourceFunc func,
|
|
|
|
|
gpointer data,
|
|
|
|
|
GDestroyNotify notify);
|
2007-06-07 23:51:53 +00:00
|
|
|
|
2007-11-19 16:30:56 +00:00
|
|
|
void clutter_set_motion_events_enabled (gboolean enable);
|
|
|
|
|
gboolean clutter_get_motion_events_enabled (void);
|
|
|
|
|
void clutter_set_motion_events_frequency (guint frequency);
|
|
|
|
|
guint clutter_get_motion_events_frequency (void);
|
2007-08-13 20:48:01 +00:00
|
|
|
|
2007-11-19 16:30:56 +00:00
|
|
|
void clutter_set_default_frame_rate (guint frames_per_sec);
|
|
|
|
|
guint clutter_get_default_frame_rate (void);
|
2007-08-13 20:48:01 +00:00
|
|
|
|
2007-11-19 16:30:56 +00:00
|
|
|
void clutter_grab_pointer (ClutterActor *actor);
|
|
|
|
|
void clutter_ungrab_pointer (void);
|
|
|
|
|
ClutterActor * clutter_get_pointer_grab (void);
|
2007-11-15 17:08:48 +00:00
|
|
|
|
2007-11-19 16:30:56 +00:00
|
|
|
void clutter_grab_keyboard (ClutterActor *actor);
|
|
|
|
|
void clutter_ungrab_keyboard (void);
|
|
|
|
|
ClutterActor * clutter_get_keyboard_grab (void);
|
2007-11-15 18:00:24 +00:00
|
|
|
|
2008-05-28 Emmanuele Bassi <ebassi@openedhand.com>
Bug #919 - Replacement pango renderer (Neil Roberts)
* clutter/clutter-backend.h:
* clutter/clutter-backend.c:
(clutter_backend_set_font_options),
(clutter_backend_get_font_options): Add the ability to set
the cairo_font_options_t* for the backend at construction
time, so that backend implementations can have their own
options.
* clutter/clutter-color.c: Include pango/pango-attributes.h
for the pango_color_parse() function.
* clutter/clutter-label.c:
(clutter_label_ensure_layout),
(clutter_label_init), (clutter_label_set_text),
(clutter_label_set_font_name), (clutter_label_set_ellipsize),
(clutter_label_set_use_markup): Ensure that the cache is
always primed when the Label changes; this makes sure that
the cache is rebuilt outside the paint run, which should
make the painting perform better especially on embedded
devices.
* clutter/clutter-entry.c:
(clutter_entry_ensure_layout),
(clutter_entry_init), (clutter_entry_set_text),
(clutter_entry_set_font_name): Ditto as above.
* clutter/clutter-private.h:
* clutter/clutter-main.[ch]: Create the font-map inside the
main context; add two new functions:
clutter_clear_glyph_cache()
clutter_set_use_mipmapped_text()
that control the glyphs cache.
* clutter/pango/Makefile.am:
* clutter/pango/pangoclutter-fontmap.c:
* clutter/pango/pangoclutter-private.h:
* clutter/pango/pangoclutter-render.c:
* clutter/pango/pangoclutter.h: Rewrite the Pango renderer
using a PangoCairo context and saving the glyphs inside a
more efficient cache.
* configure.ac: Depend on pangocairo instead of pangoft2.
2008-05-28 14:03:28 +00:00
|
|
|
void clutter_clear_glyph_cache (void);
|
|
|
|
|
void clutter_set_use_mipmapped_text (gboolean value);
|
2008-06-10 Emmanuele Bassi <ebassi@openedhand.com>
Bug #815 - Split up request, allocation, and paint box
* clutter/clutter-actor.[ch]: Rework the size allocation,
request and paint area. Now ::request_coords() is called
::allocate(), and ::query_coords() has been split into
::get_preferred_width() and ::get_preferred_height(). See
the documentation and the layout test on how to implement
a container and layout manager with the new API. (#915,
based on a patch by Havoc Pennington, Lucas Rocha and Johan
Bilien)
* clutter/clutter-clone-texture.c: Port CloneTexture to
the new size negotiation API; it just means forwarding
the requests to the parent texture.
* clutter/clutter-deprecated.h: Add deprecated and replaced
API.
* clutter/clutter-entry.c: Port Entry to the new size
negotiation API.
* clutter/clutter-group.c: Port Group to the new size
negotiation API; the semantics of the Group actor do not
change.
* clutter/clutter-label.c: Port Label to the new size
negotiation API, and vastly simplify the code.
* clutter/clutter-main.[ch]: Add API for executing a
relayout when needed.
* clutter/clutter-private.h: Add new Stage private API.
* clutter/clutter-rectangle.c: Update the get_abs_opacity()
call to get_paint_opacity().
* clutter/clutter-stage.c:
(clutter_stage_get_preferred_width),
(clutter_stage_get_preferred_height),
(clutter_stage_allocate),
(clutter_stage_class_init): Port Stage to the new size
negotiation API.
* clutter/clutter-texture.c: Port Texture to the new size
negotiation API.
* clutter/clutter-types.h: Add ClutterRequestMode enumeration.
* clutter/x11/clutter-stage-x11.c: Port the X11 stage
implementation to the new size negotiation API.
* tests/Makefile.am: Add the layout manager test case.
* tests/test-opacity.c: Update.
* tests/test-project.c: Update.
* tests/test-layout.c: Test case for a layout manager implemented
using the new size negotiation API; the layout manager handles
both transformed and untransformed children.
2008-06-10 17:07:52 +00:00
|
|
|
gboolean clutter_get_use_mipmapped_text (void);
|
2008-05-28 Emmanuele Bassi <ebassi@openedhand.com>
Bug #919 - Replacement pango renderer (Neil Roberts)
* clutter/clutter-backend.h:
* clutter/clutter-backend.c:
(clutter_backend_set_font_options),
(clutter_backend_get_font_options): Add the ability to set
the cairo_font_options_t* for the backend at construction
time, so that backend implementations can have their own
options.
* clutter/clutter-color.c: Include pango/pango-attributes.h
for the pango_color_parse() function.
* clutter/clutter-label.c:
(clutter_label_ensure_layout),
(clutter_label_init), (clutter_label_set_text),
(clutter_label_set_font_name), (clutter_label_set_ellipsize),
(clutter_label_set_use_markup): Ensure that the cache is
always primed when the Label changes; this makes sure that
the cache is rebuilt outside the paint run, which should
make the painting perform better especially on embedded
devices.
* clutter/clutter-entry.c:
(clutter_entry_ensure_layout),
(clutter_entry_init), (clutter_entry_set_text),
(clutter_entry_set_font_name): Ditto as above.
* clutter/clutter-private.h:
* clutter/clutter-main.[ch]: Create the font-map inside the
main context; add two new functions:
clutter_clear_glyph_cache()
clutter_set_use_mipmapped_text()
that control the glyphs cache.
* clutter/pango/Makefile.am:
* clutter/pango/pangoclutter-fontmap.c:
* clutter/pango/pangoclutter-private.h:
* clutter/pango/pangoclutter-render.c:
* clutter/pango/pangoclutter.h: Rewrite the Pango renderer
using a PangoCairo context and saving the glyphs inside a
more efficient cache.
* configure.ac: Depend on pangocairo instead of pangoft2.
2008-05-28 14:03:28 +00:00
|
|
|
|
2008-06-23 09:55:42 +00:00
|
|
|
ClutterInputDevice* clutter_get_input_device_for_id (gint id);
|
|
|
|
|
|
|
|
|
|
void clutter_grab_pointer_for_device (ClutterActor *actor,
|
|
|
|
|
gint id);
|
|
|
|
|
|
|
|
|
|
void clutter_ungrab_pointer_for_device (gint id);
|
|
|
|
|
|
|
|
|
|
|
2006-07-24 21:15:19 +00:00
|
|
|
G_END_DECLS
|
2006-05-29 08:59:36 +00:00
|
|
|
|
2007-08-08 10:20:14 +00:00
|
|
|
#endif /* _HAVE_CLUTTER_MAIN_H */
|
