2009-11-17 08:52:40 -05:00
|
|
|
/*
|
|
|
|
* Cogl
|
|
|
|
*
|
2014-02-21 20:28:54 -05:00
|
|
|
* A Low Level GPU Graphics and Utilities API
|
2009-11-17 08:52:40 -05:00
|
|
|
*
|
|
|
|
* Copyright (C) 2009 Intel Corporation.
|
|
|
|
*
|
2014-02-21 20:28:54 -05:00
|
|
|
* Permission is hereby granted, free of charge, to any person
|
|
|
|
* obtaining a copy of this software and associated documentation
|
|
|
|
* files (the "Software"), to deal in the Software without
|
|
|
|
* restriction, including without limitation the rights to use, copy,
|
|
|
|
* modify, merge, publish, distribute, sublicense, and/or sell copies
|
|
|
|
* of the Software, and to permit persons to whom the Software is
|
|
|
|
* furnished to do so, subject to the following conditions:
|
2009-11-17 08:52:40 -05:00
|
|
|
*
|
2014-02-21 20:28:54 -05:00
|
|
|
* The above copyright notice and this permission notice shall be
|
|
|
|
* included in all copies or substantial portions of the Software.
|
2009-11-17 08:52:40 -05:00
|
|
|
*
|
2014-02-21 20:28:54 -05:00
|
|
|
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
|
|
|
|
* EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
|
|
|
|
* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
|
|
|
|
* NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS
|
|
|
|
* BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
|
|
|
|
* ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
|
|
|
|
* CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
|
|
* SOFTWARE.
|
2010-03-01 07:56:10 -05:00
|
|
|
*
|
|
|
|
*
|
2009-11-17 08:52:40 -05:00
|
|
|
*/
|
|
|
|
|
|
|
|
#ifndef __COGL_FEATURE_PRIVATE_H
|
|
|
|
#define __COGL_FEATURE_PRIVATE_H
|
|
|
|
|
|
|
|
#include <glib.h>
|
|
|
|
|
2010-11-05 08:28:33 -04:00
|
|
|
|
2009-11-17 08:52:40 -05:00
|
|
|
#define COGL_CHECK_GL_VERSION(driver_major, driver_minor, \
|
|
|
|
target_major, target_minor) \
|
|
|
|
((driver_major) > (target_major) || \
|
|
|
|
((driver_major) == (target_major) && (driver_minor) >= (target_minor)))
|
|
|
|
|
2011-07-06 13:59:20 -04:00
|
|
|
typedef enum
|
|
|
|
{
|
|
|
|
COGL_EXT_IN_GLES = (1 << 0),
|
|
|
|
COGL_EXT_IN_GLES2 = (1 << 1)
|
|
|
|
} CoglExtGlesAvailability;
|
|
|
|
|
2009-11-17 08:52:40 -05:00
|
|
|
typedef struct _CoglFeatureFunction CoglFeatureFunction;
|
|
|
|
|
|
|
|
struct _CoglFeatureFunction
|
|
|
|
{
|
|
|
|
/* The name of the function without the "EXT" or "ARB" suffix */
|
cogl: improves header and coding style consistency
We've had complaints that our Cogl code/headers are a bit "special" so
this is a first pass at tidying things up by giving them some
consistency. These changes are all consistent with how new code in Cogl
is being written, but the style isn't consistently applied across all
code yet.
There are two parts to this patch; but since each one required a large
amount of effort to maintain tidy indenting it made sense to combine the
changes to reduce the time spent re indenting the same lines.
The first change is to use a consistent style for declaring function
prototypes in headers. Cogl headers now consistently use this style for
prototypes:
return_type
cogl_function_name (CoglType arg0,
CoglType arg1);
Not everyone likes this style, but it seems that most of the currently
active Cogl developers agree on it.
The second change is to constrain the use of redundant glib data types
in Cogl. Uses of gint, guint, gfloat, glong, gulong and gchar have all
been replaced with int, unsigned int, float, long, unsigned long and char
respectively. When talking about pixel data; use of guchar has been
replaced with guint8, otherwise unsigned char can be used.
The glib types that we continue to use for portability are gboolean,
gint{8,16,32,64}, guint{8,16,32,64} and gsize.
The general intention is that Cogl should look palatable to the widest
range of C programmers including those outside the Gnome community so
- especially for the public API - we want to minimize the number of
foreign looking typedefs.
2010-02-09 20:57:32 -05:00
|
|
|
const char *name;
|
2009-11-17 08:52:40 -05:00
|
|
|
/* The offset in the context of where to store the function pointer */
|
cogl: improves header and coding style consistency
We've had complaints that our Cogl code/headers are a bit "special" so
this is a first pass at tidying things up by giving them some
consistency. These changes are all consistent with how new code in Cogl
is being written, but the style isn't consistently applied across all
code yet.
There are two parts to this patch; but since each one required a large
amount of effort to maintain tidy indenting it made sense to combine the
changes to reduce the time spent re indenting the same lines.
The first change is to use a consistent style for declaring function
prototypes in headers. Cogl headers now consistently use this style for
prototypes:
return_type
cogl_function_name (CoglType arg0,
CoglType arg1);
Not everyone likes this style, but it seems that most of the currently
active Cogl developers agree on it.
The second change is to constrain the use of redundant glib data types
in Cogl. Uses of gint, guint, gfloat, glong, gulong and gchar have all
been replaced with int, unsigned int, float, long, unsigned long and char
respectively. When talking about pixel data; use of guchar has been
replaced with guint8, otherwise unsigned char can be used.
The glib types that we continue to use for portability are gboolean,
gint{8,16,32,64}, guint{8,16,32,64} and gsize.
The general intention is that Cogl should look palatable to the widest
range of C programmers including those outside the Gnome community so
- especially for the public API - we want to minimize the number of
foreign looking typedefs.
2010-02-09 20:57:32 -05:00
|
|
|
unsigned int pointer_offset;
|
2009-11-17 08:52:40 -05:00
|
|
|
};
|
|
|
|
|
|
|
|
typedef struct _CoglFeatureData CoglFeatureData;
|
|
|
|
|
|
|
|
struct _CoglFeatureData
|
|
|
|
{
|
|
|
|
/* A minimum GL version which the functions should be defined in
|
|
|
|
without needing an extension. Set to 255,255 if it's only
|
|
|
|
provided in an extension */
|
2011-07-06 13:59:20 -04:00
|
|
|
int min_gl_major, min_gl_minor;
|
|
|
|
/* Flags specifying which versions of GLES the feature is available
|
|
|
|
in core in */
|
|
|
|
CoglExtGlesAvailability gles_availability;
|
2009-11-17 08:52:40 -05:00
|
|
|
/* \0 separated list of namespaces to try. Eg "EXT\0ARB\0" */
|
cogl: improves header and coding style consistency
We've had complaints that our Cogl code/headers are a bit "special" so
this is a first pass at tidying things up by giving them some
consistency. These changes are all consistent with how new code in Cogl
is being written, but the style isn't consistently applied across all
code yet.
There are two parts to this patch; but since each one required a large
amount of effort to maintain tidy indenting it made sense to combine the
changes to reduce the time spent re indenting the same lines.
The first change is to use a consistent style for declaring function
prototypes in headers. Cogl headers now consistently use this style for
prototypes:
return_type
cogl_function_name (CoglType arg0,
CoglType arg1);
Not everyone likes this style, but it seems that most of the currently
active Cogl developers agree on it.
The second change is to constrain the use of redundant glib data types
in Cogl. Uses of gint, guint, gfloat, glong, gulong and gchar have all
been replaced with int, unsigned int, float, long, unsigned long and char
respectively. When talking about pixel data; use of guchar has been
replaced with guint8, otherwise unsigned char can be used.
The glib types that we continue to use for portability are gboolean,
gint{8,16,32,64}, guint{8,16,32,64} and gsize.
The general intention is that Cogl should look palatable to the widest
range of C programmers including those outside the Gnome community so
- especially for the public API - we want to minimize the number of
foreign looking typedefs.
2010-02-09 20:57:32 -05:00
|
|
|
const char *namespaces;
|
2009-11-17 08:52:40 -05:00
|
|
|
/* \0 separated list of required extension names without the GL_EXT
|
2011-07-06 13:59:20 -04:00
|
|
|
or GL_ARB prefix. Any of the extensions must be available for the
|
2009-11-17 08:52:40 -05:00
|
|
|
feature to be considered available. If the suffix for an
|
|
|
|
extension is different from the namespace, you can specify it
|
|
|
|
with a ':' after the namespace */
|
cogl: improves header and coding style consistency
We've had complaints that our Cogl code/headers are a bit "special" so
this is a first pass at tidying things up by giving them some
consistency. These changes are all consistent with how new code in Cogl
is being written, but the style isn't consistently applied across all
code yet.
There are two parts to this patch; but since each one required a large
amount of effort to maintain tidy indenting it made sense to combine the
changes to reduce the time spent re indenting the same lines.
The first change is to use a consistent style for declaring function
prototypes in headers. Cogl headers now consistently use this style for
prototypes:
return_type
cogl_function_name (CoglType arg0,
CoglType arg1);
Not everyone likes this style, but it seems that most of the currently
active Cogl developers agree on it.
The second change is to constrain the use of redundant glib data types
in Cogl. Uses of gint, guint, gfloat, glong, gulong and gchar have all
been replaced with int, unsigned int, float, long, unsigned long and char
respectively. When talking about pixel data; use of guchar has been
replaced with guint8, otherwise unsigned char can be used.
The glib types that we continue to use for portability are gboolean,
gint{8,16,32,64}, guint{8,16,32,64} and gsize.
The general intention is that Cogl should look palatable to the widest
range of C programmers including those outside the Gnome community so
- especially for the public API - we want to minimize the number of
foreign looking typedefs.
2010-02-09 20:57:32 -05:00
|
|
|
const char *extension_names;
|
2009-11-17 08:52:40 -05:00
|
|
|
/* A set of feature flags to enable if the extension is available */
|
|
|
|
CoglFeatureFlags feature_flags;
|
2011-05-24 12:21:28 -04:00
|
|
|
/* A set of private feature flags to enable if the extension is
|
|
|
|
* available */
|
|
|
|
int feature_flags_private;
|
2010-11-05 08:28:33 -04:00
|
|
|
/* An optional corresponding winsys feature. */
|
|
|
|
CoglWinsysFeature winsys_feature;
|
2009-11-17 08:52:40 -05:00
|
|
|
/* A list of functions required for this feature. Terminated with a
|
|
|
|
NULL name */
|
|
|
|
const CoglFeatureFunction *functions;
|
|
|
|
};
|
|
|
|
|
Switch use of primitive glib types to c99 equivalents
The coding style has for a long time said to avoid using redundant glib
data types such as gint or gchar etc because we feel that they make the
code look unnecessarily foreign to developers coming from outside of the
Gnome developer community.
Note: When we tried to find the historical rationale for the types we
just found that they were apparently only added for consistent syntax
highlighting which didn't seem that compelling.
Up until now we have been continuing to use some of the platform
specific type such as gint{8,16,32,64} and gsize but this patch switches
us over to using the standard c99 equivalents instead so we can further
ensure that our code looks familiar to the widest range of C developers
who might potentially contribute to Cogl.
So instead of using the gint{8,16,32,64} and guint{8,16,32,64} types this
switches all Cogl code to instead use the int{8,16,32,64}_t and
uint{8,16,32,64}_t c99 types instead.
Instead of gsize we now use size_t
For now we are not going to use the c99 _Bool type and instead we have
introduced a new CoglBool type to use instead of gboolean.
Reviewed-by: Neil Roberts <neil@linux.intel.com>
(cherry picked from commit 5967dad2400d32ca6319cef6cb572e81bf2c15f0)
2012-04-16 16:56:40 -04:00
|
|
|
CoglBool
|
2011-07-27 07:30:02 -04:00
|
|
|
_cogl_feature_check (CoglRenderer *renderer,
|
2011-05-23 20:38:48 -04:00
|
|
|
const char *driver_prefix,
|
2010-11-05 08:28:33 -04:00
|
|
|
const CoglFeatureData *data,
|
2011-07-06 13:59:20 -04:00
|
|
|
int gl_major,
|
|
|
|
int gl_minor,
|
2011-07-07 15:44:56 -04:00
|
|
|
CoglDriver driver,
|
2012-09-26 15:32:36 -04:00
|
|
|
char * const *extensions,
|
2010-11-05 08:28:33 -04:00
|
|
|
void *function_table);
|
2009-11-17 08:52:40 -05:00
|
|
|
|
2011-07-06 13:59:20 -04:00
|
|
|
void
|
|
|
|
_cogl_feature_check_ext_functions (CoglContext *context,
|
|
|
|
int gl_major,
|
|
|
|
int gl_minor,
|
2012-09-26 15:32:36 -04:00
|
|
|
char * const *gl_extensions);
|
2011-07-06 13:59:20 -04:00
|
|
|
|
2009-11-17 08:52:40 -05:00
|
|
|
#endif /* __COGL_FEATURE_PRIVATE_H */
|