isa/mutter
1
0
Fork 0
mirror of https://github.com/brl/mutter.git synced 2024-12-25 20:32:16 +00:00
Code Issues Packages Projects Releases Wiki Activity

Add compiler deprecation warnings

Browse Source 
This adds compiler symbol deprecation declarations for old Cogl APIs so
that users can easily see via compiler warning when they are using these
symbols, and also see a hint for what the apis should be replaced with.

So that users of Cogl can manage when to show these warnings this
introduces a scheme borrowed from glib whereby you can declare what
version of the Cogl api you are using:

COGL_VERSION_MIN_REQUIRED can be defined to indicate the oldest Cogl api
that the application wants to use. Cogl will only warn about
deprecations for symbols that were deprecated earlier than this required
version. If this is left undefined then by default Cogl will warn about
all deprecations.

COGL_VERSION_MAX_ALLOWED can be defined to indicate the newest api
that the application uses. If the application uses symbols newer than
this then Cogl will give a warning about that.

This patch removes the need to maintain the COGL_DISABLE_DEPRECATED
guards around deprecated symbols.

This patch fixes a few uses of deprecated symbols in the examples/

Reviewed-by: Neil Roberts <neil@linux.intel.com>
This commit is contained in:
Robert Bragg 2013-03-22 21:18:53 +00:00
parent b5e57c914b
commit afbb13e1a4
26 changed files with 1021 additions and 278 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

48
cogl-pango/cogl-pango.h
View File

@ -53,7 +53,7 @@ typedef PangoCairoFontMap CoglPangoFontMap;
*
* Return value: (transfer full): the newly created #PangoFontMap
*
* Since: 2.0
* Since: 1.14
*/
PangoFontMap *
cogl_pango_font_map_new (void);
@ -80,7 +80,7 @@ cogl_pango_font_map_create_context (CoglPangoFontMap *font_map);
* The default value is %96, meaning that a 10 point font will be 13
* units high. (10 * 96. / 72. = 13.3).
*
* Since: 2.0
* Since: 1.14
*/
void
cogl_pango_font_map_set_resolution (CoglPangoFontMap *font_map,
@ -165,7 +165,7 @@ cogl_pango_font_map_get_renderer (CoglPangoFontMap *font_map);
* @y) within the @framebuffer<!-- -->'s current model-view coordinate
* space.
*
* Since: 2.0
* Since: 1.14
*/
void
cogl_pango_show_layout (CoglFramebuffer *framebuffer,
@ -186,7 +186,7 @@ cogl_pango_show_layout (CoglFramebuffer *framebuffer,
* @y) within the @framebuffer<!-- -->'s current model-view coordinate
* space.
*
* Since: 2.0
* Since: 1.14
*/
void
cogl_pango_show_layout_line (CoglFramebuffer *framebuffer,
@ -209,19 +209,51 @@ typedef struct _CoglPangoRendererClass CoglPangoRendererClass;
GType cogl_pango_renderer_get_type (void) G_GNUC_CONST;
/**
* cogl_pango_render_layout:
* @layout: a #PangoLayout
* @x: X coordinate (in Pango units) to render the layout at
* @y: Y coordinate (in Pango units) to render the layout at
* @color: color to use when rendering the layout
* @flags:
*
* Draws a solidly coloured @layout on the given @framebuffer at (@x,
* @y) within the @framebuffer<!-- -->'s current model-view coordinate
* space.
*
* Since: 1.0
* Deprecated: 1.16: Use cogl_pango_show_layout() instead
*/
void
cogl_pango_render_layout_subpixel (PangoLayout *layout,
int x,
int y,
const CoglColor *color,
int flags);
int flags)
COGL_DEPRECATED_IN_1_16_FOR (cogl_pango_show_layout);
/**
* cogl_pango_render_layout:
* @layout: a #PangoLayout
* @x: X coordinate to render the layout at
* @y: Y coordinate to render the layout at
* @color: color to use when rendering the layout
* @flags:
*
* Draws a solidly coloured @layout on the given @framebuffer at (@x,
* @y) within the @framebuffer<!-- -->'s current model-view coordinate
* space.
*
* Since: 1.0
* Deprecated: 1.16: Use cogl_pango_show_layout() instead
*/
void
cogl_pango_render_layout (PangoLayout *layout,
int x,
int y,
const CoglColor *color,
int flags);
int flags)
COGL_DEPRECATED_IN_1_16_FOR (cogl_pango_show_layout);
/**
* cogl_pango_render_layout_line:
@ -233,12 +265,14 @@ cogl_pango_render_layout (PangoLayout *layout,
* Renders @line at the given coordinates using the given color.
*
* Since: 1.0
* Deprecated: 1.16: Use cogl_pango_show_layout() instead
*/
void
cogl_pango_render_layout_line (PangoLayoutLine *line,
int x,
int y,
const CoglColor *color);
const CoglColor *color)
COGL_DEPRECATED_IN_1_16_FOR (cogl_pango_show_layout_line);
COGL_END_DECLS

1
cogl/Makefile.am
View File

@ -132,6 +132,7 @@ cogl_experimental_h = \
$(srcdir)/cogl-pixel-buffer.h \
$(srcdir)/cogl2-experimental.h \
$(srcdir)/cogl2-compatibility.h \
$(srcdir)/cogl-macros.h \
$(srcdir)/cogl-version.h \
$(srcdir)/cogl-error.h \
$(NULL)

6
cogl/cogl-clutter.h
View File

@ -32,11 +32,13 @@ COGL_BEGIN_DECLS
#define cogl_clutter_check_extension cogl_clutter_check_extension_CLUTTER
CoglBool
cogl_clutter_check_extension (const char *name, const char *ext);
cogl_clutter_check_extension (const char *name, const char *ext)
COGL_DEPRECATED_IN_1_16;
#define cogl_clutter_winsys_has_feature cogl_clutter_winsys_has_feature_CLUTTER
CoglBool
cogl_clutter_winsys_has_feature (CoglWinsysFeature feature);
cogl_clutter_winsys_has_feature (CoglWinsysFeature feature)
COGL_DEPRECATED_FOR (cogl_has_feature);
#define cogl_onscreen_clutter_backend_set_size cogl_onscreen_clutter_backend_set_size_CLUTTER
void

7
cogl/cogl-color.h
View File

@ -39,6 +39,7 @@
#define __COGL_COLOR_H__
#include <cogl/cogl-types.h>
#include <cogl/cogl-macros.h>
COGL_BEGIN_DECLS
@ -117,7 +118,8 @@ cogl_color_set_from_4ub (CoglColor *color,
uint8_t red,
uint8_t green,
uint8_t blue,
uint8_t alpha);
uint8_t alpha)
COGL_DEPRECATED_IN_1_4_FOR (cogl_color_init_from_4ub);
/**
* cogl_color_init_from_4f:
@ -156,7 +158,8 @@ cogl_color_set_from_4f (CoglColor *color,
float red,
float green,
float blue,
float alpha);
float alpha)
COGL_DEPRECATED_IN_1_4_FOR (cogl_color_init_from_4f);
/**
* cogl_color_init_from_4fv:

253
cogl/cogl-macros.h Normal file
View File

@ -0,0 +1,253 @@
/*
* Cogl.
*
* An OpenGL based 'interactive canvas' library.
*
* Copyright (C) 2012 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/>.
*/
#if !defined(__COGL_H_INSIDE__) && !defined(COGL_COMPILATION)
#error "Only <cogl/cogl.h> can be included directly."
#endif
#ifndef __COGL_MACROS_H__
#define __COGL_MACROS_H__
#include <cogl/cogl-version.h>
/* These macros are used to mark deprecated functions, and thus have
* to be exposed in a public header.
*
* They are only intended for internal use and should not be used by
* other projects.
*/
#ifdef COGL_DISABLE_DEPRECATION_WARNINGS
#define COGL_DEPRECATED
#define COGL_DEPRECATED_FOR(f)
#define COGL_UNAVAILABLE(maj,min)
#else /* COGL_DISABLE_DEPRECATION_WARNINGS */
#if __GNUC__ > 3 || (__GNUC__ == 3 && __GNUC_MINOR__ >= 1)
#define COGL_DEPRECATED __attribute__((__deprecated__))
#elif defined(_MSC_VER) && (_MSC_VER >= 1300)
#define COGL_DEPRECATED __declspec(deprecated)
#else
#define COGL_DEPRECATED
#endif
#if __GNUC__ > 4 || (__GNUC__ == 4 && __GNUC_MINOR__ >= 5)
#define COGL_DEPRECATED_FOR(f) __attribute__((__deprecated__("Use '" #f "' instead")))
#elif defined(_MSC_FULL_VER) && (_MSC_FULL_VER > 140050320)
#define COGL_DEPRECATED_FOR(f) __declspec(deprecated("is deprecated. Use '" #f "' instead"))
#else
#define COGL_DEPRECATED_FOR(f) G_DEPRECATED
#endif
#if __GNUC__ > 4 || (__GNUC__ == 4 && __GNUC_MINOR__ >= 5)
#define COGL_UNAVAILABLE(maj,min) __attribute__((deprecated("Not available before " #maj "." #min)))
#elif defined(_MSC_FULL_VER) && (_MSC_FULL_VER > 140050320)
#define COGL_UNAVAILABLE(maj,min) __declspec(deprecated("is not available before " #maj "." #min))
#else
#define COGL_UNAVAILABLE(maj,min)
#endif
#endif /* COGL_DISABLE_DEPRECATION_WARNINGS */
/**
* COGL_VERSION_MIN_REQUIRED:
*
* A macro that should be defined by the user prior to including the
* cogl.h header.
*
* The definition should be one of the predefined Cogl version macros,
* such as: %COGL_VERSION_1_8, %COGL_VERSION_1_10, ...
*
* This macro defines the lower bound for the Cogl API to be used.
*
* If a function has been deprecated in a newer version of Cogl, it
* is possible to use this symbol to avoid the compiler warnings without
* disabling warnings for every deprecated function.
*
* Since: 1.16
*/
#ifndef COGL_VERSION_MIN_REQUIRED
# define COGL_VERSION_MIN_REQUIRED (COGL_VERSION_CURRENT_STABLE)
#endif
/**
* COGL_VERSION_MAX_ALLOWED:
*
* A macro that should be define by the user prior to including the
* cogl.h header.
*
* The definition should be one of the predefined Cogl version macros,
* such as: %COGL_VERSION_1_0, %COGL_VERSION_1_2, ...
*
* This macro defines the upper bound for the Cogl API to be used.
*
* If a function has been introduced in a newer version of Cogl, it
* is possible to use this symbol to get compiler warnings when trying
* to use that function.
*
* Since: 1.16
*/
#ifndef COGL_VERSION_MAX_ALLOWED
# if COGL_VERSION_MIN_REQUIRED > COGL_VERSION_PREVIOUS_STABLE
# define COGL_VERSION_MAX_ALLOWED COGL_VERSION_MIN_REQUIRED
# else
# define COGL_VERSION_MAX_ALLOWED COGL_VERSION_CURRENT_STABLE
# endif
#endif
/* sanity checks */
#if COGL_VERSION_MAX_ALLOWED < COGL_VERSION_MIN_REQUIRED
# error "COGL_VERSION_MAX_ALLOWED must be >= COGL_VERSION_MIN_REQUIRED"
#endif
#if COGL_VERSION_MIN_REQUIRED < COGL_VERSION_1_0
# error "COGL_VERSION_MIN_REQUIRED must be >= COGL_VERSION_1_0"
#endif
/* XXX: Every new stable minor release should add a set of macros here */
#if COGL_VERSION_MIN_REQUIRED >= COGL_VERSION_1_0
# define COGL_DEPRECATED_IN_1_0 COGL_DEPRECATED
# define COGL_DEPRECATED_IN_1_0_FOR(f) COGL_DEPRECATED_FOR(f)
#else
# define COGL_DEPRECATED_IN_1_0
# define COGL_DEPRECATED_IN_1_0_FOR(f)
#endif
#if COGL_VERSION_MAX_ALLOWED < COGL_VERSION_1_0
# define COGL_AVAILABLE_IN_1_0 COGL_UNAVAILABLE(1, 0)
#else
# define COGL_AVAILABLE_IN_1_0
#endif
#if COGL_VERSION_MIN_REQUIRED >= COGL_VERSION_1_2
# define COGL_DEPRECATED_IN_1_2 COGL_DEPRECATED
# define COGL_DEPRECATED_IN_1_2_FOR(f) COGL_DEPRECATED_FOR(f)
#else
# define COGL_DEPRECATED_IN_1_2
# define COGL_DEPRECATED_IN_1_2_FOR(f)
#endif
#if COGL_VERSION_MAX_ALLOWED < COGL_VERSION_1_2
# define COGL_AVAILABLE_IN_1_2 COGL_UNAVAILABLE(1, 2)
#else
# define COGL_AVAILABLE_IN_1_2
#endif
#if COGL_VERSION_MIN_REQUIRED >= COGL_VERSION_1_4
# define COGL_DEPRECATED_IN_1_4 COGL_DEPRECATED
# define COGL_DEPRECATED_IN_1_4_FOR(f) COGL_DEPRECATED_FOR(f)
#else
# define COGL_DEPRECATED_IN_1_4
# define COGL_DEPRECATED_IN_1_4_FOR(f)
#endif
#if COGL_VERSION_MAX_ALLOWED < COGL_VERSION_1_4
# define COGL_AVAILABLE_IN_1_4 COGL_UNAVAILABLE(1, 4)
#else
# define COGL_AVAILABLE_IN_1_4
#endif
#if COGL_VERSION_MIN_REQUIRED >= COGL_VERSION_1_6
# define COGL_DEPRECATED_IN_1_6 COGL_DEPRECATED
# define COGL_DEPRECATED_IN_1_6_FOR(f) COGL_DEPRECATED_FOR(f)
#else
# define COGL_DEPRECATED_IN_1_6
# define COGL_DEPRECATED_IN_1_6_FOR(f)
#endif
#if COGL_VERSION_MAX_ALLOWED < COGL_VERSION_1_6
# define COGL_AVAILABLE_IN_1_6 COGL_UNAVAILABLE(1, 6)
#else
# define COGL_AVAILABLE_IN_1_6
#endif
#if COGL_VERSION_MIN_REQUIRED >= COGL_VERSION_1_8
# define COGL_DEPRECATED_IN_1_8 COGL_DEPRECATED
# define COGL_DEPRECATED_IN_1_8_FOR(f) COGL_DEPRECATED_FOR(f)
#else
# define COGL_DEPRECATED_IN_1_8
# define COGL_DEPRECATED_IN_1_8_FOR(f)
#endif
#if COGL_VERSION_MAX_ALLOWED < COGL_VERSION_1_8
# define COGL_AVAILABLE_IN_1_8 COGL_UNAVAILABLE(1, 8)
#else
# define COGL_AVAILABLE_IN_1_8
#endif
#if COGL_VERSION_MIN_REQUIRED >= COGL_VERSION_1_10
# define COGL_DEPRECATED_IN_1_10 COGL_DEPRECATED
# define COGL_DEPRECATED_IN_1_10_FOR(f) COGL_DEPRECATED_FOR(f)
#else
# define COGL_DEPRECATED_IN_1_10
# define COGL_DEPRECATED_IN_1_10_FOR(f)
#endif
#if COGL_VERSION_MAX_ALLOWED < COGL_VERSION_1_10
# define COGL_AVAILABLE_IN_1_10 COGL_UNAVAILABLE(1, 10)
#else
# define COGL_AVAILABLE_IN_1_10
#endif
#if COGL_VERSION_MIN_REQUIRED >= COGL_VERSION_1_12
# define COGL_DEPRECATED_IN_1_12 COGL_DEPRECATED
# define COGL_DEPRECATED_IN_1_12_FOR(f) COGL_DEPRECATED_FOR(f)
#else
# define COGL_DEPRECATED_IN_1_12
# define COGL_DEPRECATED_IN_1_12_FOR(f)
#endif
#if COGL_VERSION_MAX_ALLOWED < COGL_VERSION_1_12
# define COGL_AVAILABLE_IN_1_12 COGL_UNAVAILABLE(1, 12)
#else
# define COGL_AVAILABLE_IN_1_12
#endif
#if COGL_VERSION_MIN_REQUIRED >= COGL_VERSION_1_14
# define COGL_DEPRECATED_IN_1_14 COGL_DEPRECATED
# define COGL_DEPRECATED_IN_1_14_FOR(f) COGL_DEPRECATED_FOR(f)
#else
# define COGL_DEPRECATED_IN_1_14
# define COGL_DEPRECATED_IN_1_14_FOR(f)
#endif
#if COGL_VERSION_MAX_ALLOWED < COGL_VERSION_1_14
# define COGL_AVAILABLE_IN_1_14 COGL_UNAVAILABLE(1, 14)
#else
# define COGL_AVAILABLE_IN_1_14
#endif
#if COGL_VERSION_MIN_REQUIRED >= COGL_VERSION_1_16
# define COGL_DEPRECATED_IN_1_16 COGL_DEPRECATED
# define COGL_DEPRECATED_IN_1_16_FOR(f) COGL_DEPRECATED_FOR(f)
#else
# define COGL_DEPRECATED_IN_1_16
# define COGL_DEPRECATED_IN_1_16_FOR(f)
#endif
#if COGL_VERSION_MAX_ALLOWED < COGL_VERSION_1_16
# define COGL_AVAILABLE_IN_1_16 COGL_UNAVAILABLE(1, 16)
#else
# define COGL_AVAILABLE_IN_1_16
#endif
#endif /* __COGL_MACROS_H__ */

