8458fb7e20
This is a publicly exposed texture backend to create a texture which
contains the contents of an X11 pixmap. The API is currently marked as
experimental.
The backend internally holds a handle to another texture. All of the
backend virtuals simply redirect to the internal texture.
The texture can optionally be automatically updated if the
automatic_updates parameter is TRUE. If set then Cogl will listen for
damage events on the pixmap and update the texture accordingly.
Alternatively a damage object can be created externally and passed
down to Cogl.
The updates can be performed with XGetImage, XShmGetImage or the
GLX_EXT_texture_pixmap extension. If the TFP extension is used it will
optionally try to create a rectangle texture if the driver does not
support NPOTs or it is forced through the
COGL_PIXMAP_TEXTURE_RECTANGLE or CLUTTER_PIXMAP_TEXTURE_RECTANGLE
environment variables.
If the GLXFBConfig does not support mipmapping then it will fallback
to using X{Shm,}GetImage. It keeps a separate texture around for this
so that it can later start using the TFP texture again if the texture
is later drawn with mipmaps disabled.
118 lines
3.3 KiB
C
118 lines
3.3 KiB
C
/*
|
|
* Cogl
|
|
*
|
|
* An object oriented GL/GLES Abstraction/Utility Layer
|
|
*
|
|
* 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/>.
|
|
*
|
|
*
|
|
*/
|
|
|
|
#ifndef __COGL_CONTEXT_WINSYS_H
|
|
#define __COGL_CONTEXT_WINSYS_H
|
|
|
|
#ifdef COGL_HAS_XLIB_SUPPORT
|
|
#include <X11/extensions/Xdamage.h>
|
|
#include <X11/Xlib.h>
|
|
#endif
|
|
|
|
#ifdef COGL_HAS_GLX_SUPPORT
|
|
#include <GL/glx.h>
|
|
#endif
|
|
|
|
typedef enum
|
|
{
|
|
COGL_WINSYS_FEATURE_TEXTURE_FROM_PIXMAP = 1
|
|
} CoglWinsysFeatureFlags;
|
|
|
|
#ifdef COGL_HAS_XLIB_SUPPORT
|
|
|
|
typedef struct _CoglXlibTrapState CoglXlibTrapState;
|
|
|
|
struct _CoglXlibTrapState
|
|
{
|
|
/* These values are intended to be internal to
|
|
_cogl_xlib_{un,}trap_errors but they need to be in the header so
|
|
that the struct can be allocated on the stack */
|
|
int (* old_error_handler) (Display *, XErrorEvent *);
|
|
int trapped_error_code;
|
|
CoglXlibTrapState *old_state;
|
|
};
|
|
|
|
#endif /* COGL_HAS_XLIB_SUPPORT */
|
|
|
|
#ifdef COGL_HAS_GLX_SUPPORT
|
|
|
|
typedef struct
|
|
{
|
|
/* This will be -1 if there is no cached config in this slot */
|
|
int depth;
|
|
GLXFBConfig fb_config;
|
|
gboolean can_mipmap;
|
|
} CoglWinsysCachedConfig;
|
|
|
|
#define COGL_WINSYS_N_CACHED_CONFIGS 3
|
|
|
|
typedef enum
|
|
{
|
|
COGL_WINSYS_RECTANGLE_STATE_UNKNOWN,
|
|
COGL_WINSYS_RECTANGLE_STATE_DISABLE,
|
|
COGL_WINSYS_RECTANGLE_STATE_ENABLE
|
|
} CoglWinsysRectangleState;
|
|
|
|
#endif /* COGL_HAS_GLX_SUPPORT */
|
|
|
|
typedef struct
|
|
{
|
|
/* These are specific to winsys backends supporting Xlib. This
|
|
should probably eventually be moved into a separate file specific
|
|
to Xlib when Cogl gains a more complete winsys abstraction */
|
|
#ifdef COGL_HAS_XLIB_SUPPORT
|
|
/* This will be -1 if the damage extension is not support, or it
|
|
will be the event number offset for damage events if it is */
|
|
int damage_base;
|
|
/* List of callback functions that will be given every Xlib event */
|
|
GSList *event_filters;
|
|
/* Current top of the XError trap state stack. The actual memory for
|
|
these is expected to be allocated on the stack by the caller */
|
|
CoglXlibTrapState *trap_state;
|
|
#endif
|
|
|
|
#ifdef COGL_HAS_GLX_SUPPORT
|
|
CoglWinsysCachedConfig glx_cached_configs[COGL_WINSYS_N_CACHED_CONFIGS];
|
|
/* Whether the texture rectangle extension should be used */
|
|
CoglWinsysRectangleState rectangle_state;
|
|
#endif
|
|
|
|
/* Function pointers for winsys specific extensions */
|
|
#define COGL_WINSYS_FEATURE_BEGIN(a, b, c, d, e)
|
|
|
|
#define COGL_WINSYS_FEATURE_FUNCTION(ret, name, args) \
|
|
ret (APIENTRY * pf_ ## name) args;
|
|
|
|
#define COGL_WINSYS_FEATURE_END()
|
|
|
|
#include "cogl-winsys-feature-functions.h"
|
|
|
|
#undef COGL_WINSYS_FEATURE_BEGIN
|
|
#undef COGL_WINSYS_FEATURE_FUNCTION
|
|
#undef COGL_WINSYS_FEATURE_END
|
|
|
|
CoglWinsysFeatureFlags feature_flags;
|
|
} CoglContextWinsys;
|
|
|
|
#endif /* __COGL_CONTEXT_WINSYS_H */
|