isa/mutter
1
0
Fork 0
mirror of https://github.com/brl/mutter.git synced 2024-12-23 11:32:04 +00:00
Code Issues Packages Projects Releases Wiki Activity
a54a01d1e2
mutter/clutter/clutter/clutter-paint-context-private.h

32 lines
1.3 KiB
C
Raw Normal View History

clutter: Introduce paint contexts When painting, actors rely on semi global state tracked by the state to get various things needed for painting, such as the current draw framebuffer. Having state hidden in such ways can be very deceiving as it's hard to follow changes spread out, and adding more and more state that should be tracked during a paint gets annoying as they will not change in isolation but one by one in their own places. To do this better, introduce a paint context that is passed along in paint calls that contains the necessary state needed during painting. The paint context implements a framebuffer stack just as Cogl works, which is currently needed for offscreen rendering used by clutter. The same context is passed around for paint nodes, contents and effects as well. In this commit, the context is only introduced, but not used. It aims to replace the Cogl framebuffer stack, and will allow actors to know what view it is currently painted on. https://gitlab.gnome.org/GNOME/mutter/merge_requests/935
2019-11-13 21:21:58 +00:00
/*
* Copyright (C) 2019 Red Hat Inc.
*
* 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_PAINT_CONTEXT_PRIVATE_H
#define CLUTTER_PAINT_CONTEXT_PRIVATE_H
#include "clutter-paint-context.h"
clutter: Pass redraw clip via paint context Instead of users fetching it via `clutter_stage_get_redraw_clip()`, pass it via the paint context. This is helpful as it is only valid during a paint, making it more obvious that it needs to be handled differently when there is no redraw clip (i.e. we're painting off-screen). https://gitlab.gnome.org/GNOME/mutter/merge_requests/1042
2020-02-06 09:04:49 +00:00
ClutterPaintContext * clutter_paint_context_new_for_view (ClutterStageView *view,
clutter/paint-context: Add paint flag A paint flag affects a paint operation in ways defined by the flags. Currently no flags are defined, so no semantical changes are defined yet. Eventually a flag aiming to avoid painting of cursors is going to be added, so that screen cast streams can decide whether to include a cursor or not. https://gitlab.gnome.org/GNOME/mutter/-/merge_requests/1207
2020-04-20 19:10:23 +00:00
const cairo_region_t *redraw_clip,
ClutterPaintFlag paint_flags);
clutter: Introduce paint contexts When painting, actors rely on semi global state tracked by the state to get various things needed for painting, such as the current draw framebuffer. Having state hidden in such ways can be very deceiving as it's hard to follow changes spread out, and adding more and more state that should be tracked during a paint gets annoying as they will not change in isolation but one by one in their own places. To do this better, introduce a paint context that is passed along in paint calls that contains the necessary state needed during painting. The paint context implements a framebuffer stack just as Cogl works, which is currently needed for offscreen rendering used by clutter. The same context is passed around for paint nodes, contents and effects as well. In this commit, the context is only introduced, but not used. It aims to replace the Cogl framebuffer stack, and will allow actors to know what view it is currently painted on. https://gitlab.gnome.org/GNOME/mutter/merge_requests/935
2019-11-13 21:21:58 +00:00
clutter/actor: Use paint context when culling to check render target Rendering off stage we never cull, and previously this was checked by comparing the "active framebuffer" of the stage, to the current framebuffer in the cogl stack. Replace this by checking whether the current paint context is currently drawing on stage or not. https://gitlab.gnome.org/GNOME/mutter/merge_requests/935
2019-11-21 15:26:35 +00:00
gboolean clutter_paint_context_is_drawing_off_stage (ClutterPaintContext *paint_context);
clutter/paint-context: Add API to get base framebuffer This corresponds to the framebuffer the paint targets. For regular stage redraws, this means the framebuffer of the stage view. https://gitlab.gnome.org/GNOME/mutter/merge_requests/935
2019-11-21 20:28:36 +00:00
CoglFramebuffer * clutter_paint_context_get_base_framebuffer (ClutterPaintContext *paint_context);
clutter: Introduce paint contexts When painting, actors rely on semi global state tracked by the state to get various things needed for painting, such as the current draw framebuffer. Having state hidden in such ways can be very deceiving as it's hard to follow changes spread out, and adding more and more state that should be tracked during a paint gets annoying as they will not change in isolation but one by one in their own places. To do this better, introduce a paint context that is passed along in paint calls that contains the necessary state needed during painting. The paint context implements a framebuffer stack just as Cogl works, which is currently needed for offscreen rendering used by clutter. The same context is passed around for paint nodes, contents and effects as well. In this commit, the context is only introduced, but not used. It aims to replace the Cogl framebuffer stack, and will allow actors to know what view it is currently painted on. https://gitlab.gnome.org/GNOME/mutter/merge_requests/935
2019-11-13 21:21:58 +00:00
#endif /* CLUTTER_PAINT_CONTEXT_PRIVATE_H */
Reference in New Issue Copy Permalink