2007-03-22 18:21:59 +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
|
2008-10-30 17:04:34 +00:00
|
|
|
* License along with this library. If not, see <http://www.gnu.org/licenses/>.
|
2007-03-22 18:21:59 +00:00
|
|
|
*/
|
|
|
|
|
|
2008-10-30 17:04:34 +00:00
|
|
|
#if !defined(__CLUTTER_H_INSIDE__) && !defined(CLUTTER_COMPILATION)
|
|
|
|
|
#error "Only <clutter/clutter.h> can be included directly."
|
|
|
|
|
#endif
|
|
|
|
|
|
2007-03-22 18:21:59 +00:00
|
|
|
#ifndef __CLUTTER_BACKEND_H__
|
|
|
|
|
#define __CLUTTER_BACKEND_H__
|
|
|
|
|
|
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
|
|
|
#include <cairo.h>
|
2007-03-22 18:21:59 +00:00
|
|
|
#include <glib-object.h>
|
2008-12-23 15:03:11 +00:00
|
|
|
#include <pango/pango.h>
|
2011-08-12 15:25:53 +00:00
|
|
|
#ifdef COGL_ENABLE_EXPERIMENTAL_2_0_API
|
|
|
|
|
#include <cogl/cogl.h>
|
|
|
|
|
#endif
|
2008-12-23 15:03:11 +00:00
|
|
|
|
2007-03-22 18:21:59 +00:00
|
|
|
#include <clutter/clutter-actor.h>
|
2010-02-17 17:06:25 +00:00
|
|
|
#include <clutter/clutter-device-manager.h>
|
2007-03-22 18:21:59 +00:00
|
|
|
#include <clutter/clutter-event.h>
|
2007-05-16 09:08:30 +00:00
|
|
|
#include <clutter/clutter-feature.h>
|
2009-08-13 11:34:07 +00:00
|
|
|
#include <clutter/clutter-stage.h>
|
|
|
|
|
#include <clutter/clutter-stage-window.h>
|
2007-03-22 18:21:59 +00:00
|
|
|
|
|
|
|
|
G_BEGIN_DECLS
|
|
|
|
|
|
|
|
|
|
#define CLUTTER_TYPE_BACKEND (clutter_backend_get_type ())
|
|
|
|
|
#define CLUTTER_BACKEND(obj) (G_TYPE_CHECK_INSTANCE_CAST ((obj), CLUTTER_TYPE_BACKEND, ClutterBackend))
|
|
|
|
|
#define CLUTTER_IS_BACKEND(obj) (G_TYPE_CHECK_INSTANCE_TYPE ((obj), CLUTTER_TYPE_BACKEND))
|
|
|
|
|
|
2011-01-20 16:18:16 +00:00
|
|
|
/**
|
|
|
|
|
* ClutterBackend:
|
|
|
|
|
*
|
|
|
|
|
* <structname>ClutterBackend</structname> is an opaque structure whose
|
|
|
|
|
* members cannot be directly accessed.
|
|
|
|
|
*
|
|
|
|
|
* Since: 0.4
|
|
|
|
|
*/
|
2007-03-22 18:21:59 +00:00
|
|
|
typedef struct _ClutterBackend ClutterBackend;
|
2011-01-20 16:18:16 +00:00
|
|
|
typedef struct _ClutterBackendClass ClutterBackendClass;
|
2007-03-22 18:21:59 +00:00
|
|
|
|
2007-04-19 15:25:34 +00:00
|
|
|
GType clutter_backend_get_type (void) G_GNUC_CONST;
|
2007-03-23 17:55:13 +00:00
|
|
|
|
|
|
|
|
ClutterBackend *clutter_get_default_backend (void);
|
|
|
|
|
|
2010-06-21 16:58:26 +00:00
|
|
|
#ifndef CLUTTER_DISABLE_DEPRECATED
|
2011-10-11 22:03:09 +00:00
|
|
|
CLUTTER_DEPRECATED_FOR(ClutterSettings:font_dpi)
|
2009-02-26 15:32:48 +00:00
|
|
|
void clutter_backend_set_resolution (ClutterBackend *backend,
|
|
|
|
|
gdouble dpi);
|
2011-10-11 22:03:09 +00:00
|
|
|
|
|
|
|
|
CLUTTER_DEPRECATED_FOR(ClutterSettings:double_click_time)
|
2009-02-26 15:32:48 +00:00
|
|
|
void clutter_backend_set_double_click_time (ClutterBackend *backend,
|
|
|
|
|
guint msec);
|
2011-10-11 22:03:09 +00:00
|
|
|
|
|
|
|
|
CLUTTER_DEPRECATED_FOR(ClutterSettings:double_click_time)
|
2009-02-26 15:32:48 +00:00
|
|
|
guint clutter_backend_get_double_click_time (ClutterBackend *backend);
|
2011-10-11 22:03:09 +00:00
|
|
|
|
|
|
|
|
CLUTTER_DEPRECATED_FOR(ClutterSettings:double_click_distance)
|
2009-02-26 15:32:48 +00:00
|
|
|
void clutter_backend_set_double_click_distance (ClutterBackend *backend,
|
|
|
|
|
guint distance);
|
2011-10-11 22:03:09 +00:00
|
|
|
|
|
|
|
|
CLUTTER_DEPRECATED_FOR(ClutterSettings:double_click_distance)
|
2009-02-26 15:32:48 +00:00
|
|
|
guint clutter_backend_get_double_click_distance (ClutterBackend *backend);
|
2011-10-11 22:03:09 +00:00
|
|
|
|
|
|
|
|
CLUTTER_DEPRECATED_FOR(ClutterSettings:font_name)
|
2009-02-26 15:32:48 +00:00
|
|
|
void clutter_backend_set_font_name (ClutterBackend *backend,
|
|
|
|
|
const gchar *font_name);
|
2011-10-11 22:03:09 +00:00
|
|
|
|
|
|
|
|
CLUTTER_DEPRECATED_FOR(ClutterSettings:font_name)
|
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 14:49:20 +00:00
|
|
|
const gchar * clutter_backend_get_font_name (ClutterBackend *backend);
|
2010-06-21 16:58:26 +00:00
|
|
|
#endif /* CLUTTER_DISABLE_DEPRECATED */
|
|
|
|
|
|
2010-06-21 17:01:57 +00:00
|
|
|
gdouble clutter_backend_get_resolution (ClutterBackend *backend);
|
|
|
|
|
|
2010-06-21 16:58:26 +00:00
|
|
|
void clutter_backend_set_font_options (ClutterBackend *backend,
|
|
|
|
|
const cairo_font_options_t *options);
|
|
|
|
|
const cairo_font_options_t *clutter_backend_get_font_options (ClutterBackend *backend);
|
2007-03-22 18:21:59 +00:00
|
|
|
|
2011-08-12 15:25:53 +00:00
|
|
|
#if defined (COGL_ENABLE_EXPERIMENTAL_2_0_API) && defined (CLUTTER_ENABLE_EXPERIMENTAL_API)
|
|
|
|
|
CoglContext *clutter_backend_get_cogl_context (ClutterBackend *backend);
|
|
|
|
|
#endif
|
|
|
|
|
|
2007-03-22 18:21:59 +00:00
|
|
|
G_END_DECLS
|
|
|
|
|
|
|
|
|
|
#endif /* __CLUTTER_BACKEND_H__ */
|