2010-10-21 12:13:00 +00:00
|
|
|
/*
|
|
|
|
* Clutter.
|
|
|
|
*
|
|
|
|
* An OpenGL based 'interactive canvas' library.
|
|
|
|
*
|
|
|
|
* Copyright (C) 2010 Intel Corporation.
|
|
|
|
*
|
|
|
|
* 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.gnu.org/licenses/>.
|
|
|
|
*/
|
|
|
|
|
2010-10-21 10:49:37 +00:00
|
|
|
#ifndef __CLUTTER_BACKEND_PRIVATE_H__
|
|
|
|
#define __CLUTTER_BACKEND_PRIVATE_H__
|
|
|
|
|
|
|
|
#include <clutter/clutter-backend.h>
|
2011-02-09 12:20:56 +00:00
|
|
|
#include "clutter-event-translator.h"
|
2010-10-21 10:49:37 +00:00
|
|
|
|
|
|
|
#define CLUTTER_BACKEND_CLASS(klass) (G_TYPE_CHECK_CLASS_CAST ((klass), CLUTTER_TYPE_BACKEND, ClutterBackendClass))
|
|
|
|
#define CLUTTER_IS_BACKEND_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((klass), CLUTTER_TYPE_BACKEND))
|
|
|
|
#define CLUTTER_BACKEND_GET_CLASS(obj) (G_TYPE_INSTANCE_GET_CLASS ((obj), CLUTTER_TYPE_BACKEND, ClutterBackendClass))
|
|
|
|
|
|
|
|
G_BEGIN_DECLS
|
|
|
|
|
|
|
|
typedef struct _ClutterBackendPrivate ClutterBackendPrivate;
|
|
|
|
|
|
|
|
struct _ClutterBackend
|
|
|
|
{
|
|
|
|
/*< private >*/
|
|
|
|
GObject parent_instance;
|
2010-11-05 12:28:33 +00:00
|
|
|
|
|
|
|
CoglRenderer *cogl_renderer;
|
|
|
|
CoglDisplay *cogl_display;
|
|
|
|
CoglContext *cogl_context;
|
|
|
|
|
2010-10-21 10:49:37 +00:00
|
|
|
ClutterBackendPrivate *priv;
|
|
|
|
};
|
|
|
|
|
|
|
|
struct _ClutterBackendClass
|
|
|
|
{
|
|
|
|
/*< private >*/
|
|
|
|
GObjectClass parent_class;
|
|
|
|
|
|
|
|
/* vfuncs */
|
|
|
|
gboolean (* pre_parse) (ClutterBackend *backend,
|
|
|
|
GError **error);
|
|
|
|
gboolean (* post_parse) (ClutterBackend *backend,
|
|
|
|
GError **error);
|
|
|
|
ClutterStageWindow * (* create_stage) (ClutterBackend *backend,
|
|
|
|
ClutterStage *wrapper,
|
|
|
|
GError **error);
|
|
|
|
void (* init_events) (ClutterBackend *backend);
|
|
|
|
void (* init_features) (ClutterBackend *backend);
|
|
|
|
void (* add_options) (ClutterBackend *backend,
|
|
|
|
GOptionGroup *group);
|
|
|
|
ClutterFeatureFlags (* get_features) (ClutterBackend *backend);
|
|
|
|
void (* redraw) (ClutterBackend *backend,
|
|
|
|
ClutterStage *stage);
|
|
|
|
gboolean (* create_context) (ClutterBackend *backend,
|
|
|
|
GError **error);
|
|
|
|
void (* ensure_context) (ClutterBackend *backend,
|
|
|
|
ClutterStage *stage);
|
|
|
|
ClutterDeviceManager *(* get_device_manager) (ClutterBackend *backend);
|
|
|
|
|
|
|
|
void (* copy_event_data) (ClutterBackend *backend,
|
|
|
|
const ClutterEvent *src,
|
|
|
|
ClutterEvent *dest);
|
|
|
|
void (* free_event_data) (ClutterBackend *backend,
|
|
|
|
ClutterEvent *event);
|
|
|
|
|
event/x11: Rework the way we translate X11 events
This is a lump commit that is fairly difficult to break down without
either breaking bisecting or breaking the test cases.
The new design for handling X11 event translation works this way:
- ClutterBackend::translate_event() has been added as the central
point used by a ClutterBackend implementation to translate a
native event into a ClutterEvent;
- ClutterEventTranslator is a private interface that should be
implemented by backend-specific objects, like stage
implementations and ClutterDeviceManager sub-classes, and
allows dealing with class-specific event translation;
- ClutterStageX11 implements EventTranslator, and deals with the
stage-relative X11 events coming from the X11 event source;
- ClutterStageGLX overrides EventTranslator, in order to
deal with the INTEL_GLX_swap_event extension, and it chains up
to the X11 default implementation;
- ClutterDeviceManagerX11 has been split into two separate classes,
one that deals with core and (optionally) XI1 events, and the
other that deals with XI2 events; the selection is done at run-time,
since the core+XI1 and XI2 mechanisms are mutually exclusive.
All the other backends we officially support still use their own
custom event source and translation function, but the end goal is to
migrate them to the translate_event() virtual function, and have the
event source be a shared part of Clutter core.
2011-01-04 12:32:04 +00:00
|
|
|
gboolean (* translate_event) (ClutterBackend *backend,
|
|
|
|
gpointer native,
|
|
|
|
ClutterEvent *event);
|
|
|
|
|
2010-10-21 10:49:37 +00:00
|
|
|
/* signals */
|
|
|
|
void (* resolution_changed) (ClutterBackend *backend);
|
|
|
|
void (* font_changed) (ClutterBackend *backend);
|
|
|
|
void (* settings_changed) (ClutterBackend *backend);
|
|
|
|
};
|
|
|
|
|
|
|
|
/* vfuncs implemented by backend */
|
|
|
|
GType _clutter_backend_impl_get_type (void);
|
|
|
|
|
|
|
|
void _clutter_backend_redraw (ClutterBackend *backend,
|
|
|
|
ClutterStage *stage);
|
|
|
|
ClutterStageWindow *_clutter_backend_create_stage (ClutterBackend *backend,
|
|
|
|
ClutterStage *wrapper,
|
|
|
|
GError **error);
|
|
|
|
void _clutter_backend_ensure_context (ClutterBackend *backend,
|
|
|
|
ClutterStage *stage);
|
|
|
|
void _clutter_backend_ensure_context_internal
|
|
|
|
(ClutterBackend *backend,
|
|
|
|
ClutterStage *stage);
|
|
|
|
gboolean _clutter_backend_create_context (ClutterBackend *backend,
|
|
|
|
GError **error);
|
|
|
|
|
|
|
|
void _clutter_backend_add_options (ClutterBackend *backend,
|
|
|
|
GOptionGroup *group);
|
|
|
|
gboolean _clutter_backend_pre_parse (ClutterBackend *backend,
|
|
|
|
GError **error);
|
|
|
|
gboolean _clutter_backend_post_parse (ClutterBackend *backend,
|
|
|
|
GError **error);
|
|
|
|
void _clutter_backend_init_events (ClutterBackend *backend);
|
|
|
|
|
|
|
|
void _clutter_backend_copy_event_data (ClutterBackend *backend,
|
|
|
|
const ClutterEvent *src,
|
|
|
|
ClutterEvent *dest);
|
|
|
|
void _clutter_backend_free_event_data (ClutterBackend *backend,
|
|
|
|
ClutterEvent *event);
|
|
|
|
|
|
|
|
ClutterFeatureFlags _clutter_backend_get_features (ClutterBackend *backend);
|
|
|
|
|
|
|
|
gfloat _clutter_backend_get_units_per_em (ClutterBackend *backend,
|
|
|
|
PangoFontDescription *font_desc);
|
|
|
|
|
|
|
|
gint32 _clutter_backend_get_units_serial (ClutterBackend *backend);
|
|
|
|
|
event/x11: Rework the way we translate X11 events
This is a lump commit that is fairly difficult to break down without
either breaking bisecting or breaking the test cases.
The new design for handling X11 event translation works this way:
- ClutterBackend::translate_event() has been added as the central
point used by a ClutterBackend implementation to translate a
native event into a ClutterEvent;
- ClutterEventTranslator is a private interface that should be
implemented by backend-specific objects, like stage
implementations and ClutterDeviceManager sub-classes, and
allows dealing with class-specific event translation;
- ClutterStageX11 implements EventTranslator, and deals with the
stage-relative X11 events coming from the X11 event source;
- ClutterStageGLX overrides EventTranslator, in order to
deal with the INTEL_GLX_swap_event extension, and it chains up
to the X11 default implementation;
- ClutterDeviceManagerX11 has been split into two separate classes,
one that deals with core and (optionally) XI1 events, and the
other that deals with XI2 events; the selection is done at run-time,
since the core+XI1 and XI2 mechanisms are mutually exclusive.
All the other backends we officially support still use their own
custom event source and translation function, but the end goal is to
migrate them to the translate_event() virtual function, and have the
event source be a shared part of Clutter core.
2011-01-04 12:32:04 +00:00
|
|
|
gboolean _clutter_backend_translate_event (ClutterBackend *backend,
|
|
|
|
gpointer native,
|
|
|
|
ClutterEvent *event);
|
|
|
|
|
2011-02-09 12:20:56 +00:00
|
|
|
void _clutter_backend_add_event_translator (ClutterBackend *backend,
|
|
|
|
ClutterEventTranslator *translator);
|
|
|
|
void _clutter_backend_remove_event_translator (ClutterBackend *backend,
|
|
|
|
ClutterEventTranslator *translator);
|
|
|
|
|
|
|
|
|
2010-10-21 10:49:37 +00:00
|
|
|
G_END_DECLS
|
|
|
|
|
|
|
|
#endif /* __CLUTTER_BACKEND_PRIVATE_H__ */
|