566c28bdaf
Add support for drawing a stage using multiple framebuffers each making up one part of the stage. This works by the stage backend (ClutterStageWindow) providing a list of views which will be for splitting up the stage in different regions. A view layout, for now, is a set of rectangles. The stage window (i.e. stage "backend" will use this information when drawing a frame, using one framebuffer for each view. The scene graph is adapted to explictly take a view when painting the stage. It will use this view, its assigned framebuffer and layout to offset and clip the drawing accordingly. This effectively removes any notion of "stage framebuffer", since each stage now may consist of multiple framebuffers. Therefore, API involving this has been deprecated and made no-ops; namely clutter_stage_ensure_context(). Callers are now assumed to either always use a framebuffer reference explicitly, or push/pop the framebuffer of a given view where the code has not yet changed to use the explicit-buffer-using cogl API. Currently only the nested X11 backend supports this mode fully, and the per view framebuffers are all offscreen. Upon frame completion, it'll blit each view's framebuffer onto the onscreen framebuffer before swapping. Other backends (X11 CM and native/KMS) are adapted to manage a full-stage view. The X11 CM backend will continue to use this method, while the native/KMS backend will be adopted to use multiple view drawing. https://bugzilla.gnome.org/show_bug.cgi?id=768976
159 lines
7.8 KiB
C
159 lines
7.8 KiB
C
/*
|
|
* 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/>.
|
|
*/
|
|
|
|
#ifndef __CLUTTER_BACKEND_PRIVATE_H__
|
|
#define __CLUTTER_BACKEND_PRIVATE_H__
|
|
|
|
#include <clutter/clutter-backend.h>
|
|
#include <clutter/clutter-device-manager.h>
|
|
#include <clutter/clutter-stage-window.h>
|
|
|
|
#include "clutter-event-translator.h"
|
|
|
|
#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;
|
|
|
|
CoglRenderer *cogl_renderer;
|
|
CoglDisplay *cogl_display;
|
|
CoglContext *cogl_context;
|
|
GSource *cogl_source;
|
|
|
|
CoglOnscreen *dummy_onscreen;
|
|
|
|
ClutterDeviceManager *device_manager;
|
|
|
|
cairo_font_options_t *font_options;
|
|
|
|
gchar *font_name;
|
|
|
|
gfloat units_per_em;
|
|
gint32 units_serial;
|
|
|
|
GList *event_translators;
|
|
};
|
|
|
|
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);
|
|
CoglRenderer * (* get_renderer) (ClutterBackend *backend,
|
|
GError **error);
|
|
CoglDisplay * (* get_display) (ClutterBackend *backend,
|
|
CoglRenderer *renderer,
|
|
CoglSwapChain *swap_chain,
|
|
GError **error);
|
|
gboolean (* create_context) (ClutterBackend *backend,
|
|
GError **error);
|
|
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);
|
|
|
|
gboolean (* translate_event) (ClutterBackend *backend,
|
|
gpointer native,
|
|
ClutterEvent *event);
|
|
|
|
PangoDirection (* get_keymap_direction) (ClutterBackend *backend);
|
|
|
|
/* signals */
|
|
void (* resolution_changed) (ClutterBackend *backend);
|
|
void (* font_changed) (ClutterBackend *backend);
|
|
void (* settings_changed) (ClutterBackend *backend);
|
|
};
|
|
|
|
ClutterBackend * _clutter_create_backend (void);
|
|
|
|
ClutterStageWindow * _clutter_backend_create_stage (ClutterBackend *backend,
|
|
ClutterStage *wrapper,
|
|
GError **error);
|
|
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);
|
|
gboolean _clutter_backend_translate_event (ClutterBackend *backend,
|
|
gpointer native,
|
|
ClutterEvent *event);
|
|
|
|
CLUTTER_AVAILABLE_IN_MUTTER
|
|
void _clutter_backend_add_event_translator (ClutterBackend *backend,
|
|
ClutterEventTranslator *translator);
|
|
|
|
void _clutter_backend_remove_event_translator (ClutterBackend *backend,
|
|
ClutterEventTranslator *translator);
|
|
|
|
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);
|
|
|
|
PangoDirection _clutter_backend_get_keymap_direction (ClutterBackend *backend);
|
|
|
|
CLUTTER_AVAILABLE_IN_MUTTER
|
|
void _clutter_backend_reset_cogl_framebuffer (ClutterBackend *backend);
|
|
|
|
void clutter_set_allowed_drivers (const char *drivers);
|
|
|
|
void clutter_try_set_windowing_backend (const char *drivers);
|
|
|
|
G_END_DECLS
|
|
|
|
#endif /* __CLUTTER_BACKEND_PRIVATE_H__ */
|