OpenGL Window

OpenGL Window — OpenGL window which is located on-screen

Synopsis


#include <gdk/gdkgl.h>


struct      GdkGLWindow;
GdkGLWindow* gdk_gl_window_new              (GdkGLConfig *glconfig,
                                             GdkWindow *window,
                                             const int *attrib_list);
void        gdk_gl_window_destroy           (GdkGLWindow *glwindow);
GdkWindow*  gdk_gl_window_get_window        (GdkGLWindow *glwindow);
GdkGLWindow* gdk_window_set_gl_capability   (GdkWindow *window,
                                             GdkGLConfig *glconfig,
                                             const int *attrib_list);
void        gdk_window_unset_gl_capability  (GdkWindow *window);
gboolean    gdk_window_is_gl_capable        (GdkWindow *window);
GdkGLWindow* gdk_window_get_gl_window       (GdkWindow *window);
#define     gdk_window_get_gl_drawable      (window)


Object Hierarchy


  GObject
   +----GdkDrawable
         +----GdkGLWindow

Description

Details

struct GdkGLWindow

struct GdkGLWindow;


gdk_gl_window_new ()

GdkGLWindow* gdk_gl_window_new              (GdkGLConfig *glconfig,
                                             GdkWindow *window,
                                             const int *attrib_list);

Creates an on-screen rendering area. attrib_list is currently unused. This must be set to NULL or empty (first attribute of None). See GLX 1.3 spec.

glconfig : a GdkGLConfig.
window : the GdkWindow to be used as the rendering area.
attrib_list : this must be set to NULL or empty (first attribute of None).
Returns : the new GdkGLWindow.

gdk_gl_window_destroy ()

void        gdk_gl_window_destroy           (GdkGLWindow *glwindow);

Destroys the OpenGL resources associated with glwindow and decrements glwindow's reference count.

glwindow : a GdkGLWindow.

gdk_gl_window_get_window ()

GdkWindow*  gdk_gl_window_get_window        (GdkGLWindow *glwindow);

Returns the GdkWindow associated with glwindow.

Notice that GdkGLWindow is not GdkWindow, but another GdkDrawable which have an associated GdkWindow.

glwindow : a GdkGLWindow.
Returns : the GdkWindow associated with glwindow.

gdk_window_set_gl_capability ()

GdkGLWindow* gdk_window_set_gl_capability   (GdkWindow *window,
                                             GdkGLConfig *glconfig,
                                             const int *attrib_list);

Set the OpenGL-capability to the window. This function creates a new GdkGLWindow held by the window. attrib_list is currently unused. This must be set to NULL or empty (first attribute of None).

window : the GdkWindow to be used as the rendering area.
glconfig : a GdkGLConfig.
attrib_list : this must be set to NULL or empty (first attribute of None).
Returns : the GdkGLWindow used by the window if it is successful, NULL otherwise.

gdk_window_unset_gl_capability ()

void        gdk_window_unset_gl_capability  (GdkWindow *window);

Unset the OpenGL-capability of the window. This function destroys the GdkGLWindow held by the window.

window : a GdkWindow.

gdk_window_is_gl_capable ()

gboolean    gdk_window_is_gl_capable        (GdkWindow *window);

Returns whether the window is OpenGL-capable.

window : a GdkWindow.
Returns : TRUE if the window is OpenGL-capable, FALSE otherwise.

gdk_window_get_gl_window ()

GdkGLWindow* gdk_window_get_gl_window       (GdkWindow *window);

Returns the GdkGLWindow held by the window.

window : a GdkWindow.
Returns : the GdkGLWindow.

gdk_window_get_gl_drawable()

#define     gdk_window_get_gl_drawable(window)

Returns the GdkGLDrawable held by the window. In fact, this is macro that casts the result of gdk_window_get_gl_window to GdkGLDrawable.

window :a GdkGLWindow.
Returns :the GdkGLDrawable.