220
cogl/cogl-material-compat.h
View File

@ -32,6 +32,7 @@
#include <cogl/cogl-matrix.h>
#include <cogl/cogl-depth-state.h>
#include <cogl/cogl-error.h>
#include <cogl/cogl-macros.h>
G_BEGIN_DECLS
@ -134,9 +135,10 @@ typedef enum {
* Allocates and initializes a blank white material
*
* Return value: a pointer to a new #CoglMaterial
* Deprecated: 1.16: Use cogl_pipeline_new() instead
*/
CoglMaterial *
cogl_material_new (void);
cogl_material_new (void) COGL_DEPRECATED_IN_1_16_FOR (cogl_pipeline_new);
/**
* cogl_material_copy:
@ -154,11 +156,11 @@ cogl_material_new (void);
* Returns: a pointer to the newly allocated #CoglMaterial
*
* Since: 1.2
* Deprecated: 1.16: Use cogl_pipeline_copy() instead
*/
CoglMaterial *
cogl_material_copy (CoglMaterial *source);
#ifndef COGL_DISABLE_DEPRECATED
cogl_material_copy (CoglMaterial *source)
COGL_DEPRECATED_IN_1_16_FOR (cogl_pipeline_copy);
/**
* cogl_material_ref:
@ -173,7 +175,7 @@ cogl_material_copy (CoglMaterial *source);
* Deprecated: 1.2: Use cogl_object_ref() instead
*/
CoglHandle
cogl_material_ref (CoglHandle material) G_GNUC_DEPRECATED;
cogl_material_ref (CoglHandle material) COGL_DEPRECATED;
/**
* cogl_material_unref:
@ -186,9 +188,7 @@ cogl_material_ref (CoglHandle material) G_GNUC_DEPRECATED;
* Deprecated: 1.2: Use cogl_object_unref() instead
*/
void
cogl_material_unref (CoglHandle material) G_GNUC_DEPRECATED;
#endif /* COGL_DISABLE_DEPRECATED */
cogl_material_unref (CoglHandle material) COGL_DEPRECATED;
/**
* cogl_is_material:
@ -198,9 +198,11 @@ cogl_material_unref (CoglHandle material) G_GNUC_DEPRECATED;
*
* Return value: %TRUE if the handle references a #CoglMaterial,
* %FALSE otherwise
* Deprecated: 1.16: Use cogl_is_pipeline() instead
*/
CoglBool
cogl_is_material (CoglHandle handle);
cogl_is_material (CoglHandle handle)
COGL_DEPRECATED_IN_1_16_FOR (cogl_is_pipeline);
/**
* cogl_material_set_color:
@ -217,10 +219,12 @@ cogl_is_material (CoglHandle handle);
* The default value is (1.0, 1.0, 1.0, 1.0)
*
* Since: 1.0
* Deprecated: 1.16: Use cogl_pipeline_set_color() instead
*/
void
cogl_material_set_color (CoglMaterial *material,
const CoglColor *color);
const CoglColor *color)
COGL_DEPRECATED_IN_1_16_FOR (cogl_pipeline_set_color);
/**
* cogl_material_set_color4ub:
@ -235,13 +239,15 @@ cogl_material_set_color (CoglMaterial *material,
* The default value is (0xff, 0xff, 0xff, 0xff)
*
* Since: 1.0
* Deprecated: 1.16: Use cogl_pipeline_set_color4ub() instead
*/
void
cogl_material_set_color4ub (CoglMaterial *material,
uint8_t red,
uint8_t green,
uint8_t blue,
uint8_t alpha);
uint8_t alpha)
COGL_DEPRECATED_IN_1_16_FOR (cogl_pipeline_set_color4ub);
/**
* cogl_material_set_color4f:
@ -256,13 +262,15 @@ cogl_material_set_color4ub (CoglMaterial *material,
* The default value is (1.0, 1.0, 1.0, 1.0)
*
* Since: 1.0
* Deprecated: 1.16: Use cogl_pipeline_set_color4f() instead
*/
void
cogl_material_set_color4f (CoglMaterial *material,
float red,
float green,
float blue,
float alpha);
float alpha)
COGL_DEPRECATED_IN_1_16_FOR (cogl_pipeline_set_color4f);
/**
* cogl_material_get_color:
@ -272,10 +280,12 @@ cogl_material_set_color4f (CoglMaterial *material,
* Retrieves the current material color.
*
* Since: 1.0
* Deprecated: 1.16: Use cogl_pipeline_get_color() instead
*/
void
cogl_material_get_color (CoglMaterial *material,
CoglColor *color);
CoglColor *color)
COGL_DEPRECATED_IN_1_16_FOR (cogl_pipeline_get_color);
/**
* cogl_material_set_ambient:
@ -292,10 +302,12 @@ cogl_material_get_color (CoglMaterial *material,
* The default value is (0.2, 0.2, 0.2, 1.0)
*
* Since: 1.0
* Deprecated: 1.16: Use the #CoglSnippet shader api for lighting
*/
void
cogl_material_set_ambient (CoglMaterial *material,
const CoglColor *ambient);
const CoglColor *ambient)
COGL_DEPRECATED_IN_1_16_FOR (cogl_snippet_);
/**
* cogl_material_get_ambient:
@ -305,10 +317,12 @@ cogl_material_set_ambient (CoglMaterial *material,
* Retrieves the current ambient color for @material
*
* Since: 1.0
* Deprecated: 1.16: Use the #CoglSnippet shader api for lighting
*/
void
cogl_material_get_ambient (CoglMaterial *material,
CoglColor *ambient);
CoglColor *ambient)
COGL_DEPRECATED_IN_1_16_FOR (cogl_snippet_);
/**
* cogl_material_set_diffuse:
@ -322,10 +336,12 @@ cogl_material_get_ambient (CoglMaterial *material,
* The default value is (0.8, 0.8, 0.8, 1.0)
*
* Since: 1.0
* Deprecated: 1.16: Use the #CoglSnippet shader api for lighting
*/
void
cogl_material_set_diffuse (CoglMaterial *material,
const CoglColor *diffuse);
const CoglColor *diffuse)
COGL_DEPRECATED_IN_1_16_FOR (cogl_snippet_);
/**
* cogl_material_get_diffuse:
@ -335,10 +351,12 @@ cogl_material_set_diffuse (CoglMaterial *material,
* Retrieves the current diffuse color for @material
*
* Since: 1.0
* Deprecated: 1.16: Use the #CoglSnippet shader api for lighting
*/
void
cogl_material_get_diffuse (CoglMaterial *material,
CoglColor *diffuse);
CoglColor *diffuse)
COGL_DEPRECATED_IN_1_16_FOR (cogl_snippet_);
/**
* cogl_material_set_ambient_and_diffuse:
@ -353,10 +371,12 @@ cogl_material_get_diffuse (CoglMaterial *material,
* The default diffuse color is (0.8, 0.8, 0.8, 1.0)
*
* Since: 1.0
* Deprecated: 1.16: Use the #CoglSnippet shader api for lighting
*/
void
cogl_material_set_ambient_and_diffuse (CoglMaterial *material,
const CoglColor *color);
const CoglColor *color)
COGL_DEPRECATED_IN_1_16_FOR (cogl_snippet_);
/**
* cogl_material_set_specular:
@ -370,10 +390,12 @@ cogl_material_set_ambient_and_diffuse (CoglMaterial *material,
* The default value is (0.0, 0.0, 0.0, 1.0)
*
* Since: 1.0
* Deprecated: 1.16: Use the #CoglSnippet shader api for lighting
*/
void
cogl_material_set_specular (CoglMaterial *material,
const CoglColor *specular);
const CoglColor *specular)
COGL_DEPRECATED_IN_1_16_FOR (cogl_snippet_);
/**
* cogl_material_get_specular:
@ -383,10 +405,12 @@ cogl_material_set_specular (CoglMaterial *material,
* Retrieves the materials current specular color.
*
* Since: 1.0
* Deprecated: 1.16: Use the #CoglSnippet shader api for lighting
*/
void
cogl_material_get_specular (CoglMaterial *material,
CoglColor *specular);
CoglColor *specular)
COGL_DEPRECATED_IN_1_16_FOR (cogl_snippet_);
/**
* cogl_material_set_shininess:
@ -401,10 +425,12 @@ cogl_material_get_specular (CoglMaterial *material,
* The default value is 0.0
*
* Since: 1.0
* Deprecated: 1.16: Use the #CoglSnippet shader api for lighting
*/
void
cogl_material_set_shininess (CoglMaterial *material,
float shininess);
float shininess)
COGL_DEPRECATED_IN_1_16_FOR (cogl_snippet_);
/**
* cogl_material_get_shininess:
@ -415,9 +441,11 @@ cogl_material_set_shininess (CoglMaterial *material,
* Return value: The materials current shininess value
*
* Since: 1.0
* Deprecated: 1.16: Use the #CoglSnippet shader api for lighting
*/
float
cogl_material_get_shininess (CoglMaterial *material);
cogl_material_get_shininess (CoglMaterial *material)
COGL_DEPRECATED_IN_1_16_FOR (cogl_snippet_);
/**
* cogl_material_set_emission:
@ -431,10 +459,12 @@ cogl_material_get_shininess (CoglMaterial *material);
* The default value is (0.0, 0.0, 0.0, 1.0)
*
* Since: 1.0
* Deprecated: 1.16: Use the #CoglSnippet shader api for lighting
*/
void
cogl_material_set_emission (CoglMaterial *material,
const CoglColor *emission);
const CoglColor *emission)
COGL_DEPRECATED_IN_1_16_FOR (cogl_snippet_);
/**
* cogl_material_get_emission:
@ -444,10 +474,12 @@ cogl_material_set_emission (CoglMaterial *material,
* Retrieves the materials current emission color.
*
* Since: 1.0
* Deprecated: 1.16: Use the #CoglSnippet shader api for lighting
*/
void
cogl_material_get_emission (CoglMaterial *material,
CoglColor *emission);
CoglColor *emission)
COGL_DEPRECATED_IN_1_16_FOR (cogl_snippet_);
/**
* CoglMaterialAlphaFunc:
@ -498,11 +530,13 @@ typedef enum {
* The default is %COGL_MATERIAL_ALPHA_FUNC_ALWAYS
*
* Since: 1.0
* Deprecated: 1.16: Use cogl_pipeline_set_alpha_test_function() instead
*/
void
cogl_material_set_alpha_test_function (CoglMaterial *material,
CoglMaterialAlphaFunc alpha_func,
float alpha_reference);
float alpha_reference)
COGL_DEPRECATED_IN_1_16_FOR (cogl_pipeline_set_alpha_test_function);
/**
* cogl_material_set_blend:
@ -587,11 +621,13 @@ cogl_material_set_alpha_test_function (CoglMaterial *material,
* present).
*
* Since: 1.0
* Deprecated: 1.16: Use cogl_pipeline_set_blend() instead
*/
CoglBool
cogl_material_set_blend (CoglMaterial *material,
const char *blend_string,
CoglError **error);
CoglError **error)
COGL_DEPRECATED_IN_1_16_FOR (cogl_pipeline_set_blend);
/**
* cogl_material_set_blend_constant:
@ -602,10 +638,12 @@ cogl_material_set_blend (CoglMaterial *material,
* blending will depend on the constant set with this function.
*
* Since: 1.0
* Deprecated: 1.16: Use cogl_pipeline_set_blend_constant() instead
*/
void
cogl_material_set_blend_constant (CoglMaterial *material,
const CoglColor *constant_color);
const CoglColor *constant_color)
COGL_DEPRECATED_IN_1_16_FOR (cogl_pipeline_set_blend_constant);
/**
* cogl_material_set_point_size:
@ -621,10 +659,12 @@ cogl_material_set_blend_constant (CoglMaterial *material,
* transformations. The default point size is 1.0.
*
* Since: 1.4
* Deprecated: 1.16: Use cogl_pipeline_set_point_size() instead
*/
void
cogl_material_set_point_size (CoglMaterial *material,
float point_size);
float point_size)
COGL_DEPRECATED_IN_1_16_FOR (cogl_pipeline_set_point_size);
/**
* cogl_material_get_point_size:
@ -636,9 +676,11 @@ cogl_material_set_point_size (CoglMaterial *material,
* Return value: the point size of the material.
*
* Since: 1.4
* Deprecated: 1.16: Use cogl_pipeline_get_point_size() instead
*/
float
cogl_material_get_point_size (CoglMaterial *material);
cogl_material_get_point_size (CoglMaterial *material)
COGL_DEPRECATED_IN_1_16_FOR (cogl_pipeline_get_point_size);
/**
* cogl_material_get_user_program:
@ -651,9 +693,11 @@ cogl_material_get_point_size (CoglMaterial *material);
* or %COGL_INVALID_HANDLE.
*
* Since: 1.4
* Deprecated: 1.16: Use #CoglSnippet api instead instead
*/
CoglHandle
cogl_material_get_user_program (CoglMaterial *material);
cogl_material_get_user_program (CoglMaterial *material)
COGL_DEPRECATED_IN_1_16_FOR (cogl_snippet_);
/**
* cogl_material_set_user_program:
@ -700,10 +744,12 @@ cogl_material_get_user_program (CoglMaterial *material);
* using the cogl_program or cogl_shader API.
*
* Since: 1.4
* Deprecated: 1.16: Use #CoglSnippet api instead instead
*/
void
cogl_material_set_user_program (CoglMaterial *material,
CoglHandle program);
CoglHandle program)
COGL_DEPRECATED_IN_1_16_FOR (cogl_snippet_);
/**
* cogl_material_set_layer:
@ -723,11 +769,13 @@ cogl_material_set_user_program (CoglMaterial *material,
* as purely GLSL based layers.</note>
*
* Since: 1.0
* Deprecated: 1.16: Use cogl_pipeline_set_layer() instead
*/
void
cogl_material_set_layer (CoglMaterial *material,
int layer_index,
CoglHandle texture);
CoglHandle texture)
COGL_DEPRECATED_IN_1_16_FOR (cogl_pipeline_set_layer);
/**
* cogl_material_remove_layer:
@ -735,10 +783,12 @@ cogl_material_set_layer (CoglMaterial *material,
* @layer_index: Specifies the layer you want to remove
*
* This function removes a layer from your material
* Deprecated: 1.16: Use cogl_pipeline_remove_layer() instead
*/
void
cogl_material_remove_layer (CoglMaterial *material,
int layer_index);
int layer_index)
COGL_DEPRECATED_IN_1_16_FOR (cogl_pipeline_remove_layer);
/**
@ -832,12 +882,14 @@ cogl_material_remove_layer (CoglMaterial *material,
* or hardware. On failure, %FALSE is returned and @error is set
*
* Since: 1.0
* Deprecated: 1.16: Use cogl_pipeline_set_layer_combine() instead
*/
CoglBool
cogl_material_set_layer_combine (CoglMaterial *material,
int layer_index,
const char *blend_string,
CoglError **error);
CoglError **error)
COGL_DEPRECATED_IN_1_16_FOR (cogl_pipeline_set_layer_combine);
/**
* cogl_material_set_layer_combine_constant:
@ -850,11 +902,14 @@ cogl_material_set_layer_combine (CoglMaterial *material,
* description then you can use this function to define its value.
*
* Since: 1.0
* Deprecated: 1.16: Use cogl_pipeline_set_layer_combine_constant()
* instead
*/
void
cogl_material_set_layer_combine_constant (CoglMaterial *material,
int layer_index,
const CoglColor *constant);
const CoglColor *constant)
COGL_DEPRECATED_IN_1_16_FOR (cogl_pipeline_set_layer_combine_constant);
/**
* cogl_material_set_layer_matrix:
@ -864,11 +919,13 @@ cogl_material_set_layer_combine_constant (CoglMaterial *material,
*
* This function lets you set a matrix that can be used to e.g. translate
* and rotate a single layer of a material used to fill your geometry.
* Deprecated: 1.16: Use cogl_pipeline_set_layer_matrix() instead
*/
void
cogl_material_set_layer_matrix (CoglMaterial *material,
int layer_index,
const CoglMatrix *matrix);
const CoglMatrix *matrix)
COGL_DEPRECATED_IN_1_16_FOR (cogl_pipeline_set_layer_matrix);
/**
* cogl_material_get_layers:
@ -890,9 +947,11 @@ cogl_material_set_layer_matrix (CoglMaterial *material,
* list of #CoglMaterialLayer<!-- -->'s that can be passed to the
* cogl_material_layer_* functions. The list is owned by Cogl and it
* should not be modified or freed
* Deprecated: 1.16: Use cogl_pipeline_get_layers() instead
*/
const GList *
cogl_material_get_layers (CoglMaterial *material);
cogl_material_get_layers (CoglMaterial *material)
COGL_DEPRECATED_IN_1_16_FOR (cogl_pipeline_get_layers);
/**
* cogl_material_get_n_layers:
@ -903,9 +962,11 @@ cogl_material_get_layers (CoglMaterial *material);
* Return value: the number of layers
*
* Since: 1.0
* Deprecated: 1.16: Use cogl_pipeline_get_n_layers() instead
*/
int
cogl_material_get_n_layers (CoglMaterial *material);
cogl_material_get_n_layers (CoglMaterial *material)
COGL_DEPRECATED_IN_1_16_FOR (cogl_pipeline_get_n_layers);
/**
* CoglMaterialLayerType:
@ -934,9 +995,11 @@ typedef enum {
* first.
*
* Return value: the type of the layer
* Deprecated: 1.16: No replacement
*/
CoglMaterialLayerType
cogl_material_layer_get_type (CoglMaterialLayer *layer);
cogl_material_layer_get_type (CoglMaterialLayer *layer)
COGL_DEPRECATED_IN_1_16;
/**
* cogl_material_layer_get_texture:
@ -951,9 +1014,11 @@ cogl_material_layer_get_type (CoglMaterialLayer *layer);
* type %COGL_MATERIAL_LAYER_TYPE_TEXTURE before calling this function.</note>
*
* Return value: (transfer none): a #CoglHandle for the texture inside the layer
* Deprecated: 1.16: No replacement
*/
CoglHandle
cogl_material_layer_get_texture (CoglMaterialLayer *layer);
cogl_material_layer_get_texture (CoglMaterialLayer *layer)
COGL_DEPRECATED_IN_1_16;
/**
* cogl_material_layer_get_min_filter:
@ -962,9 +1027,11 @@ cogl_material_layer_get_texture (CoglMaterialLayer *layer);
* Queries the currently set downscaling filter for a material layer
*
* Return value: the current downscaling filter
* Deprecated: 1.16: No replacement
*/
CoglMaterialFilter
cogl_material_layer_get_min_filter (CoglMaterialLayer *layer);
cogl_material_layer_get_min_filter (CoglMaterialLayer *layer)
COGL_DEPRECATED_IN_1_16;
/**
* cogl_material_layer_get_mag_filter:
@ -973,9 +1040,11 @@ cogl_material_layer_get_min_filter (CoglMaterialLayer *layer);
* Queries the currently set downscaling filter for a material later
*
* Return value: the current downscaling filter
* Deprecated: 1.16: No replacement
*/
CoglMaterialFilter
cogl_material_layer_get_mag_filter (CoglMaterialLayer *layer);
cogl_material_layer_get_mag_filter (CoglMaterialLayer *layer)
COGL_DEPRECATED_IN_1_16;
/**
* cogl_material_set_layer_filters:
@ -986,12 +1055,14 @@ cogl_material_layer_get_mag_filter (CoglMaterialLayer *layer);
*
* Changes the decimation and interpolation filters used when a texture is
* drawn at other scales than 100%.
* Deprecated: 1.16: Use cogl_pipeline_set_layer_filters() instead
*/
void
cogl_material_set_layer_filters (CoglMaterial *material,
int layer_index,
CoglMaterialFilter min_filter,
CoglMaterialFilter mag_filter);
CoglMaterialFilter mag_filter)
COGL_DEPRECATED_IN_1_16_FOR (cogl_pipeline_set_layer_filters);
/**
* cogl_material_set_layer_point_sprite_coords_enabled:
@ -1013,12 +1084,15 @@ cogl_material_set_layer_filters (CoglMaterial *material,
*
* Return value: %TRUE if the function succeeds, %FALSE otherwise.
* Since: 1.4
* Deprecated: 1.16: Use cogl_pipeline_set_layer_point_sprite_coords_enabled()
* instead
*/
CoglBool
cogl_material_set_layer_point_sprite_coords_enabled (CoglMaterial *material,
int layer_index,
CoglBool enable,
CoglError **error);
CoglError **error)
COGL_DEPRECATED_IN_1_16_FOR (cogl_pipeline_set_layer_point_sprite_coords_enabled);
/**
* cogl_material_get_layer_point_sprite_coords_enabled:
@ -1032,10 +1106,13 @@ cogl_material_set_layer_point_sprite_coords_enabled (CoglMaterial *material,
* point sprite coordinates.
*
* Since: 1.4
* Deprecated: 1.16: Use cogl_pipeline_get_layer_point_sprite_coords_enabled()
* instead
*/
CoglBool
cogl_material_get_layer_point_sprite_coords_enabled (CoglMaterial *material,
int layer_index);
int layer_index)
COGL_DEPRECATED_IN_1_16_FOR (cogl_pipeline_get_layer_point_sprite_coords_enabled);
/**
* cogl_material_get_layer_wrap_mode_s:
@ -1049,10 +1126,12 @@ cogl_material_get_layer_point_sprite_coords_enabled (CoglMaterial *material,
* this layer.
*
* Since: 1.6
* Deprecated: 1.16: Use cogl_pipeline_get_layer_wrap_mode_s() instead
*/
CoglMaterialWrapMode
cogl_material_get_layer_wrap_mode_s (CoglMaterial *material,
int layer_index);
int layer_index)
COGL_DEPRECATED_IN_1_16_FOR (cogl_pipeline_get_layer_wrap_mode_s);
/**
* cogl_material_set_layer_wrap_mode_s:
@ -1063,11 +1142,13 @@ cogl_material_get_layer_wrap_mode_s (CoglMaterial *material,
* Sets the wrap mode for the 's' coordinate of texture lookups on this layer.
*
* Since: 1.4
* Deprecated: 1.16: Use cogl_pipeline_set_layer_wrap_mode_s() instead
*/
void
cogl_material_set_layer_wrap_mode_s (CoglMaterial *material,
int layer_index,
CoglMaterialWrapMode mode);
CoglMaterialWrapMode mode)
COGL_DEPRECATED_IN_1_16_FOR (cogl_pipeline_set_layer_wrap_mode_s);
/**
* cogl_material_get_layer_wrap_mode_t:
@ -1081,10 +1162,12 @@ cogl_material_set_layer_wrap_mode_s (CoglMaterial *material,
* this layer.
*
* Since: 1.6
* Deprecated: 1.16: Use cogl_pipeline_get_layer_wrap_mode_t() instead
*/
CoglMaterialWrapMode
cogl_material_get_layer_wrap_mode_t (CoglMaterial *material,
int layer_index);
int layer_index)
COGL_DEPRECATED_IN_1_16_FOR (cogl_pipeline_get_layer_wrap_mode_t);
/**
@ -1096,11 +1179,13 @@ cogl_material_get_layer_wrap_mode_t (CoglMaterial *material,
* Sets the wrap mode for the 't' coordinate of texture lookups on this layer.
*
* Since: 1.4
* Deprecated: 1.16: Use cogl_pipeline_set_layer_wrap_mode_t() instead
*/
void
cogl_material_set_layer_wrap_mode_t (CoglMaterial *material,
int layer_index,
CoglMaterialWrapMode mode);
CoglMaterialWrapMode mode)
COGL_DEPRECATED_IN_1_16_FOR (cogl_pipeline_set_layer_wrap_mode_t);
/**
* cogl_material_get_layer_wrap_mode_p:
@ -1114,10 +1199,12 @@ cogl_material_set_layer_wrap_mode_t (CoglMaterial *material,
* this layer.
*
* Since: 1.6
* Deprecated: 1.16: Use cogl_pipeline_get_layer_wrap_mode_p() instead
*/
CoglMaterialWrapMode
cogl_material_get_layer_wrap_mode_p (CoglMaterial *material,
int layer_index);
int layer_index)
COGL_DEPRECATED_IN_1_16_FOR (cogl_pipeline_get_layer_wrap_mode_p);
/**
* cogl_material_set_layer_wrap_mode_p:
@ -1129,11 +1216,13 @@ cogl_material_get_layer_wrap_mode_p (CoglMaterial *material,
* this layer. 'p' is the third coordinate.
*
* Since: 1.4
* Deprecated: 1.16: Use cogl_pipeline_set_layer_wrap_mode_p() instead
*/
void
cogl_material_set_layer_wrap_mode_p (CoglMaterial *material,
int layer_index,
CoglMaterialWrapMode mode);
CoglMaterialWrapMode mode)
COGL_DEPRECATED_IN_1_16_FOR (cogl_pipeline_set_layer_wrap_mode_p);
/**
* cogl_material_set_layer_wrap_mode:
@ -1148,11 +1237,13 @@ cogl_material_set_layer_wrap_mode_p (CoglMaterial *material,
* cogl_material_set_layer_wrap_mode_p() separately.
*
* Since: 1.4
* Deprecated: 1.16: Use cogl_pipeline_set_layer_wrap_mode() instead
*/
void
cogl_material_set_layer_wrap_mode (CoglMaterial *material,
int layer_index,
CoglMaterialWrapMode mode);
CoglMaterialWrapMode mode)
COGL_DEPRECATED_IN_1_16_FOR (cogl_pipeline_set_layer_wrap_mode);
/**
* cogl_material_layer_get_wrap_mode_s:
@ -1163,9 +1254,11 @@ cogl_material_set_layer_wrap_mode (CoglMaterial *material,
* Return value: the wrap mode value for the s coordinate.
*
* Since: 1.4
* Deprecated: 1.16: Use cogl_pipeline_layer_get_wrap_mode_s() instead
*/
CoglMaterialWrapMode
cogl_material_layer_get_wrap_mode_s (CoglMaterialLayer *layer);
cogl_material_layer_get_wrap_mode_s (CoglMaterialLayer *layer)
COGL_DEPRECATED_IN_1_16_FOR (cogl_pipeline_layer_get_wrap_mode_s);
/**
* cogl_material_layer_get_wrap_mode_t:
@ -1176,9 +1269,11 @@ cogl_material_layer_get_wrap_mode_s (CoglMaterialLayer *layer);
* Return value: the wrap mode value for the t coordinate.
*
* Since: 1.4
* Deprecated: 1.16: Use cogl_pipeline_layer_get_wrap_mode_t() instead
*/
CoglMaterialWrapMode
cogl_material_layer_get_wrap_mode_t (CoglMaterialLayer *layer);
cogl_material_layer_get_wrap_mode_t (CoglMaterialLayer *layer)
COGL_DEPRECATED_IN_1_16_FOR (cogl_pipeline_layer_get_wrap_mode_t);
/**
* cogl_material_layer_get_wrap_mode_p:
@ -1190,9 +1285,11 @@ cogl_material_layer_get_wrap_mode_t (CoglMaterialLayer *layer);
* Return value: the wrap mode value for the p coordinate.
*
* Since: 1.4
* Deprecated: 1.16: Use cogl_pipeline_layer_get_wrap_mode_p() instead
*/
CoglMaterialWrapMode
cogl_material_layer_get_wrap_mode_p (CoglMaterialLayer *layer);
cogl_material_layer_get_wrap_mode_p (CoglMaterialLayer *layer)
COGL_DEPRECATED_IN_1_16_FOR (cogl_pipeline_layer_get_wrap_mode_p);
#ifdef COGL_ENABLE_EXPERIMENTAL_API
@ -1215,11 +1312,13 @@ cogl_material_layer_get_wrap_mode_p (CoglMaterialLayer *layer);
*
* Since: 1.8
* Stability: Unstable
* Deprecated: 1.16: Use cogl_pipeline_set_depth_state() instead
*/
CoglBool
cogl_material_set_depth_state (CoglMaterial *material,
const CoglDepthState *state,
CoglError **error);
CoglError **error)
COGL_DEPRECATED_IN_1_16_FOR (cogl_pipeline_set_depth_state);
/**
* cogl_material_get_depth_state:
@ -1231,10 +1330,12 @@ cogl_material_set_depth_state (CoglMaterial *material,
*
* Since: 2.0
* Stability: Unstable
* Deprecated: 1.16: Use cogl_pipeline_get_depth_state() instead
*/
void
cogl_material_get_depth_state (CoglMaterial *material,
CoglDepthState *state_out);
CoglDepthState *state_out)
COGL_DEPRECATED_IN_1_16_FOR (cogl_pipeline_get_depth_state);
/**
* CoglMaterialLayerCallback:
@ -1247,6 +1348,7 @@ cogl_material_get_depth_state (CoglMaterial *material,
*
* Since: 1.4
* Stability: Unstable
* Deprecated: 1.16
*/
typedef CoglBool (*CoglMaterialLayerCallback) (CoglMaterial *material,
int layer_index,
@ -1263,11 +1365,13 @@ typedef CoglBool (*CoglMaterialLayerCallback) (CoglMaterial *material,
*
* Since: 1.4
* Stability: Unstable
* Deprecated: 1.16: No replacement
*/
void
cogl_material_foreach_layer (CoglMaterial *material,
CoglMaterialLayerCallback callback,
void *user_data);
void *user_data)
COGL_DEPRECATED_IN_1_16;
#endif /* COGL_ENABLE_EXPERIMENTAL_API */

8
cogl/cogl-matrix.h
View File

@ -31,10 +31,11 @@
#include <glib-object.h>
#endif /* COGL_HAS_GTYPE_SUPPORT */
#include "cogl-types.h"
#include <cogl/cogl-types.h>
#include <cogl/cogl-macros.h>
#ifdef COGL_ENABLE_EXPERIMENTAL_API
#include "cogl-quaternion.h"
#include <cogl/cogl-quaternion.h>
#endif
COGL_BEGIN_DECLS
@ -408,7 +409,8 @@ cogl_matrix_ortho (CoglMatrix *matrix,
float bottom,
float top,
float near,
float far);
float far)
COGL_DEPRECATED_IN_1_10_FOR (cogl_matrix_orthographic);
#ifdef COGL_ENABLE_EXPERIMENTAL_API
/**

8
cogl/cogl-offscreen.h
View File

@ -82,8 +82,6 @@ cogl_offscreen_new_to_texture (CoglTexture *texture);
CoglBool
cogl_is_offscreen (void *object);
#ifndef COGL_DISABLE_DEPRECATED
/**
* cogl_offscreen_ref:
* @offscreen: A pointer to a #CoglOffscreen framebuffer
@ -96,7 +94,7 @@ cogl_is_offscreen (void *object);
* Deprecated: 1.2: cogl_object_ref() should be used in new code.
*/
void *
cogl_offscreen_ref (void *offscreen) G_GNUC_DEPRECATED;
cogl_offscreen_ref (void *offscreen) COGL_DEPRECATED_FOR (cogl_object_ref);
/**
* cogl_offscreen_unref:
@ -108,9 +106,7 @@ cogl_offscreen_ref (void *offscreen) G_GNUC_DEPRECATED;
* Deprecated: 1.2: cogl_object_unref() should be used in new code.
*/
void
cogl_offscreen_unref (void *offscreen) G_GNUC_DEPRECATED;
#endif /* COGL_DISABLE_DEPRECATED */
cogl_offscreen_unref (void *offscreen) COGL_DEPRECATED_FOR (cogl_object_unref);
COGL_END_DECLS

