2008-04-25 13:37:36 +00:00
|
|
|
/*
|
2009-04-27 14:48:12 +00:00
|
|
|
* Cogl
|
2008-04-25 13:37:36 +00:00
|
|
|
*
|
2009-04-27 14:48:12 +00:00
|
|
|
* An object oriented GL/GLES Abstraction/Utility Layer
|
2008-04-25 13:37:36 +00:00
|
|
|
*
|
2009-04-27 14:48:12 +00:00
|
|
|
* Copyright (C) 2008,2009 Intel Corporation.
|
2008-04-25 13:37:36 +00:00
|
|
|
*
|
|
|
|
* This library is free software; you can redistribute it and/or
|
2009-04-27 14:48:12 +00:00
|
|
|
|
2008-04-25 13:37:36 +00:00
|
|
|
* 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_H__
|
|
|
|
#define __COGL_H__
|
|
|
|
|
|
|
|
#include <glib.h>
|
|
|
|
|
2009-02-23 12:47:02 +00:00
|
|
|
#define __COGL_H_INSIDE__
|
|
|
|
|
2009-11-18 17:35:07 +00:00
|
|
|
#include <cogl/cogl-defines.h>
|
2008-10-30 17:25:00 +00:00
|
|
|
|
2009-11-06 15:06:39 +00:00
|
|
|
#include <cogl/cogl-bitmap.h>
|
2008-10-30 16:50:07 +00:00
|
|
|
#include <cogl/cogl-color.h>
|
2009-11-06 15:06:39 +00:00
|
|
|
#include <cogl/cogl-debug.h>
|
|
|
|
#include <cogl/cogl-fixed.h>
|
Adds a CoglMaterial abstraction, which includes support for multi-texturing
My previous work to provide muti-texturing support has been extended into
a CoglMaterial abstraction that adds control over the texture combine
functions (controlling how multiple texture layers are blended together),
the gl blend function (used for blending the final primitive with the
framebuffer), the alpha function (used to discard fragments based on
their alpha channel), describing attributes such as a diffuse, ambient and
specular color (for use with the standard OpenGL lighting model), and
per layer rotations. (utilizing the new CoglMatrix utility API)
For now the only way this abstraction is exposed is via a new
cogl_material_rectangle function, that is similar to cogl_texture_rectangle
but doesn't take a texture handle (the source material is pulled from
the context), and the array of texture coordinates is extended to be able
to supply coordinates for each layer.
Note: this function doesn't support sliced textures; supporting sliced
textures is a non trivial problem, considering the ability to rotate layers.
Note: cogl_material_rectangle, has quite a few workarounds, for a number of
other limitations within Cogl a.t.m.
Note: The GLES1/2 multi-texturing support has yet to be updated to use
the material abstraction.
2008-12-11 20:11:30 +00:00
|
|
|
#include <cogl/cogl-material.h>
|
2009-11-06 15:06:39 +00:00
|
|
|
#include <cogl/cogl-matrix.h>
|
|
|
|
#include <cogl/cogl-offscreen.h>
|
2008-10-30 17:25:00 +00:00
|
|
|
#include <cogl/cogl-path.h>
|
|
|
|
#include <cogl/cogl-shader.h>
|
|
|
|
#include <cogl/cogl-texture.h>
|
|
|
|
#include <cogl/cogl-types.h>
|
2009-11-06 15:06:39 +00:00
|
|
|
#include <cogl/cogl-vertex-buffer.h>
|
|
|
|
|
2009-05-29 11:31:47 +00:00
|
|
|
#include <cogl/cogl-enum-types.h>
|
2008-04-25 13:37:36 +00:00
|
|
|
|
2009-11-06 15:06:39 +00:00
|
|
|
#include <cogl/cogl-deprecated.h>
|
|
|
|
|
2008-04-25 13:37:36 +00:00
|
|
|
G_BEGIN_DECLS
|
|
|
|
|
2008-06-12 17:21:16 +00:00
|
|
|
/**
|
|
|
|
* SECTION:cogl
|
|
|
|
* @short_description: General purpose API
|
|
|
|
*
|
|
|
|
* General utility functions for COGL.
|
|
|
|
*/
|
|
|
|
|
2009-02-23 12:47:02 +00:00
|
|
|
/**
|
|
|
|
* cogl_get_option_group:
|
|
|
|
*
|
|
|
|
* Retrieves the #GOptionGroup used by COGL to parse the command
|
|
|
|
* line options. Clutter uses this to handle the COGL command line
|
|
|
|
* options during its initialization process.
|
|
|
|
*
|
|
|
|
* Return value: a #GOptionGroup
|
|
|
|
*
|
|
|
|
* Since: 1.0
|
|
|
|
*/
|
|
|
|
GOptionGroup * cogl_get_option_group (void);
|
|
|
|
|
2008-04-25 13:37:36 +00:00
|
|
|
/* Misc */
|
|
|
|
/**
|
|
|
|
* cogl_get_features:
|
|
|
|
*
|
|
|
|
* Returns all of the features supported by COGL.
|
|
|
|
*
|
|
|
|
* Return value: A logical OR of all the supported COGL features.
|
|
|
|
*
|
|
|
|
* Since: 0.8
|
|
|
|
*/
|
2008-10-30 16:52:56 +00:00
|
|
|
CoglFeatureFlags cogl_get_features (void);
|
2008-04-25 13:37:36 +00:00
|
|
|
|
|
|
|
/**
|
|
|
|
* cogl_features_available:
|
|
|
|
* @features: A bitmask of features to check for
|
|
|
|
*
|
|
|
|
* Checks whether the given COGL features are available. Multiple
|
|
|
|
* features can be checked for by or-ing them together with the '|'
|
|
|
|
* operator. %TRUE is only returned if all of the requested features
|
|
|
|
* are available.
|
|
|
|
*
|
|
|
|
* Return value: %TRUE if the features are available, %FALSE otherwise.
|
|
|
|
*/
|
2008-04-28 15:36:11 +00:00
|
|
|
gboolean cogl_features_available (CoglFeatureFlags features);
|
2008-04-25 13:37:36 +00:00
|
|
|
|
|
|
|
/**
|
|
|
|
* cogl_get_proc_address:
|
|
|
|
* @name: the name of the function.
|
|
|
|
*
|
|
|
|
* Gets a pointer to a given GL or GL ES extension function. This acts
|
|
|
|
* as a wrapper around glXGetProcAddress() or whatever is the
|
|
|
|
* appropriate function for the current backend.
|
|
|
|
*
|
|
|
|
* Return value: a pointer to the requested function or %NULL if the
|
2009-11-19 13:55:10 +00:00
|
|
|
* function is not available.
|
2008-04-25 13:37:36 +00:00
|
|
|
*/
|
2008-04-28 15:36:11 +00:00
|
|
|
CoglFuncPtr cogl_get_proc_address (const gchar *name);
|
2008-04-25 13:37:36 +00:00
|
|
|
|
2008-04-28 14:00:46 +00:00
|
|
|
/**
|
|
|
|
* cogl_check_extension:
|
|
|
|
* @name: extension to check for
|
|
|
|
* @ext: list of extensions
|
|
|
|
*
|
|
|
|
* Check whether @name occurs in list of extensions in @ext.
|
|
|
|
*
|
2009-11-19 13:55:10 +00:00
|
|
|
* Return value: %TRUE if the extension occurs in the list, %FALSE otherwize.
|
2008-04-28 14:00:46 +00:00
|
|
|
*/
|
2008-04-28 15:36:11 +00:00
|
|
|
gboolean cogl_check_extension (const gchar *name,
|
|
|
|
const gchar *ext);
|
2008-04-25 13:37:36 +00:00
|
|
|
|
|
|
|
/**
|
|
|
|
* cogl_get_bitmasks:
|
2009-11-19 13:55:10 +00:00
|
|
|
* @red: (out): Return location for the number of red bits or %NULL
|
|
|
|
* @green: (out): Return location for the number of green bits or %NULL
|
|
|
|
* @blue: (out): Return location for the number of blue bits or %NULL
|
|
|
|
* @alpha: (out): Return location for the number of alpha bits or %NULL
|
2008-04-25 13:37:36 +00:00
|
|
|
*
|
|
|
|
* Gets the number of bitplanes used for each of the color components
|
|
|
|
* in the color buffer. Pass %NULL for any of the arguments if the
|
|
|
|
* value is not required.
|
|
|
|
*/
|
2008-04-28 15:36:11 +00:00
|
|
|
void cogl_get_bitmasks (gint *red,
|
|
|
|
gint *green,
|
|
|
|
gint *blue,
|
|
|
|
gint *alpha);
|
2008-04-28 14:00:46 +00:00
|
|
|
|
|
|
|
/**
|
|
|
|
* cogl_perspective:
|
|
|
|
* @fovy: Vertical of view angle in degrees.
|
|
|
|
* @aspect: Aspect ratio of diesplay
|
2008-04-28 15:36:11 +00:00
|
|
|
* @z_near: Nearest visible point
|
|
|
|
* @z_far: Furthest visible point along the z-axis
|
2008-04-28 14:00:46 +00:00
|
|
|
*
|
2008-08-01 12:23:57 +00:00
|
|
|
* Replaces the current projection matrix with a perspective matrix
|
|
|
|
* based on the provided values.
|
2008-04-28 14:00:46 +00:00
|
|
|
*/
|
2009-01-20 16:20:54 +00:00
|
|
|
void cogl_perspective (float fovy,
|
|
|
|
float aspect,
|
|
|
|
float z_near,
|
|
|
|
float z_far);
|
2008-04-25 13:37:36 +00:00
|
|
|
|
2008-08-01 12:23:57 +00:00
|
|
|
/**
|
|
|
|
* cogl_frustum:
|
|
|
|
* @left: Left clipping plane
|
|
|
|
* @right: Right clipping plane
|
|
|
|
* @bottom: Bottom clipping plane
|
|
|
|
* @top: Top clipping plane
|
|
|
|
* @z_near: Nearest visible point
|
|
|
|
* @z_far: Furthest visible point along the z-axis
|
|
|
|
*
|
|
|
|
* Replaces the current projection matrix with a perspective matrix
|
|
|
|
* for the given viewing frustum.
|
|
|
|
*
|
|
|
|
* Since: 0.8.2
|
|
|
|
*/
|
2009-01-20 16:20:54 +00:00
|
|
|
void cogl_frustum (float left,
|
|
|
|
float right,
|
|
|
|
float bottom,
|
|
|
|
float top,
|
|
|
|
float z_near,
|
|
|
|
float z_far);
|
2008-08-01 12:23:57 +00:00
|
|
|
|
2009-05-26 10:33:54 +00:00
|
|
|
/**
|
|
|
|
* cogl_ortho:
|
|
|
|
* @left: The coordinate for the left clipping plane
|
|
|
|
* @right: The coordinate for the right clipping plane
|
|
|
|
* @bottom: The coordinate for the bottom clipping plane
|
|
|
|
* @top: The coordinate for the top clipping plane
|
|
|
|
* @near: The coordinate for the near clipping plane (may be negative if
|
|
|
|
* the plane is behind the viewer)
|
|
|
|
* @far: The coordinate for the far clipping plane (may be negative if
|
|
|
|
* the plane is behind the viewer)
|
|
|
|
*
|
|
|
|
* Replaces the current projection matrix with a parallel projection
|
|
|
|
* matrix.
|
|
|
|
*
|
|
|
|
* Since: 1.0
|
|
|
|
*/
|
|
|
|
void cogl_ortho (float left,
|
|
|
|
float right,
|
|
|
|
float bottom,
|
|
|
|
float top,
|
|
|
|
float near,
|
|
|
|
float far);
|
|
|
|
|
2009-05-28 12:03:19 +00:00
|
|
|
/*
|
|
|
|
* _cogl_setup_viewport:
|
2008-04-25 13:37:36 +00:00
|
|
|
* @width: Width of the viewport
|
|
|
|
* @height: Height of the viewport
|
|
|
|
* @fovy: Field of view angle in degrees
|
|
|
|
* @aspect: Aspect ratio to determine the field of view along the x-axis
|
|
|
|
* @z_near: Nearest visible point along the z-axis
|
|
|
|
* @z_far: Furthest visible point along the z-axis
|
|
|
|
*
|
|
|
|
* Replaces the current viewport and projection matrix with the given
|
|
|
|
* values. The viewport is placed at the top left corner of the window
|
|
|
|
* with the given width and height. The projection matrix is replaced
|
|
|
|
* with one that has a viewing angle of @fovy along the y-axis and a
|
|
|
|
* view scaled according to @aspect along the x-axis. The view is
|
|
|
|
* clipped according to @z_near and @z_far on the z-axis.
|
2009-05-28 12:03:19 +00:00
|
|
|
*
|
|
|
|
* This function is used only by Clutter.
|
2008-04-25 13:37:36 +00:00
|
|
|
*/
|
2009-05-28 12:03:19 +00:00
|
|
|
void _cogl_setup_viewport (guint width,
|
|
|
|
guint height,
|
2009-01-20 16:20:54 +00:00
|
|
|
float fovy,
|
|
|
|
float aspect,
|
|
|
|
float z_near,
|
|
|
|
float z_far);
|
2008-04-25 13:37:36 +00:00
|
|
|
|
2009-11-03 13:26:58 +00:00
|
|
|
#ifndef COGL_DISABLE_DEPRECATED
|
|
|
|
|
2008-08-01 12:23:57 +00:00
|
|
|
/**
|
|
|
|
* cogl_viewport:
|
|
|
|
* @width: Width of the viewport
|
|
|
|
* @height: Height of the viewport
|
|
|
|
*
|
|
|
|
* Replace the current viewport with the given values.
|
|
|
|
*
|
|
|
|
* Since: 0.8.2
|
2009-11-18 18:04:13 +00:00
|
|
|
*
|
|
|
|
* Deprecated: 1.2: Use cogl_set_viewport() instead
|
2008-08-01 12:23:57 +00:00
|
|
|
*/
|
|
|
|
void cogl_viewport (guint width,
|
2009-11-03 13:26:58 +00:00
|
|
|
guint height) G_GNUC_DEPRECATED;
|
|
|
|
|
2009-11-18 18:04:13 +00:00
|
|
|
#endif /* COGL_DISABLE_DEPRECATED */
|
2009-11-03 13:26:58 +00:00
|
|
|
|
|
|
|
/**
|
|
|
|
* cogl_set_viewport:
|
2009-11-19 13:55:10 +00:00
|
|
|
* @x: X offset of the viewport
|
|
|
|
* @y: Y offset of the viewport
|
2009-11-03 13:26:58 +00:00
|
|
|
* @width: Width of the viewport
|
|
|
|
* @height: Height of the viewport
|
|
|
|
*
|
2009-11-19 13:55:10 +00:00
|
|
|
* Replaces the current viewport with the given values.
|
2009-11-03 13:26:58 +00:00
|
|
|
*
|
|
|
|
* Since: 1.2
|
|
|
|
*/
|
|
|
|
void cogl_set_viewport (int x,
|
|
|
|
int y,
|
|
|
|
int width,
|
|
|
|
int height);
|
2008-08-01 12:23:57 +00:00
|
|
|
|
2008-04-25 13:37:36 +00:00
|
|
|
/**
|
|
|
|
* cogl_push_matrix:
|
|
|
|
*
|
2009-11-19 13:55:10 +00:00
|
|
|
* Stores the current model-view matrix on the matrix stack. The matrix
|
2008-04-25 13:37:36 +00:00
|
|
|
* can later be restored with cogl_pop_matrix().
|
|
|
|
*/
|
2008-04-28 15:36:11 +00:00
|
|
|
void cogl_push_matrix (void);
|
2008-04-25 13:37:36 +00:00
|
|
|
|
|
|
|
/**
|
|
|
|
* cogl_pop_matrix:
|
|
|
|
*
|
2009-11-19 13:55:10 +00:00
|
|
|
* Restores the current model-view matrix from the matrix stack.
|
2008-04-25 13:37:36 +00:00
|
|
|
*/
|
2008-04-28 15:36:11 +00:00
|
|
|
void cogl_pop_matrix (void);
|
2008-04-25 13:37:36 +00:00
|
|
|
|
|
|
|
/**
|
|
|
|
* cogl_scale:
|
|
|
|
* @x: Amount to scale along the x-axis
|
|
|
|
* @y: Amount to scale along the y-axis
|
2009-01-26 22:52:38 +00:00
|
|
|
* @z: Amount to scale along the z-axis
|
2008-04-25 13:37:36 +00:00
|
|
|
*
|
2009-01-26 22:52:38 +00:00
|
|
|
* Multiplies the current model-view matrix by one that scales the x,
|
|
|
|
* y and z axes by the given values.
|
2008-04-25 13:37:36 +00:00
|
|
|
*/
|
2009-01-20 16:20:54 +00:00
|
|
|
void cogl_scale (float x,
|
2009-01-26 22:52:38 +00:00
|
|
|
float y,
|
|
|
|
float z);
|
2008-04-25 13:37:36 +00:00
|
|
|
|
|
|
|
/**
|
2009-01-20 16:20:54 +00:00
|
|
|
* cogl_translate:
|
2008-04-25 13:37:36 +00:00
|
|
|
* @x: Distance to translate along the x-axis
|
|
|
|
* @y: Distance to translate along the y-axis
|
|
|
|
* @z: Distance to translate along the z-axis
|
|
|
|
*
|
|
|
|
* Multiplies the current model-view matrix by one that translates the
|
|
|
|
* model along all three axes according to the given values.
|
|
|
|
*/
|
2009-01-20 16:20:54 +00:00
|
|
|
void cogl_translate (float x,
|
|
|
|
float y,
|
|
|
|
float z);
|
2008-04-25 13:37:36 +00:00
|
|
|
|
|
|
|
/**
|
2009-01-20 16:20:54 +00:00
|
|
|
* cogl_rotate:
|
2008-04-25 13:37:36 +00:00
|
|
|
* @angle: Angle in degrees to rotate.
|
|
|
|
* @x: X-component of vertex to rotate around.
|
|
|
|
* @y: Y-component of vertex to rotate around.
|
|
|
|
* @z: Z-component of vertex to rotate around.
|
|
|
|
*
|
|
|
|
* Multiplies the current model-view matrix by one that rotates the
|
|
|
|
* model around the vertex specified by @x, @y and @z. The rotation
|
|
|
|
* follows the right-hand thumb rule so for example rotating by 10
|
|
|
|
* degrees about the vertex (0, 0, 1) causes a small counter-clockwise
|
|
|
|
* rotation.
|
|
|
|
*/
|
2009-01-20 16:20:54 +00:00
|
|
|
void cogl_rotate (float angle,
|
|
|
|
float x,
|
|
|
|
float y,
|
|
|
|
float z);
|
2008-04-25 13:37:36 +00:00
|
|
|
|
|
|
|
/**
|
|
|
|
* cogl_get_modelview_matrix:
|
2009-11-19 13:55:10 +00:00
|
|
|
* @matrix: (out): return location for the model-view matrix
|
2008-04-25 13:37:36 +00:00
|
|
|
*
|
2009-02-18 18:54:54 +00:00
|
|
|
* Stores the current model-view matrix in @matrix.
|
2008-04-25 13:37:36 +00:00
|
|
|
*/
|
2009-02-18 18:54:54 +00:00
|
|
|
void cogl_get_modelview_matrix (CoglMatrix *matrix);
|
2008-04-25 13:37:36 +00:00
|
|
|
|
2009-05-26 10:33:54 +00:00
|
|
|
/**
|
|
|
|
* cogl_set_modelview_matrix:
|
2009-11-19 13:55:10 +00:00
|
|
|
* @matrix: the new model-view matrix
|
2009-05-26 10:33:54 +00:00
|
|
|
*
|
2009-11-19 13:55:10 +00:00
|
|
|
* Loads @matrix as the new model-view matrix.
|
2009-05-26 10:33:54 +00:00
|
|
|
*/
|
|
|
|
void cogl_set_modelview_matrix (CoglMatrix *matrix);
|
|
|
|
|
2008-04-25 13:37:36 +00:00
|
|
|
/**
|
|
|
|
* cogl_get_projection_matrix:
|
2009-11-19 13:55:10 +00:00
|
|
|
* @matrix: (out): return location for the projection matrix
|
2008-04-25 13:37:36 +00:00
|
|
|
*
|
2009-02-18 18:54:54 +00:00
|
|
|
* Stores the current projection matrix in @matrix.
|
2008-04-25 13:37:36 +00:00
|
|
|
*/
|
2009-02-18 18:54:54 +00:00
|
|
|
void cogl_get_projection_matrix (CoglMatrix *matrix);
|
2008-04-25 13:37:36 +00:00
|
|
|
|
2009-05-26 10:33:54 +00:00
|
|
|
/**
|
|
|
|
* cogl_set_projection_matrix:
|
2009-11-19 13:55:10 +00:00
|
|
|
* @matrix: the new projection matrix
|
2009-05-26 10:33:54 +00:00
|
|
|
*
|
|
|
|
* Loads matrix as the new projection matrix.
|
|
|
|
*/
|
|
|
|
void cogl_set_projection_matrix (CoglMatrix *matrix);
|
|
|
|
|
2008-04-25 13:37:36 +00:00
|
|
|
/**
|
|
|
|
* cogl_get_viewport:
|
2009-11-19 13:55:10 +00:00
|
|
|
* @v: (out) (array fixed-size=4): pointer to a 4 element array
|
|
|
|
* of #float<!-- -->s to receive the viewport dimensions.
|
2008-04-25 13:37:36 +00:00
|
|
|
*
|
|
|
|
* Stores the current viewport in @v. @v[0] and @v[1] get the x and y
|
|
|
|
* position of the viewport and @v[2] and @v[3] get the width and
|
|
|
|
* height.
|
|
|
|
*/
|
2009-01-20 16:20:54 +00:00
|
|
|
void cogl_get_viewport (float v[4]);
|
2008-04-25 13:37:36 +00:00
|
|
|
|
|
|
|
/**
|
2009-06-10 11:50:45 +00:00
|
|
|
* cogl_set_depth_test_enabled:
|
2008-04-25 13:37:36 +00:00
|
|
|
* @setting: %TRUE to enable depth testing or %FALSE to disable.
|
|
|
|
*
|
|
|
|
* Sets whether depth testing is enabled. If it is disabled then the
|
|
|
|
* order that actors are layered on the screen depends solely on the
|
|
|
|
* order specified using clutter_actor_raise() and
|
|
|
|
* clutter_actor_lower(), otherwise it will also take into account the
|
|
|
|
* actor's depth. Depth testing is disabled by default.
|
|
|
|
*/
|
2009-06-10 11:50:45 +00:00
|
|
|
void cogl_set_depth_test_enabled (gboolean setting);
|
2008-04-25 13:37:36 +00:00
|
|
|
|
2008-10-27 14:36:52 +00:00
|
|
|
/**
|
2009-07-20 11:49:35 +00:00
|
|
|
* cogl_get_depth_test_enabled:
|
2009-05-26 15:55:11 +00:00
|
|
|
*
|
|
|
|
* Queries if depth testing has been enabled via cogl_set_depth_test_enable()
|
|
|
|
*
|
2009-11-19 13:55:10 +00:00
|
|
|
* Return value: %TRUE if depth testing is enabled, and %FALSE otherwise
|
2009-05-26 15:55:11 +00:00
|
|
|
*/
|
2009-06-10 11:50:45 +00:00
|
|
|
gboolean cogl_get_depth_test_enabled (void);
|
2009-05-26 15:55:11 +00:00
|
|
|
|
|
|
|
/**
|
|
|
|
* cogl_set_backface_culling_enabled:
|
2008-10-27 14:36:52 +00:00
|
|
|
* @setting: %TRUE to enable backface culling or %FALSE to disable.
|
|
|
|
*
|
|
|
|
* Sets whether textures positioned so that their backface is showing
|
|
|
|
* should be hidden. This can be used to efficiently draw two-sided
|
2009-05-21 13:56:38 +00:00
|
|
|
* textures or fully closed cubes without enabling depth testing. This
|
|
|
|
* only affects calls to the cogl_rectangle* family of functions and
|
|
|
|
* cogl_vertex_buffer_draw*. Backface culling is disabled by default.
|
2008-10-27 14:36:52 +00:00
|
|
|
*/
|
2009-05-26 15:55:11 +00:00
|
|
|
void cogl_set_backface_culling_enabled (gboolean setting);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* cogl_get_backface_culling_enabled:
|
|
|
|
*
|
|
|
|
* Queries if backface culling has been enabled via
|
|
|
|
* cogl_set_backface_culling_enabled()
|
|
|
|
*
|
2009-11-19 13:55:10 +00:00
|
|
|
* Return value: %TRUE if backface culling is enabled, and %FALSE otherwise
|
2009-05-26 15:55:11 +00:00
|
|
|
*/
|
|
|
|
gboolean cogl_get_backface_culling_enabled (void);
|
2008-10-27 14:36:52 +00:00
|
|
|
|
2008-04-25 13:37:36 +00:00
|
|
|
/**
|
2009-02-04 09:21:37 +00:00
|
|
|
* cogl_set_fog:
|
2008-04-25 13:37:36 +00:00
|
|
|
* @fog_color: The color of the fog
|
2009-11-19 13:55:10 +00:00
|
|
|
* @mode: A #CoglFogMode that determines the equation used to calculate the
|
|
|
|
* fogging blend factor.
|
|
|
|
* @density: Used by %COGL_FOG_MODE_EXPONENTIAL and by
|
|
|
|
* %COGL_FOG_MODE_EXPONENTIAL_SQUARED equations.
|
|
|
|
* @z_near: Position along Z axis where no fogging should be applied
|
|
|
|
* @z_far: Position along Z axis where full fogging should be applied
|
2008-04-25 13:37:36 +00:00
|
|
|
*
|
2009-06-07 10:54:05 +00:00
|
|
|
* Enables fogging. Fogging causes vertices that are further away from the eye
|
|
|
|
* to be rendered with a different color. The color is determined according to
|
|
|
|
* the chosen fog mode; at it's simplest the color is linearly interpolated so
|
|
|
|
* that vertices at @z_near are drawn fully with their original color and
|
|
|
|
* vertices at @z_far are drawn fully with @fog_color. Fogging will remain
|
|
|
|
* enabled until you call cogl_disable_fog().
|
|
|
|
*
|
2009-07-20 11:49:35 +00:00
|
|
|
* <note>The fogging functions only work correctly when primitives use
|
|
|
|
* unmultiplied alpha colors. By default Cogl will premultiply textures
|
|
|
|
* and cogl_set_source_color() will premultiply colors, so unless you
|
|
|
|
* explicitly load your textures requesting an unmultiplied internal format
|
|
|
|
* and use cogl_material_set_color() you can only use fogging with fully
|
|
|
|
* opaque primitives. This might improve in the future when we can depend
|
|
|
|
* on fragment shaders.</note>
|
2008-04-25 13:37:36 +00:00
|
|
|
*/
|
2009-02-04 09:21:37 +00:00
|
|
|
void cogl_set_fog (const CoglColor *fog_color,
|
2009-02-12 13:23:20 +00:00
|
|
|
CoglFogMode mode,
|
2009-02-04 09:21:37 +00:00
|
|
|
float density,
|
|
|
|
float z_near,
|
|
|
|
float z_far);
|
2008-04-25 13:37:36 +00:00
|
|
|
|
|
|
|
/**
|
2009-02-12 13:23:20 +00:00
|
|
|
* cogl_disable_fog:
|
|
|
|
*
|
|
|
|
* This function disables fogging, so primitives drawn afterwards will not be
|
|
|
|
* blended with any previously set fog color.
|
|
|
|
*/
|
|
|
|
void cogl_disable_fog (void);
|
|
|
|
|
2009-04-24 17:09:52 +00:00
|
|
|
/**
|
|
|
|
* CoglBufferBit:
|
|
|
|
* @COGL_BUFFER_BIT_COLOR: Selects the primary color buffer
|
|
|
|
* @COGL_BUFFER_BIT_DEPTH: Selects the depth buffer
|
|
|
|
* @COGL_BUFFER_BIT_STENCIL: Selects the stencil buffer
|
2009-05-28 16:18:13 +00:00
|
|
|
*
|
|
|
|
* Types of auxiliary buffers
|
|
|
|
*
|
|
|
|
* Since: 1.0
|
2009-04-24 17:09:52 +00:00
|
|
|
*/
|
2009-05-29 11:31:47 +00:00
|
|
|
typedef enum {
|
2009-04-24 17:09:52 +00:00
|
|
|
COGL_BUFFER_BIT_COLOR = 1L<<0,
|
|
|
|
COGL_BUFFER_BIT_DEPTH = 1L<<1,
|
|
|
|
COGL_BUFFER_BIT_STENCIL = 1L<<2
|
|
|
|
} CoglBufferBit;
|
|
|
|
|
2009-02-12 13:23:20 +00:00
|
|
|
/**
|
|
|
|
* cogl_clear:
|
2008-04-25 13:37:36 +00:00
|
|
|
* @color: Background color to clear to
|
2009-05-29 11:31:47 +00:00
|
|
|
* @buffers: A mask of #CoglBufferBit<!-- -->'s identifying which auxiliary
|
|
|
|
* buffers to clear
|
2008-04-25 13:37:36 +00:00
|
|
|
*
|
2009-04-24 17:09:52 +00:00
|
|
|
* Clears all the auxiliary buffers identified in the @buffers mask, and if
|
|
|
|
* that includes the color buffer then the specified @color is used.
|
2008-04-25 13:37:36 +00:00
|
|
|
*/
|
2009-05-29 11:31:47 +00:00
|
|
|
void cogl_clear (const CoglColor *color,
|
|
|
|
gulong buffers);
|
2008-04-25 13:37:36 +00:00
|
|
|
|
2009-02-06 11:16:42 +00:00
|
|
|
/**
|
|
|
|
* cogl_set_source:
|
2009-11-19 13:55:10 +00:00
|
|
|
* @material: A #CoglHandle for a material
|
2009-02-06 11:16:42 +00:00
|
|
|
*
|
|
|
|
* This function sets the source material that will be used to fill subsequent
|
|
|
|
* geometry emitted via the cogl API.
|
|
|
|
*
|
2009-11-19 13:55:10 +00:00
|
|
|
* <note>In the future we may add the ability to set a front facing material,
|
2009-02-06 11:16:42 +00:00
|
|
|
* and a back facing material, in which case this function will set both to the
|
2009-11-19 13:55:10 +00:00
|
|
|
* same.</note>
|
2009-02-06 11:16:42 +00:00
|
|
|
*
|
2009-11-19 11:51:21 +00:00
|
|
|
* Since: 1.0
|
2009-02-06 11:16:42 +00:00
|
|
|
*/
|
|
|
|
void cogl_set_source (CoglHandle material);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* cogl_set_source_color:
|
|
|
|
* @color: a #CoglColor
|
|
|
|
*
|
2009-05-09 18:39:01 +00:00
|
|
|
* This is a convenience function for creating a solid fill source material
|
|
|
|
* from the given color. This color will be used for any subsequent drawing
|
|
|
|
* operation.
|
|
|
|
*
|
|
|
|
* The color will be premultiplied by Cogl, so the color should be
|
|
|
|
* non-premultiplied. For example: use (1.0, 0.0, 0.0, 0.5) for
|
|
|
|
* semi-transparent red.
|
2009-02-06 11:16:42 +00:00
|
|
|
*
|
|
|
|
* See also cogl_set_source_color4ub() and cogl_set_source_color4f()
|
|
|
|
* if you already have the color components.
|
|
|
|
*
|
|
|
|
* Since: 1.0
|
|
|
|
*/
|
|
|
|
void cogl_set_source_color (const CoglColor *color);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* cogl_set_source_color4ub:
|
|
|
|
* @red: value of the red channel, between 0 and 255
|
|
|
|
* @green: value of the green channel, between 0 and 255
|
|
|
|
* @blue: value of the blue channel, between 0 and 255
|
|
|
|
* @alpha: value of the alpha channel, between 0 and 255
|
|
|
|
*
|
|
|
|
* This is a convenience function for creating a solid fill source material
|
|
|
|
* from the given color using unsigned bytes for each component. This
|
|
|
|
* color will be used for any subsequent drawing operation.
|
|
|
|
*
|
|
|
|
* The value for each component is an unsigned byte in the range
|
|
|
|
* between 0 and 255.
|
|
|
|
*
|
|
|
|
* Since: 1.0
|
|
|
|
*/
|
|
|
|
void cogl_set_source_color4ub (guint8 red,
|
|
|
|
guint8 green,
|
|
|
|
guint8 blue,
|
|
|
|
guint8 alpha);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* cogl_set_source_color4f:
|
|
|
|
* @red: value of the red channel, between 0 and %1.0
|
|
|
|
* @green: value of the green channel, between 0 and %1.0
|
|
|
|
* @blue: value of the blue channel, between 0 and %1.0
|
|
|
|
* @alpha: value of the alpha channel, between 0 and %1.0
|
|
|
|
*
|
|
|
|
* This is a convenience function for creating a solid fill source material
|
|
|
|
* from the given color using normalized values for each component. This color
|
|
|
|
* will be used for any subsequent drawing operation.
|
|
|
|
*
|
|
|
|
* The value for each component is a fixed point number in the range
|
|
|
|
* between 0 and %1.0. If the values passed in are outside that
|
|
|
|
* range, they will be clamped.
|
|
|
|
*
|
|
|
|
* Since: 1.0
|
|
|
|
*/
|
|
|
|
void cogl_set_source_color4f (float red,
|
|
|
|
float green,
|
|
|
|
float blue,
|
|
|
|
float alpha);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* cogl_set_source_texture:
|
|
|
|
* @texture_handle: The Cogl texture you want as your source
|
|
|
|
*
|
|
|
|
* This is a convenience function for creating a material with the first
|
|
|
|
* layer set to #texture_handle and setting that material as the source with
|
|
|
|
* cogl_set_source.
|
|
|
|
*
|
|
|
|
* Note: There is no interaction between calls to cogl_set_source_color
|
|
|
|
* and cogl_set_source_texture. If you need to blend a texture with a color then
|
|
|
|
* you can create a simple material like this:
|
|
|
|
* <programlisting>
|
|
|
|
* material = cogl_material_new ();
|
|
|
|
* cogl_material_set_color4ub (material, 0xff, 0x00, 0x00, 0x80);
|
|
|
|
* cogl_material_set_layer (material, 0, tex_handle);
|
|
|
|
* cogl_set_source (material);
|
|
|
|
* </programlisting>
|
|
|
|
*
|
2009-11-19 11:51:21 +00:00
|
|
|
* Since: 1.0
|
2009-02-06 11:16:42 +00:00
|
|
|
*/
|
|
|
|
void cogl_set_source_texture (CoglHandle texture_handle);
|
|
|
|
|
2009-02-12 13:23:20 +00:00
|
|
|
/**
|
|
|
|
* SECTION:cogl-clipping
|
|
|
|
* @short_description: Fuctions for manipulating a stack of clipping regions
|
|
|
|
*
|
|
|
|
* To support clipping your geometry to rectangles or paths Cogl exposes a
|
|
|
|
* stack based API whereby each clip region you push onto the stack is
|
|
|
|
* intersected with the previous region.
|
|
|
|
*/
|
|
|
|
|
[cogl-clip] deprecate parts and cleanup the API
cogl_clip_push() which accepts a rectangle in model space shouldn't have
been defined to take x,y,width,height arguments because this isn't consistant
with other Cogl API dealing with model space rectangles. If you are using a
coordinate system with the origin at the center and the y+ extending up,
then x,y,width,height isn't as natural as (x0,y0)(x1,y1). This API has
now been replace with cogl_clip_push_rectangle()
(As a general note: the Cogl API should only use the x,y,width,height style
when the appropriate coordinate space is defined by Cogl to have a top left
origin. E.g. window coordinates, or potentially texture coordinates)
cogl_clip_push_window_rect() shouldn't have been defined to take float
arguments since we only clip with integral pixel precision. We also
shouldn't have abbreviated "rectangle". This API has been replaced with
cogl_clip_push_window_rectangle()
cogl_clip_ensure() wasn't documented at all in Clutter 1.0 and probably
no one even knew it existed. This API isn't useful, and so it's now
deprecated. If no one complains we may remove the API altogether for
Clutter 1.2.
cogl_clip_stack_save() and cogl_clip_stack_restore() were originally added
to allow us to save/restore the clip when switching to/from offscreen
rendering. Now that offscreen draw buffers are defined to own their clip
state and the state will be automatically saved and restored this API is now
redundant and so deprecated.
2009-11-04 19:31:43 +00:00
|
|
|
#ifndef COGL_DISABLE_DEPRECATED
|
|
|
|
|
2009-05-08 15:32:01 +00:00
|
|
|
/**
|
|
|
|
* cogl_clip_push_window_rect:
|
|
|
|
* @x_offset: left edge of the clip rectangle in window coordinates
|
|
|
|
* @y_offset: top edge of the clip rectangle in window coordinates
|
|
|
|
* @width: width of the clip rectangle
|
|
|
|
* @height: height of the clip rectangle
|
|
|
|
*
|
|
|
|
* Specifies a rectangular clipping area for all subsequent drawing
|
|
|
|
* operations. Any drawing commands that extend outside the rectangle
|
|
|
|
* will be clipped so that only the portion inside the rectangle will
|
|
|
|
* be displayed. The rectangle dimensions are not transformed by the
|
|
|
|
* current model-view matrix.
|
|
|
|
*
|
|
|
|
* The rectangle is intersected with the current clip region. To undo
|
|
|
|
* the effect of this function, call cogl_clip_pop().
|
[cogl-clip] deprecate parts and cleanup the API
cogl_clip_push() which accepts a rectangle in model space shouldn't have
been defined to take x,y,width,height arguments because this isn't consistant
with other Cogl API dealing with model space rectangles. If you are using a
coordinate system with the origin at the center and the y+ extending up,
then x,y,width,height isn't as natural as (x0,y0)(x1,y1). This API has
now been replace with cogl_clip_push_rectangle()
(As a general note: the Cogl API should only use the x,y,width,height style
when the appropriate coordinate space is defined by Cogl to have a top left
origin. E.g. window coordinates, or potentially texture coordinates)
cogl_clip_push_window_rect() shouldn't have been defined to take float
arguments since we only clip with integral pixel precision. We also
shouldn't have abbreviated "rectangle". This API has been replaced with
cogl_clip_push_window_rectangle()
cogl_clip_ensure() wasn't documented at all in Clutter 1.0 and probably
no one even knew it existed. This API isn't useful, and so it's now
deprecated. If no one complains we may remove the API altogether for
Clutter 1.2.
cogl_clip_stack_save() and cogl_clip_stack_restore() were originally added
to allow us to save/restore the clip when switching to/from offscreen
rendering. Now that offscreen draw buffers are defined to own their clip
state and the state will be automatically saved and restored this API is now
redundant and so deprecated.
2009-11-04 19:31:43 +00:00
|
|
|
*
|
2009-11-18 18:04:13 +00:00
|
|
|
* Deprecated: 1.2: Use cogl_clip_push_window_rectangle() instead
|
2009-05-08 15:32:01 +00:00
|
|
|
*/
|
|
|
|
void cogl_clip_push_window_rect (float x_offset,
|
|
|
|
float y_offset,
|
|
|
|
float width,
|
[cogl-clip] deprecate parts and cleanup the API
cogl_clip_push() which accepts a rectangle in model space shouldn't have
been defined to take x,y,width,height arguments because this isn't consistant
with other Cogl API dealing with model space rectangles. If you are using a
coordinate system with the origin at the center and the y+ extending up,
then x,y,width,height isn't as natural as (x0,y0)(x1,y1). This API has
now been replace with cogl_clip_push_rectangle()
(As a general note: the Cogl API should only use the x,y,width,height style
when the appropriate coordinate space is defined by Cogl to have a top left
origin. E.g. window coordinates, or potentially texture coordinates)
cogl_clip_push_window_rect() shouldn't have been defined to take float
arguments since we only clip with integral pixel precision. We also
shouldn't have abbreviated "rectangle". This API has been replaced with
cogl_clip_push_window_rectangle()
cogl_clip_ensure() wasn't documented at all in Clutter 1.0 and probably
no one even knew it existed. This API isn't useful, and so it's now
deprecated. If no one complains we may remove the API altogether for
Clutter 1.2.
cogl_clip_stack_save() and cogl_clip_stack_restore() were originally added
to allow us to save/restore the clip when switching to/from offscreen
rendering. Now that offscreen draw buffers are defined to own their clip
state and the state will be automatically saved and restored this API is now
redundant and so deprecated.
2009-11-04 19:31:43 +00:00
|
|
|
float height) G_GNUC_DEPRECATED;
|
|
|
|
|
2009-11-18 18:04:13 +00:00
|
|
|
#endif /* COGL_DISABLE_DEPRECATED */
|
[cogl-clip] deprecate parts and cleanup the API
cogl_clip_push() which accepts a rectangle in model space shouldn't have
been defined to take x,y,width,height arguments because this isn't consistant
with other Cogl API dealing with model space rectangles. If you are using a
coordinate system with the origin at the center and the y+ extending up,
then x,y,width,height isn't as natural as (x0,y0)(x1,y1). This API has
now been replace with cogl_clip_push_rectangle()
(As a general note: the Cogl API should only use the x,y,width,height style
when the appropriate coordinate space is defined by Cogl to have a top left
origin. E.g. window coordinates, or potentially texture coordinates)
cogl_clip_push_window_rect() shouldn't have been defined to take float
arguments since we only clip with integral pixel precision. We also
shouldn't have abbreviated "rectangle". This API has been replaced with
cogl_clip_push_window_rectangle()
cogl_clip_ensure() wasn't documented at all in Clutter 1.0 and probably
no one even knew it existed. This API isn't useful, and so it's now
deprecated. If no one complains we may remove the API altogether for
Clutter 1.2.
cogl_clip_stack_save() and cogl_clip_stack_restore() were originally added
to allow us to save/restore the clip when switching to/from offscreen
rendering. Now that offscreen draw buffers are defined to own their clip
state and the state will be automatically saved and restored this API is now
redundant and so deprecated.
2009-11-04 19:31:43 +00:00
|
|
|
|
|
|
|
/**
|
|
|
|
* cogl_clip_push_window_rectangle:
|
|
|
|
* @x_offset: left edge of the clip rectangle in window coordinates
|
|
|
|
* @y_offset: top edge of the clip rectangle in window coordinates
|
|
|
|
* @width: width of the clip rectangle
|
|
|
|
* @height: height of the clip rectangle
|
|
|
|
*
|
|
|
|
* Specifies a rectangular clipping area for all subsequent drawing
|
|
|
|
* operations. Any drawing commands that extend outside the rectangle
|
|
|
|
* will be clipped so that only the portion inside the rectangle will
|
|
|
|
* be displayed. The rectangle dimensions are not transformed by the
|
|
|
|
* current model-view matrix.
|
|
|
|
*
|
|
|
|
* The rectangle is intersected with the current clip region. To undo
|
|
|
|
* the effect of this function, call cogl_clip_pop().
|
|
|
|
*
|
|
|
|
* Since: 1.2
|
|
|
|
*/
|
|
|
|
void cogl_clip_push_window_rectangle (int x_offset,
|
|
|
|
int y_offset,
|
|
|
|
int width,
|
|
|
|
int height);
|
|
|
|
|
|
|
|
#ifndef COGL_DISABLE_DEPRECATED
|
2009-05-08 15:32:01 +00:00
|
|
|
|
2009-02-12 13:23:20 +00:00
|
|
|
/**
|
|
|
|
* cogl_clip_push:
|
|
|
|
* @x_offset: left edge of the clip rectangle
|
|
|
|
* @y_offset: top edge of the clip rectangle
|
|
|
|
* @width: width of the clip rectangle
|
|
|
|
* @height: height of the clip rectangle
|
|
|
|
*
|
|
|
|
* Specifies a rectangular clipping area for all subsequent drawing
|
|
|
|
* operations. Any drawing commands that extend outside the rectangle
|
|
|
|
* will be clipped so that only the portion inside the rectangle will
|
|
|
|
* be displayed. The rectangle dimensions are transformed by the
|
|
|
|
* current model-view matrix.
|
|
|
|
*
|
|
|
|
* The rectangle is intersected with the current clip region. To undo
|
|
|
|
* the effect of this function, call cogl_clip_pop().
|
[cogl-clip] deprecate parts and cleanup the API
cogl_clip_push() which accepts a rectangle in model space shouldn't have
been defined to take x,y,width,height arguments because this isn't consistant
with other Cogl API dealing with model space rectangles. If you are using a
coordinate system with the origin at the center and the y+ extending up,
then x,y,width,height isn't as natural as (x0,y0)(x1,y1). This API has
now been replace with cogl_clip_push_rectangle()
(As a general note: the Cogl API should only use the x,y,width,height style
when the appropriate coordinate space is defined by Cogl to have a top left
origin. E.g. window coordinates, or potentially texture coordinates)
cogl_clip_push_window_rect() shouldn't have been defined to take float
arguments since we only clip with integral pixel precision. We also
shouldn't have abbreviated "rectangle". This API has been replaced with
cogl_clip_push_window_rectangle()
cogl_clip_ensure() wasn't documented at all in Clutter 1.0 and probably
no one even knew it existed. This API isn't useful, and so it's now
deprecated. If no one complains we may remove the API altogether for
Clutter 1.2.
cogl_clip_stack_save() and cogl_clip_stack_restore() were originally added
to allow us to save/restore the clip when switching to/from offscreen
rendering. Now that offscreen draw buffers are defined to own their clip
state and the state will be automatically saved and restored this API is now
redundant and so deprecated.
2009-11-04 19:31:43 +00:00
|
|
|
*
|
2009-11-18 18:04:13 +00:00
|
|
|
* Deprecated: 1.2: The x, y, width, height arguments are inconsistent
|
|
|
|
* with other API that specify rectangles in model space, and when used
|
|
|
|
* with a coordinate space that puts the origin at the center and y+
|
|
|
|
* extending up, it's awkward to use. Please use cogl_clip_push_rectangle()
|
|
|
|
* instead
|
2009-02-12 13:23:20 +00:00
|
|
|
*/
|
|
|
|
void cogl_clip_push (float x_offset,
|
|
|
|
float y_offset,
|
|
|
|
float width,
|
[cogl-clip] deprecate parts and cleanup the API
cogl_clip_push() which accepts a rectangle in model space shouldn't have
been defined to take x,y,width,height arguments because this isn't consistant
with other Cogl API dealing with model space rectangles. If you are using a
coordinate system with the origin at the center and the y+ extending up,
then x,y,width,height isn't as natural as (x0,y0)(x1,y1). This API has
now been replace with cogl_clip_push_rectangle()
(As a general note: the Cogl API should only use the x,y,width,height style
when the appropriate coordinate space is defined by Cogl to have a top left
origin. E.g. window coordinates, or potentially texture coordinates)
cogl_clip_push_window_rect() shouldn't have been defined to take float
arguments since we only clip with integral pixel precision. We also
shouldn't have abbreviated "rectangle". This API has been replaced with
cogl_clip_push_window_rectangle()
cogl_clip_ensure() wasn't documented at all in Clutter 1.0 and probably
no one even knew it existed. This API isn't useful, and so it's now
deprecated. If no one complains we may remove the API altogether for
Clutter 1.2.
cogl_clip_stack_save() and cogl_clip_stack_restore() were originally added
to allow us to save/restore the clip when switching to/from offscreen
rendering. Now that offscreen draw buffers are defined to own their clip
state and the state will be automatically saved and restored this API is now
redundant and so deprecated.
2009-11-04 19:31:43 +00:00
|
|
|
float height) G_GNUC_DEPRECATED;
|
|
|
|
|
2009-11-18 18:04:13 +00:00
|
|
|
#endif /* COGL_DISABLE_DEPRECATED */
|
[cogl-clip] deprecate parts and cleanup the API
cogl_clip_push() which accepts a rectangle in model space shouldn't have
been defined to take x,y,width,height arguments because this isn't consistant
with other Cogl API dealing with model space rectangles. If you are using a
coordinate system with the origin at the center and the y+ extending up,
then x,y,width,height isn't as natural as (x0,y0)(x1,y1). This API has
now been replace with cogl_clip_push_rectangle()
(As a general note: the Cogl API should only use the x,y,width,height style
when the appropriate coordinate space is defined by Cogl to have a top left
origin. E.g. window coordinates, or potentially texture coordinates)
cogl_clip_push_window_rect() shouldn't have been defined to take float
arguments since we only clip with integral pixel precision. We also
shouldn't have abbreviated "rectangle". This API has been replaced with
cogl_clip_push_window_rectangle()
cogl_clip_ensure() wasn't documented at all in Clutter 1.0 and probably
no one even knew it existed. This API isn't useful, and so it's now
deprecated. If no one complains we may remove the API altogether for
Clutter 1.2.
cogl_clip_stack_save() and cogl_clip_stack_restore() were originally added
to allow us to save/restore the clip when switching to/from offscreen
rendering. Now that offscreen draw buffers are defined to own their clip
state and the state will be automatically saved and restored this API is now
redundant and so deprecated.
2009-11-04 19:31:43 +00:00
|
|
|
|
|
|
|
/**
|
|
|
|
* cogl_clip_push_rectangle:
|
|
|
|
* @x0: x coordinate for top left corner of the clip rectangle
|
|
|
|
* @y0: y coordinate for top left corner of the clip rectangle
|
|
|
|
* @x1: x coordinate for bottom right corner of the clip rectangle
|
|
|
|
* @y1: y coordinate for bottom right corner of the clip rectangle
|
|
|
|
*
|
|
|
|
* Specifies a rectangular clipping area for all subsequent drawing
|
|
|
|
* operations. Any drawing commands that extend outside the rectangle
|
|
|
|
* will be clipped so that only the portion inside the rectangle will
|
|
|
|
* be displayed. The rectangle dimensions are transformed by the
|
|
|
|
* current model-view matrix.
|
|
|
|
*
|
|
|
|
* The rectangle is intersected with the current clip region. To undo
|
|
|
|
* the effect of this function, call cogl_clip_pop().
|
|
|
|
*
|
|
|
|
* Since: 1.2
|
|
|
|
*/
|
|
|
|
void cogl_clip_push_rectangle (float x0,
|
|
|
|
float y0,
|
|
|
|
float x1,
|
|
|
|
float y1);
|
2009-02-12 13:23:20 +00:00
|
|
|
|
|
|
|
/**
|
|
|
|
* cogl_clip_push_from_path:
|
|
|
|
*
|
|
|
|
* Sets a new clipping area using the current path. The current path
|
|
|
|
* is then cleared. The clipping area is intersected with the previous
|
|
|
|
* clipping area. To restore the previous clipping area, call
|
|
|
|
* cogl_clip_pop().
|
|
|
|
*
|
|
|
|
* Since: 1.0
|
|
|
|
*/
|
|
|
|
void cogl_clip_push_from_path (void);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* cogl_clip_push_from_path_preserve:
|
|
|
|
*
|
|
|
|
* Sets a new clipping area using the current path. The current path
|
|
|
|
* is then cleared. The clipping area is intersected with the previous
|
|
|
|
* clipping area. To restore the previous clipping area, call
|
|
|
|
* cogl_clip_pop().
|
|
|
|
*
|
|
|
|
* Since: 1.0
|
|
|
|
*/
|
|
|
|
void cogl_clip_push_from_path_preserve (void);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* cogl_clip_pop:
|
|
|
|
*
|
|
|
|
* Reverts the clipping region to the state before the last call to
|
|
|
|
* cogl_clip_push().
|
|
|
|
*/
|
|
|
|
void cogl_clip_pop (void);
|
|
|
|
|
[cogl-clip] deprecate parts and cleanup the API
cogl_clip_push() which accepts a rectangle in model space shouldn't have
been defined to take x,y,width,height arguments because this isn't consistant
with other Cogl API dealing with model space rectangles. If you are using a
coordinate system with the origin at the center and the y+ extending up,
then x,y,width,height isn't as natural as (x0,y0)(x1,y1). This API has
now been replace with cogl_clip_push_rectangle()
(As a general note: the Cogl API should only use the x,y,width,height style
when the appropriate coordinate space is defined by Cogl to have a top left
origin. E.g. window coordinates, or potentially texture coordinates)
cogl_clip_push_window_rect() shouldn't have been defined to take float
arguments since we only clip with integral pixel precision. We also
shouldn't have abbreviated "rectangle". This API has been replaced with
cogl_clip_push_window_rectangle()
cogl_clip_ensure() wasn't documented at all in Clutter 1.0 and probably
no one even knew it existed. This API isn't useful, and so it's now
deprecated. If no one complains we may remove the API altogether for
Clutter 1.2.
cogl_clip_stack_save() and cogl_clip_stack_restore() were originally added
to allow us to save/restore the clip when switching to/from offscreen
rendering. Now that offscreen draw buffers are defined to own their clip
state and the state will be automatically saved and restored this API is now
redundant and so deprecated.
2009-11-04 19:31:43 +00:00
|
|
|
#ifndef COGL_DISABLE_DEPRECATED
|
|
|
|
|
2009-02-12 13:23:20 +00:00
|
|
|
/**
|
|
|
|
* cogl_clip_ensure:
|
|
|
|
*
|
|
|
|
* Ensures that the current clipping region has been set in GL. This
|
|
|
|
* will automatically be called before any Cogl primitives but it
|
|
|
|
* maybe be neccessary to call if you are using raw GL calls with
|
|
|
|
* clipping.
|
|
|
|
*
|
2009-11-18 18:04:13 +00:00
|
|
|
* Deprecated: 1.2: Calling this function has no effect
|
[cogl-clip] deprecate parts and cleanup the API
cogl_clip_push() which accepts a rectangle in model space shouldn't have
been defined to take x,y,width,height arguments because this isn't consistant
with other Cogl API dealing with model space rectangles. If you are using a
coordinate system with the origin at the center and the y+ extending up,
then x,y,width,height isn't as natural as (x0,y0)(x1,y1). This API has
now been replace with cogl_clip_push_rectangle()
(As a general note: the Cogl API should only use the x,y,width,height style
when the appropriate coordinate space is defined by Cogl to have a top left
origin. E.g. window coordinates, or potentially texture coordinates)
cogl_clip_push_window_rect() shouldn't have been defined to take float
arguments since we only clip with integral pixel precision. We also
shouldn't have abbreviated "rectangle". This API has been replaced with
cogl_clip_push_window_rectangle()
cogl_clip_ensure() wasn't documented at all in Clutter 1.0 and probably
no one even knew it existed. This API isn't useful, and so it's now
deprecated. If no one complains we may remove the API altogether for
Clutter 1.2.
cogl_clip_stack_save() and cogl_clip_stack_restore() were originally added
to allow us to save/restore the clip when switching to/from offscreen
rendering. Now that offscreen draw buffers are defined to own their clip
state and the state will be automatically saved and restored this API is now
redundant and so deprecated.
2009-11-04 19:31:43 +00:00
|
|
|
*
|
2009-02-12 13:23:20 +00:00
|
|
|
* Since: 1.0
|
|
|
|
*/
|
[cogl-clip] deprecate parts and cleanup the API
cogl_clip_push() which accepts a rectangle in model space shouldn't have
been defined to take x,y,width,height arguments because this isn't consistant
with other Cogl API dealing with model space rectangles. If you are using a
coordinate system with the origin at the center and the y+ extending up,
then x,y,width,height isn't as natural as (x0,y0)(x1,y1). This API has
now been replace with cogl_clip_push_rectangle()
(As a general note: the Cogl API should only use the x,y,width,height style
when the appropriate coordinate space is defined by Cogl to have a top left
origin. E.g. window coordinates, or potentially texture coordinates)
cogl_clip_push_window_rect() shouldn't have been defined to take float
arguments since we only clip with integral pixel precision. We also
shouldn't have abbreviated "rectangle". This API has been replaced with
cogl_clip_push_window_rectangle()
cogl_clip_ensure() wasn't documented at all in Clutter 1.0 and probably
no one even knew it existed. This API isn't useful, and so it's now
deprecated. If no one complains we may remove the API altogether for
Clutter 1.2.
cogl_clip_stack_save() and cogl_clip_stack_restore() were originally added
to allow us to save/restore the clip when switching to/from offscreen
rendering. Now that offscreen draw buffers are defined to own their clip
state and the state will be automatically saved and restored this API is now
redundant and so deprecated.
2009-11-04 19:31:43 +00:00
|
|
|
void cogl_clip_ensure (void) G_GNUC_DEPRECATED;
|
2009-02-12 13:23:20 +00:00
|
|
|
|
|
|
|
/**
|
|
|
|
* cogl_clip_stack_save:
|
|
|
|
*
|
|
|
|
* Save the entire state of the clipping stack and then clear all
|
|
|
|
* clipping. The previous state can be returned to with
|
|
|
|
* cogl_clip_stack_restore(). Each call to cogl_clip_push() after this
|
|
|
|
* must be matched by a call to cogl_clip_pop() before calling
|
|
|
|
* cogl_clip_stack_restore().
|
|
|
|
*
|
2009-11-18 18:04:13 +00:00
|
|
|
* Deprecated: 1.2: This was originally added to allow us to save the
|
2009-11-26 19:06:35 +00:00
|
|
|
* clip stack when switching to an offscreen framebuffer, but it's
|
|
|
|
* not necessary anymore given that framebuffers now own separate
|
2009-11-18 18:04:13 +00:00
|
|
|
* clip stacks which will be automatically switched between when a
|
|
|
|
* new buffer is set. Calling this function has no effect
|
[cogl-clip] deprecate parts and cleanup the API
cogl_clip_push() which accepts a rectangle in model space shouldn't have
been defined to take x,y,width,height arguments because this isn't consistant
with other Cogl API dealing with model space rectangles. If you are using a
coordinate system with the origin at the center and the y+ extending up,
then x,y,width,height isn't as natural as (x0,y0)(x1,y1). This API has
now been replace with cogl_clip_push_rectangle()
(As a general note: the Cogl API should only use the x,y,width,height style
when the appropriate coordinate space is defined by Cogl to have a top left
origin. E.g. window coordinates, or potentially texture coordinates)
cogl_clip_push_window_rect() shouldn't have been defined to take float
arguments since we only clip with integral pixel precision. We also
shouldn't have abbreviated "rectangle". This API has been replaced with
cogl_clip_push_window_rectangle()
cogl_clip_ensure() wasn't documented at all in Clutter 1.0 and probably
no one even knew it existed. This API isn't useful, and so it's now
deprecated. If no one complains we may remove the API altogether for
Clutter 1.2.
cogl_clip_stack_save() and cogl_clip_stack_restore() were originally added
to allow us to save/restore the clip when switching to/from offscreen
rendering. Now that offscreen draw buffers are defined to own their clip
state and the state will be automatically saved and restored this API is now
redundant and so deprecated.
2009-11-04 19:31:43 +00:00
|
|
|
*
|
2009-02-12 13:23:20 +00:00
|
|
|
* Since: 0.8.2
|
|
|
|
*/
|
[cogl-clip] deprecate parts and cleanup the API
cogl_clip_push() which accepts a rectangle in model space shouldn't have
been defined to take x,y,width,height arguments because this isn't consistant
with other Cogl API dealing with model space rectangles. If you are using a
coordinate system with the origin at the center and the y+ extending up,
then x,y,width,height isn't as natural as (x0,y0)(x1,y1). This API has
now been replace with cogl_clip_push_rectangle()
(As a general note: the Cogl API should only use the x,y,width,height style
when the appropriate coordinate space is defined by Cogl to have a top left
origin. E.g. window coordinates, or potentially texture coordinates)
cogl_clip_push_window_rect() shouldn't have been defined to take float
arguments since we only clip with integral pixel precision. We also
shouldn't have abbreviated "rectangle". This API has been replaced with
cogl_clip_push_window_rectangle()
cogl_clip_ensure() wasn't documented at all in Clutter 1.0 and probably
no one even knew it existed. This API isn't useful, and so it's now
deprecated. If no one complains we may remove the API altogether for
Clutter 1.2.
cogl_clip_stack_save() and cogl_clip_stack_restore() were originally added
to allow us to save/restore the clip when switching to/from offscreen
rendering. Now that offscreen draw buffers are defined to own their clip
state and the state will be automatically saved and restored this API is now
redundant and so deprecated.
2009-11-04 19:31:43 +00:00
|
|
|
void cogl_clip_stack_save (void) G_GNUC_DEPRECATED;
|
2009-02-12 13:23:20 +00:00
|
|
|
|
|
|
|
/**
|
|
|
|
* cogl_clip_stack_restore:
|
|
|
|
*
|
|
|
|
* Restore the state of the clipping stack that was previously saved
|
|
|
|
* by cogl_clip_stack_save().
|
|
|
|
*
|
2009-11-18 18:04:13 +00:00
|
|
|
* Deprecated: 1.2: This was originally added to allow us to restore
|
2009-11-26 19:06:35 +00:00
|
|
|
* the clip stack when switching back from an offscreen framebuffer,
|
|
|
|
* but it's not necessary anymore given that framebuffers now own
|
2009-11-18 18:04:13 +00:00
|
|
|
* separate clip stacks which will be automatically switched between
|
|
|
|
* when a new buffer is set. Calling this function has no effect
|
[cogl-clip] deprecate parts and cleanup the API
cogl_clip_push() which accepts a rectangle in model space shouldn't have
been defined to take x,y,width,height arguments because this isn't consistant
with other Cogl API dealing with model space rectangles. If you are using a
coordinate system with the origin at the center and the y+ extending up,
then x,y,width,height isn't as natural as (x0,y0)(x1,y1). This API has
now been replace with cogl_clip_push_rectangle()
(As a general note: the Cogl API should only use the x,y,width,height style
when the appropriate coordinate space is defined by Cogl to have a top left
origin. E.g. window coordinates, or potentially texture coordinates)
cogl_clip_push_window_rect() shouldn't have been defined to take float
arguments since we only clip with integral pixel precision. We also
shouldn't have abbreviated "rectangle". This API has been replaced with
cogl_clip_push_window_rectangle()
cogl_clip_ensure() wasn't documented at all in Clutter 1.0 and probably
no one even knew it existed. This API isn't useful, and so it's now
deprecated. If no one complains we may remove the API altogether for
Clutter 1.2.
cogl_clip_stack_save() and cogl_clip_stack_restore() were originally added
to allow us to save/restore the clip when switching to/from offscreen
rendering. Now that offscreen draw buffers are defined to own their clip
state and the state will be automatically saved and restored this API is now
redundant and so deprecated.
2009-11-04 19:31:43 +00:00
|
|
|
*
|
2009-02-12 13:23:20 +00:00
|
|
|
* Since: 0.8.2
|
|
|
|
*/
|
[cogl-clip] deprecate parts and cleanup the API
cogl_clip_push() which accepts a rectangle in model space shouldn't have
been defined to take x,y,width,height arguments because this isn't consistant
with other Cogl API dealing with model space rectangles. If you are using a
coordinate system with the origin at the center and the y+ extending up,
then x,y,width,height isn't as natural as (x0,y0)(x1,y1). This API has
now been replace with cogl_clip_push_rectangle()
(As a general note: the Cogl API should only use the x,y,width,height style
when the appropriate coordinate space is defined by Cogl to have a top left
origin. E.g. window coordinates, or potentially texture coordinates)
cogl_clip_push_window_rect() shouldn't have been defined to take float
arguments since we only clip with integral pixel precision. We also
shouldn't have abbreviated "rectangle". This API has been replaced with
cogl_clip_push_window_rectangle()
cogl_clip_ensure() wasn't documented at all in Clutter 1.0 and probably
no one even knew it existed. This API isn't useful, and so it's now
deprecated. If no one complains we may remove the API altogether for
Clutter 1.2.
cogl_clip_stack_save() and cogl_clip_stack_restore() were originally added
to allow us to save/restore the clip when switching to/from offscreen
rendering. Now that offscreen draw buffers are defined to own their clip
state and the state will be automatically saved and restored this API is now
redundant and so deprecated.
2009-11-04 19:31:43 +00:00
|
|
|
void cogl_clip_stack_restore (void) G_GNUC_DEPRECATED;
|
|
|
|
|
2009-11-18 18:04:13 +00:00
|
|
|
#endif /* COGL_DISABLE_DEPRECATED */
|
2009-02-12 13:23:20 +00:00
|
|
|
|
2009-11-26 19:06:35 +00:00
|
|
|
/**
|
|
|
|
* cogl_set_framebuffer:
|
|
|
|
* @buffer: The #CoglHandle of a Cogl framebuffer; either onscreen or
|
|
|
|
* offscreen.
|
|
|
|
*
|
|
|
|
* This redirects all subsequent drawing to the specified framebuffer. This
|
|
|
|
* can either be an offscreen buffer created with
|
|
|
|
* cogl_offscreen_new_to_texture () or you can revert to your original
|
|
|
|
* onscreen window buffer.
|
|
|
|
*
|
|
|
|
* Since: 1.2
|
|
|
|
*/
|
|
|
|
void cogl_set_framebuffer (CoglHandle buffer);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* cogl_push_framebuffer:
|
|
|
|
* @buffer: The #CoglHandle of a Cogl framebuffer; either onscreen or
|
|
|
|
* offscreen.
|
|
|
|
*
|
|
|
|
* Redirects all subsequent drawing to the specified framebuffer. This
|
|
|
|
* can either be an offscreen buffer created with
|
|
|
|
* cogl_offscreen_new_to_texture () or you can revert to your original
|
|
|
|
* onscreen window buffer.
|
|
|
|
*
|
|
|
|
* The previous framebuffer can be restored by calling cogl_pop_framebuffer()
|
|
|
|
*
|
|
|
|
* Since: 1.2
|
|
|
|
*/
|
|
|
|
void cogl_push_framebuffer (CoglHandle buffer);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* cogl_pop_framebuffer:
|
|
|
|
*
|
|
|
|
* Restores the framebuffer that was previously at the top of the stack.
|
|
|
|
* All subsequent drawing will be redirected to this framebuffer.
|
|
|
|
*
|
|
|
|
* Since: 1.2
|
|
|
|
*/
|
|
|
|
void cogl_pop_framebuffer (void);
|
|
|
|
|
|
|
|
#ifndef COGL_DISABLE_DEPRECATED
|
|
|
|
|
2009-04-30 21:19:43 +00:00
|
|
|
/**
|
|
|
|
* cogl_set_draw_buffer:
|
2009-11-26 19:06:35 +00:00
|
|
|
* @target: A #CoglBufferTarget that specifies what kind of framebuffer you
|
2009-04-30 21:19:43 +00:00
|
|
|
* are setting as the render target.
|
2009-11-26 19:06:35 +00:00
|
|
|
* @offscreen: If you are setting a framebuffer of type COGL_OFFSCREEN_BUFFER
|
2009-04-30 21:19:43 +00:00
|
|
|
* then this is a CoglHandle for the offscreen buffer.
|
|
|
|
*
|
2009-11-26 19:06:35 +00:00
|
|
|
* Redirects all subsequent drawing to the specified framebuffer. This
|
2009-04-30 21:19:43 +00:00
|
|
|
* can either be an offscreen buffer created with
|
|
|
|
* cogl_offscreen_new_to_texture () or you can revert to your original
|
|
|
|
* on screen window buffer.
|
2009-11-26 19:06:35 +00:00
|
|
|
*
|
|
|
|
* Deprecated: 1.2: The target argument was redundant since we could look at
|
|
|
|
* the type of CoglHandle given instead.
|
2009-04-30 21:19:43 +00:00
|
|
|
*/
|
|
|
|
void cogl_set_draw_buffer (CoglBufferTarget target,
|
2009-11-26 19:06:35 +00:00
|
|
|
CoglHandle offscreen) G_GNUC_DEPRECATED;
|
2009-04-30 21:19:43 +00:00
|
|
|
|
|
|
|
/**
|
|
|
|
* cogl_push_draw_buffer:
|
|
|
|
*
|
|
|
|
* Save cogl_set_draw_buffer() state.
|
2009-11-26 19:06:35 +00:00
|
|
|
*
|
|
|
|
* Deprecated: 1.2: The draw buffer API was replaced with a framebuffer API
|
2009-04-30 21:19:43 +00:00
|
|
|
*/
|
2009-11-26 19:06:35 +00:00
|
|
|
void cogl_push_draw_buffer (void) G_GNUC_DEPRECATED;
|
2009-04-30 21:19:43 +00:00
|
|
|
|
|
|
|
/**
|
|
|
|
* cogl_pop_draw_buffer:
|
|
|
|
*
|
|
|
|
* Restore cogl_set_draw_buffer() state.
|
2009-11-26 19:06:35 +00:00
|
|
|
*
|
|
|
|
* Deprecated: 1.2: The draw buffer API was replaced with a framebuffer API
|
2009-04-30 21:19:43 +00:00
|
|
|
*/
|
2009-11-26 19:06:35 +00:00
|
|
|
void cogl_pop_draw_buffer (void) G_GNUC_DEPRECATED;
|
|
|
|
|
|
|
|
#endif /* COGL_DISABLE_DEPRECATED */
|
2009-04-30 21:19:43 +00:00
|
|
|
|
2009-06-17 13:30:44 +00:00
|
|
|
/**
|
|
|
|
* CoglReadPixelsFlags:
|
|
|
|
* @COGL_READ_PIXELS_COLOR_BUFFER: Read from the color buffer
|
2009-07-20 11:49:35 +00:00
|
|
|
*
|
|
|
|
* Flags for cogl_read_pixels()
|
|
|
|
*
|
|
|
|
* Since: 1.0
|
2009-06-17 13:30:44 +00:00
|
|
|
*/
|
2009-07-20 11:49:35 +00:00
|
|
|
typedef enum { /*< prefix=COGL_READ_PIXELS >*/
|
|
|
|
COGL_READ_PIXELS_COLOR_BUFFER = 1L << 0
|
2009-06-17 13:30:44 +00:00
|
|
|
} CoglReadPixelsFlags;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* cogl_read_pixels:
|
|
|
|
* @x: The window x position to start reading from
|
|
|
|
* @y: The window y position to start reading from
|
|
|
|
* @width: The width of the rectangle you want to read
|
|
|
|
* @height: The height of the rectangle you want to read
|
|
|
|
* @source: Identifies which auxillary buffer you want to read
|
|
|
|
* (only COGL_READ_PIXELS_COLOR_BUFFER supported currently)
|
|
|
|
* @format: The pixel format you want the result in
|
|
|
|
* (only COGL_PIXEL_FORMAT_RGBA_8888 supported currently)
|
|
|
|
* @pixels: The location to write the pixel data.
|
|
|
|
*
|
2009-11-26 19:06:35 +00:00
|
|
|
* This reads a rectangle of pixels from the current framebuffer where
|
2009-06-17 13:30:44 +00:00
|
|
|
* position (0, 0) is the top left. The pixel at (x, y) is the first
|
|
|
|
* read, and the data is returned with a rowstride of (width * 4)
|
|
|
|
*/
|
|
|
|
void cogl_read_pixels (int x,
|
|
|
|
int y,
|
|
|
|
int width,
|
|
|
|
int height,
|
|
|
|
CoglReadPixelsFlags source,
|
|
|
|
CoglPixelFormat format,
|
|
|
|
guint8 *pixels);
|
|
|
|
|
2009-06-29 16:10:34 +00:00
|
|
|
/**
|
|
|
|
* cogl_flush:
|
|
|
|
*
|
|
|
|
* This function should only need to be called in exceptional circumstances.
|
|
|
|
*
|
|
|
|
* As an optimization Cogl drawing functions may batch up primitives
|
|
|
|
* internally, so if you are trying to use raw GL outside of Cogl you stand a
|
|
|
|
* better chance of being successful if you ask Cogl to flush any batched
|
|
|
|
* geometry before making your state changes.
|
|
|
|
*
|
|
|
|
* It only ensure that the underlying driver is issued all the commands
|
|
|
|
* necessary to draw the batched primitives. It provides no guarantees about
|
|
|
|
* when the driver will complete the rendering.
|
|
|
|
*
|
|
|
|
* This provides no guarantees about the GL state upon returning and to avoid
|
|
|
|
* confusing Cogl you should aim to restore any changes you make before
|
|
|
|
* resuming use of Cogl.
|
|
|
|
*
|
|
|
|
* If you are making state changes with the intention of affecting Cogl drawing
|
|
|
|
* primitives you are 100% on your own since you stand a good chance of
|
|
|
|
* conflicting with Cogl internals. For example clutter-gst which currently
|
|
|
|
* uses direct GL calls to bind ARBfp programs will very likely break when Cogl
|
|
|
|
* starts to use ARBfb programs itself for the material API.
|
|
|
|
*
|
|
|
|
* Since: 1.0
|
|
|
|
*/
|
|
|
|
void cogl_flush (void);
|
|
|
|
|
2009-06-29 21:32:05 +00:00
|
|
|
/**
|
|
|
|
* cogl_begin_gl:
|
|
|
|
*
|
|
|
|
* We do not advise nor reliably support the interleaving of raw GL drawing and
|
|
|
|
* Cogl drawing functions, but if you insist, cogl_begin_gl() and cogl_end_gl()
|
|
|
|
* provide a simple mechanism that may at least give you a fighting chance of
|
|
|
|
* succeeding.
|
|
|
|
*
|
|
|
|
* Note: this doesn't help you modify the behaviour of Cogl drawing functions
|
|
|
|
* through the modification of GL state; that will never be reliably supported,
|
|
|
|
* but if you are trying to do something like:
|
2009-11-19 13:55:10 +00:00
|
|
|
*
|
|
|
|
* |[
|
2009-06-29 21:32:05 +00:00
|
|
|
* {
|
|
|
|
* - setup some OpenGL state.
|
|
|
|
* - draw using OpenGL (e.g. glDrawArrays() )
|
|
|
|
* - reset modified OpenGL state.
|
|
|
|
* - continue using Cogl to draw
|
|
|
|
* }
|
2009-11-19 13:55:10 +00:00
|
|
|
* ]|
|
|
|
|
*
|
2009-06-29 21:32:05 +00:00
|
|
|
* You should surround blocks of drawing using raw GL with cogl_begin_gl()
|
|
|
|
* and cogl_end_gl():
|
2009-11-19 13:55:10 +00:00
|
|
|
*
|
|
|
|
* |[
|
2009-06-29 21:32:05 +00:00
|
|
|
* {
|
|
|
|
* cogl_begin_gl ();
|
|
|
|
* - setup some OpenGL state.
|
|
|
|
* - draw using OpenGL (e.g. glDrawArrays() )
|
|
|
|
* - reset modified OpenGL state.
|
|
|
|
* cogl_end_gl ();
|
|
|
|
* - continue using Cogl to draw
|
|
|
|
* }
|
2009-11-19 13:55:10 +00:00
|
|
|
* ]|
|
2009-06-29 21:32:05 +00:00
|
|
|
*
|
|
|
|
* Don't ever try and do:
|
2009-11-19 13:55:10 +00:00
|
|
|
*
|
|
|
|
* |[
|
2009-06-29 21:32:05 +00:00
|
|
|
* {
|
|
|
|
* - setup some OpenGL state.
|
|
|
|
* - use Cogl to draw
|
|
|
|
* - reset modified OpenGL state.
|
|
|
|
* }
|
2009-11-19 13:55:10 +00:00
|
|
|
* ]|
|
|
|
|
*
|
2009-06-29 21:32:05 +00:00
|
|
|
* When the internals of Cogl evolves, this is very liable to break.
|
|
|
|
*
|
|
|
|
* This function will flush all batched primitives, and subsequently flush
|
|
|
|
* all internal Cogl state to OpenGL as if it were going to draw something
|
|
|
|
* itself.
|
|
|
|
*
|
|
|
|
* The result is that the OpenGL modelview matrix will be setup; the state
|
|
|
|
* corresponding to the current source material will be set up and other world
|
|
|
|
* state such as backface culling, depth and fogging enabledness will be sent
|
|
|
|
* to OpenGL.
|
|
|
|
*
|
2009-11-19 13:55:10 +00:00
|
|
|
* <note>No special material state is flushed, so if you want Cogl to setup a
|
2009-06-29 21:32:05 +00:00
|
|
|
* simplified material state it is your responsibility to set a simple source
|
2009-11-19 13:55:10 +00:00
|
|
|
* material before calling cogl_begin_gl(). E.g. by calling
|
|
|
|
* cogl_set_source_color4ub().</note>
|
2009-06-29 21:32:05 +00:00
|
|
|
*
|
2009-11-19 13:55:10 +00:00
|
|
|
* <note>It is your responsibility to restore any OpenGL state that you modify
|
2009-06-29 21:32:05 +00:00
|
|
|
* to how it was after calling cogl_begin_gl() if you don't do this then the
|
2009-11-19 13:55:10 +00:00
|
|
|
* result of further Cogl calls is undefined.</note>
|
2009-06-29 21:32:05 +00:00
|
|
|
*
|
2009-11-19 13:55:10 +00:00
|
|
|
* <note>You can not nest begin/end blocks.</note>
|
2009-06-29 21:32:05 +00:00
|
|
|
*
|
|
|
|
* Again we would like to stress, we do not advise the use of this API and if
|
|
|
|
* possible we would prefer to improve Cogl than have developers require raw
|
|
|
|
* OpenGL.
|
|
|
|
*
|
|
|
|
* Since: 1.0
|
|
|
|
*/
|
|
|
|
void cogl_begin_gl (void);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* cogl_end_gl:
|
|
|
|
*
|
|
|
|
* This is the counterpart to cogl_begin_gl() used to delimit blocks of drawing
|
|
|
|
* code using raw OpenGL. Please refer to cogl_begin_gl() for full details.
|
|
|
|
*
|
|
|
|
* Since: 1.0
|
|
|
|
*/
|
|
|
|
void cogl_end_gl (void);
|
2009-05-26 14:41:53 +00:00
|
|
|
|
|
|
|
/*
|
|
|
|
* Internal API available only to Clutter.
|
|
|
|
*
|
|
|
|
* These are typically only to deal with the poor seperation of
|
|
|
|
* responsabilities that currently exists between Clutter and Cogl.
|
|
|
|
* Eventually a lot of the backend code currently in Clutter will
|
|
|
|
* move down into Cogl and these functions will be removed.
|
|
|
|
*/
|
|
|
|
|
|
|
|
void _cogl_destroy_context (void);
|
|
|
|
|
2009-11-19 13:55:10 +00:00
|
|
|
/*< private >*/
|
2009-11-11 13:26:54 +00:00
|
|
|
#define COGL_DRIVER_ERROR (_cogl_driver_error_quark ())
|
|
|
|
|
|
|
|
typedef enum { /*< prefix=COGL_DRIVER_ERROR >*/
|
|
|
|
COGL_DRIVER_ERROR_UNKNOWN_VERSION,
|
|
|
|
COGL_DRIVER_ERROR_INVALID_VERSION
|
|
|
|
} CoglDriverError;
|
|
|
|
|
2009-02-24 18:51:25 +00:00
|
|
|
void _cogl_set_indirect_context (gboolean indirect);
|
2009-09-25 13:34:34 +00:00
|
|
|
void _cogl_set_viewport (int x, int y, int width, int height);
|
2009-11-11 13:26:54 +00:00
|
|
|
gboolean _cogl_check_driver_valid (GError **error);
|
|
|
|
GQuark _cogl_driver_error_quark (void);
|
2009-02-24 18:51:25 +00:00
|
|
|
|
2009-10-21 22:24:49 +00:00
|
|
|
void
|
|
|
|
_cogl_onscreen_clutter_backend_set_size (int width, int height);
|
|
|
|
|
2008-04-25 13:37:36 +00:00
|
|
|
G_END_DECLS
|
|
|
|
|
2008-10-30 17:04:34 +00:00
|
|
|
#undef __COGL_H_INSIDE__
|
|
|
|
|
2008-04-25 13:37:36 +00:00
|
|
|
#endif /* __COGL_H__ */
|