forked from AuroraMiddleware/gtk
22e6f37c9c
One of the major requests by OpenGL users has been the ability to specify settings when creating a GL context, like the version to use or whether the debug support should be enabled. We have a couple of requirements in terms of API: • avoid, if at all possible, the "C arrays of integers with attribute, value pairs", which are hard to write and hard to bind in non-C languages. • allow failing in a recoverable way. • do not make the GL context creation API a mess of arguments. Looking at prior art, it seems that a common pattern is to split the construction phase in two: • a first phase that creates a GL context wrapper object and does preliminary checks on the environment. • a second phase that creates the backend-specific GL object. We adopted a similar pattern: • gdk_window_create_gl_context() creates a GdkGLContext • gdk_gl_context_realize() creates the underlying resources Calling gdk_gl_context_make_current() also realizes the context, so simple GL users do not need to care. Advanced users will want to call gdk_window_create_gl_context(), set up the optional requirements, and then call gdk_gl_context_realize(). If either of these two steps fails, it's possible to recover by changing the requirements, or simply creating a new GdkGLContext instance. https://bugzilla.gnome.org/show_bug.cgi?id=741946
88 lines
3.1 KiB
C
88 lines
3.1 KiB
C
/* GDK - The GIMP Drawing Kit
|
|
*
|
|
* gdkglcontextprivate.h: GL context abstraction
|
|
*
|
|
* Copyright © 2014 Emmanuele Bassi
|
|
*
|
|
* This library is free software; you can redistribute it and/or
|
|
* modify it under the terms of the GNU Library 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
|
|
* Library General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU Library General Public
|
|
* License along with this library. If not, see <http://www.gnu.org/licenses/>.
|
|
*/
|
|
|
|
#ifndef __GDK_GL_CONTEXT_PRIVATE_H__
|
|
#define __GDK_GL_CONTEXT_PRIVATE_H__
|
|
|
|
#include "gdkglcontext.h"
|
|
|
|
G_BEGIN_DECLS
|
|
|
|
#define GDK_GL_CONTEXT_CLASS(klass) (G_TYPE_CHECK_CLASS_CAST ((klass), GDK_TYPE_GL_CONTEXT, GdkGLContextClass))
|
|
#define GDK_IS_GL_CONTEXT_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((klass), GDK_TYPE_GL_CONTEXT))
|
|
#define GDK_GL_CONTEXT_GET_CLASS(obj) (G_TYPE_INSTANCE_GET_CLASS ((obj), GDK_TYPE_GL_CONTEXT, GdkGLContextClass))
|
|
|
|
typedef struct _GdkGLContextClass GdkGLContextClass;
|
|
|
|
struct _GdkGLContext
|
|
{
|
|
GObject parent_instance;
|
|
};
|
|
|
|
struct _GdkGLContextClass
|
|
{
|
|
GObjectClass parent_class;
|
|
|
|
gboolean (* realize) (GdkGLContext *context,
|
|
GError **error);
|
|
|
|
void (* end_frame) (GdkGLContext *context,
|
|
cairo_region_t *painted,
|
|
cairo_region_t *damage);
|
|
gboolean (* texture_from_surface) (GdkGLContext *context,
|
|
cairo_surface_t *surface,
|
|
cairo_region_t *region);
|
|
void (* upload_texture) (GdkGLContext *context,
|
|
cairo_surface_t *image_surface,
|
|
int width,
|
|
int height,
|
|
guint texture_target);
|
|
};
|
|
|
|
typedef struct {
|
|
guint program;
|
|
guint position_location;
|
|
guint uv_location;
|
|
guint map_location;
|
|
} GdkGLContextProgram;
|
|
|
|
typedef struct {
|
|
guint vertex_array_object;
|
|
guint tmp_framebuffer;
|
|
guint tmp_vertex_buffer;
|
|
|
|
GdkGLContextProgram texture_2d_quad_program;
|
|
GdkGLContextProgram texture_rect_quad_program;
|
|
|
|
GdkGLContextProgram *current_program;
|
|
} GdkGLContextPaintData;
|
|
|
|
GdkGLContextPaintData *gdk_gl_context_get_paint_data (GdkGLContext *context);
|
|
gboolean gdk_gl_context_use_texture_rectangle (GdkGLContext *context);
|
|
gboolean gdk_gl_context_has_framebuffer_blit (GdkGLContext *context);
|
|
gboolean gdk_gl_context_has_frame_terminator (GdkGLContext *context);
|
|
void gdk_gl_context_end_frame (GdkGLContext *context,
|
|
cairo_region_t *painted,
|
|
cairo_region_t *damage);
|
|
|
|
G_END_DECLS
|
|
|
|
#endif /* __GDK_GL_CONTEXT_PRIVATE_H__ */
|