10
cogl/cogl-onscreen.h
View File

@ -546,12 +546,13 @@ typedef void (*CoglSwapBuffersNotify) (CoglFramebuffer *framebuffer,
* the callback later.
* Since: 1.10
* Stability: unstable
* Deprecated: 1.14: Use cogl_onscreen_add_swap_complete_callback
* Deprecated: 1.14: Use cogl_onscreen_add_frame_callback() instead
*/
unsigned int
cogl_onscreen_add_swap_buffers_callback (CoglOnscreen *onscreen,
CoglSwapBuffersNotify callback,
void *user_data);
void *user_data)
COGL_DEPRECATED_IN_1_14_FOR (cogl_onscreen_add_frame_callback);
/**
* cogl_onscreen_remove_swap_buffers_callback:
@ -563,11 +564,12 @@ cogl_onscreen_add_swap_buffers_callback (CoglOnscreen *onscreen,
*
* Since: 1.10
* Stability: unstable
* Deprecated: 1.14: Use cogl_onscreen_remove_swap_complete_callback
* Deprecated: 1.14: Use cogl_onscreen_remove_frame_callback() instead
*/
void
cogl_onscreen_remove_swap_buffers_callback (CoglOnscreen *onscreen,
unsigned int id);
unsigned int id)
COGL_DEPRECATED_IN_1_14_FOR (cogl_onscreen_remove_frame_callback);
/**
* cogl_onscreen_set_resizable:

138
cogl/cogl-shader.h
View File

@ -30,6 +30,7 @@
#include <cogl/cogl-types.h>
#include <cogl/cogl-defines.h>
#include <cogl/cogl-macros.h>
COGL_BEGIN_DECLS
@ -239,11 +240,11 @@ typedef enum {
* source code to be used on it.
*
* Returns: a new shader handle.
* Deprecated: 1.16: Use #CoglSnippet api
*/
CoglHandle
cogl_create_shader (CoglShaderType shader_type);
#ifndef COGL_DISABLE_DEPRECATED
cogl_create_shader (CoglShaderType shader_type)
COGL_DEPRECATED_IN_1_16_FOR (cogl_snippet_);
/**
* cogl_shader_ref:
@ -251,12 +252,12 @@ cogl_create_shader (CoglShaderType shader_type);
*
* Add an extra reference to a shader.
*
* Deprecated: 1.0: Please use cogl_handle_ref() instead.
*
* Returns: @handle
* Deprecated: 1.16: Use #CoglSnippet api
*/
CoglHandle
cogl_shader_ref (CoglHandle handle) G_GNUC_DEPRECATED;
cogl_shader_ref (CoglHandle handle)
COGL_DEPRECATED_IN_1_16_FOR (cogl_snippet_);
/**
* cogl_shader_unref:
@ -265,12 +266,11 @@ cogl_shader_ref (CoglHandle handle) G_GNUC_DEPRECATED;
* Removes a reference to a shader. If it was the last reference the
* shader object will be destroyed.
*
* Deprecated: 1.0: Please use cogl_handle_unref() instead.
* Deprecated: 1.16: Use #CoglSnippet api
*/
void
cogl_shader_unref (CoglHandle handle) G_GNUC_DEPRECATED;
#endif /* COGL_DISABLE_DEPRECATED */
cogl_shader_unref (CoglHandle handle)
COGL_DEPRECATED_IN_1_16_FOR (cogl_snippet_);
/**
* cogl_is_shader:
@ -280,9 +280,11 @@ cogl_shader_unref (CoglHandle handle) G_GNUC_DEPRECATED;
*
* Returns: %TRUE if the handle references a shader,
* %FALSE otherwise
* Deprecated: 1.16: Use #CoglSnippet api
*/
CoglBool
cogl_is_shader (CoglHandle handle);
cogl_is_shader (CoglHandle handle)
COGL_DEPRECATED_IN_1_16_FOR (cogl_snippet_);
/**
* cogl_shader_source:
@ -295,10 +297,13 @@ cogl_is_shader (CoglHandle handle);
* Please see <link
* linkend="cogl-Shaders-and-Programmable-Pipeline.description">above</link>
* for a description of the recommended format for the shader code.
* Deprecated: 1.16: Use #CoglSnippet api
*/
void
cogl_shader_source (CoglHandle shader,
const char *source);
const char *source)
COGL_DEPRECATED_IN_1_16_FOR (cogl_snippet_);
/**
* cogl_shader_compile:
* @handle: #CoglHandle for a shader.
@ -307,9 +312,11 @@ cogl_shader_source (CoglHandle shader,
* for linking into a program. Note that calling this function is
* optional. If it is not called then the shader will be automatically
* compiled when it is linked.
* Deprecated: 1.16: Use #CoglSnippet api
*/
void
cogl_shader_compile (CoglHandle handle);
cogl_shader_compile (CoglHandle handle)
COGL_DEPRECATED_IN_1_16_FOR (cogl_snippet_);
/**
* cogl_shader_get_info_log:
@ -322,9 +329,11 @@ cogl_shader_compile (CoglHandle handle);
*
* Return value: a newly allocated string containing the info log. Use
* g_free() to free it
* Deprecated: 1.16: Use #CoglSnippet api
*/
char *
cogl_shader_get_info_log (CoglHandle handle);
cogl_shader_get_info_log (CoglHandle handle)
COGL_DEPRECATED_IN_1_16_FOR (cogl_snippet_);
/**
* cogl_shader_get_type:
@ -334,9 +343,11 @@ cogl_shader_get_info_log (CoglHandle handle);
*
* Return value: %COGL_SHADER_TYPE_VERTEX if the shader is a vertex processor
* or %COGL_SHADER_TYPE_FRAGMENT if the shader is a frament processor
* Deprecated: 1.16: Use #CoglSnippet api
*/
CoglShaderType
cogl_shader_get_type (CoglHandle handle);
cogl_shader_get_type (CoglHandle handle)
COGL_DEPRECATED_IN_1_16_FOR (cogl_snippet_);
/**
* cogl_shader_is_compiled:
@ -345,9 +356,11 @@ cogl_shader_get_type (CoglHandle handle);
* Retrieves whether a shader #CoglHandle has been compiled
*
* Return value: %TRUE if the shader object has sucessfully be compiled
* Deprecated: 1.16: Use #CoglSnippet api
*/
CoglBool
cogl_shader_is_compiled (CoglHandle handle);
cogl_shader_is_compiled (CoglHandle handle)
COGL_DEPRECATED_IN_1_16_FOR (cogl_snippet_);
/**
* cogl_create_program:
@ -356,11 +369,11 @@ cogl_shader_is_compiled (CoglHandle handle);
* rendering pipeline with custom code.
*
* Returns: a new cogl program.
* Deprecated: 1.16: Use #CoglSnippet api
*/
CoglHandle
cogl_create_program (void);
#ifndef COGL_DISABLE_DEPRECATED
cogl_create_program (void)
COGL_DEPRECATED_IN_1_16_FOR (cogl_snippet_);
/**
* cogl_program_ref:
@ -368,12 +381,14 @@ cogl_create_program (void);
*
* Add an extra reference to a program.
*
* Deprecated: 1.0: Please use cogl_handle_ref() instead.
* Deprecated: 1.0: Please use cogl_object_ref() instead.
*
* Returns: @handle
* Deprecated: 1.16: Use #CoglSnippet api
*/
CoglHandle
cogl_program_ref (CoglHandle handle) G_GNUC_DEPRECATED;
cogl_program_ref (CoglHandle handle)
COGL_DEPRECATED_IN_1_16_FOR (cogl_snippet_);
/**
* cogl_program_unref:
@ -382,12 +397,12 @@ cogl_program_ref (CoglHandle handle) G_GNUC_DEPRECATED;
* Removes a reference to a program. If it was the last reference the
* program object will be destroyed.
*
* Deprecated: 1.0: Please use cogl_handle_unref() instead.
* Deprecated: 1.16: Use #CoglSnippet api
*/
void
cogl_program_unref (CoglHandle handle) G_GNUC_DEPRECATED;
#endif /* COGL_DISABLE_DEPRECATED */
cogl_program_unref (CoglHandle handle)
COGL_DEPRECATED_IN_1_4_FOR (cogl_object_unref)
COGL_DEPRECATED_IN_1_16_FOR (cogl_snippet_);
/**
* cogl_is_program:
@ -397,9 +412,12 @@ cogl_program_unref (CoglHandle handle) G_GNUC_DEPRECATED;
*
* Returns: %TRUE if the handle references a program,
* %FALSE otherwise
*
* Deprecated: 1.16: Use #CoglSnippet api
*/
CoglBool
cogl_is_program (CoglHandle handle);
cogl_is_program (CoglHandle handle)
COGL_DEPRECATED_IN_1_16_FOR (cogl_snippet_);
/**
* cogl_program_attach_shader:
@ -410,10 +428,13 @@ cogl_is_program (CoglHandle handle);
* vertex or fragment shaders but only one of them may provide a
* main() function. It is allowed to use a program with only a vertex
* shader or only a fragment shader.
*
* Deprecated: 1.16: Use #CoglSnippet api
*/
void
cogl_program_attach_shader (CoglHandle program_handle,
CoglHandle shader_handle);
CoglHandle shader_handle)
COGL_DEPRECATED_IN_1_16_FOR (cogl_snippet_);
/**
* cogl_program_link:
@ -422,9 +443,12 @@ cogl_program_attach_shader (CoglHandle program_handle,
* Links a program making it ready for use. Note that calling this
* function is optional. If it is not called the program will
* automatically be linked the first time it is used.
*
* Deprecated: 1.16: Use #CoglSnippet api
*/
void
cogl_program_link (CoglHandle handle);
cogl_program_link (CoglHandle handle)
COGL_DEPRECATED_IN_1_16_FOR (cogl_snippet_);
/**
* cogl_program_use:
@ -438,9 +462,12 @@ cogl_program_link (CoglHandle handle);
* context. It is much more efficient to attach the shader to a
* specific material used for rendering instead by calling
* cogl_material_set_user_program().
*
* Deprecated: 1.16: Use #CoglSnippet api
*/
void
cogl_program_use (CoglHandle handle);
cogl_program_use (CoglHandle handle)
COGL_DEPRECATED_IN_1_16_FOR (cogl_snippet_);
/**
* cogl_program_get_uniform_location:
@ -454,10 +481,12 @@ cogl_program_use (CoglHandle handle);
* Return value: the offset of a uniform in a specified program.
* This uniform can be set using cogl_program_uniform_1f() when the
* program is in use.
* Deprecated: 1.16: Use #CoglSnippet api instead
*/
int
cogl_program_get_uniform_location (CoglHandle handle,
const char *uniform_name);
const char *uniform_name)
COGL_DEPRECATED_IN_1_16_FOR (cogl_snippet_);
/**
* cogl_program_set_uniform_1f:
@ -470,11 +499,13 @@ cogl_program_get_uniform_location (CoglHandle handle,
* @program.
*
* Since: 1.4
* Deprecated: 1.16: Use #CoglSnippet api instead
*/
void
cogl_program_set_uniform_1f (CoglHandle program,
int uniform_location,
float value);
float value)
COGL_DEPRECATED_IN_1_16_FOR (cogl_snippet_);
/**
* cogl_program_set_uniform_1i:
@ -487,11 +518,13 @@ cogl_program_set_uniform_1f (CoglHandle program,
* @program.
*
* Since: 1.4
* Deprecated: 1.16: Use #CoglSnippet api instead
*/
void
cogl_program_set_uniform_1i (CoglHandle program,
int uniform_location,
int value);
int value)
COGL_DEPRECATED_IN_1_16_FOR (cogl_snippet_);
/**
* cogl_program_set_uniform_float:
@ -508,13 +541,15 @@ cogl_program_set_uniform_1i (CoglHandle program,
* the given linked @program.
*
* Since: 1.4
* Deprecated: 1.16: Use #CoglSnippet api instead
*/
void
cogl_program_set_uniform_float (CoglHandle program,
int uniform_location,
int n_components,
int count,
const float *value);
const float *value)
COGL_DEPRECATED_IN_1_16_FOR (cogl_snippet_);
/**
* cogl_program_set_uniform_int:
@ -531,13 +566,15 @@ cogl_program_set_uniform_float (CoglHandle program,
* the given linked @program.
*
* Since: 1.4
* Deprecated: 1.16: Use #CoglSnippet api instead
*/
void
cogl_program_set_uniform_int (CoglHandle program,
int uniform_location,
int n_components,
int count,
const int *value);
const int *value)
COGL_DEPRECATED_IN_1_16_FOR (cogl_snippet_);
/**
* cogl_program_set_uniform_matrix:
@ -555,6 +592,7 @@ cogl_program_set_uniform_int (CoglHandle program,
* given linked @program.
*
* Since: 1.4
* Deprecated: 1.16: Use #CoglSnippet api instead
*/
void
cogl_program_set_uniform_matrix (CoglHandle program,
@ -562,9 +600,8 @@ cogl_program_set_uniform_matrix (CoglHandle program,
int dimensions,
int count,
CoglBool transpose,
const float *value);
#ifndef COGL_DISABLE_DEPRECATED
const float *value)
COGL_DEPRECATED_IN_1_16_FOR (cogl_snippet_);
/**
* cogl_program_uniform_1f:
@ -574,11 +611,12 @@ cogl_program_set_uniform_matrix (CoglHandle program,
* Changes the value of a floating point uniform in the currently
* used (see cogl_program_use()) shader program.
*
* Deprecated: 1.4: Use cogl_program_set_uniform_1f() instead.
* Deprecated: 1.16: Use #CoglSnippet api
*/
void
cogl_program_uniform_1f (int uniform_no,
float value) G_GNUC_DEPRECATED;
float value)
COGL_DEPRECATED_IN_1_16_FOR (cogl_snippet_);
/**
* cogl_program_uniform_1i:
@ -588,11 +626,12 @@ cogl_program_uniform_1f (int uniform_no,
* Changes the value of an integer uniform in the currently
* used (see cogl_program_use()) shader program.
*
* Deprecated: 1.4: Use cogl_program_set_uniform_1i() instead.
* Deprecated: 1.16: Use #CoglSnippet api
*/
void
cogl_program_uniform_1i (int uniform_no,
int value) G_GNUC_DEPRECATED;
int value)
COGL_DEPRECATED_IN_1_16_FOR (cogl_snippet_);
/**
* cogl_program_uniform_float:
@ -604,13 +643,14 @@ cogl_program_uniform_1i (int uniform_no,
* Changes the value of a float vector uniform, or uniform array in the
* currently used (see cogl_program_use()) shader program.
*
* Deprecated: 1.4: Use cogl_program_set_uniform_float() instead.
* Deprecated: 1.16: Use #CoglSnippet api
*/
void
cogl_program_uniform_float (int uniform_no,
int size,
int count,
const float *value) G_GNUC_DEPRECATED;
const float *value)
COGL_DEPRECATED_IN_1_16_FOR (cogl_snippet_);
/**
* cogl_program_uniform_int:
@ -621,12 +661,15 @@ cogl_program_uniform_float (int uniform_no,
*
* Changes the value of a int vector uniform, or uniform array in the
* currently used (see cogl_program_use()) shader program.
*
* Deprecated: 1.16: Use #CoglSnippet api
*/
void
cogl_program_uniform_int (int uniform_no,
int size,
int count,
const int *value) G_GNUC_DEPRECATED;
const int *value)
COGL_DEPRECATED_IN_1_16_FOR (cogl_snippet_);
/**
* cogl_program_uniform_matrix:
@ -639,15 +682,16 @@ cogl_program_uniform_int (int uniform_no,
* Changes the value of a matrix uniform, or uniform array in the
* currently used (see cogl_program_use()) shader program. The @size
* parameter is used to determine the square size of the matrix.
*
* Deprecated: 1.16: Use #CoglSnippet api
*/
void
cogl_program_uniform_matrix (int uniform_no,
int size,
int count,
CoglBool transpose,
const float *value) G_GNUC_DEPRECATED;
#endif /* COGL_DISABLE_DEPRECATED */
const float *value)
COGL_DEPRECATED_IN_1_16_FOR (cogl_snippet_);
COGL_END_DECLS

