2008-04-25 13:37:36 +00:00
|
|
|
/*
|
|
|
|
* Clutter COGL
|
|
|
|
*
|
|
|
|
* A basic GL/GLES Abstraction/Utility Layer
|
|
|
|
*
|
|
|
|
* Authored By Matthew Allum <mallum@openedhand.com>
|
|
|
|
*
|
|
|
|
* Copyright (C) 2007 OpenedHand
|
|
|
|
*
|
|
|
|
* 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, write to the
|
|
|
|
* Free Software Foundation, Inc., 59 Temple Place - Suite 330,
|
|
|
|
* Boston, MA 02111-1307, USA.
|
|
|
|
*/
|
|
|
|
|
|
|
|
#ifndef __COGL_INTERNAL_H
|
|
|
|
#define __COGL_INTERNAL_H
|
|
|
|
|
|
|
|
#define COGL_DEBUG 0
|
|
|
|
|
|
|
|
#if COGL_DEBUG
|
2008-05-21 13:20:33 +00:00
|
|
|
|
|
|
|
#include <stdio.h>
|
|
|
|
|
|
|
|
const char *_cogl_error_string(GLenum errorCode);
|
|
|
|
|
2008-04-25 13:37:36 +00:00
|
|
|
#define GE(x...) G_STMT_START { \
|
|
|
|
GLenum err; \
|
|
|
|
(x); \
|
|
|
|
while ((err = glGetError()) != GL_NO_ERROR) { \
|
|
|
|
fprintf(stderr, "glError: %s caught at %s:%u\n", \
|
2008-05-21 13:20:33 +00:00
|
|
|
(char *)_cogl_error_string(err), \
|
|
|
|
__FILE__, __LINE__); \
|
2008-04-25 13:37:36 +00:00
|
|
|
} \
|
|
|
|
} G_STMT_END
|
2008-05-21 13:20:33 +00:00
|
|
|
|
|
|
|
#else /* COGL_DEBUG */
|
|
|
|
|
2008-11-18 16:23:40 +00:00
|
|
|
#define GE(x) (x)
|
2008-05-21 13:20:33 +00:00
|
|
|
|
|
|
|
#endif /* COGL_DEBUG */
|
2008-04-25 13:37:36 +00:00
|
|
|
|
|
|
|
#define COGL_ENABLE_BLEND (1<<1)
|
Fully integrates CoglMaterial throughout the rest of Cogl
This glues CoglMaterial in as the fundamental way that Cogl describes how to
fill in geometry.
It adds cogl_set_source (), which is used to set the material which will be
used by all subsequent drawing functions
It adds cogl_set_source_texture as a convenience for setting up a default
material with a single texture layer, and cogl_set_source_color is now also
a convenience for setting up a material with a solid fill.
"drawing functions" include, cogl_rectangle, cogl_texture_rectangle,
cogl_texture_multiple_rectangles, cogl_texture_polygon (though the
cogl_texture_* funcs have been renamed; see below for details),
cogl_path_fill/stroke and cogl_vertex_buffer_draw*.
cogl_texture_rectangle, cogl_texture_multiple_rectangles and
cogl_texture_polygon no longer take a texture handle; instead the current
source material is referenced. The functions have also been renamed to:
cogl_rectangle_with_texture_coords, cogl_rectangles_with_texture_coords
and cogl_polygon respectivly.
Most code that previously did:
cogl_texture_rectangle (tex_handle, x, y,...);
needs to be changed to now do:
cogl_set_source_texture (tex_handle);
cogl_rectangle_with_texture_coords (x, y,....);
In the less likely case where you were blending your source texture with a color
like:
cogl_set_source_color4ub (r,g,b,a); /* where r,g,b,a isn't just white */
cogl_texture_rectangle (tex_handle, x, y,...);
you will need your own material to do that:
mat = cogl_material_new ();
cogl_material_set_color4ub (r,g,b,a);
cogl_material_set_layer (mat, 0, tex_handle));
cogl_set_source_material (mat);
Code that uses the texture coordinates, 0, 0, 1, 1 don't need to use
cog_rectangle_with_texure_coords since these are the coordinates that
cogl_rectangle will use.
For cogl_texture_polygon; as well as dropping the texture handle, the
n_vertices and vertices arguments were transposed for consistency. So
code previously written as:
cogl_texture_polygon (tex_handle, 3, verts, TRUE);
need to be written as:
cogl_set_source_texture (tex_handle);
cogl_polygon (verts, 3, TRUE);
All of the unit tests have been updated to now use the material API and
test-cogl-material has been renamed to test-cogl-multitexture since any
textured quad is now technically a test of CoglMaterial but this test
specifically creates a material with multiple texture layers.
Note: The GLES backend has not been updated yet; that will be done in a
following commit.
2009-01-23 16:15:40 +00:00
|
|
|
#define COGL_ENABLE_ALPHA_TEST (1<<2)
|
|
|
|
#define COGL_ENABLE_VERTEX_ARRAY (1<<3)
|
|
|
|
#define COGL_ENABLE_COLOR_ARRAY (1<<4)
|
|
|
|
#define COGL_ENABLE_BACKFACE_CULLING (1<<5)
|
2008-04-25 13:37:36 +00:00
|
|
|
|
|
|
|
gint
|
|
|
|
_cogl_get_format_bpp (CoglPixelFormat format);
|
|
|
|
|
|
|
|
void
|
|
|
|
cogl_enable (gulong flags);
|
|
|
|
|
|
|
|
gulong
|
|
|
|
cogl_get_enable ();
|
|
|
|
|
|
|
|
#endif /* __COGL_INTERNAL_H */
|