/usr/include/cairo-dock/gldit/cairo-dock-opengl.h is in libgldi-dev 3.4.1-0ubuntu1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 | /*
* This file is a part of the Cairo-Dock project
*
* Copyright : (C) see the 'copyright' file.
* E-mail : see the 'copyright' file.
*
* This program is free software; you can redistribute it and/or
* modify it under the terms of the GNU General Public License
* as published by the Free Software Foundation; either version 3
* of the License, or (at your option) any later version.
*
* This program 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 General Public License for more details.
* You should have received a copy of the GNU General Public License
* along with this program. If not, see <http://www.gnu.org/licenses/>.
*/
#ifndef __CAIRO_DOCK_OPENGL__
#define __CAIRO_DOCK_OPENGL__
#include <glib.h>
#include "gldi-config.h"
#include "cairo-dock-struct.h"
#include "cairo-dock-container.h"
G_BEGIN_DECLS
/**
*@file cairo-dock-opengl.h This class manages the OpenGL backend and context.
*/
/// This strucure summarizes the available OpenGL configuration on the system.
struct _CairoDockGLConfig {
gboolean bIndirectRendering;
gboolean bAlphaAvailable;
gboolean bStencilBufferAvailable;
gboolean bAccumBufferAvailable;
gboolean bFboAvailable;
gboolean bNonPowerOfTwoAvailable;
gboolean bTextureFromPixmapAvailable;
#ifdef HAVE_GLX
void (*bindTexImage) (Display *display, GLXDrawable drawable, int buffer, int *attribList); // texture from pixmap
void (*releaseTexImage) (Display *display, GLXDrawable drawable, int buffer); // texture from pixmap
#elif defined(HAVE_EGL)
void (*bindTexImage) (EGLDisplay *display, EGLSurface drawable, int buffer); // texture from pixmap
void (*releaseTexImage) (EGLDisplay *display, EGLSurface drawable, int buffer); // texture from pixmap
#endif
};
struct _GldiGLManagerBackend {
gboolean (*init) (gboolean bForceOpenGL);
void (*stop) (void);
gboolean (*container_make_current) (GldiContainer *pContainer);
void (*container_end_draw) (GldiContainer *pContainer);
void (*container_init) (GldiContainer *pContainer);
void (*container_finish) (GldiContainer *pContainer);
};
/////////////
// BACKEND //
/////////////
/** Initialize the OpenGL backend, by trying to get a suitable GLX configuration.
*@param bForceOpenGL whether to force the use of OpenGL, or let the function decide.
*@return TRUE if OpenGL is usable.
*/
gboolean gldi_gl_backend_init (gboolean bForceOpenGL);
void gldi_gl_backend_deactivate (void);
#define gldi_gl_backend_is_safe(...) (g_bUseOpenGL && ! g_openglConfig.bIndirectRendering && g_openglConfig.bAlphaAvailable && g_openglConfig.bStencilBufferAvailable) // bNonPowerOfTwoAvailable et FBO sont detectes une fois qu'on a un contexte OpenGL, on ne peut donc pas les inclure ici.
/* Toggle on/off the indirect rendering mode (for cards like Radeon 35xx).
*/
void gldi_gl_backend_force_indirect_rendering (void);
///////////////
// CONTAINER //
///////////////
/** Make a Container's OpenGL context the current one.
*@param pContainer the container
*@return TRUE if the Container's context is now the current one.
*/
gboolean gldi_gl_container_make_current (GldiContainer *pContainer);
/** Start drawing on a Container's OpenGL context.
*@param pContainer the container
*@param pArea optional area to clip the drawing (NULL to draw on the whole Container)
*@param bClear whether to clear the color buffer or not
*/
gboolean gldi_gl_container_begin_draw_full (GldiContainer *pContainer, GdkRectangle *pArea, gboolean bClear);
/** Start drawing on a Container's OpenGL context (draw on the whole Container and clear buffers).
*@param pContainer the container
*/
#define gldi_gl_container_begin_draw(pContainer) gldi_gl_container_begin_draw_full (pContainer, NULL, TRUE)
/** Ends the drawing on a Container's OpenGL context.
*@param pContainer the container
*/
void gldi_gl_container_end_draw (GldiContainer *pContainer);
/** Set a perspective view to the current GL context to fit a given Container. You may want to ensure the Container's context is really the current one.
*@param pContainer the container
*/
void gldi_gl_container_set_perspective_view (GldiContainer *pContainer);
/** Set a perspective view to the current GL context to fit a given Icon (which must be inside a Container). You may want to ensure the Icon's Container's context is really the current one.
*@param pIcon the icon
*/
void gldi_gl_container_set_perspective_view_for_icon (Icon *pIcon);
/** Set a orthogonal view to the current GL context to fit a given Container. You may want to ensure the Container's context is really the current one.
*@param pContainer the container
*/
void gldi_gl_container_set_ortho_view (GldiContainer *pContainer);
/** Set a orthogonal view to the current GL context to fit a given Icon (which must be inside a Container). You may want to ensure the Icon's Container's context is really the current one.
*@param pIcon the icon
*/
void gldi_gl_container_set_ortho_view_for_icon (Icon *pIcon);
/** Set a shared default-initialized GL context on a window.
*@param pContainer the container, not yet realized.
*/
void gldi_gl_container_init (GldiContainer *pContainer);
void gldi_gl_container_finish (GldiContainer *pContainer);
void gldi_gl_manager_register_backend (GldiGLManagerBackend *pBackend);
G_END_DECLS
#endif
|