10
cogl/cogl-texture.h
View File

@ -315,7 +315,7 @@ cogl_texture_get_format (CoglTexture *texture);
* a mistake that it was ever published.
*/
unsigned int
cogl_texture_get_rowstride (CoglTexture *texture);
cogl_texture_get_rowstride (CoglTexture *texture) COGL_DEPRECATED_IN_1_10;
/**
* cogl_texture_get_max_waste:
@ -556,8 +556,6 @@ cogl_texture_new_from_sub_texture (CoglTexture *full_texture,
int sub_width,
int sub_height);
#ifndef COGL_DISABLE_DEPRECATED
/**
* cogl_texture_ref:
* @texture: a #CoglTexture.
@ -569,7 +567,7 @@ cogl_texture_new_from_sub_texture (CoglTexture *full_texture,
* Return value: the @texture pointer.
*/
void *
cogl_texture_ref (void *texture) G_GNUC_DEPRECATED;
cogl_texture_ref (void *texture) COGL_DEPRECATED_FOR (cogl_object_ref);
/**
* cogl_texture_unref:
@ -580,9 +578,7 @@ cogl_texture_ref (void *texture) G_GNUC_DEPRECATED;
* Deprecated: 1.2: Use cogl_object_unref() instead
*/
void
cogl_texture_unref (void *texture) G_GNUC_DEPRECATED;
#endif /* COGL_DISABLE_DEPRECATED */
cogl_texture_unref (void *texture) COGL_DEPRECATED_FOR (cogl_object_unref);
/**
* cogl_texture_allocate:

153
cogl/cogl-version.h
View File

@ -3,7 +3,7 @@
*
* An object oriented GL/GLES Abstraction/Utility Layer
*
* Copyright (C) 2012 Intel Corporation.
* Copyright (C) 2012,2013 Intel Corporation.
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
@ -16,7 +16,8 @@
* 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/>.
* License along with this library. If not, see
* <http://www.gnu.org/licenses/>.
*
*
*/
@ -33,7 +34,39 @@
* Cogl offers a set of macros for checking the version of the library
* at compile time.
*
* Since: 1.12.0
* Cogl adds version information to both API deprecations and additions;
* by definining the macros %COGL_VERSION_MIN_REQUIRED and
* %COGL_VERSION_MAX_ALLOWED, you can specify the range of Cogl versions
* whose API you want to use. Functions that were deprecated before, or
* introduced after, this range will trigger compiler warnings. For instance,
* if we define the following symbols:
*
* |[
* COGL_VERSION_MIN_REQUIRED = COGL_VERSION_1_6
* COGL_VERSION_MAX_ALLOWED = COGL_VERSION_1_8
* ]|
*
* and we have the following functions annotated in the Cogl headers:
*
* |[
* void cogl_function_A (void) COGL_DEPRECATED_IN_1_4;
* void cogl_function_B (void) COGL_DEPRECATED_IN_1_6;
* void cogl_function_C (void) COGL_AVAILABLE_IN_1_8;
* void cogl_function_D (void) COGL_AVAILABLE_IN_1_10;
* ]|
*
* then any application code using the functions above will get the output:
*
* |[
* cogl_function_A: deprecation warning
* cogl_function_B: no warning
* cogl_function_C: no warning
* cogl_function_D: symbol not available warning
* ]|
*
* It is possible to disable the compiler warnings by defining the macro
* %COGL_DISABLE_DEPRECATION_WARNINGS before including the cogl.h
* header.
*/
/**
@ -182,4 +215,118 @@
#define COGL_VERSION_CHECK(major, minor, micro) \
(COGL_VERSION >= COGL_VERSION_ENCODE (major, minor, micro))
/**
* COGL_VERSION_1_0:
*
* A macro that evaluates to the 1.0 version of Cogl, in a format
* that can be used by the C pre-processor.
*
* Since: 1.16
*/
#define COGL_VERSION_1_0 (COGL_VERSION_ENCODE (1, 0, 0))
/**
* COGL_VERSION_1_2:
*
* A macro that evaluates to the 1.2 version of Cogl, in a format
* that can be used by the C pre-processor.
*
* Since: 1.16
*/
#define COGL_VERSION_1_2 (COGL_VERSION_ENCODE (1, 2, 0))
/**
* COGL_VERSION_1_4:
*
* A macro that evaluates to the 1.4 version of Cogl, in a format
* that can be used by the C pre-processor.
*
* Since: 1.16
*/
#define COGL_VERSION_1_4 (COGL_VERSION_ENCODE (1, 4, 0))
/**
* COGL_VERSION_1_6:
*
* A macro that evaluates to the 1.6 version of Cogl, in a format
* that can be used by the C pre-processor.
*
* Since: 1.16
*/
#define COGL_VERSION_1_6 (COGL_VERSION_ENCODE (1, 6, 0))
/**
* COGL_VERSION_1_8:
*
* A macro that evaluates to the 1.8 version of Cogl, in a format
* that can be used by the C pre-processor.
*
* Since: 1.16
*/
#define COGL_VERSION_1_8 (COGL_VERSION_ENCODE (1, 8, 0))
/**
* COGL_VERSION_1_10:
*
* A macro that evaluates to the 1.10 version of Cogl, in a format
* that can be used by the C pre-processor.
*
* Since: 1.16
*/
#define COGL_VERSION_1_10 (COGL_VERSION_ENCODE (1, 10, 0))
/**
* COGL_VERSION_1_12:
*
* A macro that evaluates to the 1.12 version of Cogl, in a format
* that can be used by the C pre-processor.
*
* Since: 1.16
*/
#define COGL_VERSION_1_12 (COGL_VERSION_ENCODE (1, 12, 0))
/**
* COGL_VERSION_1_14:
*
* A macro that evaluates to the 1.14 version of Cogl, in a format
* that can be used by the C pre-processor.
*
* Since: 1.16
*/
#define COGL_VERSION_1_14 (COGL_VERSION_ENCODE (1, 14, 0))
/**
* COGL_VERSION_1_16:
*
* A macro that evaluates to the 1.16 version of Cogl, in a format
* that can be used by the C pre-processor.
*
* Since: 1.16
*/
#define COGL_VERSION_1_16 (COGL_VERSION_ENCODE (1, 16, 0))
/* evaluates to the current stable version; for development cycles,
* this means the next stable target
*/
#if (COGL_VERSION_MINOR_INTERNAL % 2)
#define COGL_VERSION_CURRENT_STABLE \
(COGL_VERSION_ENCODE (COGL_VERSION_MAJOR_INTERNAL, \
COGL_VERSION_MINOR_INTERNAL + 1, 0))
#else
#define COGL_VERSION_CURRENT_STABLE \
(COGL_VERSION_ENCODE (COGL_VERSION_MAJOR_INTERNAL, \
COGL_VERSION_MINOR_INTERNAL, 0))
#endif
/* evaluates to the previous stable version */
#if (COGL_VERSION_MINOR_INTERNAL % 2)
#define COGL_VERSION_PREVIOUS_STABLE \
(COGL_VERSION_ENCODE (COGL_VERSION_MAJOR_INTERNAL, \
COGL_VERSION_MINOR_INTERNAL - 1, 0))
#else
#define COGL_VERSION_PREVIOUS_STABLE \
(COGL_VERSION_ENCODE (COGL_VERSION_MAJOR_INTERNAL, \
COGL_VERSION_MINOR_INTERNAL - 2, 0))
#endif
#endif /* __COGL_VERSION_H__ */

