Introduce regional stage rendering

Desktop / GNOME / Mutter - Jonas Ådahl [gmail.com] - 20 July 2016 01:23 UTC

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

566c28b Introduce regional stage rendering
clutter/clutter/Makefile.am | 2 +
clutter/clutter/clutter-backend-private.h | 7 +-
clutter/clutter/clutter-backend.c | 103 -----
clutter/clutter/clutter-macros.h | 2 +
clutter/clutter/clutter-mutter.h | 1 +
clutter/clutter/clutter-private.h | 4 +
clutter/clutter/clutter-stage-private.h | 6 +-
clutter/clutter/clutter-stage-view.c | 188 +++++++++
clutter/clutter/clutter-stage-view.h | 55 +++
clutter/clutter/clutter-stage-window.c | 38 +-
clutter/clutter/clutter-stage-window.h | 14 +-
clutter/clutter/clutter-stage.c | 373 ++++++++++++------
clutter/clutter/clutter-stage.h | 3 -
clutter/clutter/clutter-util.c | 33 ++
clutter/clutter/cogl/clutter-stage-cogl.c | 427 +++++++++++++++------
clutter/clutter/cogl/clutter-stage-cogl.h | 19 +-
clutter/clutter/deprecated/clutter-stage.h | 3 +
clutter/clutter/x11/clutter-stage-x11.c | 67 +++-
clutter/clutter/x11/clutter-stage-x11.h | 3 +
src/Makefile.am | 2 +
src/backends/meta-backend-private.h | 2 +
src/backends/meta-renderer-view.c | 43 +++
src/backends/meta-renderer-view.h | 29 ++
src/backends/meta-renderer.c | 74 +++-
src/backends/meta-renderer.h | 12 +
src/backends/meta-stage.c | 3 +
src/backends/meta-stage.h | 3 +
src/backends/native/meta-backend-native.c | 7 +
src/backends/native/meta-clutter-backend-native.c | 25 +-
src/backends/native/meta-clutter-backend-native.h | 3 +
src/backends/native/meta-stage-native.c | 146 +++++--
src/backends/native/meta-stage-native.h | 4 +
src/backends/x11/meta-backend-x11.c | 3 +
src/backends/x11/meta-renderer-x11.c | 31 ++
src/backends/x11/meta-stage-x11-nested.c | 130 ++++++-
src/core/boxes-private.h | 2 +
src/core/boxes.c | 11 +
37 files changed, 1434 insertions(+), 444 deletions(-)

Upstream: git.gnome.org


  • Share