49c8d42317
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
124 lines
4.7 KiB
C
124 lines
4.7 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/>.
|
|
*
|
|
* Author:
|
|
* Emmanuele Bassi <ebassi@linux.intel.com>
|
|
*/
|
|
|
|
#ifndef __CLUTTER_OFFSCREEN_EFFECT_H__
|
|
#define __CLUTTER_OFFSCREEN_EFFECT_H__
|
|
|
|
#if !defined(__CLUTTER_H_INSIDE__) && !defined(CLUTTER_COMPILATION)
|
|
#error "Only <clutter/clutter.h> can be included directly."
|
|
#endif
|
|
|
|
#include <cogl/cogl.h>
|
|
#include <clutter/clutter-effect.h>
|
|
|
|
G_BEGIN_DECLS
|
|
|
|
#define CLUTTER_TYPE_OFFSCREEN_EFFECT (clutter_offscreen_effect_get_type ())
|
|
#define CLUTTER_OFFSCREEN_EFFECT(o) (G_TYPE_CHECK_INSTANCE_CAST ((o), CLUTTER_TYPE_OFFSCREEN_EFFECT, ClutterOffscreenEffect))
|
|
#define CLUTTER_IS_OFFSCREEN_EFFECT(o) (G_TYPE_CHECK_INSTANCE_TYPE ((o), CLUTTER_TYPE_OFFSCREEN_EFFECT))
|
|
#define CLUTTER_OFFSCREEN_EFFECT_CLASS(k) (G_TYPE_CHECK_CLASS_CAST ((k), CLUTTER_TYPE_OFFSCREEN_EFFECT, ClutterOffscreenEffectClass))
|
|
#define CLUTTER_IS_OFFSCREEN_EFFECT_CLASS(k) (G_TYPE_CHECK_CLASS_TYPE ((k), CLUTTER_TYPE_OFFSCREEN_EFFECT))
|
|
#define CLUTTER_OFFSCREEN_EFFECT_GET_CLASS(o) (G_TYPE_INSTANCE_GET_CLASS ((o), CLUTTER_TYPE_OFFSCREEN_EFFECT, ClutterOffscreenEffectClass))
|
|
|
|
typedef struct _ClutterOffscreenEffect ClutterOffscreenEffect;
|
|
typedef struct _ClutterOffscreenEffectPrivate ClutterOffscreenEffectPrivate;
|
|
typedef struct _ClutterOffscreenEffectClass ClutterOffscreenEffectClass;
|
|
|
|
/**
|
|
* ClutterOffscreenEffect:
|
|
*
|
|
* The #ClutterOffscreenEffect structure contains only private data
|
|
* and should be accessed using the provided API
|
|
*
|
|
* Since: 1.4
|
|
*/
|
|
struct _ClutterOffscreenEffect
|
|
{
|
|
/*< private >*/
|
|
ClutterEffect parent_instance;
|
|
|
|
ClutterOffscreenEffectPrivate *priv;
|
|
};
|
|
|
|
/**
|
|
* ClutterOffscreenEffectClass:
|
|
* @create_texture: virtual function
|
|
* @paint_target: virtual function
|
|
*
|
|
* The #ClutterOffscreenEffectClass structure contains only private data
|
|
*
|
|
* Since: 1.4
|
|
*/
|
|
struct _ClutterOffscreenEffectClass
|
|
{
|
|
/*< private >*/
|
|
ClutterEffectClass parent_class;
|
|
|
|
/*< public >*/
|
|
CoglHandle (* create_texture) (ClutterOffscreenEffect *effect,
|
|
gfloat width,
|
|
gfloat height);
|
|
void (* paint_target) (ClutterOffscreenEffect *effect,
|
|
ClutterPaintContext *paint_context);
|
|
|
|
/*< private >*/
|
|
void (* _clutter_offscreen1) (void);
|
|
void (* _clutter_offscreen2) (void);
|
|
void (* _clutter_offscreen3) (void);
|
|
void (* _clutter_offscreen4) (void);
|
|
void (* _clutter_offscreen5) (void);
|
|
void (* _clutter_offscreen6) (void);
|
|
void (* _clutter_offscreen7) (void);
|
|
};
|
|
|
|
CLUTTER_EXPORT
|
|
GType clutter_offscreen_effect_get_type (void) G_GNUC_CONST;
|
|
|
|
CLUTTER_EXPORT
|
|
CoglMaterial * clutter_offscreen_effect_get_target (ClutterOffscreenEffect *effect);
|
|
|
|
CLUTTER_EXPORT
|
|
CoglHandle clutter_offscreen_effect_get_texture (ClutterOffscreenEffect *effect);
|
|
|
|
CLUTTER_EXPORT
|
|
void clutter_offscreen_effect_paint_target (ClutterOffscreenEffect *effect,
|
|
ClutterPaintContext *paint_context);
|
|
CLUTTER_EXPORT
|
|
CoglHandle clutter_offscreen_effect_create_texture (ClutterOffscreenEffect *effect,
|
|
gfloat width,
|
|
gfloat height);
|
|
|
|
CLUTTER_DEPRECATED_FOR (clutter_offscreen_effect_get_target_rect)
|
|
gboolean clutter_offscreen_effect_get_target_size (ClutterOffscreenEffect *effect,
|
|
gfloat *width,
|
|
gfloat *height);
|
|
|
|
CLUTTER_EXPORT
|
|
gboolean clutter_offscreen_effect_get_target_rect (ClutterOffscreenEffect *effect,
|
|
graphene_rect_t *rect);
|
|
|
|
G_END_DECLS
|
|
|
|
#endif /* __CLUTTER_OFFSCREEN_EFFECT_H__ */
|