80
cogl/cogl-vertex-buffer.h
View File

@ -34,6 +34,7 @@
#include <glib.h>
#include <cogl/cogl-defines.h>
#include <cogl/cogl-types.h>
#include <cogl/cogl-macros.h>
COGL_BEGIN_DECLS
@ -82,9 +83,11 @@ COGL_BEGIN_DECLS
* Creates a new vertex buffer that you can use to add attributes.
*
* Return value: a new #CoglHandle
* Deprecated: 1.16: Use the #CoglPrimitive api instead
*/
CoglHandle
cogl_vertex_buffer_new (unsigned int n_vertices);
cogl_vertex_buffer_new (unsigned int n_vertices)
COGL_DEPRECATED_IN_1_16_FOR (cogl_primitive_API);
/**
* cogl_vertex_buffer_get_n_vertices:
@ -93,9 +96,11 @@ cogl_vertex_buffer_new (unsigned int n_vertices);
* Retrieves the number of vertices that @handle represents
*
* Return value: the number of vertices
* Deprecated: 1.16: Use the #CoglPrimitive api instead
*/
unsigned int
cogl_vertex_buffer_get_n_vertices (CoglHandle handle);
cogl_vertex_buffer_get_n_vertices (CoglHandle handle)
COGL_DEPRECATED_IN_1_16_FOR (cogl_primitive_API);
/**
* cogl_vertex_buffer_add:
@ -159,6 +164,8 @@ cogl_vertex_buffer_get_n_vertices (CoglHandle handle);
* |- - - - -0-0-0-0-0-0 0 0 0 0|
* </programlisting>
* (Though you can have multiple groups of interleved attributes)</note>
*
* Deprecated: 1.16: Use the #CoglPrimitive api instead
*/
void
cogl_vertex_buffer_add (CoglHandle handle,
@ -167,7 +174,8 @@ cogl_vertex_buffer_add (CoglHandle handle,
CoglAttributeType type,
CoglBool normalized,
uint16_t stride,
const void *pointer);
const void *pointer)
COGL_DEPRECATED_IN_1_16_FOR (cogl_primitive_API);
/**
* cogl_vertex_buffer_delete:
@ -177,10 +185,13 @@ cogl_vertex_buffer_add (CoglHandle handle,
* Deletes an attribute from a buffer. You will need to call
* cogl_vertex_buffer_submit() or issue a draw call to commit this
* change to the GPU.
*
* Deprecated: 1.16: Use the #CoglPrimitive api instead
*/
void
cogl_vertex_buffer_delete (CoglHandle handle,
const char *attribute_name);
const char *attribute_name)
COGL_DEPRECATED_IN_1_16_FOR (cogl_primitive_API);
/**
* cogl_vertex_buffer_submit:
@ -193,9 +204,12 @@ cogl_vertex_buffer_delete (CoglHandle handle,
* validating your data; it potentially incurs a transport cost (especially if
* you are using GLX indirect rendering) and potentially a format conversion
* cost if the GPU doesn't natively support any of the given attribute formats.
*
* Deprecated: 1.16: Use the #CoglPrimitive api instead
*/
void
cogl_vertex_buffer_submit (CoglHandle handle);
cogl_vertex_buffer_submit (CoglHandle handle)
COGL_DEPRECATED_IN_1_16_FOR (cogl_primitive_API);
/**
* cogl_vertex_buffer_disable:
@ -210,10 +224,13 @@ cogl_vertex_buffer_submit (CoglHandle handle);
*
* You don't need to call cogl_vertex_buffer_submit() after using this
* function.
*
* Deprecated: 1.16: Use the #CoglPrimitive api instead
*/
void
cogl_vertex_buffer_disable (CoglHandle handle,
const char *attribute_name);
const char *attribute_name)
COGL_DEPRECATED_IN_1_16_FOR (cogl_primitive_API);
/**
* cogl_vertex_buffer_enable:
@ -227,10 +244,13 @@ cogl_vertex_buffer_disable (CoglHandle handle,
* attributes before using a buffer for drawing.
*
* You don't need to call cogl_vertex_buffer_submit() after using this function
*
* Deprecated: 1.16: Use the #CoglPrimitive api instead
*/
void
cogl_vertex_buffer_enable (CoglHandle handle,
const char *attribute_name);
const char *attribute_name)
COGL_DEPRECATED_IN_1_16_FOR (cogl_primitive_API);
/**
* cogl_vertex_buffer_draw:
@ -245,12 +265,15 @@ cogl_vertex_buffer_enable (CoglHandle handle,
*
* Any un-submitted attribute changes are automatically submitted before
* drawing.
*
* Deprecated: 1.16: Use the #CoglPrimitive api instead
*/
void
cogl_vertex_buffer_draw (CoglHandle handle,
CoglVerticesMode mode,
int first,
int count);
int count)
COGL_DEPRECATED_IN_1_16_FOR (cogl_primitive_API);
/**
* cogl_vertex_buffer_indices_new:
@ -267,11 +290,14 @@ cogl_vertex_buffer_draw (CoglHandle handle,
*
* Return value: A CoglHandle for the indices which you can pass to
* cogl_vertex_buffer_draw_elements().
*
* Deprecated: 1.16: Use the #CoglPrimitive api instead
*/
CoglHandle
cogl_vertex_buffer_indices_new (CoglIndicesType indices_type,
const void *indices_array,
int indices_len);
int indices_len)
COGL_DEPRECATED_IN_1_16_FOR (cogl_primitive_API);
/**
* cogl_vertex_buffer_indices_get_type:
@ -280,9 +306,12 @@ cogl_vertex_buffer_indices_new (CoglIndicesType indices_type,
* Queries back the data type used for the given indices
*
* Returns: The CoglIndicesType used
*
* Deprecated: 1.16: Use the #CoglPrimitive api instead
*/
CoglIndicesType
cogl_vertex_buffer_indices_get_type (CoglHandle indices);
cogl_vertex_buffer_indices_get_type (CoglHandle indices)
COGL_DEPRECATED_IN_1_16_FOR (cogl_primitive_API);
/**
* cogl_vertex_buffer_draw_elements:
@ -303,6 +332,7 @@ cogl_vertex_buffer_indices_get_type (CoglHandle indices);
*
* Any un-submitted attribute changes are automatically submitted before
* drawing.
* Deprecated: 1.16: Use the #CoglPrimitive api instead
*/
void
cogl_vertex_buffer_draw_elements (CoglHandle handle,
@ -311,9 +341,8 @@ cogl_vertex_buffer_draw_elements (CoglHandle handle,
int min_index,
int max_index,
int indices_offset,
int count);
#ifndef COGL_DISABLE_DEPRECATED
int count)
COGL_DEPRECATED_IN_1_16_FOR (cogl_primitive_API);
/**
* cogl_vertex_buffer_ref:
@ -323,10 +352,11 @@ cogl_vertex_buffer_draw_elements (CoglHandle handle,
*
* Return value: the @handle.
*
* Deprecated: 1.2: Use cogl_handle_ref() instead
* Deprecated: 1.2: Use cogl_object_ref() instead
*/
CoglHandle
cogl_vertex_buffer_ref (CoglHandle handle) G_GNUC_DEPRECATED;
cogl_vertex_buffer_ref (CoglHandle handle)
COGL_DEPRECATED_FOR (cogl_object_ref);
/**
* cogl_vertex_buffer_unref:
@ -334,12 +364,11 @@ cogl_vertex_buffer_ref (CoglHandle handle) G_GNUC_DEPRECATED;
*
* Decrement the reference count for a vertex buffer
*
* Deprecated: 1.2: Use cogl_handle_unref() instead
* Deprecated: 1.2: Use cogl_object_unref() instead
*/
void
cogl_vertex_buffer_unref (CoglHandle handle) G_GNUC_DEPRECATED;
#endif /* COGL_DISABLE_DEPRECATED */
cogl_vertex_buffer_unref (CoglHandle handle)
COGL_DEPRECATED_FOR (cogl_object_unref);
/**
* cogl_vertex_buffer_indices_get_for_quads:
@ -371,9 +400,12 @@ cogl_vertex_buffer_unref (CoglHandle handle) G_GNUC_DEPRECATED;
*
* Returns: A %CoglHandle containing the indices. The handled is
* owned by Cogl and should not be modified or unref'd.
*
* Deprecated: 1.16: Use the #CoglPrimitive api instead
*/
CoglHandle
cogl_vertex_buffer_indices_get_for_quads (unsigned int n_indices);
cogl_vertex_buffer_indices_get_for_quads (unsigned int n_indices)
COGL_DEPRECATED_IN_1_16_FOR (cogl_primitive_API);
/**
* cogl_is_vertex_buffer:
@ -385,9 +417,11 @@ cogl_vertex_buffer_indices_get_for_quads (unsigned int n_indices);
* otherwise
*
* Since: 1.0
* Deprecated: 1.16: Use the #CoglPrimitive api instead
*/
CoglBool
cogl_is_vertex_buffer (CoglHandle handle);
cogl_is_vertex_buffer (CoglHandle handle)
COGL_DEPRECATED_IN_1_16_FOR (cogl_primitive_API);
/**
* cogl_is_vertex_buffer_indices:
@ -400,9 +434,11 @@ cogl_is_vertex_buffer (CoglHandle handle);
* otherwise
*
* Since: 1.4
* Deprecated: 1.16: Use the #CoglPrimitive api instead
*/
CoglBool
cogl_is_vertex_buffer_indices (CoglHandle handle);
cogl_is_vertex_buffer_indices (CoglHandle handle)
COGL_DEPRECATED_IN_1_16_FOR (cogl_primitive_API);
COGL_END_DECLS

