forked from AuroraMiddleware/gtk
3d90a070d5
Render nodes need access to rendering information like scaling factors. If we keep render nodes separate from renderers until we submit a nodes tree for rendering we're going to have to duplicate all that information in a way that makes the API more complicated and fuzzier on its semantics. By having GskRenderer create GskRenderNode instances we can tie nodes and renderers together; since higher layers will also have access to the renderer instance, this does not add any burden to callers. Additionally, if memory measurements indicate that we are spending too much time in the allocation of new render nodes, we can now easily implement a free-list or a renderer-specific allocator without breaking the API.
111 lines
5.7 KiB
C
111 lines
5.7 KiB
C
/* GSK - The GTK Scene Kit
|
|
*
|
|
* Copyright 2016 Endless
|
|
*
|
|
* 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 __GSK_RENDERER_H__
|
|
#define __GSK_RENDERER_H__
|
|
|
|
#if !defined (__GSK_H_INSIDE__) && !defined (GSK_COMPILATION)
|
|
#error "Only <gsk/gsk.h> can be included directly."
|
|
#endif
|
|
|
|
#include <gsk/gsktypes.h>
|
|
#include <gsk/gskrendernode.h>
|
|
|
|
G_BEGIN_DECLS
|
|
|
|
#define GSK_TYPE_RENDERER (gsk_renderer_get_type ())
|
|
|
|
#define GSK_RENDERER(obj) (G_TYPE_CHECK_INSTANCE_CAST ((obj), GSK_TYPE_RENDERER, GskRenderer))
|
|
#define GSK_IS_RENDERER(obj) (G_TYPE_CHECK_INSTANCE_TYPE ((obj), GSK_TYPE_RENDERER))
|
|
|
|
typedef struct _GskRenderer GskRenderer;
|
|
typedef struct _GskRendererClass GskRendererClass;
|
|
|
|
GDK_AVAILABLE_IN_3_22
|
|
GType gsk_renderer_get_type (void) G_GNUC_CONST;
|
|
|
|
GDK_AVAILABLE_IN_3_22
|
|
GskRenderer * gsk_renderer_get_for_display (GdkDisplay *display);
|
|
|
|
GDK_AVAILABLE_IN_3_22
|
|
void gsk_renderer_set_viewport (GskRenderer *renderer,
|
|
const graphene_rect_t *viewport);
|
|
GDK_AVAILABLE_IN_3_22
|
|
void gsk_renderer_get_viewport (GskRenderer *renderer,
|
|
graphene_rect_t *viewport);
|
|
GDK_AVAILABLE_IN_3_22
|
|
void gsk_renderer_set_projection (GskRenderer *renderer,
|
|
const graphene_matrix_t *projection);
|
|
GDK_AVAILABLE_IN_3_22
|
|
void gsk_renderer_get_projection (GskRenderer *renderer,
|
|
graphene_matrix_t *projection);
|
|
GDK_AVAILABLE_IN_3_22
|
|
void gsk_renderer_set_modelview (GskRenderer *renderer,
|
|
const graphene_matrix_t *modelview);
|
|
GDK_AVAILABLE_IN_3_22
|
|
void gsk_renderer_get_modelview (GskRenderer *renderer,
|
|
graphene_matrix_t *modelview);
|
|
GDK_AVAILABLE_IN_3_22
|
|
void gsk_renderer_set_scaling_filters (GskRenderer *renderer,
|
|
GskScalingFilter min_filter,
|
|
GskScalingFilter mag_filter);
|
|
GDK_AVAILABLE_IN_3_22
|
|
void gsk_renderer_get_scaling_filters (GskRenderer *renderer,
|
|
GskScalingFilter *min_filter,
|
|
GskScalingFilter *mag_filter);
|
|
GDK_AVAILABLE_IN_3_22
|
|
void gsk_renderer_set_scale_factor (GskRenderer *renderer,
|
|
int scale_factor);
|
|
GDK_AVAILABLE_IN_3_22
|
|
int gsk_renderer_get_scale_factor (GskRenderer *renderer);
|
|
GDK_AVAILABLE_IN_3_22
|
|
void gsk_renderer_set_auto_clear (GskRenderer *renderer,
|
|
gboolean clear);
|
|
GDK_AVAILABLE_IN_3_22
|
|
gboolean gsk_renderer_get_auto_clear (GskRenderer *renderer);
|
|
GDK_AVAILABLE_IN_3_22
|
|
void gsk_renderer_set_use_alpha (GskRenderer *renderer,
|
|
gboolean use_alpha);
|
|
GDK_AVAILABLE_IN_3_22
|
|
gboolean gsk_renderer_get_use_alpha (GskRenderer *renderer);
|
|
GDK_AVAILABLE_IN_3_22
|
|
void gsk_renderer_set_window (GskRenderer *renderer,
|
|
GdkWindow *window);
|
|
GDK_AVAILABLE_IN_3_22
|
|
GdkWindow * gsk_renderer_get_window (GskRenderer *renderer);
|
|
|
|
GDK_AVAILABLE_IN_3_22
|
|
GdkDisplay * gsk_renderer_get_display (GskRenderer *renderer);
|
|
|
|
GDK_AVAILABLE_IN_3_22
|
|
gboolean gsk_renderer_realize (GskRenderer *renderer);
|
|
GDK_AVAILABLE_IN_3_22
|
|
void gsk_renderer_unrealize (GskRenderer *renderer);
|
|
|
|
GDK_AVAILABLE_IN_3_22
|
|
GskRenderNode * gsk_renderer_create_render_node (GskRenderer *renderer);
|
|
|
|
GDK_AVAILABLE_IN_3_22
|
|
void gsk_renderer_render (GskRenderer *renderer,
|
|
GskRenderNode *root,
|
|
GdkDrawingContext *context);
|
|
|
|
G_END_DECLS
|
|
|
|
#endif /* __GSK_RENDERER_H__ */
|