14
cogl/cogl-xlib.h
View File

@ -32,6 +32,7 @@
#include <cogl/cogl-types.h>
#include <cogl/cogl-clutter-xlib.h>
#include <cogl/cogl-xlib-renderer.h>
#include <cogl/cogl-macros.h>
COGL_BEGIN_DECLS
@ -43,9 +44,11 @@ COGL_BEGIN_DECLS
* before this function is called.
*
* Stability: Unstable
* Deprecated: 1.16: Use cogl_xlib_renderer_get_display() instead
*/
Display *
cogl_xlib_get_display (void);
cogl_xlib_get_display (void)
COGL_DEPRECATED_IN_1_16_FOR (cogl_xlib_renderer_get_display);
/*
* cogl_xlib_set_display:
@ -55,9 +58,12 @@ cogl_xlib_get_display (void);
* more complete winsys abstraction.
*
* Stability: Unstable
* Deprecated: 1.16: Use cogl_xlib_renderer_set_foreign_display()
* instead
*/
void
cogl_xlib_set_display (Display *display);
cogl_xlib_set_display (Display *display)
COGL_DEPRECATED_IN_1_16_FOR (cogl_xlib_renderer_set_foreign_display);
/*
* cogl_xlib_handle_event:
@ -75,9 +81,11 @@ cogl_xlib_set_display (Display *display);
* any exclusive action.
*
* Stability: Unstable
* Deprecated: 1.16: Use cogl_xlib_renderer_handle_event() instead
*/
CoglFilterReturn
cogl_xlib_handle_event (XEvent *xevent);
cogl_xlib_handle_event (XEvent *xevent)
COGL_DEPRECATED_IN_1_16_FOR (cogl_xlib_renderer_handle_event);
COGL_END_DECLS

6
cogl/cogl.c
View File

@ -21,15 +21,15 @@
*
*/
#ifdef HAVE_CONFIG_H
#include "config.h"
#endif
#include <config.h>
#include <string.h>
#include <math.h>
#include <stdlib.h>
#include <glib/gi18n-lib.h>
#define COGL_VERSION_MIN_REQUIRED COGL_VERSION_1_4
#include "cogl-debug.h"
#include "cogl-util.h"
#include "cogl-context-private.h"

2
cogl/cogl.h
View File

@ -44,6 +44,8 @@
*/
#include <cogl/cogl-defines.h>
#include <cogl/cogl-macros.h>
#include <cogl/cogl-error.h>
#include <cogl/cogl-object.h>

293
cogl/cogl1-context.h
View File

@ -34,6 +34,7 @@
#include <cogl/cogl-types.h>
#include <cogl/cogl-texture.h>
#include <cogl/cogl-framebuffer.h>
#include <cogl/cogl-macros.h>
COGL_BEGIN_DECLS
@ -47,9 +48,10 @@ COGL_BEGIN_DECLS
* Return value: a #GOptionGroup
*
* Since: 1.0
* Deprecated: 1.16: Not replaced
*/
GOptionGroup *
cogl_get_option_group (void);
cogl_get_option_group (void) COGL_DEPRECATED_IN_1_16;
/* Misc */
/**
@ -60,9 +62,11 @@ cogl_get_option_group (void);
* Return value: A logical OR of all the supported COGL features.
*
* Since: 0.8
* Deprecated: 1.10: Use cogl_foreach_feature() instead
*/
CoglFeatureFlags
cogl_get_features (void);
cogl_get_features (void)
COGL_DEPRECATED_IN_1_10_FOR (cogl_foreach_feature);
/**
* cogl_features_available:
@ -74,9 +78,11 @@ cogl_get_features (void);
* are available.
*
* Return value: %TRUE if the features are available, %FALSE otherwise.
* Deprecated: 1.10: Use cogl_has_feature() instead
*/
CoglBool
cogl_features_available (CoglFeatureFlags features);
cogl_features_available (CoglFeatureFlags features)
COGL_DEPRECATED_IN_1_10_FOR (cogl_has_feature);
/**
* cogl_get_proc_address:
@ -96,8 +102,6 @@ cogl_features_available (CoglFeatureFlags features);
CoglFuncPtr
cogl_get_proc_address (const char *name);
#ifndef COGL_DISABLE_DEPRECATED
/**
* cogl_check_extension:
* @name: extension to check for
@ -116,9 +120,7 @@ cogl_get_proc_address (const char *name);
*/
CoglBool
cogl_check_extension (const char *name,
const char *ext) G_GNUC_DEPRECATED;
#endif /* COGL_DISABLE_DEPRECATED */
const char *ext) COGL_DEPRECATED;
/**
* cogl_get_bitmasks:
@ -130,12 +132,16 @@ cogl_check_extension (const char *name,
* 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.
*
* Deprecated: 1.8: Use cogl_framebuffer_get_red/green/blue/alpha_bits()
* instead
*/
void
cogl_get_bitmasks (int *red,
int *green,
int *blue,
int *alpha);
int *alpha)
COGL_DEPRECATED_IN_1_8_FOR (cogl_framebuffer_get_red_OR_green_OR_blue_OR_alpha_bits);
/**
* cogl_perspective:
@ -151,12 +157,15 @@ cogl_get_bitmasks (int *red,
* ratio since that will reduce the effectiveness of depth testing
* since there wont be enough precision to identify the depth of
* objects near to each other.</note>
*
* Deprecated: 1.10: Use cogl_framebuffer_perspective() instead
*/
void
cogl_perspective (float fovy,
float aspect,
float z_near,
float z_far);
float z_far)
COGL_DEPRECATED_IN_1_10_FOR (cogl_framebuffer_perspective);
/**
* cogl_frustum:
@ -176,6 +185,7 @@ cogl_perspective (float fovy,
* all cross through the origin and 2 near and far clip planes.
*
* Since: 0.8.2
* Deprecated: 1.10: Use cogl_framebuffer_frustum() instead
*/
void
cogl_frustum (float left,
@ -183,7 +193,8 @@ cogl_frustum (float left,
float bottom,
float top,
float z_near,
float z_far);
float z_far)
COGL_DEPRECATED_IN_1_10_FOR (cogl_framebuffer_frustum);
/**
* cogl_ortho:
@ -213,6 +224,7 @@ cogl_frustum (float left,
* left, right bottom and top arguments.</note>
*
* Since: 1.0
* Deprecated: 1.10: Use cogl_framebuffer_orthographic() instead
*/
void
cogl_ortho (float left,
@ -220,9 +232,8 @@ cogl_ortho (float left,
float bottom,
float top,
float near,
float far);
#ifndef COGL_DISABLE_DEPRECATED
float far)
COGL_DEPRECATED_IN_1_10_FOR (cogl_framebuffer_orthographic);
/**
* cogl_viewport:
@ -232,14 +243,12 @@ cogl_ortho (float left,
* Replace the current viewport with the given values.
*
* Since: 0.8.2
*
* Deprecated: 1.2: Use cogl_set_viewport() instead
* Deprecated: 1.8: Use cogl_framebuffer_set_viewport instead
*/
void
cogl_viewport (unsigned int width,
unsigned int height) G_GNUC_DEPRECATED;
#endif /* COGL_DISABLE_DEPRECATED */
unsigned int height)
COGL_DEPRECATED_IN_1_8_FOR (cogl_framebuffer_set_viewport);
/**
* cogl_set_viewport:
@ -251,29 +260,37 @@ cogl_viewport (unsigned int width,
* Replaces the current viewport with the given values.
*
* Since: 1.2
* Deprecated: 1.8: Use cogl_framebuffer_set_viewport() instead
*/
void
cogl_set_viewport (int x,
int y,
int width,
int height);
int height)
COGL_DEPRECATED_IN_1_8_FOR (cogl_framebuffer_set_viewport);
/**
* cogl_push_matrix:
*
* Stores the current model-view matrix on the matrix stack. The matrix
* can later be restored with cogl_pop_matrix().
*
* Deprecated: 1.10: Use cogl_framebuffer_push_matrix() instead
*/
void
cogl_push_matrix (void);
cogl_push_matrix (void)
COGL_DEPRECATED_IN_1_10_FOR (cogl_framebuffer_push_matrix);
/**
* cogl_pop_matrix:
*
* Restores the current model-view matrix from the matrix stack.
*
* Deprecated: 1.10: Use cogl_framebuffer_pop_matrix() instead
*/
void
cogl_pop_matrix (void);
cogl_pop_matrix (void)
COGL_DEPRECATED_IN_1_10_FOR (cogl_framebuffer_push_matrix);
/**
* cogl_scale:
@ -283,11 +300,14 @@ cogl_pop_matrix (void);
*
* Multiplies the current model-view matrix by one that scales the x,
* y and z axes by the given values.
*
* Deprecated: 1.10: Use cogl_framebuffer_pop_matrix() instead
*/
void
cogl_scale (float x,
float y,
float z);
float z)
COGL_DEPRECATED_IN_1_10_FOR (cogl_framebuffer_scale);
/**
* cogl_translate:
@ -297,11 +317,14 @@ cogl_scale (float x,
*
* Multiplies the current model-view matrix by one that translates the
* model along all three axes according to the given values.
*
* Deprecated: 1.10: Use cogl_framebuffer_translate() instead
*/
void
cogl_translate (float x,
float y,
float z);
float z)
COGL_DEPRECATED_IN_1_10_FOR (cogl_framebuffer_translate);
/**
* cogl_rotate:
@ -315,12 +338,15 @@ cogl_translate (float x,
* 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.
*
* Deprecated: 1.10: Use cogl_framebuffer_rotate() instead
*/
void
cogl_rotate (float angle,
float x,
float y,
float z);
float z)
COGL_DEPRECATED_IN_1_10_FOR (cogl_framebuffer_rotate);
/**
* cogl_transform:
@ -329,45 +355,63 @@ cogl_rotate (float angle,
* Multiplies the current model-view matrix by the given matrix.
*
* Since: 1.4
* Deprecated: 1.10: Use cogl_framebuffer_transform() instead
*/
void
cogl_transform (const CoglMatrix *matrix);
cogl_transform (const CoglMatrix *matrix)
COGL_DEPRECATED_IN_1_10_FOR (cogl_framebuffer_transform);
/**
* cogl_get_modelview_matrix:
* @matrix: (out): return location for the model-view matrix
*
* Stores the current model-view matrix in @matrix.
*
* Deprecated: 1.10: Use cogl_framebuffer_get_modelview_matrix()
* instead
*/
void
cogl_get_modelview_matrix (CoglMatrix *matrix);
cogl_get_modelview_matrix (CoglMatrix *matrix)
COGL_DEPRECATED_IN_1_10_FOR (cogl_framebuffer_get_modelview_matrix);
/**
* cogl_set_modelview_matrix:
* @matrix: the new model-view matrix
*
* Loads @matrix as the new model-view matrix.
*
* Deprecated: 1.10: Use cogl_framebuffer_set_modelview_matrix()
* instead
*/
void
cogl_set_modelview_matrix (CoglMatrix *matrix);
cogl_set_modelview_matrix (CoglMatrix *matrix)
COGL_DEPRECATED_IN_1_10_FOR (cogl_framebuffer_set_modelview_matrix);
/**
* cogl_get_projection_matrix:
* @matrix: (out): return location for the projection matrix
*
* Stores the current projection matrix in @matrix.
*
* Deprecated: 1.10: Use cogl_framebuffer_get_projection_matrix()
* instead
*/
void
cogl_get_projection_matrix (CoglMatrix *matrix);
cogl_get_projection_matrix (CoglMatrix *matrix)
COGL_DEPRECATED_IN_1_10_FOR (cogl_framebuffer_get_projection_matrix);
/**
* cogl_set_projection_matrix:
* @matrix: the new projection matrix
*
* Loads matrix as the new projection matrix.
*
* Deprecated: 1.10: Use cogl_framebuffer_set_projection_matrix()
* instead
*/
void
cogl_set_projection_matrix (CoglMatrix *matrix);
cogl_set_projection_matrix (CoglMatrix *matrix)
COGL_DEPRECATED_IN_1_10_FOR (cogl_framebuffer_set_projection_matrix);
/**
* cogl_get_viewport:
@ -377,9 +421,13 @@ cogl_set_projection_matrix (CoglMatrix *matrix);
* 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.
*
* Deprecated: 1.10: Use cogl_framebuffer_get_viewport4fv()
* instead
*/
void
cogl_get_viewport (float v[4]);
cogl_get_viewport (float v[4])
COGL_DEPRECATED_IN_1_10_FOR (cogl_framebuffer_get_viewport4fv);
/**
* cogl_set_depth_test_enabled:
@ -391,11 +439,11 @@ cogl_get_viewport (float v[4]);
* clutter_actor_lower(), otherwise it will also take into account the
* actor's depth. Depth testing is disabled by default.
*
* Deprecated: 1.4: Use cogl_material_set_depth_test_enabled()
* instead.
* Deprecated: 1.16: Use cogl_pipeline_set_depth_state() instead
*/
void
cogl_set_depth_test_enabled (CoglBool setting);
cogl_set_depth_test_enabled (CoglBool setting)
COGL_DEPRECATED_IN_1_16_FOR (cogl_pipeline_set_depth_state);
/**
* cogl_get_depth_test_enabled:
@ -404,11 +452,11 @@ cogl_set_depth_test_enabled (CoglBool setting);
*
* Return value: %TRUE if depth testing is enabled, and %FALSE otherwise
*
* Deprecated: 1.4: Use cogl_material_get_depth_test_enabled()
* instead.
* Deprecated: 1.16: Use cogl_pipeline_set_depth_state() instead
*/
CoglBool
cogl_get_depth_test_enabled (void);
cogl_get_depth_test_enabled (void)
COGL_DEPRECATED_IN_1_16_FOR (cogl_pipeline_set_depth_state);
/**
* cogl_set_backface_culling_enabled:
@ -419,9 +467,12 @@ cogl_get_depth_test_enabled (void);
* 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.
*
* Deprecated: 1.16: Use cogl_pipeline_set_cull_face_mode() instead
*/
void
cogl_set_backface_culling_enabled (CoglBool setting);
cogl_set_backface_culling_enabled (CoglBool setting)
COGL_DEPRECATED_IN_1_16_FOR (cogl_pipeline_set_cull_face_mode);
/**
* cogl_get_backface_culling_enabled:
@ -430,9 +481,12 @@ cogl_set_backface_culling_enabled (CoglBool setting);
* cogl_set_backface_culling_enabled()
*
* Return value: %TRUE if backface culling is enabled, and %FALSE otherwise
*
* Deprecated: 1.16: Use cogl_pipeline_get_cull_face_mode() instead
*/
CoglBool
cogl_get_backface_culling_enabled (void);
cogl_get_backface_culling_enabled (void)
COGL_DEPRECATED_IN_1_16_FOR (cogl_pipeline_get_cull_face_mode);
/**
* cogl_set_fog:
@ -458,22 +512,28 @@ cogl_get_backface_culling_enabled (void);
* 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>
*
* Deprecated: 1.16: Use #CoglSnippet shader api for fog
*/
void
cogl_set_fog (const CoglColor *fog_color,
CoglFogMode mode,
float density,
float z_near,
float z_far);
float z_far)
COGL_DEPRECATED_IN_1_16_FOR (cogl_snippet_API);
/**
* cogl_disable_fog:
*
* This function disables fogging, so primitives drawn afterwards will not be
* blended with any previously set fog color.
*
* Deprecated: 1.16: Use #CoglSnippet shader api for fog
*/
void
cogl_disable_fog (void);
cogl_disable_fog (void)
COGL_DEPRECATED_IN_1_16_FOR (cogl_snippet_API);
/**
* cogl_clear:
@ -483,10 +543,13 @@ cogl_disable_fog (void);
*
* Clears all the auxiliary buffers identified in the @buffers mask, and if
* that includes the color buffer then the specified @color is used.
*
* Deprecated: 1.16: Use cogl_framebuffer_clear() api instead
*/
void
cogl_clear (const CoglColor *color,
unsigned long buffers);
unsigned long buffers)
COGL_DEPRECATED_IN_1_16_FOR (cogl_framebuffer_clear);
/**
* cogl_set_source:
@ -498,9 +561,12 @@ cogl_clear (const CoglColor *color,
* cogl_rectangle() or vertices drawn using cogl_vertex_buffer_draw().
*
* Since: 1.0
* Deprecated: 1.16: Latest drawing apis all take an explicit
* #CoglPipeline argument so this stack of
* #CoglMaterial<!-- -->s shouldn't be used.
*/
void
cogl_set_source (void *material);
cogl_set_source (void *material) COGL_DEPRECATED_IN_1_16;
/**
* cogl_get_source:
@ -517,9 +583,12 @@ cogl_set_source (void *material);
* Return value: The current source material.
*
* Since: 1.6
* Deprecated: 1.16: Latest drawing apis all take an explicit
* #CoglPipeline argument so this stack of
* #CoglMaterial<!-- -->s shouldn't be used.
*/
void *
cogl_get_source (void);
cogl_get_source (void) COGL_DEPRECATED_IN_1_16;
/**
* cogl_push_source:
@ -530,9 +599,12 @@ cogl_get_source (void);
* process later primitives as defined by cogl_set_source().
*
* Since: 1.6
* Deprecated: 1.16: Latest drawing apis all take an explicit
* #CoglPipeline argument so this stack of
* #CoglMaterial<!-- -->s shouldn't be used.
*/
void
cogl_push_source (void *material);
cogl_push_source (void *material) COGL_DEPRECATED_IN_1_16;
/**
* cogl_pop_source:
@ -542,9 +614,12 @@ cogl_push_source (void *material);
* later primitives as defined by cogl_set_source().
*
* Since: 1.6
* Deprecated: 1.16: Latest drawing apis all take an explicit
* #CoglPipeline argument so this stack of
* #CoglMaterial<!-- -->s shouldn't be used.
*/
void
cogl_pop_source (void);
cogl_pop_source (void) COGL_DEPRECATED_IN_1_16;
/**
* cogl_set_source_color:
@ -562,9 +637,12 @@ cogl_pop_source (void);
* if you already have the color components.
*
* Since: 1.0
* Deprecated: 1.16: Latest drawing apis all take an explicit
* #CoglPipeline argument so this stack of
* #CoglMaterial<!-- -->s shouldn't be used.
*/
void
cogl_set_source_color (const CoglColor *color);
cogl_set_source_color (const CoglColor *color) COGL_DEPRECATED_IN_1_16;
/**
* cogl_set_source_color4ub:
@ -581,12 +659,15 @@ cogl_set_source_color (const CoglColor *color);
* between 0 and 255.
*
* Since: 1.0
* Deprecated: 1.16: Latest drawing apis all take an explicit
* #CoglPipeline argument so this stack of
* #CoglMaterial<!-- -->s shouldn't be used.
*/
void
cogl_set_source_color4ub (uint8_t red,
uint8_t green,
uint8_t blue,
uint8_t alpha);
uint8_t alpha) COGL_DEPRECATED_IN_1_16;
/**
* cogl_set_source_color4f:
@ -604,12 +685,15 @@ cogl_set_source_color4ub (uint8_t red,
* range, they will be clamped.
*
* Since: 1.0
* Deprecated: 1.16: Latest drawing apis all take an explicit
* #CoglPipeline argument so this stack of
* #CoglMaterial<!-- -->s shouldn't be used.
*/
void
cogl_set_source_color4f (float red,
float green,
float blue,
float alpha);
float alpha) COGL_DEPRECATED_IN_1_16;
/**
* cogl_set_source_texture:
@ -630,9 +714,12 @@ cogl_set_source_color4f (float red,
* </programlisting>
*
* Since: 1.0
* Deprecated: 1.16: Latest drawing apis all take an explicit
* #CoglPipeline argument so this stack of
* #CoglMaterial<!-- -->s shouldn't be used.
*/
void
cogl_set_source_texture (CoglTexture *texture);
cogl_set_source_texture (CoglTexture *texture) COGL_DEPRECATED_IN_1_16;
/**
@ -644,8 +731,6 @@ cogl_set_source_texture (CoglTexture *texture);
* intersected with the previous region.
*/
#ifndef COGL_DISABLE_DEPRECATED
/**
* cogl_clip_push_window_rect:
* @x_offset: left edge of the clip rectangle in window coordinates
@ -662,15 +747,14 @@ cogl_set_source_texture (CoglTexture *texture);
* The rectangle is intersected with the current clip region. To undo
* the effect of this function, call cogl_clip_pop().
*
* Deprecated: 1.2: Use cogl_clip_push_window_rectangle() instead
* Deprecated: 1.16: Use cogl_framebuffer_push_scissor_clip() instead
*/
void
cogl_clip_push_window_rect (float x_offset,
float y_offset,
float width,
float height) G_GNUC_DEPRECATED;
#endif /* COGL_DISABLE_DEPRECATED */
float height)
COGL_DEPRECATED_IN_1_16_FOR (cogl_framebuffer_push_scissor_clip);
/**
* cogl_clip_push_window_rectangle:
@ -689,14 +773,14 @@ cogl_clip_push_window_rect (float x_offset,
* the effect of this function, call cogl_clip_pop().
*
* Since: 1.2
* Deprecated: 1.16: Use cogl_framebuffer_push_scissor_clip() instead
*/
void
cogl_clip_push_window_rectangle (int x_offset,
int y_offset,
int width,
int height);
#ifndef COGL_DISABLE_DEPRECATED
int height)
COGL_DEPRECATED_IN_1_16_FOR (cogl_framebuffer_push_scissor_clip);
/**
* cogl_clip_push:
@ -714,19 +798,18 @@ cogl_clip_push_window_rectangle (int x_offset,
* The rectangle is intersected with the current clip region. To undo
* the effect of this function, call cogl_clip_pop().
*
* Deprecated: 1.2: The x, y, width, height arguments are inconsistent
* Deprecated: 1.16: 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
* extending up, it's awkward to use. Please use
* cogl_framebuffer_push_rectangle_clip()
*/
void
cogl_clip_push (float x_offset,
float y_offset,
float width,
float height) G_GNUC_DEPRECATED;
#endif /* COGL_DISABLE_DEPRECATED */
float height)
COGL_DEPRECATED_IN_1_16_FOR (cogl_framebuffer_push_rectangle_clip);
/**
* cogl_clip_push_rectangle:
@ -745,12 +828,15 @@ cogl_clip_push (float x_offset,
* the effect of this function, call cogl_clip_pop().
*
* Since: 1.2
* Deprecated: 1.16: Use cogl_framebuffer_push_rectangle_clip()
* instead
*/
void
cogl_clip_push_rectangle (float x0,
float y0,
float x1,
float y1);
float y1)
COGL_DEPRECATED_IN_1_16_FOR (cogl_framebuffer_push_rectangle_clip);
/**
* cogl_clip_push_from_path_preserve:
@ -761,11 +847,12 @@ cogl_clip_push_rectangle (float x0,
* cogl_clip_pop().
*
* Since: 1.0
* Deprecated: 1.16: Use cogl_framebuffer_push_path_clip() instead
*/
void
cogl_clip_push_from_path_preserve (void);
cogl_clip_push_from_path_preserve (void)
COGL_DEPRECATED_IN_1_16_FOR (cogl_framebuffer_push_path_clip);
#ifdef COGL_ENABLE_EXPERIMENTAL_2_0_API
/**
* cogl_clip_push_primitive:
* @primitive: A #CoglPrimitive describing a flat 2D shape
@ -795,25 +882,28 @@ cogl_clip_push_from_path_preserve (void);
*
* Since: 1.10
* Stability: unstable
* Deprecated: 1.16: Use cogl_framebuffer_push_primitive_clip()
* instead
*/
void
cogl_clip_push_primitive (CoglPrimitive *primitive,
float bounds_x1,
float bounds_y1,
float bounds_x2,
float bounds_y2);
#endif
float bounds_y2)
COGL_DEPRECATED_IN_1_16_FOR (cogl_framebuffer_push_primitive_clip);
/**
* cogl_clip_pop:
*
* Reverts the clipping region to the state before the last call to
* cogl_clip_push().
*
* Deprecated: 1.16: Use cogl_framebuffer_pop_clip() instead
*/
void
cogl_clip_pop (void);
#ifndef COGL_DISABLE_DEPRECATED
cogl_clip_pop (void)
COGL_DEPRECATED_IN_1_16_FOR (cogl_framebuffer_pop_clip);
/**
* cogl_clip_ensure:
@ -828,7 +918,7 @@ cogl_clip_pop (void);
* Since: 1.0
*/
void
cogl_clip_ensure (void) G_GNUC_DEPRECATED;
cogl_clip_ensure (void) COGL_DEPRECATED;
/**
* cogl_clip_stack_save:
@ -848,7 +938,7 @@ cogl_clip_ensure (void) G_GNUC_DEPRECATED;
* Since: 0.8.2
*/
void
cogl_clip_stack_save (void) G_GNUC_DEPRECATED;
cogl_clip_stack_save (void) COGL_DEPRECATED;
/**
* cogl_clip_stack_restore:
@ -865,9 +955,7 @@ cogl_clip_stack_save (void) G_GNUC_DEPRECATED;
* Since: 0.8.2
*/
void
cogl_clip_stack_restore (void) G_GNUC_DEPRECATED;
#endif /* COGL_DISABLE_DEPRECATED */
cogl_clip_stack_restore (void) COGL_DEPRECATED;
/**
* cogl_set_framebuffer:
@ -878,9 +966,12 @@ cogl_clip_stack_restore (void) G_GNUC_DEPRECATED;
* or in the future it may be an onscreen framebuffers too.
*
* Since: 1.2
* Deprecated: 1.16: The latest drawing apis take explicit
* #CoglFramebuffer arguments so this stack of
* framebuffers shouldn't be used anymore.
*/
void
cogl_set_framebuffer (CoglFramebuffer *buffer);
cogl_set_framebuffer (CoglFramebuffer *buffer) COGL_DEPRECATED_IN_1_16;
/**
* cogl_push_framebuffer:
@ -959,9 +1050,12 @@ cogl_set_framebuffer (CoglFramebuffer *buffer);
* The previous framebuffer can be restored by calling cogl_pop_framebuffer()
*
* Since: 1.2
* Deprecated: 1.16: The latest drawing apis take explicit
* #CoglFramebuffer arguments so this stack of
* framebuffers shouldn't be used anymore.
*/
void
cogl_push_framebuffer (CoglFramebuffer *buffer);
cogl_push_framebuffer (CoglFramebuffer *buffer) COGL_DEPRECATED_IN_1_16;
/**
* cogl_pop_framebuffer:
@ -970,11 +1064,12 @@ cogl_push_framebuffer (CoglFramebuffer *buffer);
* All subsequent drawing will be redirected to this framebuffer.
*
* Since: 1.2
* Deprecated: 1.16: The latest drawing apis take explicit
* #CoglFramebuffer arguments so this stack of
* framebuffers shouldn't be used anymore.
*/
void
cogl_pop_framebuffer (void);
#ifndef COGL_DISABLE_DEPRECATED
cogl_pop_framebuffer (void) COGL_DEPRECATED_IN_1_16;
/**
* cogl_set_draw_buffer:
@ -988,34 +1083,37 @@ cogl_pop_framebuffer (void);
* cogl_offscreen_new_to_texture () or you can revert to your original
* on screen window buffer.
*
* Deprecated: 1.2: The target argument was redundant since we could look at
* the type of CoglHandle given instead.
* Deprecated: 1.16: The latest drawing apis take explicit
* #CoglFramebuffer arguments so this stack of
* framebuffers shouldn't be used anymore.
*/
void
cogl_set_draw_buffer (CoglBufferTarget target,
CoglHandle offscreen) G_GNUC_DEPRECATED;
CoglHandle offscreen) COGL_DEPRECATED_IN_1_16;
/**
* cogl_push_draw_buffer:
*
* Save cogl_set_draw_buffer() state.
*
* Deprecated: 1.2: The draw buffer API was replaced with a framebuffer API
* Deprecated: 1.16: The latest drawing apis take explicit
* #CoglFramebuffer arguments so this stack of
* framebuffers shouldn't be used anymore.
*/
void
cogl_push_draw_buffer (void) COGL_GNUC_DEPRECATED;
cogl_push_draw_buffer (void) COGL_DEPRECATED_IN_1_16;
/**
* cogl_pop_draw_buffer:
*
* Restore cogl_set_draw_buffer() state.
*
* Deprecated: 1.2: The draw buffer API was replaced with a framebuffer API
* Deprecated: 1.16: The latest drawing apis take explicit
* #CoglFramebuffer arguments so this stack of
* framebuffers shouldn't be used anymore.
*/
void
cogl_pop_draw_buffer (void) COGL_GNUC_DEPRECATED;
#endif /* COGL_DISABLE_DEPRECATED */
cogl_pop_draw_buffer (void) COGL_DEPRECATED_IN_1_16;
/**
* cogl_read_pixels:
@ -1038,6 +1136,8 @@ cogl_pop_draw_buffer (void) COGL_GNUC_DEPRECATED;
* read the pixel values without any conversion you should either
* specify a format that doesn't use an alpha channel or use one of
* the formats ending in PRE.
*
* Deprecated: 1.16: Use cogl_framebuffer_read_pixels() instead
*/
void
cogl_read_pixels (int x,
@ -1046,7 +1146,8 @@ cogl_read_pixels (int x,
int height,
CoglReadPixelsFlags source,
CoglPixelFormat format,
uint8_t *pixels);
uint8_t *pixels)
COGL_DEPRECATED_IN_1_16_FOR (cogl_framebuffer_read_pixels);
/**
* cogl_flush:
@ -1149,9 +1250,10 @@ cogl_flush (void);
* OpenGL.
*
* Since: 1.0
* Deprecated: 1.16: Use the #CoglGLES2Context api instead
*/
void
cogl_begin_gl (void);
cogl_begin_gl (void) COGL_DEPRECATED_IN_1_16_FOR (CoglGLES2Context_API);
/**
* cogl_end_gl:
@ -1160,9 +1262,10 @@ cogl_begin_gl (void);
* code using raw OpenGL. Please refer to cogl_begin_gl() for full details.
*
* Since: 1.0
* Deprecated: 1.16: Use the #CoglGLES2Context api instead
*/
void
cogl_end_gl (void);
cogl_end_gl (void) COGL_DEPRECATED_IN_1_16_FOR (CoglGLES2Context_API);
COGL_END_DECLS

5
cogl/cogl2-compatibility.h
View File

@ -30,6 +30,7 @@
#include <cogl/cogl-types.h>
#include <cogl/cogl2-path.h>
#include <cogl/cogl-macros.h>
COGL_BEGIN_DECLS
@ -45,9 +46,11 @@ COGL_BEGIN_DECLS
*
* Since: 1.8
* Stability: Unstable
* Deprecated: 1.16: Use cogl_framebuffer_push_path_clip() instead
*/
void
cogl_clip_push_from_path (CoglPath *path);
cogl_clip_push_from_path (CoglPath *path)
COGL_DEPRECATED_IN_1_16_FOR (cogl_framebuffer_push_path_clip);
COGL_END_DECLS

3
doc/RELEASING
View File

@ -3,6 +3,9 @@ RELEASING
When making a new release;
- If it's a new stable release that increments the Cogl minor version
remember to add a new COGL_VERSION_1_X define to cogl/cogl-macros.h
- Verify that you don't have uncommitted changes; both:
$ git diff HEAD

12
examples/cogl-crate.c
View File

@ -169,8 +169,9 @@ main (int argc, char **argv)
cogl_onscreen_show (onscreen);
cogl_push_framebuffer (fb);
cogl_set_viewport (0, 0, data.framebuffer_width, data.framebuffer_height);
cogl_framebuffer_set_viewport (fb, 0, 0,
data.framebuffer_width,
data.framebuffer_height);
fovy = 60; /* y-axis field of view */
aspect = (float)data.framebuffer_width/(float)data.framebuffer_height;
@ -178,7 +179,7 @@ main (int argc, char **argv)
z_2d = 1000; /* position to 2d plane */
z_far = 2000; /* distance to far clipping plane */
cogl_perspective (fovy, aspect, z_near, z_far);
cogl_framebuffer_perspective (fb, fovy, aspect, z_near, z_far);
/* Since the pango renderer emits geometry in pixel/device coordinates
* and the anti aliasing is implemented with the assumption that the
@ -195,12 +196,11 @@ main (int argc, char **argv)
cogl_matrix_view_2d_in_perspective (&data.view, fovy, aspect, z_near, z_2d,
data.framebuffer_width,
data.framebuffer_height);
cogl_set_modelview_matrix (&data.view);
cogl_pop_framebuffer ();
cogl_framebuffer_set_modelview_matrix (fb, &data.view);
/* Initialize some convenient constants */
cogl_matrix_init_identity (&identity);
cogl_color_set_from_4ub (&white, 0xff, 0xff, 0xff, 0xff);
cogl_color_init_from_4ub (&white, 0xff, 0xff, 0xff, 0xff);
/* rectangle indices allow the GPU to interpret a list of quads (the
* faces of our cube) as a list of triangles.

12
examples/cogland.c
View File

@ -806,15 +806,9 @@ cogland_compositor_create_output (CoglandCompositor *compositor,
g_error ("Failed to allocate framebuffer: %s\n", error->message);
cogl_onscreen_show (output->onscreen);
#if 0
cogl_framebuffer_set_viewport (fb, x, y, width, height);
#else
cogl_push_framebuffer (fb);
cogl_set_viewport (-x, -y,
compositor->virtual_width,
compositor->virtual_height);
cogl_pop_framebuffer ();
#endif
cogl_framebuffer_set_viewport (fb, -x, -y,
compositor->virtual_width,
compositor->virtual_height);
mode = g_slice_new0 (CoglandMode);
mode->flags = 0;

2
tests/conform/test-backface-culling.c
View File

@ -1,3 +1,5 @@
#define COGL_VERSION_MIN_REQUIRED COGL_VERSION_1_0
#include <cogl/cogl.h>
#include <string.h>

2
tests/conform/test-depth-test.c
View File

@ -1,3 +1,5 @@
#define COGL_VERSION_MIN_REQUIRED COGL_VERSION_1_0
#include <cogl/cogl.h>
#include <string.h>

2
tests/conform/test-just-vertex-shader.c
View File

@ -1,3 +1,5 @@
#define COGL_VERSION_MIN_REQUIRED COGL_VERSION_1_0
#include <cogl/cogl.h>
#include <string.h>

2
tests/conform/test-offscreen.c
View File

@ -1,3 +1,5 @@
#define COGL_VERSION_MIN_REQUIRED COGL_VERSION_1_0
#include <cogl/cogl.h>
#include "test-utils.h"

2
tests/conform/test-wrap-modes.c
View File

@ -1,3 +1,5 @@
#define COGL_VERSION_MIN_REQUIRED COGL_VERSION_1_0
#include <cogl/cogl.h>
#include <string.h>