diff --git a/clutter/clutter/clutter-actor.c b/clutter/clutter/clutter-actor.c index 1dde8d948..95cfa655d 100644 --- a/clutter/clutter/clutter-actor.c +++ b/clutter/clutter/clutter-actor.c @@ -13742,8 +13742,6 @@ clutter_actor_create_pango_layout (ClutterActor *self, * actors that need to mimic those. * * In almost all cases this should not used by applications. - * - * Stability: unstable */ void clutter_actor_set_opacity_override (ClutterActor *self, @@ -13768,8 +13766,6 @@ clutter_actor_set_opacity_override (ClutterActor *self, * * Returns: the override value for the actor's opacity, or -1 if no override * is set.2 - * - * Stability: unstable */ gint clutter_actor_get_opacity_override (ClutterActor *self) diff --git a/clutter/clutter/clutter-backend.c b/clutter/clutter/clutter-backend.c index 315114953..f49c74bc7 100644 --- a/clutter/clutter/clutter-backend.c +++ b/clutter/clutter/clutter-backend.c @@ -653,7 +653,6 @@ _clutter_backend_translate_event (ClutterBackend *backend, * explicitly create a CoglContext. * * Return value: (transfer none): The #CoglContext associated with @backend. - * Stability: unstable */ CoglContext * clutter_backend_get_cogl_context (ClutterBackend *backend) diff --git a/clutter/clutter/clutter-image.c b/clutter/clutter/clutter-image.c index 0e3e0894e..ee6a1a597 100644 --- a/clutter/clutter/clutter-image.c +++ b/clutter/clutter/clutter-image.c @@ -420,7 +420,6 @@ clutter_image_set_area (ClutterImage *image, * in order to update the actors using @image as their content. * * Return value: (transfer none): a pointer to the Cogl texture, or %NULL - * Stability: unstable */ CoglTexture * clutter_image_get_texture (ClutterImage *image) diff --git a/cogl/cogl-pango/cogl-pango.h b/cogl/cogl-pango/cogl-pango.h index c0012177e..e5d30fec6 100644 --- a/cogl/cogl-pango/cogl-pango.h +++ b/cogl/cogl-pango/cogl-pango.h @@ -72,8 +72,6 @@ typedef PangoCairoFontMap CoglPangoFontMap; * Creates a new font map. * * Return value: (transfer full): the newly created #PangoFontMap - * - * Since: 1.14 */ COGL_EXPORT PangoFontMap * cogl_pango_font_map_new (void); @@ -101,8 +99,6 @@ cogl_pango_font_map_create_context (CoglPangoFontMap *font_map); * [struct@Pango.FontDescription] and Cogl units. * The default value is %96, meaning that a 10 point font will be 13 * units high. (10 * 96. / 72. = 13.3). - * - * Since: 1.14 */ COGL_EXPORT void cogl_pango_font_map_set_resolution (CoglPangoFontMap *font_map, @@ -113,8 +109,6 @@ cogl_pango_font_map_set_resolution (CoglPangoFontMap *font_map, * @font_map: a #CoglPangoFontMap * * Clears the glyph cache for @font_map. - * - * Since: 1.0 */ COGL_EXPORT void cogl_pango_font_map_clear_glyph_cache (CoglPangoFontMap *font_map); @@ -128,8 +122,6 @@ cogl_pango_font_map_clear_glyph_cache (CoglPangoFontMap *font_map); * * This api should be used to avoid mid-scene modifications of * glyph-cache textures which can lead to undefined rendering results. - * - * Since: 1.0 */ COGL_EXPORT void cogl_pango_ensure_glyph_cache_for_layout (PangoLayout *layout); @@ -141,8 +133,6 @@ cogl_pango_ensure_glyph_cache_for_layout (PangoLayout *layout); * * Sets whether the renderer for the passed font map should use * mipmapping when rendering a [class@Pango.Layout]. - * - * Since: 1.0 */ COGL_EXPORT void cogl_pango_font_map_set_use_mipmapping (CoglPangoFontMap *font_map, @@ -156,8 +146,6 @@ cogl_pango_font_map_set_use_mipmapping (CoglPangoFontMap *font_map, * mipmapping when rendering the glyphs. * * Return value: %TRUE if mipmapping is used, %FALSE otherwise. - * - * Since: 1.0 */ COGL_EXPORT gboolean cogl_pango_font_map_get_use_mipmapping (CoglPangoFontMap *font_map); @@ -169,8 +157,6 @@ cogl_pango_font_map_get_use_mipmapping (CoglPangoFontMap *font_map); * Retrieves the [class@CoglPango.Renderer] for the passed @font_map. * * Return value: (transfer none): a #PangoRenderer - * - * Since: 1.0 */ COGL_EXPORT PangoRenderer * cogl_pango_font_map_get_renderer (CoglPangoFontMap *font_map); @@ -185,8 +171,6 @@ cogl_pango_font_map_get_renderer (CoglPangoFontMap *font_map); * * Draws a solidly coloured @layout on the given @framebuffer at (@x, * @y) within the `framebuffer`'s current model-view coordinate space. - * - * Since: 1.14 */ COGL_EXPORT void cogl_pango_show_layout (CoglFramebuffer *framebuffer, @@ -205,8 +189,6 @@ cogl_pango_show_layout (CoglFramebuffer *framebuffer, * * Draws a solidly coloured @line on the given @framebuffer at (@x, * @y) within the `framebuffer`'s current model-view coordinate space. - * - * Since: 1.14 */ COGL_EXPORT void cogl_pango_show_layout_line (CoglFramebuffer *framebuffer, diff --git a/cogl/cogl/cogl-atlas-texture.h b/cogl/cogl/cogl-atlas-texture.h index 5c6184a42..397d53f5b 100644 --- a/cogl/cogl/cogl-atlas-texture.h +++ b/cogl/cogl/cogl-atlas-texture.h @@ -106,8 +106,6 @@ GType cogl_atlas_texture_get_gtype (void); * for more details. * * Returns: (transfer full): A new #CoglAtlasTexture object. - * Since: 1.16 - * Stability: unstable */ COGL_EXPORT CoglAtlasTexture * cogl_atlas_texture_new_with_size (CoglContext *ctx, @@ -144,8 +142,6 @@ cogl_atlas_texture_new_with_size (CoglContext *ctx, * * Return value: (transfer full): A new #CoglAtlasTexture object or * %NULL on failure and @error will be updated. - * Since: 1.16 - * Stability: unstable */ COGL_EXPORT CoglAtlasTexture * cogl_atlas_texture_new_from_file (CoglContext *ctx, @@ -189,8 +185,6 @@ cogl_atlas_texture_new_from_file (CoglContext *ctx, * * Return value: (transfer full): A new #CoglAtlasTexture object or * %NULL on failure and @error will be updated. - * Since: 1.16 - * Stability: unstable */ COGL_EXPORT CoglAtlasTexture * cogl_atlas_texture_new_from_data (CoglContext *ctx, @@ -229,8 +223,6 @@ cogl_atlas_texture_new_from_data (CoglContext *ctx, * for more details. * * Returns: (transfer full): A new #CoglAtlasTexture object. - * Since: 1.16 - * Stability: unstable */ COGL_EXPORT CoglAtlasTexture * cogl_atlas_texture_new_from_bitmap (CoglBitmap *bmp); @@ -243,9 +235,6 @@ cogl_atlas_texture_new_from_bitmap (CoglBitmap *bmp); * * Return value: %TRUE if the passed object represents an atlas * texture and %FALSE otherwise - * - * Since: 1.16 - * Stability: Unstable */ COGL_EXPORT gboolean cogl_is_atlas_texture (void *object); diff --git a/cogl/cogl/cogl-attribute-buffer.h b/cogl/cogl/cogl-attribute-buffer.h index 9175a8b66..1157f1949 100644 --- a/cogl/cogl/cogl-attribute-buffer.h +++ b/cogl/cogl/cogl-attribute-buffer.h @@ -87,8 +87,6 @@ GType cogl_attribute_buffer_get_gtype (void); * %NULL * * Return value: (transfer full): A newly allocated #CoglAttributeBuffer. Never %NULL. - * - * Stability: Unstable */ COGL_EXPORT CoglAttributeBuffer * cogl_attribute_buffer_new_with_size (CoglContext *context, @@ -119,9 +117,6 @@ cogl_attribute_buffer_new_with_size (CoglContext *context, * cogl_buffer_map(). * * Return value: (transfer full): A newly allocated #CoglAttributeBuffer (never %NULL) - * - * Since: 1.4 - * Stability: Unstable */ COGL_EXPORT CoglAttributeBuffer * cogl_attribute_buffer_new (CoglContext *context, @@ -136,9 +131,6 @@ cogl_attribute_buffer_new (CoglContext *context, * * Returns: %TRUE if @object references a #CoglAttributeBuffer, * %FALSE otherwise - * - * Since: 1.4 - * Stability: Unstable */ COGL_EXPORT gboolean cogl_is_attribute_buffer (void *object); diff --git a/cogl/cogl/cogl-attribute.h b/cogl/cogl/cogl-attribute.h index 39a62d2dd..732946f95 100644 --- a/cogl/cogl/cogl-attribute.h +++ b/cogl/cogl/cogl-attribute.h @@ -150,9 +150,6 @@ GType cogl_attribute_get_gtype (void); * Return value: (transfer full): A newly allocated #CoglAttribute * describing the layout for a list of attribute values * stored in @array. - * - * Since: 1.4 - * Stability: Unstable */ /* XXX: look for a precedent to see if the stride/offset args should * have a different order. */ @@ -489,9 +486,6 @@ cogl_attribute_new_const_4x4fv (CoglContext *context, * attribute. For the builtin properties cogl_color_in and * cogl_normal_in it will default to TRUE and for all other names it * will default to FALSE. - * - * Stability: unstable - * Since: 1.10 */ COGL_EXPORT void cogl_attribute_set_normalized (CoglAttribute *attribute, @@ -503,9 +497,6 @@ cogl_attribute_set_normalized (CoglAttribute *attribute, * * Return value: the value of the normalized property set with * cogl_attribute_set_normalized(). - * - * Stability: unstable - * Since: 1.10 */ COGL_EXPORT gboolean cogl_attribute_get_normalized (CoglAttribute *attribute); @@ -516,9 +507,6 @@ cogl_attribute_get_normalized (CoglAttribute *attribute); * * Return value: (transfer none): the #CoglAttributeBuffer that was * set with cogl_attribute_set_buffer() or cogl_attribute_new(). - * - * Stability: unstable - * Since: 1.10 */ COGL_EXPORT CoglAttributeBuffer * cogl_attribute_get_buffer (CoglAttribute *attribute); @@ -529,9 +517,6 @@ cogl_attribute_get_buffer (CoglAttribute *attribute); * @attribute_buffer: A #CoglAttributeBuffer * * Sets a new #CoglAttributeBuffer for the attribute. - * - * Stability: unstable - * Since: 1.10 */ COGL_EXPORT void cogl_attribute_set_buffer (CoglAttribute *attribute, diff --git a/cogl/cogl/cogl-bitmap-private.h b/cogl/cogl/cogl-bitmap-private.h index a92d6af48..ac0e477d8 100644 --- a/cogl/cogl/cogl-bitmap-private.h +++ b/cogl/cogl/cogl-bitmap-private.h @@ -78,9 +78,6 @@ struct _CoglBitmap * the bitmap is freed. * * Return value: a #CoglPixelBuffer representing the newly created array - * - * Since: 1.10 - * Stability: Unstable */ CoglBitmap * _cogl_bitmap_new_with_malloc_buffer (CoglContext *context, diff --git a/cogl/cogl/cogl-bitmap.h b/cogl/cogl/cogl-bitmap.h index 955fbb59d..504987f78 100644 --- a/cogl/cogl/cogl-bitmap.h +++ b/cogl/cogl/cogl-bitmap.h @@ -78,8 +78,6 @@ GType cogl_bitmap_get_gtype (void); * * Return value: (transfer full): a #CoglBitmap to the new loaded * image data, or %NULL if loading the image failed. - * - * Since: 1.0 */ COGL_EXPORT CoglBitmap * cogl_bitmap_new_from_file (const char *filename, @@ -100,9 +98,6 @@ cogl_bitmap_new_from_file (const char *filename, * a #CoglBitmap. The data is not copied in this process. * * Return value: (transfer full): a #CoglBitmap encapsulating the given @buffer. - * - * Since: 1.8 - * Stability: unstable */ COGL_EXPORT CoglBitmap * cogl_bitmap_new_from_buffer (CoglBuffer *buffer, @@ -137,9 +132,6 @@ cogl_bitmap_new_from_buffer (CoglBuffer *buffer, * * Return value: (transfer full): a #CoglPixelBuffer representing the * newly created array or %NULL on failure - * - * Since: 1.10 - * Stability: Unstable */ COGL_EXPORT CoglBitmap * cogl_bitmap_new_with_size (CoglContext *context, @@ -164,8 +156,6 @@ cogl_bitmap_new_with_size (CoglContext *context, * into an application buffer with the specified rowstride. * * Return value: (transfer full): A new #CoglBitmap. - * Since: 1.10 - * Stability: unstable */ COGL_EXPORT CoglBitmap * cogl_bitmap_new_for_data (CoglContext *context, @@ -180,8 +170,6 @@ cogl_bitmap_new_for_data (CoglContext *context, * @bitmap: A #CoglBitmap * * Return value: the #CoglPixelFormat that the data for the bitmap is in. - * Since: 1.10 - * Stability: unstable */ COGL_EXPORT CoglPixelFormat cogl_bitmap_get_format (CoglBitmap *bitmap); @@ -191,8 +179,6 @@ cogl_bitmap_get_format (CoglBitmap *bitmap); * @bitmap: A #CoglBitmap * * Return value: the width of the bitmap - * Since: 1.10 - * Stability: unstable */ COGL_EXPORT int cogl_bitmap_get_width (CoglBitmap *bitmap); @@ -202,8 +188,6 @@ cogl_bitmap_get_width (CoglBitmap *bitmap); * @bitmap: A #CoglBitmap * * Return value: the height of the bitmap - * Since: 1.10 - * Stability: unstable */ COGL_EXPORT int cogl_bitmap_get_height (CoglBitmap *bitmap); @@ -215,8 +199,6 @@ cogl_bitmap_get_height (CoglBitmap *bitmap); * Return value: the rowstride of the bitmap. This is the number of * bytes between the address of start of one row to the address of the * next row in the image. - * Since: 1.10 - * Stability: unstable */ COGL_EXPORT int cogl_bitmap_get_rowstride (CoglBitmap *bitmap); @@ -229,8 +211,6 @@ cogl_bitmap_get_rowstride (CoglBitmap *bitmap); * buffer uses for storage. Note that if the bitmap was created with * cogl_bitmap_new_from_file() then it will not actually be using a * pixel buffer and this function will return %NULL. - * Stability: unstable - * Since: 1.10 */ COGL_EXPORT CoglPixelBuffer * cogl_bitmap_get_buffer (CoglBitmap *bitmap); @@ -245,8 +225,6 @@ cogl_bitmap_get_buffer (CoglBitmap *bitmap); * of the bitmap. * * Return value: %TRUE if the image was successfully parsed - * - * Since: 1.0 */ COGL_EXPORT gboolean cogl_bitmap_get_size_from_file (const char *filename, @@ -261,8 +239,6 @@ cogl_bitmap_get_size_from_file (const char *filename, * * Return value: %TRUE if the passed @object represents a bitmap, * and %FALSE otherwise - * - * Since: 1.0 */ COGL_EXPORT gboolean cogl_is_bitmap (void *object); @@ -271,8 +247,6 @@ cogl_is_bitmap (void *object); * COGL_BITMAP_ERROR: * * #GError domain for bitmap errors. - * - * Since: 1.4 */ #define COGL_BITMAP_ERROR (cogl_bitmap_error_quark ()) @@ -288,8 +262,6 @@ cogl_is_bitmap (void *object); * errors directly from the underlying image loading library. For * example, if GdkPixbuf is used then errors #GdkPixbufErrors * will be used directly. - * - * Since: 1.4 */ typedef enum { diff --git a/cogl/cogl/cogl-buffer.h b/cogl/cogl/cogl-buffer.h index 4dc1f5744..f1f906502 100644 --- a/cogl/cogl/cogl-buffer.h +++ b/cogl/cogl/cogl-buffer.h @@ -46,7 +46,6 @@ G_BEGIN_DECLS /** * SECTION:cogl-buffer * @short_description: Common buffer functions, including data upload APIs - * @stability: unstable * * The CoglBuffer API provides a common interface to manipulate * buffers that have been allocated either via cogl_pixel_buffer_new() @@ -85,8 +84,6 @@ typedef struct _CoglBuffer CoglBuffer; * limitation was hit. * * Error enumeration for #CoglBuffer - * - * Stability: unstable */ typedef enum /*< prefix=COGL_BUFFER_ERROR >*/ { @@ -103,9 +100,6 @@ _cogl_buffer_error_domain (void); * Checks whether @buffer is a buffer object. * * Return value: %TRUE if the handle is a CoglBuffer, and %FALSE otherwise - * - * Since: 1.2 - * Stability: unstable */ COGL_EXPORT gboolean cogl_is_buffer (void *object); @@ -117,9 +111,6 @@ cogl_is_buffer (void *object); * Retrieves the size of buffer * * Return value: the size of the buffer in bytes - * - * Since: 1.2 - * Stability: unstable */ COGL_EXPORT unsigned int cogl_buffer_get_size (CoglBuffer *buffer); @@ -133,9 +124,6 @@ cogl_buffer_get_size (CoglBuffer *buffer); * * The update hint on a buffer allows the user to give some detail on how often * the buffer data is going to be updated. - * - * Since: 1.2 - * Stability: unstable */ typedef enum /*< prefix=COGL_BUFFER_UPDATE_HINT >*/ { @@ -151,9 +139,6 @@ typedef enum /*< prefix=COGL_BUFFER_UPDATE_HINT >*/ * * Sets the update hint on a buffer. See #CoglBufferUpdateHint for a description * of the available hints. - * - * Since: 1.2 - * Stability: unstable */ COGL_EXPORT void cogl_buffer_set_update_hint (CoglBuffer *buffer, @@ -166,9 +151,6 @@ cogl_buffer_set_update_hint (CoglBuffer *buffer, * Retrieves the update hints set using cogl_buffer_set_update_hint() * * Return value: the #CoglBufferUpdateHint currently used by the buffer - * - * Since: 1.2 - * Stability: unstable */ COGL_EXPORT CoglBufferUpdateHint cogl_buffer_get_update_hint (CoglBuffer *buffer); @@ -181,9 +163,6 @@ cogl_buffer_get_update_hint (CoglBuffer *buffer); * writing * * The access hints for cogl_buffer_set_update_hint() - * - * Since: 1.2 - * Stability: unstable */ typedef enum /*< prefix=COGL_BUFFER_ACCESS >*/ { @@ -206,9 +185,6 @@ typedef enum /*< prefix=COGL_BUFFER_ACCESS >*/ * * Hints to Cogl about how you are planning to modify the data once it * is mapped. - * - * Since: 1.4 - * Stability: unstable */ typedef enum /*< prefix=COGL_BUFFER_MAP_HINT >*/ { @@ -240,9 +216,6 @@ typedef enum /*< prefix=COGL_BUFFER_MAP_HINT >*/ * * Return value: (transfer none): A pointer to the mapped memory or * %NULL is the call fails - * - * Since: 1.2 - * Stability: unstable */ COGL_EXPORT void * cogl_buffer_map (CoglBuffer *buffer, @@ -277,9 +250,6 @@ cogl_buffer_map (CoglBuffer *buffer, * * Return value: (transfer none): A pointer to the mapped memory or * %NULL is the call fails - * - * Since: 2.0 - * Stability: unstable */ COGL_EXPORT void * cogl_buffer_map_range (CoglBuffer *buffer, @@ -294,9 +264,6 @@ cogl_buffer_map_range (CoglBuffer *buffer, * @buffer: a buffer object * * Unmaps a buffer previously mapped by cogl_buffer_map(). - * - * Since: 1.2 - * Stability: unstable */ COGL_EXPORT void cogl_buffer_unmap (CoglBuffer *buffer); @@ -313,9 +280,6 @@ cogl_buffer_unmap (CoglBuffer *buffer); * buffer size. * * Return value: %TRUE is the operation succeeded, %FALSE otherwise - * - * Since: 1.2 - * Stability: unstable */ COGL_EXPORT gboolean cogl_buffer_set_data (CoglBuffer *buffer, diff --git a/cogl/cogl/cogl-color.h b/cogl/cogl/cogl-color.h index 0defb733c..b03245d63 100644 --- a/cogl/cogl/cogl-color.h +++ b/cogl/cogl/cogl-color.h @@ -41,8 +41,6 @@ * * #CoglColor is a simple structure holding the definition of a color such * that it can be efficiently used by GL - * - * Since: 1.0 */ #include @@ -67,8 +65,6 @@ GType cogl_color_get_gtype (void); * * Return value: a newly-allocated #CoglColor. Use cogl_color_free() * to free the allocated resources - * - * Since: 1.0 */ COGL_EXPORT CoglColor * cogl_color_new (void); @@ -81,8 +77,6 @@ cogl_color_new (void); * * Return value: a newly-allocated #CoglColor. Use cogl_color_free() * to free the allocate resources - * - * Since: 1.0 */ COGL_EXPORT CoglColor * cogl_color_copy (const CoglColor *color); @@ -92,8 +86,6 @@ cogl_color_copy (const CoglColor *color); * @color: the color to free * * Frees the resources allocated by cogl_color_new() and cogl_color_copy() - * - * Since: 1.0 */ COGL_EXPORT void cogl_color_free (CoglColor *color); @@ -107,8 +99,6 @@ cogl_color_free (CoglColor *color); * @alpha: value of the alpha channel, between 0 and 255 * * Sets the values of the passed channels into a #CoglColor. - * - * Since: 1.4 */ COGL_EXPORT void cogl_color_init_from_4ub (CoglColor *color, @@ -126,8 +116,6 @@ cogl_color_init_from_4ub (CoglColor *color, * @alpha: value of the alpha channel, between 0 and 1.0 * * Sets the values of the passed channels into a #CoglColor - * - * Since: 1.4 */ COGL_EXPORT void cogl_color_init_from_4f (CoglColor *color, @@ -142,8 +130,6 @@ cogl_color_init_from_4f (CoglColor *color, * @color_array: a pointer to an array of 4 float color components * * Sets the values of the passed channels into a #CoglColor - * - * Since: 1.4 */ COGL_EXPORT void cogl_color_init_from_4fv (CoglColor *color, @@ -157,8 +143,6 @@ cogl_color_init_from_4fv (CoglColor *color, * between 0 and 255 * * Return value: the red channel of the passed color - * - * Since: 1.0 */ COGL_EXPORT unsigned char cogl_color_get_red_byte (const CoglColor *color); @@ -171,8 +155,6 @@ cogl_color_get_red_byte (const CoglColor *color); * between 0 and 255 * * Return value: the green channel of the passed color - * - * Since: 1.0 */ COGL_EXPORT unsigned char cogl_color_get_green_byte (const CoglColor *color); @@ -185,8 +167,6 @@ cogl_color_get_green_byte (const CoglColor *color); * between 0 and 255 * * Return value: the blue channel of the passed color - * - * Since: 1.0 */ COGL_EXPORT unsigned char cogl_color_get_blue_byte (const CoglColor *color); @@ -199,8 +179,6 @@ cogl_color_get_blue_byte (const CoglColor *color); * between 0 and 255 * * Return value: the alpha channel of the passed color - * - * Since: 1.0 */ COGL_EXPORT unsigned char cogl_color_get_alpha_byte (const CoglColor *color); @@ -213,8 +191,6 @@ cogl_color_get_alpha_byte (const CoglColor *color); * value between 0.0 and 1.0 * * Return value: the red channel of the passed color - * - * Since: 1.0 */ COGL_EXPORT float cogl_color_get_red_float (const CoglColor *color); @@ -227,8 +203,6 @@ cogl_color_get_red_float (const CoglColor *color); * value between 0.0 and 1.0 * * Return value: the green channel of the passed color - * - * Since: 1.0 */ COGL_EXPORT float cogl_color_get_green_float (const CoglColor *color); @@ -241,8 +215,6 @@ cogl_color_get_green_float (const CoglColor *color); * value between 0.0 and 1.0 * * Return value: the blue channel of the passed color - * - * Since: 1.0 */ COGL_EXPORT float cogl_color_get_blue_float (const CoglColor *color); @@ -255,8 +227,6 @@ cogl_color_get_blue_float (const CoglColor *color); * value between 0.0 and 1.0 * * Return value: the alpha channel of the passed color - * - * Since: 1.0 */ COGL_EXPORT float cogl_color_get_alpha_float (const CoglColor *color); @@ -269,8 +239,6 @@ cogl_color_get_alpha_float (const CoglColor *color); * value between 0 and 1.0. * * Return value: the red channel of the passed color - * - * Since: 1.0 */ COGL_EXPORT float cogl_color_get_red (const CoglColor *color); @@ -283,8 +251,6 @@ cogl_color_get_red (const CoglColor *color); * value between 0 and 1.0. * * Return value: the green channel of the passed color - * - * Since: 1.0 */ COGL_EXPORT float cogl_color_get_green (const CoglColor *color); @@ -297,8 +263,6 @@ cogl_color_get_green (const CoglColor *color); * value between 0 and 1.0. * * Return value: the blue channel of the passed color - * - * Since: 1.0 */ COGL_EXPORT float cogl_color_get_blue (const CoglColor *color); @@ -311,8 +275,6 @@ cogl_color_get_blue (const CoglColor *color); * value between 0 and 1.0. * * Return value: the alpha channel of the passed color - * - * Since: 1.0 */ COGL_EXPORT float cogl_color_get_alpha (const CoglColor *color); @@ -323,8 +285,6 @@ cogl_color_get_alpha (const CoglColor *color); * @red: a byte value between 0 and 255 * * Sets the red channel of @color to @red. - * - * Since: 1.4 */ COGL_EXPORT void cogl_color_set_red_byte (CoglColor *color, @@ -336,8 +296,6 @@ cogl_color_set_red_byte (CoglColor *color, * @green: a byte value between 0 and 255 * * Sets the green channel of @color to @green. - * - * Since: 1.4 */ COGL_EXPORT void cogl_color_set_green_byte (CoglColor *color, @@ -349,8 +307,6 @@ cogl_color_set_green_byte (CoglColor *color, * @blue: a byte value between 0 and 255 * * Sets the blue channel of @color to @blue. - * - * Since: 1.4 */ COGL_EXPORT void cogl_color_set_blue_byte (CoglColor *color, @@ -362,8 +318,6 @@ cogl_color_set_blue_byte (CoglColor *color, * @alpha: a byte value between 0 and 255 * * Sets the alpha channel of @color to @alpha. - * - * Since: 1.4 */ COGL_EXPORT void cogl_color_set_alpha_byte (CoglColor *color, @@ -375,8 +329,6 @@ cogl_color_set_alpha_byte (CoglColor *color, * @red: a float value between 0.0f and 1.0f * * Sets the red channel of @color to @red. - * - * since: 1.4 */ COGL_EXPORT void cogl_color_set_red_float (CoglColor *color, @@ -388,8 +340,6 @@ cogl_color_set_red_float (CoglColor *color, * @green: a float value between 0.0f and 1.0f * * Sets the green channel of @color to @green. - * - * since: 1.4 */ COGL_EXPORT void cogl_color_set_green_float (CoglColor *color, @@ -401,8 +351,6 @@ cogl_color_set_green_float (CoglColor *color, * @blue: a float value between 0.0f and 1.0f * * Sets the blue channel of @color to @blue. - * - * since: 1.4 */ COGL_EXPORT void cogl_color_set_blue_float (CoglColor *color, @@ -414,8 +362,6 @@ cogl_color_set_blue_float (CoglColor *color, * @alpha: a float value between 0.0f and 1.0f * * Sets the alpha channel of @color to @alpha. - * - * since: 1.4 */ COGL_EXPORT void cogl_color_set_alpha_float (CoglColor *color, @@ -427,8 +373,6 @@ cogl_color_set_alpha_float (CoglColor *color, * @red: a float value between 0.0f and 1.0f * * Sets the red channel of @color to @red. - * - * Since: 1.4 */ COGL_EXPORT void cogl_color_set_red (CoglColor *color, @@ -440,8 +384,6 @@ cogl_color_set_red (CoglColor *color, * @green: a float value between 0.0f and 1.0f * * Sets the green channel of @color to @green. - * - * Since: 1.4 */ COGL_EXPORT void cogl_color_set_green (CoglColor *color, @@ -453,8 +395,6 @@ cogl_color_set_green (CoglColor *color, * @blue: a float value between 0.0f and 1.0f * * Sets the blue channel of @color to @blue. - * - * Since: 1.4 */ COGL_EXPORT void cogl_color_set_blue (CoglColor *color, @@ -466,8 +406,6 @@ cogl_color_set_blue (CoglColor *color, * @alpha: a float value between 0.0f and 1.0f * * Sets the alpha channel of @color to @alpha. - * - * Since: 1.4 */ COGL_EXPORT void cogl_color_set_alpha (CoglColor *color, @@ -480,8 +418,6 @@ cogl_color_set_alpha (CoglColor *color, * Converts a non-premultiplied color to a pre-multiplied color. For * example, semi-transparent red is (1.0, 0, 0, 0.5) when non-premultiplied * and (0.5, 0, 0, 0.5) when premultiplied. - * - * Since: 1.0 */ COGL_EXPORT void cogl_color_premultiply (CoglColor *color); @@ -493,8 +429,6 @@ cogl_color_premultiply (CoglColor *color); * Converts a pre-multiplied color to a non-premultiplied color. For * example, semi-transparent red is (0.5, 0, 0, 0.5) when premultiplied * and (1.0, 0, 0, 0.5) when non-premultiplied. - * - * Since: 1.4 */ COGL_EXPORT void cogl_color_unpremultiply (CoglColor *color); @@ -510,8 +444,6 @@ cogl_color_unpremultiply (CoglColor *color); * parameter, when using #CoglColors as keys in a #GHashTable. * * Return value: %TRUE if the two colors are the same. - * - * Since: 1.0 */ COGL_EXPORT gboolean cogl_color_equal (const void *v1, const void *v2); @@ -527,8 +459,6 @@ cogl_color_equal (const void *v1, const void *v2); * * The @hue value is in the 0 .. 360 range. The @luminance and * @saturation values are in the 0 .. 1 range. - * - * Since: 1.16 */ COGL_EXPORT void cogl_color_to_hsl (const CoglColor *color, @@ -545,8 +475,6 @@ cogl_color_to_hsl (const CoglColor *color, * * Converts a color expressed in HLS (hue, luminance and saturation) * values into a #CoglColor. - * - * Since: 1.16 */ COGL_EXPORT void cogl_color_init_from_hsl (CoglColor *color, diff --git a/cogl/cogl/cogl-context.h b/cogl/cogl/cogl-context.h index dd4c3e8ef..bd43ae0f2 100644 --- a/cogl/cogl/cogl-context.h +++ b/cogl/cogl/cogl-context.h @@ -113,8 +113,6 @@ GType cogl_context_get_gtype (void); * for any state objects that are allocated. * * Return value: (transfer full): A newly allocated #CoglContext - * Since: 1.8 - * Stability: unstable */ COGL_EXPORT CoglContext * cogl_context_new (CoglDisplay *display, @@ -132,8 +130,6 @@ cogl_context_new (CoglDisplay *display, * * Return value: (transfer none): The #CoglDisplay associated with the * given @context. - * Since: 1.8 - * Stability: unstable */ COGL_EXPORT CoglDisplay * cogl_context_get_display (CoglContext *context); @@ -151,8 +147,6 @@ cogl_context_get_display (CoglContext *context); * * Return value: (transfer none): The #CoglRenderer associated with the * given @context. - * Since: 1.16 - * Stability: unstable */ COGL_EXPORT CoglRenderer * cogl_context_get_renderer (CoglContext *context); @@ -165,9 +159,6 @@ cogl_context_get_renderer (CoglContext *context); * * Return value: %TRUE if the @object references a #CoglContext, * %FALSE otherwise - * - * Since: 1.10 - * Stability: Unstable */ COGL_EXPORT gboolean cogl_is_context (void *object); @@ -196,8 +187,6 @@ cogl_is_context (void *object); * All the capabilities that can vary between different GPUs supported * by Cogl. Applications that depend on any of these features should explicitly * check for them using cogl_has_feature() or cogl_has_features(). - * - * Since: 1.10 */ typedef enum _CoglFeatureID { @@ -230,9 +219,6 @@ typedef enum _CoglFeatureID * * Returns: %TRUE if the @feature is currently supported or %FALSE if * not. - * - * Since: 1.10 - * Stability: unstable */ COGL_EXPORT gboolean cogl_has_feature (CoglContext *context, CoglFeatureID feature); @@ -250,9 +236,6 @@ cogl_has_feature (CoglContext *context, CoglFeatureID feature); * * Return value: %TRUE if all the features are available, %FALSE * otherwise. - * - * Since: 1.10 - * Stability: unstable */ COGL_EXPORT gboolean cogl_has_features (CoglContext *context, ...); @@ -264,9 +247,6 @@ cogl_has_features (CoglContext *context, ...); * * A callback used with cogl_foreach_feature() for enumerating all * context level features supported by Cogl. - * - * Since: 0.10 - * Stability: unstable */ typedef void (*CoglFeatureCallback) (CoglFeatureID feature, void *user_data); @@ -279,9 +259,6 @@ typedef void (*CoglFeatureCallback) (CoglFeatureID feature, void *user_data); * * Iterates through all the context level features currently supported * for a given @context and for each feature @callback is called. - * - * Since: 1.10 - * Stability: unstable */ COGL_EXPORT void cogl_foreach_feature (CoglContext *context, diff --git a/cogl/cogl/cogl-depth-state.h b/cogl/cogl/cogl-depth-state.h index b3b240526..70f5e874f 100644 --- a/cogl/cogl/cogl-depth-state.h +++ b/cogl/cogl/cogl-depth-state.h @@ -48,7 +48,6 @@ G_BEGIN_DECLS /** * CoglDepthState: * - * Since: 2.0 */ typedef struct { /*< private >*/ @@ -80,9 +79,6 @@ typedef struct { * * You should never pass an un initialized #CoglDepthState structure * to cogl_pipeline_set_depth_state(). - * - * Since: 2.0 - * Stability: Unstable */ COGL_EXPORT void cogl_depth_state_init (CoglDepthState *state); @@ -108,9 +104,6 @@ cogl_depth_state_init (CoglDepthState *state); * NB: this won't directly affect the state of the GPU. You have * to then set the state on a #CoglPipeline using * cogl_pipeline_set_depth_state() - * - * Since: 2.0 - * Stability: Unstable */ COGL_EXPORT void cogl_depth_state_set_test_enabled (CoglDepthState *state, @@ -124,8 +117,6 @@ cogl_depth_state_set_test_enabled (CoglDepthState *state, * cogl_depth_state_set_test_enabled(). * * Returns: The pipeline's current depth test enabled state. - * Since: 2.0 - * Stability: Unstable */ COGL_EXPORT gboolean cogl_depth_state_get_test_enabled (CoglDepthState *state); @@ -146,9 +137,6 @@ cogl_depth_state_get_test_enabled (CoglDepthState *state); * NB: this won't directly affect the state of the GPU. You have * to then set the state on a #CoglPipeline using * cogl_pipeline_set_depth_state() - * - * Since: 2.0 - * Stability: Unstable */ COGL_EXPORT void cogl_depth_state_set_write_enabled (CoglDepthState *state, @@ -162,8 +150,6 @@ cogl_depth_state_set_write_enabled (CoglDepthState *state, * cogl_depth_state_set_write_enabled(). * * Returns: The current depth writing enable state - * Since: 2.0 - * Stability: Unstable */ COGL_EXPORT gboolean cogl_depth_state_get_write_enabled (CoglDepthState *state); @@ -182,9 +168,6 @@ cogl_depth_state_get_write_enabled (CoglDepthState *state); * NB: this won't directly affect the state of the GPU. You have * to then set the state on a #CoglPipeline using * cogl_pipeline_set_depth_state() - * - * Since: 2.0 - * Stability: Unstable */ COGL_EXPORT void cogl_depth_state_set_test_function (CoglDepthState *state, @@ -198,8 +181,6 @@ cogl_depth_state_set_test_function (CoglDepthState *state, * cogl_depth_state_set_test_enabled(). * * Returns: The current depth test enable state. - * Since: 2.0 - * Stability: Unstable */ COGL_EXPORT CoglDepthTestFunction cogl_depth_state_get_test_function (CoglDepthState *state); @@ -231,9 +212,6 @@ cogl_depth_state_get_test_function (CoglDepthState *state); * NB: this won't directly affect the state of the GPU. You have * to then set the state on a #CoglPipeline using * cogl_pipeline_set_depth_state(). - * - * Since: 2.0 - * Stability: Unstable */ COGL_EXPORT void cogl_depth_state_set_range (CoglDepthState *state, @@ -249,9 +227,6 @@ cogl_depth_state_set_range (CoglDepthState *state, * Gets the current range to which normalized depth values are mapped * before writing to the depth buffer. This corresponds to the range * set with cogl_depth_state_set_range(). - * - * Since: 2.0 - * Stability: Unstable */ COGL_EXPORT void cogl_depth_state_get_range (CoglDepthState *state, diff --git a/cogl/cogl/cogl-display.h b/cogl/cogl/cogl-display.h index 098e436ae..dc06bbc9e 100644 --- a/cogl/cogl/cogl-display.h +++ b/cogl/cogl/cogl-display.h @@ -115,8 +115,6 @@ GType cogl_display_get_gtype (void); * * Return value: (transfer full): A newly allocated #CoglDisplay * object in a mutable configuration mode. - * Since: 1.10 - * Stability: unstable */ COGL_EXPORT CoglDisplay * cogl_display_new (CoglRenderer *renderer, @@ -130,8 +128,6 @@ cogl_display_new (CoglRenderer *renderer, * * Return value: (transfer none): The associated #CoglRenderer * - * Since: 1.10 - * Stability: unstable */ COGL_EXPORT CoglRenderer * cogl_display_get_renderer (CoglDisplay *display); @@ -148,9 +144,6 @@ cogl_display_get_renderer (CoglDisplay *display); * final setup of the display may constrain how onscreen framebuffers may be * allocated. If Cogl knows how an application wants to allocate onscreen * framebuffers then it can try to make sure to setup the display accordingly. - * - * Since: 1.16 - * Stability: unstable */ COGL_EXPORT void cogl_display_set_onscreen_template (CoglDisplay *display, @@ -184,8 +177,6 @@ cogl_display_set_onscreen_template (CoglDisplay *display, * * Return value: Returns %TRUE if there was no error, else it returns * %FALSE and returns an exception via @error. - * Since: 1.10 - * Stability: unstable */ COGL_EXPORT gboolean cogl_display_setup (CoglDisplay *display, @@ -199,8 +190,6 @@ cogl_display_setup (CoglDisplay *display, * * Return value: %TRUE if the object references a #CoglDisplay * and %FALSE otherwise. - * Since: 1.10 - * Stability: unstable */ COGL_EXPORT gboolean cogl_is_display (void *object); diff --git a/cogl/cogl/cogl-egl.h b/cogl/cogl/cogl-egl.h index 07dac799b..0d9b6778f 100644 --- a/cogl/cogl/cogl-egl.h +++ b/cogl/cogl/cogl-egl.h @@ -73,8 +73,6 @@ G_BEGIN_DECLS * cogl_renderer_get_winsys_id(). * * Return value: The internally setup EGLDisplay handle. - * Since: 1.8 - * Stability: unstable */ COGL_EXPORT EGLDisplay cogl_egl_context_get_egl_display (CoglContext *context); diff --git a/cogl/cogl/cogl-fence.h b/cogl/cogl/cogl-fence.h index 22cb88e1f..15559388e 100644 --- a/cogl/cogl/cogl-fence.h +++ b/cogl/cogl/cogl-fence.h @@ -53,9 +53,6 @@ * An opaque object representing a fence. This type is currently * unused but in the future may be used to pass extra information * about the fence completion. - * - * Since: 2.0 - * Stability: Unstable */ typedef struct _CoglFence CoglFence; @@ -69,9 +66,6 @@ typedef struct _CoglFence CoglFence; * The callback prototype used with * cogl_framebuffer_add_fence_callback() for notification of GPU * command completion. - * - * Since: 2.0 - * Stability: Unstable */ typedef void (* CoglFenceCallback) (CoglFence *fence, void *user_data); @@ -81,9 +75,6 @@ typedef void (* CoglFenceCallback) (CoglFence *fence, * * An opaque type representing one future callback to be made when the * GPU command stream has passed a certain point. - * - * Since: 2.0 - * Stability: Unstable */ typedef struct _CoglFenceClosure CoglFenceClosure; @@ -93,9 +84,6 @@ typedef struct _CoglFenceClosure CoglFenceClosure; * * Returns the user_data submitted to cogl_framebuffer_add_fence() which * returned a given #CoglFenceClosure. - * - * Since: 2.0 - * Stability: Unstable */ COGL_EXPORT void * cogl_fence_closure_get_user_data (CoglFenceClosure *closure); @@ -114,9 +102,6 @@ cogl_fence_closure_get_user_data (CoglFenceClosure *closure); * be inserted and the callback will never be called. The user does not * need to free the closure; it will be freed automatically when the * callback is called, or cancelled. - * - * Since: 2.0 - * Stability: Unstable */ COGL_EXPORT CoglFenceClosure * cogl_framebuffer_add_fence_callback (CoglFramebuffer *framebuffer, @@ -132,9 +117,6 @@ cogl_framebuffer_add_fence_callback (CoglFramebuffer *framebuffer, * Removes a fence previously submitted with * cogl_framebuffer_add_fence_callback(); the callback will not be * called. - * - * Since: 2.0 - * Stability: Unstable */ COGL_EXPORT void cogl_framebuffer_cancel_fence_callback (CoglFramebuffer *framebuffer, diff --git a/cogl/cogl/cogl-frame-info.h b/cogl/cogl/cogl-frame-info.h index c0ff12bc1..ab10783b1 100644 --- a/cogl/cogl/cogl-frame-info.h +++ b/cogl/cogl/cogl-frame-info.h @@ -69,8 +69,6 @@ GType cogl_frame_info_get_gtype (void); * * Return value: %TRUE if the object references a #CoglFrameInfo * and %FALSE otherwise. - * Since: 2.0 - * Stability: unstable */ COGL_EXPORT gboolean cogl_is_frame_info (void *object); @@ -83,8 +81,6 @@ cogl_is_frame_info (void *object); * to this frame. * * Return value: The frame counter value - * Since: 1.14 - * Stability: unstable */ COGL_EXPORT int64_t cogl_frame_info_get_frame_counter (CoglFrameInfo *info); @@ -103,8 +99,6 @@ int64_t cogl_frame_info_get_frame_counter (CoglFrameInfo *info); * incorrectly report non-monotonic timestamps. * * Return value: the presentation time for the frame - * Since: 1.14 - * Stability: unstable */ COGL_EXPORT int64_t cogl_frame_info_get_presentation_time_us (CoglFrameInfo *info); @@ -123,8 +117,6 @@ int64_t cogl_frame_info_get_presentation_time_us (CoglFrameInfo *info); * cogl_output_get_refresh_rate(). * * Return value: the refresh rate in Hertz - * Since: 1.14 - * Stability: unstable */ COGL_EXPORT float cogl_frame_info_get_refresh_rate (CoglFrameInfo *info); diff --git a/cogl/cogl/cogl-framebuffer-private.h b/cogl/cogl/cogl-framebuffer-private.h index 945af926d..f83268d2f 100644 --- a/cogl/cogl/cogl-framebuffer-private.h +++ b/cogl/cogl/cogl-framebuffer-private.h @@ -294,9 +294,6 @@ _cogl_framebuffer_read_pixels_into_bitmap (CoglFramebuffer *framebuffer, * Retrieves the number of stencil bits of @framebuffer * * Return value: the number of bits - * - * Since: 2.0 - * Stability: unstable */ COGL_EXPORT int _cogl_framebuffer_get_stencil_bits (CoglFramebuffer *framebuffer); diff --git a/cogl/cogl/cogl-framebuffer.h b/cogl/cogl/cogl-framebuffer.h index 8e5aeb2e7..e89b8f3a7 100644 --- a/cogl/cogl/cogl-framebuffer.h +++ b/cogl/cogl/cogl-framebuffer.h @@ -119,8 +119,6 @@ struct _CoglFramebufferClass * automatic allocation. * * Return value: %TRUE if there were no error allocating the framebuffer, else %FALSE. - * Since: 1.8 - * Stability: unstable */ COGL_EXPORT gboolean cogl_framebuffer_allocate (CoglFramebuffer *framebuffer, @@ -133,8 +131,6 @@ cogl_framebuffer_allocate (CoglFramebuffer *framebuffer, * Queries the current width of the given @framebuffer. * * Return value: The width of @framebuffer. - * Since: 1.8 - * Stability: unstable */ COGL_EXPORT int cogl_framebuffer_get_width (CoglFramebuffer *framebuffer); @@ -146,8 +142,6 @@ cogl_framebuffer_get_width (CoglFramebuffer *framebuffer); * Queries the current height of the given @framebuffer. * * Return value: The height of @framebuffer. - * Since: 1.8 - * Stability: unstable */ COGL_EXPORT int cogl_framebuffer_get_height (CoglFramebuffer *framebuffer); @@ -178,8 +172,6 @@ cogl_framebuffer_get_height (CoglFramebuffer *framebuffer); * drivers only allow the use of integer values. In the future floating * point values will be exposed via a checkable feature. * - * Since: 1.8 - * Stability: unstable */ COGL_EXPORT void cogl_framebuffer_set_viewport (CoglFramebuffer *framebuffer, @@ -196,8 +188,6 @@ cogl_framebuffer_set_viewport (CoglFramebuffer *framebuffer, * or the default value which is 0. * * Return value: The x coordinate of the viewport origin. - * Since: 1.8 - * Stability: unstable */ COGL_EXPORT float cogl_framebuffer_get_viewport_x (CoglFramebuffer *framebuffer); @@ -210,8 +200,6 @@ cogl_framebuffer_get_viewport_x (CoglFramebuffer *framebuffer); * or the default value which is 0. * * Return value: The y coordinate of the viewport origin. - * Since: 1.8 - * Stability: unstable */ COGL_EXPORT float cogl_framebuffer_get_viewport_y (CoglFramebuffer *framebuffer); @@ -224,8 +212,6 @@ cogl_framebuffer_get_viewport_y (CoglFramebuffer *framebuffer); * or the default value which is the width of the framebuffer. * * Return value: The width of the viewport. - * Since: 1.8 - * Stability: unstable */ COGL_EXPORT float cogl_framebuffer_get_viewport_width (CoglFramebuffer *framebuffer); @@ -238,8 +224,6 @@ cogl_framebuffer_get_viewport_width (CoglFramebuffer *framebuffer); * or the default value which is the height of the framebuffer. * * Return value: The height of the viewport. - * Since: 1.8 - * Stability: unstable */ COGL_EXPORT float cogl_framebuffer_get_viewport_height (CoglFramebuffer *framebuffer); @@ -256,8 +240,6 @@ cogl_framebuffer_get_viewport_height (CoglFramebuffer *framebuffer); * framebuffer_width and framebuffer_height. The values are written into the * given @viewport array. * - * Since: 1.8 - * Stability: unstable */ COGL_EXPORT void cogl_framebuffer_get_viewport4fv (CoglFramebuffer *framebuffer, @@ -269,8 +251,6 @@ cogl_framebuffer_get_viewport4fv (CoglFramebuffer *framebuffer, * * Copies the current model-view matrix onto the matrix stack. The matrix * can later be restored with cogl_framebuffer_pop_matrix(). - * - * Since: 1.10 */ COGL_EXPORT void cogl_framebuffer_push_matrix (CoglFramebuffer *framebuffer); @@ -280,8 +260,6 @@ cogl_framebuffer_push_matrix (CoglFramebuffer *framebuffer); * @framebuffer: A #CoglFramebuffer pointer * * Restores the model-view matrix on the top of the matrix stack. - * - * Since: 1.10 */ COGL_EXPORT void cogl_framebuffer_pop_matrix (CoglFramebuffer *framebuffer); @@ -291,9 +269,6 @@ cogl_framebuffer_pop_matrix (CoglFramebuffer *framebuffer); * @framebuffer: A #CoglFramebuffer pointer * * Resets the current model-view matrix to the identity matrix. - * - * Since: 1.10 - * Stability: unstable */ COGL_EXPORT void cogl_framebuffer_identity_matrix (CoglFramebuffer *framebuffer); @@ -307,9 +282,6 @@ cogl_framebuffer_identity_matrix (CoglFramebuffer *framebuffer); * * Multiplies the current model-view matrix by one that scales the x, * y and z axes by the given values. - * - * Since: 1.10 - * Stability: unstable */ COGL_EXPORT void cogl_framebuffer_scale (CoglFramebuffer *framebuffer, @@ -326,9 +298,6 @@ cogl_framebuffer_scale (CoglFramebuffer *framebuffer, * * Multiplies the current model-view matrix by one that translates the * model along all three axes according to the given values. - * - * Since: 1.10 - * Stability: unstable */ COGL_EXPORT void cogl_framebuffer_translate (CoglFramebuffer *framebuffer, @@ -349,9 +318,6 @@ cogl_framebuffer_translate (CoglFramebuffer *framebuffer, * rotation follows the right-hand thumb rule so for example rotating * by 10 degrees about the axis-vector (0, 0, 1) causes a small * counter-clockwise rotation. - * - * Since: 1.10 - * Stability: unstable */ COGL_EXPORT void cogl_framebuffer_rotate (CoglFramebuffer *framebuffer, @@ -367,9 +333,6 @@ cogl_framebuffer_rotate (CoglFramebuffer *framebuffer, * * Multiplies the current model-view matrix by one that rotates * according to the rotation described by @euler. - * - * Since: 2.0 - * Stability: unstable */ COGL_EXPORT void cogl_framebuffer_rotate_euler (CoglFramebuffer *framebuffer, @@ -381,9 +344,6 @@ cogl_framebuffer_rotate_euler (CoglFramebuffer *framebuffer, * @matrix: the matrix to multiply with the current model-view * * Multiplies the current model-view matrix by the given matrix. - * - * Since: 1.10 - * Stability: unstable */ COGL_EXPORT void cogl_framebuffer_transform (CoglFramebuffer *framebuffer, @@ -395,9 +355,6 @@ cogl_framebuffer_transform (CoglFramebuffer *framebuffer, * @matrix: (out): return location for the model-view matrix * * Stores the current model-view matrix in @matrix. - * - * Since: 1.10 - * Stability: unstable */ COGL_EXPORT void cogl_framebuffer_get_modelview_matrix (CoglFramebuffer *framebuffer, @@ -409,9 +366,6 @@ cogl_framebuffer_get_modelview_matrix (CoglFramebuffer *framebuffer, * @matrix: the new model-view matrix * * Sets @matrix as the new model-view matrix. - * - * Since: 1.10 - * Stability: unstable */ COGL_EXPORT void cogl_framebuffer_set_modelview_matrix (CoglFramebuffer *framebuffer, @@ -433,9 +387,6 @@ cogl_framebuffer_set_modelview_matrix (CoglFramebuffer *framebuffer, * ratio since that will reduce the effectiveness of depth testing * since there won't be enough precision to identify the depth of * objects near to each other. - * - * Since: 1.10 - * Stability: unstable */ COGL_EXPORT void cogl_framebuffer_perspective (CoglFramebuffer *framebuffer, @@ -461,9 +412,6 @@ cogl_framebuffer_perspective (CoglFramebuffer *framebuffer, * Replaces the current projection matrix with a perspective matrix * for a given viewing frustum defined by 4 side clip planes that * all cross through the origin and 2 near and far clip planes. - * - * Since: 1.10 - * Stability: unstable */ COGL_EXPORT void cogl_framebuffer_frustum (CoglFramebuffer *framebuffer, @@ -490,9 +438,6 @@ cogl_framebuffer_frustum (CoglFramebuffer *framebuffer, * * Replaces the current projection matrix with an orthographic projection * matrix. - * - * Since: 1.10 - * Stability: unstable */ COGL_EXPORT void cogl_framebuffer_orthographic (CoglFramebuffer *framebuffer, @@ -509,9 +454,6 @@ cogl_framebuffer_orthographic (CoglFramebuffer *framebuffer, * @matrix: (out): return location for the projection matrix * * Stores the current projection matrix in @matrix. - * - * Since: 1.10 - * Stability: unstable */ COGL_EXPORT void cogl_framebuffer_get_projection_matrix (CoglFramebuffer *framebuffer, @@ -523,9 +465,6 @@ cogl_framebuffer_get_projection_matrix (CoglFramebuffer *framebuffer, * @matrix: the new projection matrix * * Sets @matrix as the new projection matrix. - * - * Since: 1.10 - * Stability: unstable */ COGL_EXPORT void cogl_framebuffer_set_projection_matrix (CoglFramebuffer *framebuffer, @@ -547,9 +486,6 @@ cogl_framebuffer_set_projection_matrix (CoglFramebuffer *framebuffer, * * The rectangle is intersected with the current clip region. To undo * the effect of this function, call cogl_framebuffer_pop_clip(). - * - * Since: 1.10 - * Stability: unstable */ COGL_EXPORT void cogl_framebuffer_push_scissor_clip (CoglFramebuffer *framebuffer, @@ -574,9 +510,6 @@ cogl_framebuffer_push_scissor_clip (CoglFramebuffer *framebuffer, * * The rectangle is intersected with the current clip region. To undo * the effect of this function, call cogl_framebuffer_pop_clip(). - * - * Since: 1.10 - * Stability: unstable */ COGL_EXPORT void cogl_framebuffer_push_rectangle_clip (CoglFramebuffer *framebuffer, @@ -610,9 +543,6 @@ cogl_framebuffer_push_rectangle_clip (CoglFramebuffer *framebuffer, * the silhouette is intersected with the previous clipping area. To * restore the previous clipping area, call * cogl_framebuffer_pop_clip(). - * - * Since: 1.10 - * Stability: unstable */ COGL_EXPORT void cogl_framebuffer_push_primitive_clip (CoglFramebuffer *framebuffer, @@ -633,9 +563,6 @@ cogl_framebuffer_push_region_clip (CoglFramebuffer *framebuffer, * Reverts the clipping region to the state before the last call to * cogl_framebuffer_push_scissor_clip(), cogl_framebuffer_push_rectangle_clip() * cogl_framebuffer_push_path_clip(), or cogl_framebuffer_push_primitive_clip(). - * - * Since: 1.10 - * Stability: unstable */ COGL_EXPORT void cogl_framebuffer_pop_clip (CoglFramebuffer *framebuffer); @@ -648,8 +575,6 @@ cogl_framebuffer_pop_clip (CoglFramebuffer *framebuffer); * * Return value: the number of bits * - * Since: 1.8 - * Stability: unstable */ COGL_EXPORT int cogl_framebuffer_get_red_bits (CoglFramebuffer *framebuffer); @@ -662,8 +587,6 @@ cogl_framebuffer_get_red_bits (CoglFramebuffer *framebuffer); * * Return value: the number of bits * - * Since: 1.8 - * Stability: unstable */ COGL_EXPORT int cogl_framebuffer_get_green_bits (CoglFramebuffer *framebuffer); @@ -676,8 +599,6 @@ cogl_framebuffer_get_green_bits (CoglFramebuffer *framebuffer); * * Return value: the number of bits * - * Since: 1.8 - * Stability: unstable */ COGL_EXPORT int cogl_framebuffer_get_blue_bits (CoglFramebuffer *framebuffer); @@ -690,8 +611,6 @@ cogl_framebuffer_get_blue_bits (CoglFramebuffer *framebuffer); * * Return value: the number of bits * - * Since: 1.8 - * Stability: unstable */ COGL_EXPORT int cogl_framebuffer_get_alpha_bits (CoglFramebuffer *framebuffer); @@ -703,9 +622,6 @@ cogl_framebuffer_get_alpha_bits (CoglFramebuffer *framebuffer); * Retrieves the number of depth bits of @framebuffer * * Return value: the number of bits - * - * Since: 2.0 - * Stability: unstable */ COGL_EXPORT int cogl_framebuffer_get_depth_bits (CoglFramebuffer *framebuffer); @@ -720,9 +636,6 @@ cogl_framebuffer_get_depth_bits (CoglFramebuffer *framebuffer); * * Return value: %TRUE if @framebuffer has separate left and * right buffers. - * - * Since: 1.20 - * Stability: unstable */ COGL_EXPORT gboolean cogl_framebuffer_get_is_stereo (CoglFramebuffer *framebuffer); @@ -739,8 +652,6 @@ cogl_framebuffer_get_is_stereo (CoglFramebuffer *framebuffer); * the user's request for dithering. * * Return value: %TRUE if dithering has been requested or %FALSE if not. - * Since: 1.8 - * Stability: unstable */ COGL_EXPORT gboolean cogl_framebuffer_get_dither_enabled (CoglFramebuffer *framebuffer); @@ -764,8 +675,6 @@ cogl_framebuffer_get_dither_enabled (CoglFramebuffer *framebuffer); * * Dithering is enabled by default. * - * Since: 1.8 - * Stability: unstable */ COGL_EXPORT void cogl_framebuffer_set_dither_enabled (CoglFramebuffer *framebuffer, @@ -779,8 +688,6 @@ cogl_framebuffer_set_dither_enabled (CoglFramebuffer *framebuffer, * can be controlled via cogl_framebuffer_set_depth_write_enabled(). * * Return value: %TRUE if depth writing is enabled or %FALSE if not. - * Since: 1.18 - * Stability: unstable */ COGL_EXPORT gboolean cogl_framebuffer_get_depth_write_enabled (CoglFramebuffer *framebuffer); @@ -796,9 +703,6 @@ cogl_framebuffer_get_depth_write_enabled (CoglFramebuffer *framebuffer); * information will be written to this buffer during rendering. * * Depth buffer writing is enabled by default. - * - * Since: 1.18 - * Stability: unstable */ COGL_EXPORT void cogl_framebuffer_set_depth_write_enabled (CoglFramebuffer *framebuffer, @@ -812,8 +716,6 @@ cogl_framebuffer_set_depth_write_enabled (CoglFramebuffer *framebuffer, * should be drawn to. See cogl_framebuffer_set_stereo_mode(). * * Returns: A #CoglStereoMode - * Since: 1.20 - * Stability: unstable */ COGL_EXPORT CoglStereoMode cogl_framebuffer_get_stereo_mode (CoglFramebuffer *framebuffer); @@ -831,9 +733,6 @@ cogl_framebuffer_get_stereo_mode (CoglFramebuffer *framebuffer); * and the framebuffer must have been created with stereo * enabled. (See cogl_onscreen_template_set_stereo_enabled(), * cogl_framebuffer_get_is_stereo().) - * - * Since: 1.20 - * Stability: unstable */ COGL_EXPORT void cogl_framebuffer_set_stereo_mode (CoglFramebuffer *framebuffer, @@ -877,8 +776,6 @@ cogl_framebuffer_set_stereo_mode (CoglFramebuffer *framebuffer, * framebuffer has changed this can lead to redundant work being * done. * - * Since: 1.8 - * Stability: unstable */ COGL_EXPORT void cogl_framebuffer_set_samples_per_pixel (CoglFramebuffer *framebuffer, @@ -904,9 +801,6 @@ cogl_framebuffer_set_samples_per_pixel (CoglFramebuffer *framebuffer, * Returns: The number of point samples made per pixel when * rasterizing geometry or 0 if single-sample rendering * has been chosen. - * - * Since: 1.10 - * Stability: unstable */ COGL_EXPORT int cogl_framebuffer_get_samples_per_pixel (CoglFramebuffer *framebuffer); @@ -937,8 +831,6 @@ cogl_framebuffer_get_samples_per_pixel (CoglFramebuffer *framebuffer); * should consider using cogl_framebuffer_resolve_samples_region() * instead to avoid resolving redundant pixels. * - * Since: 1.8 - * Stability: unstable */ COGL_EXPORT void cogl_framebuffer_resolve_samples (CoglFramebuffer *framebuffer); @@ -973,8 +865,6 @@ cogl_framebuffer_resolve_samples (CoglFramebuffer *framebuffer); * and if you have rendered to a larger region then it's possible that * other samples may be implicitly resolved. * - * Since: 1.8 - * Stability: unstable */ COGL_EXPORT void cogl_framebuffer_resolve_samples_region (CoglFramebuffer *framebuffer, @@ -993,8 +883,6 @@ cogl_framebuffer_resolve_samples_region (CoglFramebuffer *framebuffer, * * Return value: (transfer none): The #CoglContext that the given * @framebuffer was instantiated within. - * Since: 1.8 - * Stability: unstable */ COGL_EXPORT CoglContext * cogl_framebuffer_get_context (CoglFramebuffer *framebuffer); @@ -1010,8 +898,6 @@ cogl_framebuffer_get_context (CoglFramebuffer *framebuffer); * Clears all the auxiliary buffers identified in the @buffers mask, and if * that includes the color buffer then the specified @color is used. * - * Since: 1.8 - * Stability: unstable */ COGL_EXPORT void cogl_framebuffer_clear (CoglFramebuffer *framebuffer, @@ -1035,8 +921,6 @@ cogl_framebuffer_clear (CoglFramebuffer *framebuffer, * Clears all the auxiliary buffers identified in the @buffers mask, and if * that includes the color buffer then the specified @color is used. * - * Since: 1.8 - * Stability: unstable */ COGL_EXPORT void cogl_framebuffer_clear4f (CoglFramebuffer *framebuffer, @@ -1066,9 +950,6 @@ cogl_framebuffer_clear4f (CoglFramebuffer *framebuffer, * If you want to describe a rectangle with a texture mapped on * it then you can use * cogl_framebuffer_draw_textured_rectangle(). - * - * Since: 1.10 - * Stability: unstable */ COGL_EXPORT void cogl_framebuffer_draw_rectangle (CoglFramebuffer *framebuffer, @@ -1117,9 +998,6 @@ cogl_framebuffer_draw_rectangle (CoglFramebuffer *framebuffer, * (0, 0) corresponds to the top left and (1, 1) corresponds to the * bottom right. To map an entire texture across the rectangle pass * in @s_1=0, @t_1=0, @s_2=1, @t_2=1. - * - * Since: 1.10 - * Stability: unstable */ COGL_EXPORT void cogl_framebuffer_draw_textured_rectangle (CoglFramebuffer *framebuffer, @@ -1188,9 +1066,6 @@ cogl_framebuffer_draw_textured_rectangle (CoglFramebuffer *framebuffer, * smallest layer index) and if you supply less texture coordinates * than there are layers in the current source material then default * texture coordinates (0.0, 0.0, 1.0, 1.0) are generated. - * - * Since: 1.10 - * Stability: unstable */ COGL_EXPORT void cogl_framebuffer_draw_multitextured_rectangle (CoglFramebuffer *framebuffer, @@ -1232,9 +1107,6 @@ cogl_framebuffer_draw_multitextured_rectangle (CoglFramebuffer *framebuffer, * cogl_framebuffer_draw_textured_rectangle() separately for multiple * rectangles if all of the rectangles will be drawn together with the * same @pipeline state. - * - * Since: 1.10 - * Stability: unstable */ COGL_EXPORT void cogl_framebuffer_draw_rectangles (CoglFramebuffer *framebuffer, @@ -1286,9 +1158,6 @@ cogl_framebuffer_draw_rectangles (CoglFramebuffer *framebuffer, * bottom right. To map an entire texture across the rectangle pass * in tex_coords[0]=0, tex_coords[1]=0, tex_coords[2]=1, * tex_coords[3]=1. - * - * Since: 1.10 - * Stability: unstable */ COGL_EXPORT void cogl_framebuffer_draw_textured_rectangles (CoglFramebuffer *framebuffer, @@ -1322,8 +1191,6 @@ cogl_framebuffer_draw_textured_rectangles (CoglFramebuffer *framebuffer, * a #CoglOffscreen framebuffer since they are single-buffered. * * - * Since: 1.8 - * Stability: unstable */ COGL_EXPORT void cogl_framebuffer_discard_buffers (CoglFramebuffer *framebuffer, @@ -1342,9 +1209,6 @@ cogl_framebuffer_discard_buffers (CoglFramebuffer *framebuffer, * One example might be for benchmarking purposes to be sure timing * measurements reflect the time that the GPU is busy for not just the time it * takes to queue rendering commands. - * - * Stability: unstable - * Since: 1.10 */ COGL_EXPORT void cogl_framebuffer_finish (CoglFramebuffer *framebuffer); @@ -1372,8 +1236,6 @@ cogl_framebuffer_finish (CoglFramebuffer *framebuffer); * Return value: %TRUE if the read succeeded or %FALSE otherwise. The * function is only likely to fail if the bitmap points to a pixel * buffer and it could not be mapped. - * Since: 1.10 - * Stability: unstable */ COGL_EXPORT gboolean cogl_framebuffer_read_pixels_into_bitmap (CoglFramebuffer *framebuffer, @@ -1418,8 +1280,6 @@ cogl_framebuffer_read_pixels_into_bitmap (CoglFramebuffer *framebuffer, * ]| * * Return value: %TRUE if the read succeeded or %FALSE otherwise. - * Since: 1.10 - * Stability: unstable */ COGL_EXPORT gboolean cogl_framebuffer_read_pixels (CoglFramebuffer *framebuffer, @@ -1453,8 +1313,6 @@ typedef enum /*< prefix=COGL_FRAMEBUFFER_ERROR >*/ * * Return value: %TRUE if the object references a #CoglFramebuffer * and %FALSE otherwise. - * Since: 1.10 - * Stability: unstable */ COGL_EXPORT gboolean cogl_is_framebuffer (void *object); diff --git a/cogl/cogl/cogl-glib-source.h b/cogl/cogl/cogl-glib-source.h index cf192e3d7..c0001fbd3 100644 --- a/cogl/cogl/cogl-glib-source.h +++ b/cogl/cogl/cogl-glib-source.h @@ -63,9 +63,6 @@ G_BEGIN_DECLS * cogl_glib_renderer_source_new() * * Return value: a new #GSource - * - * Stability: unstable - * Since: 1.10 */ COGL_EXPORT GSource * cogl_glib_source_new (CoglContext *context, @@ -84,9 +81,6 @@ cogl_glib_source_new (CoglContext *context, * g_source_attach(). * * Return value: a new #GSource - * - * Stability: unstable - * Since: 1.16 */ COGL_EXPORT GSource * cogl_glib_renderer_source_new (CoglRenderer *renderer, diff --git a/cogl/cogl/cogl-graphene.h b/cogl/cogl/cogl-graphene.h index cd0d2971e..5de72d6fd 100644 --- a/cogl/cogl/cogl-graphene.h +++ b/cogl/cogl/cogl-graphene.h @@ -104,8 +104,6 @@ cogl_graphene_matrix_project_point (const graphene_matrix_t *matrix, * &results[0].x, * N_VERTICES); * ]| - * - * Stability: unstable */ COGL_EXPORT void cogl_graphene_matrix_transform_points (const graphene_matrix_t *matrix, @@ -159,8 +157,6 @@ cogl_graphene_matrix_transform_points (const graphene_matrix_t *matrix, * &results[0].x, * N_VERTICES); * ]| - * - * Stability: unstable */ COGL_EXPORT void cogl_graphene_matrix_project_points (const graphene_matrix_t *matrix, diff --git a/cogl/cogl/cogl-index-buffer.h b/cogl/cogl/cogl-index-buffer.h index bf9bf1e99..2bddbf3aa 100644 --- a/cogl/cogl/cogl-index-buffer.h +++ b/cogl/cogl/cogl-index-buffer.h @@ -74,9 +74,6 @@ COGL_EXPORT GType cogl_index_buffer_get_gtype (void); * address space using cogl_buffer_map(). * * Return value: (transfer full): A newly allocated #CoglIndexBuffer - * - * Since: 1.4 - * Stability: Unstable */ COGL_EXPORT CoglIndexBuffer * cogl_index_buffer_new (CoglContext *context, @@ -90,9 +87,6 @@ cogl_index_buffer_new (CoglContext *context, * * Returns: %TRUE if the @object references a #CoglIndexBuffer, * %FALSE otherwise - * - * Since: 1.4 - * Stability: Unstable */ COGL_EXPORT gboolean cogl_is_index_buffer (void *object); diff --git a/cogl/cogl/cogl-indices.h b/cogl/cogl/cogl-indices.h index 9c9c44d30..14f0d646d 100644 --- a/cogl/cogl/cogl-indices.h +++ b/cogl/cogl/cogl-indices.h @@ -150,8 +150,6 @@ cogl_get_rectangle_indices (CoglContext *context, int n_rectangles); * * Return value: %TRUE if the object references a #CoglIndices * and %FALSE otherwise. - * Since: 1.10 - * Stability: unstable */ COGL_EXPORT gboolean cogl_is_indices (void *object); diff --git a/cogl/cogl/cogl-meta-texture.h b/cogl/cogl/cogl-meta-texture.h index 9f7784d7d..686e77d89 100644 --- a/cogl/cogl/cogl-meta-texture.h +++ b/cogl/cogl/cogl-meta-texture.h @@ -124,9 +124,6 @@ typedef struct _CoglMetaTexture CoglMetaTexture; * A callback used with cogl_meta_texture_foreach_in_region() to * retrieve details of all the low-level #CoglTextures that * make up a given #CoglMetaTexture. - * - * Since: 1.10 - * Stability: unstable */ typedef void (*CoglMetaTextureCallback) (CoglTexture *sub_texture, const float *sub_texture_coords, @@ -173,9 +170,6 @@ typedef void (*CoglMetaTextureCallback) (CoglTexture *sub_texture, * For each low-level texture that makes up part of the given region * of the @meta_texture, @callback is called specifying how the * low-level texture maps to the original region. - * - * Since: 1.10 - * Stability: unstable */ COGL_EXPORT void cogl_meta_texture_foreach_in_region (CoglMetaTexture *meta_texture, diff --git a/cogl/cogl/cogl-object.h b/cogl/cogl/cogl-object.h index c93983f71..92681ca91 100644 --- a/cogl/cogl/cogl-object.h +++ b/cogl/cogl/cogl-object.h @@ -120,8 +120,6 @@ cogl_object_unref (void *object); * destroy_pipeline_private_cb); * } * ]| - * - * Since: 1.4 */ typedef struct { int unused; @@ -136,8 +134,6 @@ typedef struct { * given which will be called either if the object is destroyed or if * cogl_object_set_user_data() is called with NULL user_data for the * same key. - * - * Since: 1.4 */ typedef GDestroyNotify CoglUserDataDestroyCallback; @@ -149,9 +145,6 @@ typedef GDestroyNotify CoglUserDataDestroyCallback; * * This struct is used to pass information to the callback when * cogl_debug_object_foreach_type() is called. - * - * Since: 1.8 - * Stability: unstable */ typedef struct { const char *name; @@ -163,9 +156,6 @@ typedef struct { * @info: A pointer to a struct containing information about the type. * * A callback function to use for cogl_debug_object_foreach_type(). - * - * Since: 1.8 - * Stability: unstable */ typedef void (* CoglDebugObjectForeachTypeCallback) (const CoglDebugObjectTypeInfo *info, @@ -185,8 +175,6 @@ typedef void * Associates some private @user_data with a given #CoglObject. To * later remove the association call cogl_object_set_user_data() with * the same @key but NULL for the @user_data. - * - * Since: 1.4 */ COGL_EXPORT void cogl_object_set_user_data (CoglObject *object, @@ -207,8 +195,6 @@ cogl_object_set_user_data (CoglObject *object, * Returns: (transfer none): The user data previously associated * with @object using the given @key; or %NULL if no associated * data is found. - * - * Since: 1.4 */ COGL_EXPORT void * cogl_object_get_user_data (CoglObject *object, @@ -223,9 +209,6 @@ cogl_object_get_user_data (CoglObject *object, * passes a count of the number of objects for that type. This is * intended to be used solely for debugging purposes to track down * issues with objects leaking. - * - * Since: 1.8 - * Stability: unstable */ COGL_EXPORT void cogl_debug_object_foreach_type (CoglDebugObjectForeachTypeCallback func, @@ -238,9 +221,6 @@ cogl_debug_object_foreach_type (CoglDebugObjectForeachTypeCallback func, * number of objects of that type that are currently in use. This is * intended to be used solely for debugging purposes to track down * issues with objects leaking. - * - * Since: 1.8 - * Stability: unstable */ COGL_EXPORT void cogl_debug_object_print_instances (void); diff --git a/cogl/cogl/cogl-onscreen-template.h b/cogl/cogl/cogl-onscreen-template.h index 9881e1c48..8c948737c 100644 --- a/cogl/cogl/cogl-onscreen-template.h +++ b/cogl/cogl/cogl-onscreen-template.h @@ -77,9 +77,6 @@ cogl_onscreen_template_new (CoglSwapChain *swap_chain); * being redundant to use the cogl_framebuffer_resolve_samples() and * cogl_framebuffer_resolve_samples_region() apis with single-sample * rendering. - * - * Since: 1.10 - * Stability: unstable */ COGL_EXPORT void cogl_onscreen_template_set_samples_per_pixel ( @@ -96,9 +93,6 @@ cogl_onscreen_template_set_samples_per_pixel ( * buffers, for use with stereo display. If the display system * does not support stereo, then creation of the framebuffer will * fail. - * - * Since: 1.20 - * Stability: unstable */ COGL_EXPORT void cogl_onscreen_template_set_stereo_enabled ( @@ -112,8 +106,6 @@ cogl_onscreen_template_set_stereo_enabled ( * * Return value: %TRUE if the object references a #CoglOnscreenTemplate * and %FALSE otherwise. - * Since: 1.10 - * Stability: unstable */ COGL_EXPORT gboolean cogl_is_onscreen_template (void *object); diff --git a/cogl/cogl/cogl-onscreen.h b/cogl/cogl/cogl-onscreen.h index 677893493..44ba12dc1 100644 --- a/cogl/cogl/cogl-onscreen.h +++ b/cogl/cogl/cogl-onscreen.h @@ -120,9 +120,6 @@ typedef enum _CoglScanoutError * requests e.g. to show an already visible window. This also means * that it's acceptable to alternatively use native APIs to show and * hide windows without confusing Cogl. - * - * Since: 2.0 - * Stability: Unstable */ COGL_EXPORT void cogl_onscreen_show (CoglOnscreen *onscreen); @@ -145,9 +142,6 @@ cogl_onscreen_show (CoglOnscreen *onscreen); * requests e.g. to show an already visible window. This also means * that it's acceptable to alternatively use native APIs to show and * hide windows without confusing Cogl. - * - * Since: 2.0 - * Stability: Unstable */ COGL_EXPORT void cogl_onscreen_hide (CoglOnscreen *onscreen); @@ -169,9 +163,6 @@ cogl_onscreen_hide (CoglOnscreen *onscreen); * and also use the cogl_onscreen_get_buffer_age() api so they can * perform incremental updates to older buffers instead of having to * render a full buffer for every frame. - * - * Since: 1.10 - * Stability: unstable */ COGL_EXPORT void cogl_onscreen_swap_buffers (CoglOnscreen *onscreen, @@ -224,9 +215,6 @@ cogl_onscreen_swap_buffers (CoglOnscreen *onscreen, * * Return value: The age of the buffer contents or 0 when the buffer * contents are undefined. - * - * Since: 1.14 - * Stability: stable */ COGL_EXPORT int cogl_onscreen_get_buffer_age (CoglOnscreen *onscreen); @@ -292,9 +280,6 @@ cogl_onscreen_queue_damage_region (CoglOnscreen *onscreen, * It is highly recommended to use this API in conjunction with * the cogl_onscreen_get_buffer_age() api so that your application can * perform incremental rendering based on old back buffers. - * - * Since: 1.16 - * Stability: unstable */ COGL_EXPORT void cogl_onscreen_swap_buffers_with_damage (CoglOnscreen *onscreen, @@ -336,9 +321,6 @@ cogl_onscreen_add_frame_info (CoglOnscreen *onscreen, * significance of the discard is that you should not expect to be able to * start a new frame that incrementally builds on the contents of the previous * frame. - * - * Since: 1.10 - * Stability: unstable */ COGL_EXPORT void cogl_onscreen_swap_region (CoglOnscreen *onscreen, @@ -374,9 +356,6 @@ cogl_onscreen_swap_region (CoglOnscreen *onscreen, * A frame may not be completed before the next frame can start * so applications should avoid needing to collect all statistics for * a particular frame before they can start a new frame. - * - * Since: 1.14 - * Stability: unstable */ typedef enum _CoglFrameEvent { @@ -400,9 +379,6 @@ typedef enum _CoglFrameEvent * Please see the documentation for #CoglFrameEvent and * cogl_onscreen_add_frame_callback() for more details about what * events can be notified. - * - * Since: 1.14 - * Stability: unstable */ typedef void (*CoglFrameCallback) (CoglOnscreen *onscreen, CoglFrameEvent event, @@ -416,9 +392,6 @@ typedef void (*CoglFrameCallback) (CoglOnscreen *onscreen, * data. A #CoglFrameClosure pointer will be returned from * cogl_onscreen_add_frame_callback() and it allows you to remove a * callback later using cogl_onscreen_remove_frame_callback(). - * - * Since: 1.14 - * Stability: unstable */ typedef struct _CoglClosure CoglFrameClosure; @@ -464,8 +437,6 @@ GType cogl_frame_closure_get_gtype (void); * * Return value: a #CoglFrameClosure pointer that can be used to * remove the callback and associated @user_data later. - * Since: 1.14 - * Stability: unstable */ COGL_EXPORT CoglFrameClosure * cogl_onscreen_add_frame_callback (CoglOnscreen *onscreen, @@ -485,9 +456,6 @@ cogl_onscreen_add_frame_callback (CoglOnscreen *onscreen, * If a destroy callback was passed to * cogl_onscreen_add_frame_callback() to destroy the user data then * this will get called. - * - * Since: 1.14 - * Stability: unstable */ COGL_EXPORT void cogl_onscreen_remove_frame_callback (CoglOnscreen *onscreen, @@ -503,9 +471,6 @@ cogl_onscreen_remove_frame_callback (CoglOnscreen *onscreen, * A structure passed to callbacks registered using * cogl_onscreen_add_dirty_callback(). The members describe a * rectangle within the onscreen buffer that should be redrawn. - * - * Since: 1.16 - * Stability: unstable */ typedef struct _CoglOnscreenDirtyInfo CoglOnscreenDirtyInfo; @@ -527,9 +492,6 @@ struct _CoglOnscreenDirtyInfo * cogl_onscreen_add_dirty_callback() to be called when the windowing * system determines that a region of the onscreen window has been * lost and the application should redraw it. - * - * Since: 1.16 - * Stability: unstable */ typedef void (*CoglOnscreenDirtyCallback) (CoglOnscreen *onscreen, const CoglOnscreenDirtyInfo *info, @@ -542,9 +504,6 @@ typedef void (*CoglOnscreenDirtyCallback) (CoglOnscreen *onscreen, * user data. A #CoglOnscreenDirtyClosure pointer will be returned from * cogl_onscreen_add_dirty_callback() and it allows you to remove a * callback later using cogl_onscreen_remove_dirty_callback(). - * - * Since: 1.16 - * Stability: unstable */ typedef struct _CoglClosure CoglOnscreenDirtyClosure; @@ -583,8 +542,6 @@ GType cogl_onscreen_dirty_closure_get_gtype (void); * * Return value: a #CoglOnscreenDirtyClosure pointer that can be used to * remove the callback and associated @user_data later. - * Since: 1.16 - * Stability: unstable */ COGL_EXPORT CoglOnscreenDirtyClosure * cogl_onscreen_add_dirty_callback (CoglOnscreen *onscreen, @@ -604,9 +561,6 @@ cogl_onscreen_add_dirty_callback (CoglOnscreen *onscreen, * If a destroy callback was passed to * cogl_onscreen_add_dirty_callback() to destroy the user data then * this will also get called. - * - * Since: 1.16 - * Stability: unstable */ COGL_EXPORT void cogl_onscreen_remove_dirty_callback (CoglOnscreen *onscreen, @@ -621,8 +575,6 @@ cogl_onscreen_remove_dirty_callback (CoglOnscreen *onscreen, * is called. * * Return value: the current frame counter value - * Since: 1.14 - * Stability: unstable */ COGL_EXPORT int64_t cogl_onscreen_get_frame_counter (CoglOnscreen *onscreen); diff --git a/cogl/cogl/cogl-output.h b/cogl/cogl/cogl-output.h index 6ea135cff..583c05e49 100644 --- a/cogl/cogl/cogl-output.h +++ b/cogl/cogl/cogl-output.h @@ -103,9 +103,6 @@ GType cogl_output_get_gtype (void); * of the layout of this subpixel components, it is possible * to create image content with higher resolution than the * pixel grid. - * - * Since: 1.14 - * Stability: unstable */ typedef enum { @@ -125,8 +122,6 @@ typedef enum * * Return value: %TRUE if the object references a #CoglOutput * and %FALSE otherwise. - * Since: 1.14 - * Stability: unstable */ COGL_EXPORT gboolean cogl_is_output (void *object); @@ -140,8 +135,6 @@ cogl_is_output (void *object); * * Return value: the X position of the output as a pixel offset * from the left side of the screen coordinate space - * Since: 1.14 - * Stability: unstable */ COGL_EXPORT int cogl_output_get_x (CoglOutput *output); @@ -155,8 +148,6 @@ cogl_output_get_x (CoglOutput *output); * * Return value: the Y position of the output as a pixel offset * from the top side of the screen coordinate space - * Since: 1.14 - * Stability: unstable */ COGL_EXPORT int cogl_output_get_y (CoglOutput *output); @@ -168,8 +159,6 @@ cogl_output_get_y (CoglOutput *output); * Gets the width of the output in pixels. * * Return value: the width of the output in pixels - * Since: 1.14 - * Stability: unstable */ COGL_EXPORT int cogl_output_get_width (CoglOutput *output); @@ -181,8 +170,6 @@ cogl_output_get_width (CoglOutput *output); * Gets the height of the output in pixels. * * Return value: the height of the output in pixels - * Since: 1.14 - * Stability: unstable */ COGL_EXPORT int cogl_output_get_height (CoglOutput *output); @@ -198,8 +185,6 @@ cogl_output_get_height (CoglOutput *output); * * Return value: the height of the output in millimeters. A value * of 0 indicates the width is unknown - * Since: 1.14 - * Stability: unstable */ COGL_EXPORT int cogl_output_get_mm_width (CoglOutput *output); @@ -215,8 +200,6 @@ cogl_output_get_mm_width (CoglOutput *output); * * Return value: the height of the output in millimeters. A value * of 0 indicates that the height is unknown - * Since: 1.14 - * Stability: unstable */ COGL_EXPORT int cogl_output_get_mm_height (CoglOutput *output); @@ -230,8 +213,6 @@ cogl_output_get_mm_height (CoglOutput *output); * components. * * Return value: the order of subpixel components for the output device - * Since: 1.14 - * Stability: unstable */ COGL_EXPORT CoglSubpixelOrder cogl_output_get_subpixel_order (CoglOutput *output); @@ -245,8 +226,6 @@ cogl_output_get_subpixel_order (CoglOutput *output); * * Return value: the refresh rate of the output device. A value of zero * indicates that the refresh rate is unknown. - * Since: 1.14 - * Stability: unstable */ COGL_EXPORT float cogl_output_get_refresh_rate (CoglOutput *output); diff --git a/cogl/cogl/cogl-pipeline-layer-state.h b/cogl/cogl/cogl-pipeline-layer-state.h index bf7b1bf20..b1773a560 100644 --- a/cogl/cogl/cogl-pipeline-layer-state.h +++ b/cogl/cogl/cogl-pipeline-layer-state.h @@ -104,8 +104,6 @@ typedef enum * if you are trying to render the full texture then you may get * artifacts around the edges when the pixels from the other side are * merged in if the wrap mode is set to repeat. - * - * Since: 2.0 */ /* GL_ALWAYS is just used here as a value that is known not to clash * with any valid GL wrap modes @@ -145,9 +143,6 @@ typedef enum * * In the future, we may define other types of pipeline layers, such * as purely GLSL based layers. - * - * Since: 2.0 - * Stability: unstable */ COGL_EXPORT void cogl_pipeline_set_layer_texture (CoglPipeline *pipeline, @@ -167,9 +162,6 @@ cogl_pipeline_set_layer_texture (CoglPipeline *pipeline, * cogl_pipeline_copy(). In that case this function can be used to * specify the texture type so that any pipeline copies can share the * internal texture type state for efficiency. - * - * Since: 1.10 - * Stability: unstable */ COGL_EXPORT void cogl_pipeline_set_layer_null_texture (CoglPipeline *pipeline, @@ -182,8 +174,6 @@ cogl_pipeline_set_layer_null_texture (CoglPipeline *pipeline, * * Return value: (transfer none): the texture that was set for the * given layer of the pipeline or %NULL if no texture was set. - * Stability: unstable - * Since: 1.10 */ COGL_EXPORT CoglTexture * cogl_pipeline_get_layer_texture (CoglPipeline *pipeline, @@ -195,8 +185,6 @@ cogl_pipeline_get_layer_texture (CoglPipeline *pipeline, * @layer_index: Specifies the layer you want to remove * * This function removes a layer from your pipeline - * Since: 1.10 - * Stability: unstable */ COGL_EXPORT void cogl_pipeline_remove_layer (CoglPipeline *pipeline, @@ -292,9 +280,6 @@ cogl_pipeline_remove_layer (CoglPipeline *pipeline, * Return value: %TRUE if the blend string was successfully parsed, and the * described texture combining is supported by the underlying driver and * or hardware. On failure, %FALSE is returned and @error is set - * - * Since: 2.0 - * Stability: unstable */ COGL_EXPORT gboolean cogl_pipeline_set_layer_combine (CoglPipeline *pipeline, @@ -311,9 +296,6 @@ cogl_pipeline_set_layer_combine (CoglPipeline *pipeline, * * When you are using the 'CONSTANT' color source in a layer combine * description then you can use this function to define its value. - * - * Since: 2.0 - * Stability: unstable */ COGL_EXPORT void cogl_pipeline_set_layer_combine_constant (CoglPipeline *pipeline, @@ -328,9 +310,6 @@ cogl_pipeline_set_layer_combine_constant (CoglPipeline *pipeline, * * This function lets you set a matrix that can be used to e.g. translate * and rotate a single layer of a pipeline used to fill your geometry. - * - * Since: 1.10 - * Stability: unstable */ COGL_EXPORT void cogl_pipeline_set_layer_matrix (CoglPipeline *pipeline, @@ -344,9 +323,6 @@ cogl_pipeline_set_layer_matrix (CoglPipeline *pipeline, * Retrieves the number of layers defined for the given @pipeline * * Return value: the number of layers - * - * Since: 2.0 - * Stability: unstable */ COGL_EXPORT int cogl_pipeline_get_n_layers (CoglPipeline *pipeline); @@ -365,9 +341,6 @@ cogl_pipeline_get_n_layers (CoglPipeline *pipeline); * %COGL_PIPELINE_FILTER_NEAREST or %COGL_PIPELINE_FILTER_LINEAR as * magnification filters since magnification doesn't ever need to * reference values stored in the mipmap chain. - * - * Since: 1.10 - * Stability: unstable */ COGL_EXPORT void cogl_pipeline_set_layer_filters (CoglPipeline *pipeline, @@ -389,8 +362,6 @@ cogl_pipeline_set_layer_filters (CoglPipeline *pipeline, * * Return value: The minification #CoglPipelineFilter for the * specified layer. - * Since: 1.10 - * Stability: unstable */ COGL_EXPORT CoglPipelineFilter cogl_pipeline_get_layer_min_filter (CoglPipeline *pipeline, @@ -410,8 +381,6 @@ cogl_pipeline_get_layer_min_filter (CoglPipeline *pipeline, * * Return value: The magnification #CoglPipelineFilter for the * specified layer. - * Since: 1.10 - * Stability: unstable */ COGL_EXPORT CoglPipelineFilter cogl_pipeline_get_layer_mag_filter (CoglPipeline *pipeline, @@ -432,8 +401,6 @@ cogl_pipeline_get_layer_mag_filter (CoglPipeline *pipeline, * fixed for the entire point. * * Return value: %TRUE if the function succeeds, %FALSE otherwise. - * Since: 2.0 - * Stability: unstable */ COGL_EXPORT gboolean cogl_pipeline_set_layer_point_sprite_coords_enabled (CoglPipeline *pipeline, @@ -451,9 +418,6 @@ cogl_pipeline_set_layer_point_sprite_coords_enabled (CoglPipeline *pipeline, * * Return value: whether the texture coordinates will be replaced with * point sprite coordinates. - * - * Since: 2.0 - * Stability: unstable */ COGL_EXPORT gboolean cogl_pipeline_get_layer_point_sprite_coords_enabled (CoglPipeline *pipeline, @@ -469,9 +433,6 @@ cogl_pipeline_get_layer_point_sprite_coords_enabled (CoglPipeline *pipeline, * * Return value: the wrap mode for the 's' coordinate of texture lookups on * this layer. - * - * Since: 1.6 - * Stability: unstable */ COGL_EXPORT CoglPipelineWrapMode cogl_pipeline_get_layer_wrap_mode_s (CoglPipeline *pipeline, @@ -484,9 +445,6 @@ cogl_pipeline_get_layer_wrap_mode_s (CoglPipeline *pipeline, * @mode: the new wrap mode * * Sets the wrap mode for the 's' coordinate of texture lookups on this layer. - * - * Since: 2.0 - * Stability: unstable */ COGL_EXPORT void cogl_pipeline_set_layer_wrap_mode_s (CoglPipeline *pipeline, @@ -503,9 +461,6 @@ cogl_pipeline_set_layer_wrap_mode_s (CoglPipeline *pipeline, * * Return value: the wrap mode for the 't' coordinate of texture lookups on * this layer. - * - * Since: 1.6 - * Stability: unstable */ COGL_EXPORT CoglPipelineWrapMode cogl_pipeline_get_layer_wrap_mode_t (CoglPipeline *pipeline, @@ -519,9 +474,6 @@ cogl_pipeline_get_layer_wrap_mode_t (CoglPipeline *pipeline, * @mode: the new wrap mode * * Sets the wrap mode for the 't' coordinate of texture lookups on this layer. - * - * Since: 2.0 - * Stability: unstable */ COGL_EXPORT void cogl_pipeline_set_layer_wrap_mode_t (CoglPipeline *pipeline, @@ -538,9 +490,6 @@ cogl_pipeline_set_layer_wrap_mode_t (CoglPipeline *pipeline, * this layer. This is equivalent to calling * cogl_pipeline_set_layer_wrap_mode_s() and * cogl_pipeline_set_layer_wrap_mode_t() separately. - * - * Since: 2.0 - * Stability: unstable */ COGL_EXPORT void cogl_pipeline_set_layer_wrap_mode (CoglPipeline *pipeline, @@ -558,9 +507,6 @@ cogl_pipeline_set_layer_wrap_mode (CoglPipeline *pipeline, * around depends on the hook that is given to * cogl_snippet_new(). Note that some hooks can't be used with a layer * and need to be added with cogl_pipeline_add_snippet() instead. - * - * Since: 1.10 - * Stability: Unstable */ COGL_EXPORT void cogl_pipeline_add_layer_snippet (CoglPipeline *pipeline, diff --git a/cogl/cogl/cogl-pipeline-state.h b/cogl/cogl/cogl-pipeline-state.h index 8e079e3f3..e993f13bf 100644 --- a/cogl/cogl/cogl-pipeline-state.h +++ b/cogl/cogl/cogl-pipeline-state.h @@ -54,9 +54,6 @@ G_BEGIN_DECLS * semi-transparent red. See cogl_color_premultiply(). * * The default value is (1.0, 1.0, 1.0, 1.0) - * - * Since: 2.0 - * Stability: Unstable */ COGL_EXPORT void cogl_pipeline_set_color (CoglPipeline *pipeline, @@ -73,9 +70,6 @@ cogl_pipeline_set_color (CoglPipeline *pipeline, * Sets the basic color of the pipeline, used when no lighting is enabled. * * The default value is (0xff, 0xff, 0xff, 0xff) - * - * Since: 2.0 - * Stability: Unstable */ COGL_EXPORT void cogl_pipeline_set_color4ub (CoglPipeline *pipeline, @@ -95,9 +89,6 @@ cogl_pipeline_set_color4ub (CoglPipeline *pipeline, * Sets the basic color of the pipeline, used when no lighting is enabled. * * The default value is (1.0, 1.0, 1.0, 1.0) - * - * Since: 2.0 - * Stability: Unstable */ COGL_EXPORT void cogl_pipeline_set_color4f (CoglPipeline *pipeline, @@ -112,9 +103,6 @@ cogl_pipeline_set_color4f (CoglPipeline *pipeline, * @color: (out): The location to store the color * * Retrieves the current pipeline color. - * - * Since: 2.0 - * Stability: Unstable */ COGL_EXPORT void cogl_pipeline_get_color (CoglPipeline *pipeline, @@ -169,9 +157,6 @@ typedef enum * and which continue on to the blending stage. * * The default is %COGL_PIPELINE_ALPHA_FUNC_ALWAYS - * - * Since: 2.0 - * Stability: Unstable */ COGL_EXPORT void cogl_pipeline_set_alpha_test_function (CoglPipeline *pipeline, @@ -183,9 +168,6 @@ cogl_pipeline_set_alpha_test_function (CoglPipeline *pipeline, * @pipeline: A #CoglPipeline object * * Return value: The alpha test function of @pipeline. - * - * Since: 2.0 - * Stability: Unstable */ COGL_EXPORT CoglPipelineAlphaFunc cogl_pipeline_get_alpha_test_function (CoglPipeline *pipeline); @@ -195,9 +177,6 @@ cogl_pipeline_get_alpha_test_function (CoglPipeline *pipeline); * @pipeline: A #CoglPipeline object * * Return value: The alpha test reference value of @pipeline. - * - * Since: 2.0 - * Stability: Unstable */ COGL_EXPORT float cogl_pipeline_get_alpha_test_reference (CoglPipeline *pipeline); @@ -280,9 +259,6 @@ cogl_pipeline_get_alpha_test_reference (CoglPipeline *pipeline); * described blending is supported by the underlying driver/hardware. If * there was an error, %FALSE is returned and @error is set accordingly (if * present). - * - * Since: 2.0 - * Stability: Unstable */ COGL_EXPORT gboolean cogl_pipeline_set_blend (CoglPipeline *pipeline, @@ -296,9 +272,6 @@ cogl_pipeline_set_blend (CoglPipeline *pipeline, * * When blending is setup to reference a CONSTANT blend factor then * blending will depend on the constant set with this function. - * - * Since: 2.0 - * Stability: Unstable */ COGL_EXPORT void cogl_pipeline_set_blend_constant (CoglPipeline *pipeline, @@ -321,9 +294,6 @@ cogl_pipeline_set_blend_constant (CoglPipeline *pipeline, * pipeline will have undefined results. This is the default value so * if an application wants to draw points it must make sure to use a * pipeline that has an explicit point size set on it. - * - * Since: 2.0 - * Stability: Unstable */ COGL_EXPORT void cogl_pipeline_set_point_size (CoglPipeline *pipeline, @@ -337,9 +307,6 @@ cogl_pipeline_set_point_size (CoglPipeline *pipeline, * used with the vertex buffer API. * * Return value: the point size of the @pipeline. - * - * Since: 2.0 - * Stability: Unstable */ COGL_EXPORT float cogl_pipeline_get_point_size (CoglPipeline *pipeline); @@ -360,9 +327,6 @@ cogl_pipeline_get_point_size (CoglPipeline *pipeline); * If per-vertex point size is enabled and this attribute is not used * and cogl_point_size_out is not written to then the results are * undefined. - * - * Since: 2.0 - * Stability: Unstable * Return value: %TRUE if the change succeeded or %FALSE otherwise */ COGL_EXPORT gboolean @@ -373,9 +337,6 @@ cogl_pipeline_set_per_vertex_point_size (CoglPipeline *pipeline, /** * cogl_pipeline_get_per_vertex_point_size: * @pipeline: a #CoglPipeline pointer - * - * Since: 2.0 - * Stability: Unstable * Return value: %TRUE if the pipeline has per-vertex point size * enabled or %FALSE otherwise. The per-vertex point size can be * enabled with cogl_pipeline_set_per_vertex_point_size(). @@ -391,9 +352,6 @@ cogl_pipeline_get_per_vertex_point_size (CoglPipeline *pipeline); * @pipeline using cogl_pipeline_set_user_program(). * * Return value: (transfer none): The current user program or %NULL. - * - * Since: 2.0 - * Stability: Unstable */ COGL_EXPORT CoglHandle cogl_pipeline_get_user_program (CoglPipeline *pipeline); @@ -436,9 +394,6 @@ cogl_pipeline_get_user_program (CoglPipeline *pipeline); * cogl_shader APIs in favour of a "snippet" framework) but in the * meantime we hope this will handle most practical GLSL and ARBfp * requirements. - * - * Since: 2.0 - * Stability: Unstable */ COGL_EXPORT void cogl_pipeline_set_user_program (CoglPipeline *pipeline, @@ -460,9 +415,6 @@ cogl_pipeline_set_user_program (CoglPipeline *pipeline, * * Returns: TRUE if the GPU supports all the given @state else %FALSE * and returns an @error. - * - * Since: 2.0 - * Stability: Unstable */ COGL_EXPORT gboolean cogl_pipeline_set_depth_state (CoglPipeline *pipeline, @@ -476,9 +428,6 @@ cogl_pipeline_set_depth_state (CoglPipeline *pipeline, * * Retrieves the current depth state configuration for the given * @pipeline as previously set using cogl_pipeline_set_depth_state(). - * - * Since: 2.0 - * Stability: Unstable */ COGL_EXPORT void cogl_pipeline_get_depth_state (CoglPipeline *pipeline, @@ -520,9 +469,6 @@ typedef enum * order to represent which faces are facing inside and outside the * model. This order can be specified by calling * cogl_pipeline_set_front_face_winding(). - * - * Status: Unstable - * Since: 2.0 */ COGL_EXPORT void cogl_pipeline_set_cull_face_mode (CoglPipeline *pipeline, @@ -533,9 +479,6 @@ cogl_pipeline_set_cull_face_mode (CoglPipeline *pipeline, * * Return value: the cull face mode that was previously set with * cogl_pipeline_set_cull_face_mode(). - * - * Status: Unstable - * Since: 2.0 */ COGL_EXPORT CoglPipelineCullFaceMode cogl_pipeline_get_cull_face_mode (CoglPipeline *pipeline); @@ -552,9 +495,6 @@ cogl_pipeline_get_cull_face_mode (CoglPipeline *pipeline); * primitives with vertices in a counter-clockwise order and * %COGL_WINDING_CLOCKWISE sets them to be clockwise. The default is * %COGL_WINDING_COUNTER_CLOCKWISE. - * - * Status: Unstable - * Since: 2.0 */ COGL_EXPORT void cogl_pipeline_set_front_face_winding (CoglPipeline *pipeline, @@ -573,9 +513,6 @@ cogl_pipeline_set_front_face_winding (CoglPipeline *pipeline, * %COGL_WINDING_COUNTER_CLOCKWISE. * * Returns: The @pipeline front face winding - * - * Status: Unstable - * Since: 2.0 */ COGL_EXPORT CoglWinding cogl_pipeline_get_front_face_winding (CoglPipeline *pipeline); @@ -596,9 +533,6 @@ cogl_pipeline_get_front_face_winding (CoglPipeline *pipeline); * This function should be used to set uniforms that are of type * float. It can also be used to set a single member of a float array * uniform. - * - * Since: 2.0 - * Stability: Unstable */ COGL_EXPORT void cogl_pipeline_set_uniform_1f (CoglPipeline *pipeline, @@ -621,9 +555,6 @@ cogl_pipeline_set_uniform_1f (CoglPipeline *pipeline, * This function should be used to set uniforms that are of type * int. It can also be used to set a single member of a int array * uniform or a sampler uniform. - * - * Since: 2.0 - * Stability: Unstable */ COGL_EXPORT void cogl_pipeline_set_uniform_1i (CoglPipeline *pipeline, @@ -650,9 +581,6 @@ cogl_pipeline_set_uniform_1i (CoglPipeline *pipeline, * single vec4 uniform you would use 4 for @n_components and 1 for * @count. To set an array of 8 float values, you could use 1 for * @n_components and 8 for @count. - * - * Since: 2.0 - * Stability: Unstable */ COGL_EXPORT void cogl_pipeline_set_uniform_float (CoglPipeline *pipeline, @@ -681,9 +609,6 @@ cogl_pipeline_set_uniform_float (CoglPipeline *pipeline, * ivec4 uniform you would use 4 for @n_components and 1 for * @count. To set an array of 8 int values, you could use 1 for * @n_components and 8 for @count. - * - * Since: 2.0 - * Stability: Unstable */ COGL_EXPORT void cogl_pipeline_set_uniform_int (CoglPipeline *pipeline, @@ -718,9 +643,6 @@ cogl_pipeline_set_uniform_int (CoglPipeline *pipeline, * row-major order. You can pass a #graphene_matrix_t by calling by passing * the result of graphene_matrix_to_float() in @value and setting * @transpose to %FALSE. - * - * Since: 2.0 - * Stability: Unstable */ COGL_EXPORT void cogl_pipeline_set_uniform_matrix (CoglPipeline *pipeline, @@ -739,9 +661,6 @@ cogl_pipeline_set_uniform_matrix (CoglPipeline *pipeline, * replace some part of the pipeline as defined by the hook point in * @snippet. Note that some hook points are specific to a layer and * must be added with cogl_pipeline_add_layer_snippet() instead. - * - * Since: 1.10 - * Stability: Unstable */ COGL_EXPORT void cogl_pipeline_add_snippet (CoglPipeline *pipeline, diff --git a/cogl/cogl/cogl-pipeline.h b/cogl/cogl/cogl-pipeline.h index f420a5a84..d24d8dc83 100644 --- a/cogl/cogl/cogl-pipeline.h +++ b/cogl/cogl/cogl-pipeline.h @@ -80,9 +80,6 @@ GType cogl_pipeline_get_gtype (void); * a primitive white. * * Return value: (transfer full): a pointer to a new #CoglPipeline - * - * Since: 2.0 - * Stability: Unstable */ COGL_EXPORT CoglPipeline * cogl_pipeline_new (CoglContext *context); @@ -101,9 +98,6 @@ cogl_pipeline_new (CoglContext *context); * state changes. * * Return value: (transfer full): a pointer to the newly allocated #CoglPipeline - * - * Since: 2.0 - * Stability: Unstable */ COGL_EXPORT CoglPipeline * cogl_pipeline_copy (CoglPipeline *source); @@ -116,9 +110,6 @@ cogl_pipeline_copy (CoglPipeline *source); * * Return value: %TRUE if the @object references a #CoglPipeline, * %FALSE otherwise - * - * Since: 2.0 - * Stability: Unstable */ COGL_EXPORT gboolean cogl_is_pipeline (void *object); @@ -131,9 +122,6 @@ cogl_is_pipeline (void *object); * * The callback prototype used with cogl_pipeline_foreach_layer() for * iterating all the layers of a @pipeline. - * - * Since: 2.0 - * Stability: Unstable */ typedef gboolean (*CoglPipelineLayerCallback) (CoglPipeline *pipeline, int layer_index, @@ -148,9 +136,6 @@ typedef gboolean (*CoglPipelineLayerCallback) (CoglPipeline *pipeline, * callback * * Iterates all the layer indices of the given @pipeline. - * - * Since: 2.0 - * Stability: Unstable */ COGL_EXPORT void cogl_pipeline_foreach_layer (CoglPipeline *pipeline, @@ -173,9 +158,6 @@ cogl_pipeline_foreach_layer (CoglPipeline *pipeline, * before calling this function. * * Return value: A integer representing the location of the given uniform. - * - * Since: 2.0 - * Stability: Unstable */ COGL_EXPORT int cogl_pipeline_get_uniform_location (CoglPipeline *pipeline, diff --git a/cogl/cogl/cogl-pixel-buffer.h b/cogl/cogl/cogl-pixel-buffer.h index 79d03c83c..297ff335e 100644 --- a/cogl/cogl/cogl-pixel-buffer.h +++ b/cogl/cogl/cogl-pixel-buffer.h @@ -79,9 +79,6 @@ GType cogl_pixel_buffer_get_gtype (void); * immediately copied into the new buffer. * * Return value: (transfer full): a newly allocated #CoglPixelBuffer - * - * Since: 1.10 - * Stability: unstable */ COGL_EXPORT CoglPixelBuffer * cogl_pixel_buffer_new (CoglContext *context, @@ -96,9 +93,6 @@ cogl_pixel_buffer_new (CoglContext *context, * * Return value: %TRUE if the @object is a pixel buffer, and %FALSE * otherwise - * - * Since: 1.2 - * Stability: Unstable */ COGL_EXPORT gboolean cogl_is_pixel_buffer (void *object); diff --git a/cogl/cogl/cogl-pixel-format.h b/cogl/cogl/cogl-pixel-format.h index 5c326f6a4..8a21371a8 100644 --- a/cogl/cogl/cogl-pixel-format.h +++ b/cogl/cogl/cogl-pixel-format.h @@ -195,8 +195,6 @@ G_BEGIN_DECLS * When uploading a texture %COGL_PIXEL_FORMAT_ANY can be used as the * internal format. Cogl will try to pick the best format to use * internally and convert the texture data if necessary. - * - * Since: 0.8 */ typedef enum /*< prefix=COGL_PIXEL_FORMAT >*/ { diff --git a/cogl/cogl/cogl-poll.h b/cogl/cogl/cogl-poll.h index 5afed9089..8e7696e13 100644 --- a/cogl/cogl/cogl-poll.h +++ b/cogl/cogl/cogl-poll.h @@ -70,9 +70,6 @@ G_BEGIN_DECLS * descriptor. Note that these all have the same values as the * corresponding defines for the poll function call on Unix so they * may be directly passed to poll. - * - * Since: 1.10 - * Stability: unstable */ typedef enum { @@ -99,9 +96,6 @@ typedef enum * * Note that CoglPollFD is deliberately exactly the same as struct * pollfd on Unix so that it can simply be cast when calling poll. - * - * Since: 1.10 - * Stability: unstable */ typedef struct { int fd; @@ -153,9 +147,6 @@ typedef struct { * really changed can help avoid redundant work * depending the api. The age isn't guaranteed to change * when the timeout changes. - * - * Stability: unstable - * Since: 1.16 */ COGL_EXPORT int cogl_poll_renderer_get_info (CoglRenderer *renderer, @@ -181,9 +172,6 @@ cogl_poll_renderer_get_info (CoglRenderer *renderer, * If your application didn't originally create a #CoglRenderer * manually then you can easily get a #CoglRenderer pointer by calling * cogl_get_renderer(). - * - * Stability: unstable - * Since: 1.16 */ COGL_EXPORT void cogl_poll_renderer_dispatch (CoglRenderer *renderer, diff --git a/cogl/cogl/cogl-primitive-texture.h b/cogl/cogl/cogl-primitive-texture.h index 8d6efe9dc..86b6be71d 100644 --- a/cogl/cogl/cogl-primitive-texture.h +++ b/cogl/cogl/cogl-primitive-texture.h @@ -81,8 +81,6 @@ typedef struct _CoglPrimitiveTexture CoglPrimitiveTexture; * * Return value: %TRUE if the pointer references a primitive texture, and * %FALSE otherwise - * Since: 2.0 - * Stability: unstable */ gboolean cogl_is_primitive_texture (void *object); @@ -98,9 +96,6 @@ cogl_is_primitive_texture (void *object); * filter that requires the lower mipmap levels. An application should * disable this if it wants to upload its own data for the other * levels. By default auto mipmapping is enabled. - * - * Since: 2.0 - * Stability: unstable */ COGL_EXPORT void cogl_primitive_texture_set_auto_mipmap (CoglPrimitiveTexture *primitive_texture, diff --git a/cogl/cogl/cogl-primitive.h b/cogl/cogl/cogl-primitive.h index 722ee8dee..0f743bbf9 100644 --- a/cogl/cogl/cogl-primitive.h +++ b/cogl/cogl/cogl-primitive.h @@ -80,9 +80,6 @@ GType cogl_primitive_get_gtype (void); * * A convenience vertex definition that can be used with * cogl_primitive_new_p2(). - * - * Since: 1.6 - * Stability: Unstable */ typedef struct { float x, y; @@ -96,9 +93,6 @@ typedef struct { * * A convenience vertex definition that can be used with * cogl_primitive_new_p3(). - * - * Since: 1.6 - * Stability: Unstable */ typedef struct { float x, y, z; @@ -115,9 +109,6 @@ typedef struct { * * A convenience vertex definition that can be used with * cogl_primitive_new_p2c4(). - * - * Since: 1.6 - * Stability: Unstable */ typedef struct { float x, y; @@ -136,9 +127,6 @@ typedef struct { * * A convenience vertex definition that can be used with * cogl_primitive_new_p3c4(). - * - * Since: 1.6 - * Stability: Unstable */ typedef struct { float x, y, z; @@ -154,9 +142,6 @@ typedef struct { * * A convenience vertex definition that can be used with * cogl_primitive_new_p2t2(). - * - * Since: 1.6 - * Stability: Unstable */ typedef struct { float x, y; @@ -173,9 +158,6 @@ typedef struct { * * A convenience vertex definition that can be used with * cogl_primitive_new_p3t2(). - * - * Since: 1.6 - * Stability: Unstable */ typedef struct { float x, y, z; @@ -196,9 +178,6 @@ typedef struct { * * A convenience vertex definition that can be used with * cogl_primitive_new_p3t2c4(). - * - * Since: 1.6 - * Stability: Unstable */ typedef struct { float x, y; @@ -220,9 +199,6 @@ typedef struct { * * A convenience vertex definition that can be used with * cogl_primitive_new_p3t2c4(). - * - * Since: 1.6 - * Stability: Unstable */ typedef struct { float x, y, z; @@ -246,9 +222,6 @@ typedef struct { * the number of vertices to read when drawing. * * Return value: (transfer full): A newly allocated #CoglPrimitive object - * - * Since: 1.6 - * Stability: Unstable */ COGL_EXPORT CoglPrimitive * cogl_primitive_new (CoglVerticesMode mode, @@ -272,9 +245,6 @@ cogl_primitive_new (CoglVerticesMode mode, * the number of vertices to read when drawing. * * Return value: (transfer full): A newly allocated #CoglPrimitive object - * - * Since: 1.6 - * Stability: Unstable */ COGL_EXPORT CoglPrimitive * cogl_primitive_new_with_attributes (CoglVerticesMode mode, @@ -325,9 +295,6 @@ cogl_primitive_new_with_attributes (CoglVerticesMode mode, * * Return value: (transfer full): A newly allocated #CoglPrimitive * with a reference of 1. This can be freed using cogl_object_unref(). - * - * Since: 1.6 - * Stability: Unstable */ COGL_EXPORT CoglPrimitive * cogl_primitive_new_p2 (CoglContext *context, @@ -378,9 +345,6 @@ cogl_primitive_new_p2 (CoglContext *context, * * Return value: (transfer full): A newly allocated #CoglPrimitive * with a reference of 1. This can be freed using cogl_object_unref(). - * - * Since: 1.6 - * Stability: Unstable */ COGL_EXPORT CoglPrimitive * cogl_primitive_new_p3 (CoglContext *context, @@ -433,9 +397,6 @@ cogl_primitive_new_p3 (CoglContext *context, * * Return value: (transfer full): A newly allocated #CoglPrimitive * with a reference of 1. This can be freed using cogl_object_unref(). - * - * Since: 1.6 - * Stability: Unstable */ COGL_EXPORT CoglPrimitive * cogl_primitive_new_p2c4 (CoglContext *context, @@ -488,9 +449,6 @@ cogl_primitive_new_p2c4 (CoglContext *context, * * Return value: (transfer full): A newly allocated #CoglPrimitive * with a reference of 1. This can be freed using cogl_object_unref(). - * - * Since: 1.6 - * Stability: Unstable */ COGL_EXPORT CoglPrimitive * cogl_primitive_new_p3c4 (CoglContext *context, @@ -543,9 +501,6 @@ cogl_primitive_new_p3c4 (CoglContext *context, * * Return value: (transfer full): A newly allocated #CoglPrimitive * with a reference of 1. This can be freed using cogl_object_unref(). - * - * Since: 1.6 - * Stability: Unstable */ COGL_EXPORT CoglPrimitive * cogl_primitive_new_p2t2 (CoglContext *context, @@ -598,9 +553,6 @@ cogl_primitive_new_p2t2 (CoglContext *context, * * Return value: (transfer full): A newly allocated #CoglPrimitive * with a reference of 1. This can be freed using cogl_object_unref(). - * - * Since: 1.6 - * Stability: Unstable */ COGL_EXPORT CoglPrimitive * cogl_primitive_new_p3t2 (CoglContext *context, @@ -653,9 +605,6 @@ cogl_primitive_new_p3t2 (CoglContext *context, * * Return value: (transfer full): A newly allocated #CoglPrimitive * with a reference of 1. This can be freed using cogl_object_unref(). - * - * Since: 1.6 - * Stability: Unstable */ COGL_EXPORT CoglPrimitive * cogl_primitive_new_p2t2c4 (CoglContext *context, @@ -708,9 +657,6 @@ cogl_primitive_new_p2t2c4 (CoglContext *context, * * Return value: (transfer full): A newly allocated #CoglPrimitive * with a reference of 1. This can be freed using cogl_object_unref(). - * - * Since: 1.6 - * Stability: Unstable */ COGL_EXPORT CoglPrimitive * cogl_primitive_new_p3t2c4 (CoglContext *context, @@ -742,9 +688,6 @@ cogl_primitive_set_first_vertex (CoglPrimitive *primitive, * of vertices to read and draw. * * Returns: The number of vertices to read when drawing. - * - * Since: 1.8 - * Stability: unstable */ COGL_EXPORT int cogl_primitive_get_n_vertices (CoglPrimitive *primitive); @@ -763,9 +706,6 @@ cogl_primitive_get_n_vertices (CoglPrimitive *primitive); * To be clear; it doesn't refer to the number of vertices - in * terms of data - associated with the primitive it's just the number * of vertices to read and draw. - * - * Since: 1.8 - * Stability: unstable */ COGL_EXPORT void cogl_primitive_set_n_vertices (CoglPrimitive *primitive, @@ -785,9 +725,6 @@ cogl_primitive_set_mode (CoglPrimitive *primitive, * @n_attributes: the number of elements in @attributes * * Replaces all the attributes of the given #CoglPrimitive object. - * - * Since: 1.6 - * Stability: Unstable */ COGL_EXPORT void cogl_primitive_set_attributes (CoglPrimitive *primitive, @@ -818,9 +755,6 @@ cogl_primitive_set_attributes (CoglPrimitive *primitive, * The #CoglPrimitive first_vertex property * also affects drawing with indices by defining the first entry of the * indices to start drawing from. - * - * Since: 1.10 - * Stability: unstable */ COGL_EXPORT void cogl_primitive_set_indices (CoglPrimitive *primitive, @@ -833,9 +767,6 @@ cogl_primitive_set_indices (CoglPrimitive *primitive, * * Return value: (transfer none): the indices that were set with * cogl_primitive_set_indices() or %NULL if no indices were set. - * - * Since: 1.10 - * Stability: unstable */ COGL_EXPORT CoglIndices * cogl_primitive_get_indices (CoglPrimitive *primitive); @@ -849,8 +780,6 @@ cogl_primitive_get_indices (CoglPrimitive *primitive); * attribute buffers as the original primitive. * * Return value: (transfer full): the new primitive - * Since: 1.10 - * Stability: unstable */ COGL_EXPORT CoglPrimitive * cogl_primitive_copy (CoglPrimitive *primitive); @@ -863,9 +792,6 @@ cogl_primitive_copy (CoglPrimitive *primitive); * * Returns: %TRUE if the @object references a #CoglPrimitive, * %FALSE otherwise - * - * Since: 1.6 - * Stability: Unstable */ COGL_EXPORT gboolean cogl_is_primitive (void *object); @@ -881,9 +807,6 @@ cogl_is_primitive (void *object); * * The function should return TRUE to continue iteration or FALSE to * stop. - * - * Since: 1.10 - * Stability: Unstable */ typedef gboolean (* CoglPrimitiveAttributeCallback) (CoglPrimitive *primitive, CoglAttribute *attribute, @@ -898,9 +821,6 @@ typedef gboolean (* CoglPrimitiveAttributeCallback) (CoglPrimitive *primitive, * callback * * Iterates all the attributes of the given #CoglPrimitive. - * - * Since: 1.10 - * Stability: Unstable */ COGL_EXPORT void cogl_primitive_foreach_attribute (CoglPrimitive *primitive, @@ -921,9 +841,6 @@ cogl_primitive_foreach_attribute (CoglPrimitive *primitive, * ensure that only low-level textures that can be directly sampled by * a GPU such as #CoglTexture2D are associated with layers of the given * @pipeline. - * - * Stability: unstable - * Since: 1.16 */ COGL_EXPORT void cogl_primitive_draw (CoglPrimitive *primitive, diff --git a/cogl/cogl/cogl-renderer.h b/cogl/cogl/cogl-renderer.h index eef0e40ad..6096f2bdc 100644 --- a/cogl/cogl/cogl-renderer.h +++ b/cogl/cogl/cogl-renderer.h @@ -100,8 +100,6 @@ GType cogl_renderer_get_gtype (void); * Determines if the given @object is a #CoglRenderer * * Return value: %TRUE if @object is a #CoglRenderer, else %FALSE. - * Since: 1.10 - * Stability: unstable */ COGL_EXPORT gboolean cogl_is_renderer (void *object); @@ -142,9 +140,6 @@ cogl_is_renderer (void *object); * display. * * Return value: (transfer full): A newly created #CoglRenderer. - * - * Since: 1.10 - * Stability: unstable */ COGL_EXPORT CoglRenderer * cogl_renderer_new (void); @@ -214,8 +209,6 @@ cogl_renderer_get_winsys_id (CoglRenderer *renderer); * * Return value: %TRUE if the @onscreen_template can be supported, * else %FALSE. - * Since: 1.10 - * Stability: unstable */ COGL_EXPORT gboolean cogl_renderer_check_onscreen_template (CoglRenderer *renderer, @@ -236,8 +229,6 @@ cogl_renderer_check_onscreen_template (CoglRenderer *renderer, * * Return value: %TRUE if there was no error while connecting the * given @renderer. %FALSE if there was an error. - * Since: 1.10 - * Stability: unstable */ COGL_EXPORT gboolean cogl_renderer_connect (CoglRenderer *renderer, GError **error); @@ -260,9 +251,6 @@ cogl_renderer_connect (CoglRenderer *renderer, GError **error); * * Applications should ideally minimize how many of these constraints * they depend on to ensure maximum portability. - * - * Since: 1.10 - * Stability: unstable */ typedef enum { @@ -281,9 +269,6 @@ typedef enum * * Applications should ideally minimize how many of these constraints they * depend on to ensure maximum portability. - * - * Since: 1.10 - * Stability: unstable */ COGL_EXPORT void cogl_renderer_add_constraint (CoglRenderer *renderer, @@ -298,9 +283,6 @@ cogl_renderer_add_constraint (CoglRenderer *renderer, * * Applications should ideally minimize how many of these constraints they * depend on to ensure maximum portability. - * - * Since: 1.10 - * Stability: unstable */ COGL_EXPORT void cogl_renderer_remove_constraint (CoglRenderer *renderer, @@ -316,9 +298,6 @@ cogl_renderer_remove_constraint (CoglRenderer *renderer, * * Identifiers for underlying hardware drivers that may be used by * Cogl for rendering. - * - * Since: 1.10 - * Stability: unstable */ typedef enum { @@ -342,9 +321,6 @@ typedef enum * choosing the driver. * * This may only be called on an un-connected #CoglRenderer. - * - * Since: 1.10 - * Stability: unstable */ COGL_EXPORT void cogl_renderer_set_driver (CoglRenderer *renderer, @@ -357,9 +333,6 @@ cogl_renderer_set_driver (CoglRenderer *renderer, * Queries what underlying driver is being used by Cogl. * * This may only be called on a connected #CoglRenderer. - * - * Since: 1.10 - * Stability: unstable */ COGL_EXPORT CoglDriver cogl_renderer_get_driver (CoglRenderer *renderer); @@ -373,9 +346,6 @@ cogl_renderer_get_driver (CoglRenderer *renderer); * A callback type that can be passed to * cogl_renderer_foreach_output() for iterating display outputs for a * given renderer. - * - * Since: 1.14 - * Stability: Unstable */ typedef void (*CoglOutputCallback) (CoglOutput *output, void *user_data); @@ -389,9 +359,6 @@ typedef void (*CoglOutputCallback) (CoglOutput *output, void *user_data); * Iterates all known display outputs for the given @renderer and * passes a corresponding #CoglOutput pointer to the given @callback * for each one, along with the given @user_data. - * - * Since: 1.14 - * Stability: Unstable */ COGL_EXPORT void cogl_renderer_foreach_output (CoglRenderer *renderer, diff --git a/cogl/cogl/cogl-snippet.h b/cogl/cogl/cogl-snippet.h index 5ef21b58a..88a211445 100644 --- a/cogl/cogl/cogl-snippet.h +++ b/cogl/cogl/cogl-snippet.h @@ -651,9 +651,6 @@ GType cogl_snippet_get_gtype (void); * * * - * - * Since: 1.10 - * Stability: Unstable */ typedef enum { @@ -687,9 +684,6 @@ typedef enum * Allocates and initializes a new snippet with the given source strings. * * Returns: (transfer full): a pointer to a new #CoglSnippet - * - * Since: 1.10 - * Stability: Unstable */ COGL_EXPORT CoglSnippet * cogl_snippet_new (CoglSnippetHook hook, @@ -702,8 +696,6 @@ cogl_snippet_new (CoglSnippetHook hook, * * Returns: (transfer none): the hook that was set when cogl_snippet_new() * was called. - * Since: 1.10 - * Stability: Unstable */ COGL_EXPORT CoglSnippetHook cogl_snippet_get_hook (CoglSnippet *snippet); @@ -716,9 +708,6 @@ cogl_snippet_get_hook (CoglSnippet *snippet); * * Returns: %TRUE if the @object references a #CoglSnippet, * %FALSE otherwise - * - * Since: 1.10 - * Stability: Unstable */ COGL_EXPORT gboolean cogl_is_snippet (void *object); @@ -737,9 +726,6 @@ cogl_is_snippet (void *object); * This function should only be called before the snippet is attached * to its first pipeline. After that the snippet should be considered * immutable. - * - * Since: 1.10 - * Stability: Unstable */ COGL_EXPORT void cogl_snippet_set_declarations (CoglSnippet *snippet, @@ -751,9 +737,6 @@ cogl_snippet_set_declarations (CoglSnippet *snippet, * * Returns: (transfer none): the source string that was set with * cogl_snippet_set_declarations() or %NULL if none was set. - * - * Since: 1.10 - * Stability: Unstable */ COGL_EXPORT const char * cogl_snippet_get_declarations (CoglSnippet *snippet); @@ -771,9 +754,6 @@ cogl_snippet_get_declarations (CoglSnippet *snippet); * This function should only be called before the snippet is attached * to its first pipeline. After that the snippet should be considered * immutable. - * - * Since: 1.10 - * Stability: Unstable */ COGL_EXPORT void cogl_snippet_set_pre (CoglSnippet *snippet, @@ -785,9 +765,6 @@ cogl_snippet_set_pre (CoglSnippet *snippet, * * Returns: (transfer none): the source string that was set with * cogl_snippet_set_pre() or %NULL if none was set. - * - * Since: 1.10 - * Stability: Unstable */ COGL_EXPORT const char * cogl_snippet_get_pre (CoglSnippet *snippet); @@ -805,9 +782,6 @@ cogl_snippet_get_pre (CoglSnippet *snippet); * This function should only be called before the snippet is attached * to its first pipeline. After that the snippet should be considered * immutable. - * - * Since: 1.10 - * Stability: Unstable */ COGL_EXPORT void cogl_snippet_set_replace (CoglSnippet *snippet, @@ -819,9 +793,6 @@ cogl_snippet_set_replace (CoglSnippet *snippet, * * Returns: (transfer none): the source string that was set with * cogl_snippet_set_replace() or %NULL if none was set. - * - * Since: 1.10 - * Stability: Unstable */ COGL_EXPORT const char * cogl_snippet_get_replace (CoglSnippet *snippet); @@ -839,9 +810,6 @@ cogl_snippet_get_replace (CoglSnippet *snippet); * This function should only be called before the snippet is attached * to its first pipeline. After that the snippet should be considered * immutable. - * - * Since: 1.10 - * Stability: Unstable */ COGL_EXPORT void cogl_snippet_set_post (CoglSnippet *snippet, @@ -853,9 +821,6 @@ cogl_snippet_set_post (CoglSnippet *snippet, * * Returns: (transfer none): the source string that was set with * cogl_snippet_set_post() or %NULL if none was set. - * - * Since: 1.10 - * Stability: Unstable */ COGL_EXPORT const char * cogl_snippet_get_post (CoglSnippet *snippet); diff --git a/cogl/cogl/cogl-sub-texture.h b/cogl/cogl/cogl-sub-texture.h index 97874e763..0b863eb12 100644 --- a/cogl/cogl/cogl-sub-texture.h +++ b/cogl/cogl/cogl-sub-texture.h @@ -86,9 +86,6 @@ GType cogl_sub_texture_get_gtype (void); * * Return value: (transfer full): A newly allocated #CoglSubTexture * representing a sub-region of @parent_texture. - * - * Since: 1.10 - * Stability: unstable */ COGL_EXPORT CoglSubTexture * cogl_sub_texture_new (CoglContext *ctx, @@ -108,8 +105,6 @@ cogl_sub_texture_new (CoglContext *ctx, * * Return value: (transfer none): The parent texture that @sub_texture * derives its content from. - * Since: 1.10 - * Stability: unstable */ COGL_EXPORT CoglTexture * cogl_sub_texture_get_parent (CoglSubTexture *sub_texture); @@ -122,9 +117,6 @@ cogl_sub_texture_get_parent (CoglSubTexture *sub_texture); * * Return value: %TRUE if the passed @object represents a * #CoglSubTexture and %FALSE otherwise. - * - * Since: 1.10 - * Stability: unstable */ COGL_EXPORT gboolean cogl_is_sub_texture (void *object); diff --git a/cogl/cogl/cogl-texture-2d-sliced.h b/cogl/cogl/cogl-texture-2d-sliced.h index 98b8479d3..4591f63e4 100644 --- a/cogl/cogl/cogl-texture-2d-sliced.h +++ b/cogl/cogl/cogl-texture-2d-sliced.h @@ -115,9 +115,6 @@ GType cogl_texture_2d_sliced_get_gtype (void); * * Returns: (transfer full): A new #CoglTexture2DSliced object with no storage * allocated yet. - * - * Since: 1.10 - * Stability: unstable */ COGL_EXPORT CoglTexture2DSliced * cogl_texture_2d_sliced_new_with_size (CoglContext *ctx, @@ -164,8 +161,6 @@ cogl_texture_2d_sliced_new_with_size (CoglContext *ctx, * * Return value: (transfer full): A newly created #CoglTexture2DSliced * or %NULL on failure and @error will be updated. - * - * Since: 1.16 */ COGL_EXPORT CoglTexture2DSliced * cogl_texture_2d_sliced_new_from_file (CoglContext *ctx, @@ -225,8 +220,6 @@ cogl_texture_2d_sliced_new_from_file (CoglContext *ctx, * * Return value: (transfer full): A newly created #CoglTexture2DSliced * or %NULL on failure and @error will be updated. - * - * Since: 1.16 */ COGL_EXPORT CoglTexture2DSliced * cogl_texture_2d_sliced_new_from_data (CoglContext *ctx, @@ -276,8 +269,6 @@ cogl_texture_2d_sliced_new_from_data (CoglContext *ctx, * * Return value: (transfer full): A newly created #CoglTexture2DSliced * or %NULL on failure and @error will be updated. - * - * Since: 1.16 */ COGL_EXPORT CoglTexture2DSliced * cogl_texture_2d_sliced_new_from_bitmap (CoglBitmap *bmp, @@ -291,8 +282,6 @@ cogl_texture_2d_sliced_new_from_bitmap (CoglBitmap *bmp, * * Return value: %TRUE if the object references a #CoglTexture2DSliced * and %FALSE otherwise. - * Since: 1.10 - * Stability: unstable */ COGL_EXPORT gboolean cogl_is_texture_2d_sliced (void *object); diff --git a/cogl/cogl/cogl-texture-2d.h b/cogl/cogl/cogl-texture-2d.h index 9bee64692..bf22c5d6b 100644 --- a/cogl/cogl/cogl-texture-2d.h +++ b/cogl/cogl/cogl-texture-2d.h @@ -108,8 +108,6 @@ cogl_is_texture_2d (void *object); * cogl_texture_set_premultiplied(). * * Returns: (transfer full): A new #CoglTexture2D object with no storage yet allocated. - * - * Since: 2.0 */ COGL_EXPORT CoglTexture2D * cogl_texture_2d_new_with_size (CoglContext *ctx, @@ -137,8 +135,6 @@ cogl_texture_2d_new_with_size (CoglContext *ctx, * * Return value: (transfer full): A newly created #CoglTexture2D or %NULL on failure * and @error will be updated. - * - * Since: 1.16 */ COGL_EXPORT CoglTexture2D * cogl_texture_2d_new_from_file (CoglContext *ctx, @@ -175,8 +171,6 @@ cogl_texture_2d_new_from_file (CoglContext *ctx, * the size is not supported (because it is too large or a * non-power-of-two size that the hardware doesn't support) * it will return %NULL and set @error. - * - * Since: 2.0 */ COGL_EXPORT CoglTexture2D * cogl_texture_2d_new_from_data (CoglContext *ctx, @@ -206,9 +200,6 @@ cogl_texture_2d_new_from_data (CoglContext *ctx, * cogl_texture_set_premultiplied(). * * Returns: (transfer full): A newly allocated #CoglTexture2D - * - * Since: 2.0 - * Stability: unstable */ COGL_EXPORT CoglTexture2D * cogl_texture_2d_new_from_bitmap (CoglBitmap *bitmap); diff --git a/cogl/cogl/cogl-texture.h b/cogl/cogl/cogl-texture.h index c86b4e3a5..a2c23132b 100644 --- a/cogl/cogl/cogl-texture.h +++ b/cogl/cogl/cogl-texture.h @@ -83,9 +83,6 @@ GType cogl_texture_get_gtype (void); * COGL_TEXTURE_ERROR: * * #GError domain for texture errors. - * - * Since: 1.8 - * Stability: Unstable */ #define COGL_TEXTURE_ERROR (cogl_texture_error_quark ()) @@ -97,9 +94,6 @@ GType cogl_texture_get_gtype (void); * unsupported by the driver was used * * Error codes that can be thrown when allocating textures. - * - * Since: 1.8 - * Stability: Unstable */ typedef enum { @@ -135,8 +129,6 @@ cogl_is_texture (void *object); * @COGL_TEXTURE_COMPONENTS_DEPTH: Only a depth component * * See cogl_texture_set_components(). - * - * Since: 1.18 */ typedef enum _CoglTextureComponents { @@ -170,8 +162,6 @@ typedef enum _CoglTextureComponents * is not available then %COGL_PIXEL_FORMAT_RG_88 can still be used as * an image format as long as %COGL_TEXTURE_COMPONENTS_RG isn't used * as the texture's components. - * - * Since: 1.18 */ COGL_EXPORT void cogl_texture_set_components (CoglTexture *texture, @@ -188,8 +178,6 @@ cogl_texture_set_components (CoglTexture *texture, * is %COGL_TEXTURE_COMPONENTS_RGBA. The other constructors which take * a %CoglBitmap or a data pointer default to the same components as * the pixel format of the data. - * - * Since: 1.18 */ COGL_EXPORT CoglTextureComponents cogl_texture_get_components (CoglTexture *texture); @@ -222,8 +210,6 @@ cogl_texture_get_components (CoglTexture *texture); * converted. * * By default the @premultipled state is @TRUE. - * - * Since: 1.18 */ COGL_EXPORT void cogl_texture_set_premultiplied (CoglTexture *texture, @@ -242,7 +228,6 @@ cogl_texture_set_premultiplied (CoglTexture *texture, * Return value: %TRUE if red, green and blue components are * internally stored pre-multiplied by the alpha * value or %FALSE if not. - * Since: 1.18 */ COGL_EXPORT gboolean cogl_texture_get_premultiplied (CoglTexture *texture); @@ -461,9 +446,6 @@ cogl_texture_set_data (CoglTexture *texture, * * Return value: %TRUE if the subregion upload was successful, and * %FALSE otherwise - * - * Since: 1.8 - * Stability: unstable */ COGL_EXPORT gboolean cogl_texture_set_region_from_bitmap (CoglTexture *texture, diff --git a/cogl/cogl/cogl-types.h b/cogl/cogl/cogl-types.h index 2392b450e..6b898dc62 100644 --- a/cogl/cogl/cogl-types.h +++ b/cogl/cogl/cogl-types.h @@ -93,8 +93,6 @@ typedef struct _CoglFramebuffer CoglFramebuffer; * * Integer representation of an angle such that 1024 corresponds to * full circle (i.e., 2 * pi). - * - * Since: 1.0 */ typedef int32_t CoglAngle; @@ -124,8 +122,6 @@ typedef struct _CoglDmaBufHandle CoglDmaBufHandle; * @COGL_OFFSCREEN_BUFFER: FIXME * * Target flags for FBOs. - * - * Since: 0.8 */ typedef enum { @@ -143,8 +139,6 @@ typedef enum * A structure for holding a color definition. The contents of * the CoglColor structure are private and should never by accessed * directly. - * - * Since: 1.0 */ struct _CoglColor { @@ -188,8 +182,6 @@ COGL_STRUCT_SIZE_ASSERT (CoglTextureVertex, 36); * COGL_BLEND_STRING_ERROR: * * #GError domain for blend string parser errors - * - * Since: 1.0 */ #define COGL_BLEND_STRING_ERROR (cogl_blend_string_error_quark ()) @@ -202,8 +194,6 @@ COGL_STRUCT_SIZE_ASSERT (CoglTextureVertex, 36); * supported by the GPU * * Error enumeration for the blend strings parser - * - * Since: 1.0 */ typedef enum /*< prefix=COGL_BLEND_STRING_ERROR >*/ { @@ -242,9 +232,6 @@ cogl_blend_string_error_quark (void); * * Currently this is only used by Cogl API marked as experimental so * this enum should also be considered experimental. - * - * Since: 1.4 - * Stability: unstable */ typedef enum /*< prefix=COGL_ERROR >*/ { @@ -266,8 +253,6 @@ _cogl_system_error_quark (void); * @COGL_ATTRIBUTE_TYPE_FLOAT: Data is the same size of a float * * Data types for the components of a vertex attribute. - * - * Since: 1.0 */ typedef enum { @@ -317,8 +302,6 @@ typedef enum * @COGL_VERTICES_MODE_TRIANGLE_FAN: FIXME, equivalent to GL_TRIANGLE_FAN * * Different ways of interpreting vertices when drawing. - * - * Since: 1.0 */ typedef enum { @@ -389,8 +372,6 @@ typedef enum /*< prefix=COGL_RENDERER_ERROR >*/ * @COGL_FILTER_REMOVE: Remove the event, stops the processing * * Return values for the #CoglXlibFilterFunc and #CoglWin32FilterFunc functions. - * - * Stability: Unstable */ typedef enum _CoglFilterReturn { /*< prefix=COGL_FILTER >*/ COGL_FILTER_CONTINUE, @@ -458,8 +439,6 @@ typedef enum * @COGL_BUFFER_BIT_STENCIL: Selects the stencil buffer * * Types of auxiliary buffers - * - * Since: 1.0 */ typedef enum { @@ -473,8 +452,6 @@ typedef enum * @COGL_READ_PIXELS_COLOR_BUFFER: Read from the color buffer * * Flags for cogl_framebuffer_read_pixels_into_bitmap() - * - * Since: 1.0 */ typedef enum /*< prefix=COGL_READ_PIXELS >*/ { diff --git a/cogl/cogl/cogl1-context.h b/cogl/cogl/cogl1-context.h index 7925ed7ac..d7860a8d0 100644 --- a/cogl/cogl/cogl1-context.h +++ b/cogl/cogl/cogl1-context.h @@ -86,8 +86,6 @@ cogl_get_proc_address (const char *name); * 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 */ COGL_EXPORT void cogl_flush (void); diff --git a/cogl/cogl/deprecated/cogl-shader.h b/cogl/cogl/deprecated/cogl-shader.h index 79c023664..662356bdc 100644 --- a/cogl/cogl/deprecated/cogl-shader.h +++ b/cogl/cogl/deprecated/cogl-shader.h @@ -226,8 +226,6 @@ G_BEGIN_DECLS * @COGL_SHADER_TYPE_FRAGMENT: A program for processing fragments * * Types of shaders - * - * Since: 1.0 */ typedef enum { @@ -380,8 +378,6 @@ cogl_program_get_uniform_location (CoglHandle handle, * * Changes the value of a floating point uniform for the given linked * @program. - * - * Since: 1.4 * Deprecated: 1.16: Use #CoglSnippet api instead */ COGL_DEPRECATED_FOR (cogl_snippet_) @@ -399,8 +395,6 @@ cogl_program_set_uniform_1f (CoglHandle program, * * Changes the value of an integer uniform for the given linked * @program. - * - * Since: 1.4 * Deprecated: 1.16: Use #CoglSnippet api instead */ COGL_DEPRECATED_FOR (cogl_snippet_) @@ -422,8 +416,6 @@ cogl_program_set_uniform_1i (CoglHandle program, * * Changes the value of a float vector uniform, or uniform array for * the given linked @program. - * - * Since: 1.4 * Deprecated: 1.16: Use #CoglSnippet api instead */ COGL_DEPRECATED_FOR (cogl_snippet_) @@ -447,8 +439,6 @@ cogl_program_set_uniform_float (CoglHandle program, * * Changes the value of a int vector uniform, or uniform array for * the given linked @program. - * - * Since: 1.4 * Deprecated: 1.16: Use #CoglSnippet api instead */ COGL_DEPRECATED_FOR (cogl_snippet_) @@ -473,8 +463,6 @@ cogl_program_set_uniform_int (CoglHandle program, * * Changes the value of a matrix uniform, or uniform array in the * given linked @program. - * - * Since: 1.4 * Deprecated: 1.16: Use #CoglSnippet api instead */ COGL_DEPRECATED_FOR (cogl_snippet_) diff --git a/cogl/cogl/winsys/cogl-texture-pixmap-x11.h b/cogl/cogl/winsys/cogl-texture-pixmap-x11.h index 8103cf379..60e3b1317 100644 --- a/cogl/cogl/winsys/cogl-texture-pixmap-x11.h +++ b/cogl/cogl/winsys/cogl-texture-pixmap-x11.h @@ -88,8 +88,6 @@ typedef enum * COGL_TEXTURE_PIXMAP_X11_ERROR: * * #GError domain for texture-pixmap-x11 errors. - * - * Since: 1.10 */ #define COGL_TEXTURE_PIXMAP_X11_ERROR (cogl_texture_pixmap_x11_error_quark ()) @@ -99,8 +97,6 @@ typedef enum * * Error codes that can be thrown when performing texture-pixmap-x11 * operations. - * - * Since: 1.10 */ typedef enum { @@ -124,9 +120,6 @@ uint32_t cogl_texture_pixmap_x11_error_quark (void); * when it changes. * * Return value: a new #CoglTexturePixmapX11 instance - * - * Since: 1.10 - * Stability: Unstable */ COGL_EXPORT CoglTexturePixmapX11 * cogl_texture_pixmap_x11_new (CoglContext *context, @@ -163,9 +156,6 @@ cogl_texture_pixmap_x11_new (CoglContext *context, * pixmap is not necessary, but may save resources.) * * Return value: a new #CoglTexturePixmapX11 instance - * - * Since: 1.20 - * Stability: Unstable */ COGL_EXPORT CoglTexturePixmapX11 * cogl_texture_pixmap_x11_new_left (CoglContext *context, @@ -183,9 +173,6 @@ cogl_texture_pixmap_x11_new_left (CoglContext *context, * created using cogl_texture_pixmap_x11_new_left(). * * Return value: a new #CoglTexturePixmapX11 instance - * - * Since: 1.20 - * Stability: Unstable */ COGL_EXPORT CoglTexturePixmapX11 * cogl_texture_pixmap_x11_new_right (CoglTexturePixmapX11 *left_texture); @@ -201,9 +188,6 @@ cogl_texture_pixmap_x11_new_right (CoglTexturePixmapX11 *left_texture); * Forces an update of the given @texture so that it is refreshed with * the contents of the pixmap that was given to * cogl_texture_pixmap_x11_new(). - * - * Since: 1.4 - * Stability: Unstable */ COGL_EXPORT void cogl_texture_pixmap_x11_update_area (CoglTexturePixmapX11 *texture, @@ -224,9 +208,6 @@ cogl_texture_pixmap_x11_update_area (CoglTexturePixmapX11 *texture, * * Return value: %TRUE if the texture is using an efficient extension * and %FALSE otherwise - * - * Since: 1.4 - * Stability: Unstable */ COGL_EXPORT gboolean cogl_texture_pixmap_x11_is_using_tfp_extension (CoglTexturePixmapX11 *texture); @@ -239,9 +220,6 @@ cogl_texture_pixmap_x11_is_using_tfp_extension (CoglTexturePixmapX11 *texture); * * Return value: %TRUE if the object is a #CoglTexturePixmapX11, and * %FALSE otherwise - * - * Since: 1.4 - * Stability: Unstable */ COGL_EXPORT gboolean cogl_is_texture_pixmap_x11 (void *object); diff --git a/src/backends/native/meta-input-device-native.c b/src/backends/native/meta-input-device-native.c index 36704160e..f0d326183 100644 --- a/src/backends/native/meta-input-device-native.c +++ b/src/backends/native/meta-input-device-native.c @@ -1566,9 +1566,6 @@ meta_input_device_native_update_leds_in_impl (MetaInputDeviceNative *device, * Retrieves the libinput_device struct held in @device. * * Returns: The libinput_device struct - * - * Since: 1.20 - * Stability: unstable **/ struct libinput_device * meta_input_device_native_get_libinput_device (ClutterInputDevice *device) diff --git a/src/backends/x11/meta-event-x11.c b/src/backends/x11/meta-event-x11.c index 6d5e8f9ed..d42b33aee 100644 --- a/src/backends/x11/meta-event-x11.c +++ b/src/backends/x11/meta-event-x11.c @@ -46,8 +46,6 @@ * or has used the event to update internal state without taking * any exclusive action. %META_X11_FILTER_TRANSLATE will not * occur. - * - * Since: 0.8 */ MetaX11FilterReturn meta_x11_handle_event (MetaBackend *backend, diff --git a/src/tests/clutter-test-utils.c b/src/tests/clutter-test-utils.c index a378aff5d..dd5852576 100644 --- a/src/tests/clutter-test-utils.c +++ b/src/tests/clutter-test-utils.c @@ -40,8 +40,6 @@ log_func (const gchar *log_domain, * @argv: (inout) (array length=argc) (nullable): array of arguments * * Initializes the Clutter test environment. - * - * Since: 1.18 */ void clutter_test_init (int *argc, @@ -68,8 +66,6 @@ clutter_test_init (int *argc, * Retrieves the #ClutterStage used for testing. * * Return value: (transfer none): the stage used for testing - * - * Since: 1.18 */ ClutterActor * clutter_test_get_stage (void) @@ -153,8 +149,6 @@ clutter_test_func_wrapper (gconstpointer data_) * Adds a test unit to the Clutter test environment. * * See also: g_test_add() - * - * Since: 1.18 */ void clutter_test_add (const char *test_path, @@ -172,8 +166,6 @@ clutter_test_add (const char *test_path, * Adds a test unit to the Clutter test environment. * * See also: g_test_add_data_func() - * - * Since: 1.18 */ void clutter_test_add_data (const char *test_path, @@ -193,8 +185,6 @@ clutter_test_add_data (const char *test_path, * Adds a test unit to the Clutter test environment. * * See also: g_test_add_data_func_full() - * - * Since: 1.18 */ void clutter_test_add_data_full (const char *test_path, @@ -249,8 +239,6 @@ clutter_test_add_data_full (const char *test_path, * ]| * * Return value: the exit code for the test suite - * - * Since: 1.18 */ int clutter_test_run (void) @@ -374,8 +362,6 @@ on_key_press_event (ClutterActor *stage, * actor found there with the given @actor. * * Returns: %TRUE if the actor at the given coordinates matches - * - * Since: 1.18 */ gboolean clutter_test_check_actor_at_point (ClutterActor *stage, @@ -435,8 +421,6 @@ clutter_test_check_actor_at_point (ClutterActor *stage, * component of @color and @result is ignored. * * Returns: %TRUE if the colors match - * - * Since: 1.18 */ gboolean clutter_test_check_color_at_point (ClutterActor *stage, diff --git a/src/tests/clutter-test-utils.h b/src/tests/clutter-test-utils.h index 95f54ceed..af65352c6 100644 --- a/src/tests/clutter-test-utils.h +++ b/src/tests/clutter-test-utils.h @@ -41,8 +41,6 @@ G_BEGIN_DECLS * @func: the GTestFunc function * * Adds @func at the given @path in the test suite. - * - * Since: 1.18 */ #define CLUTTER_TEST_UNIT(path,func) \ clutter_test_add (path, func); @@ -75,8 +73,6 @@ G_BEGIN_DECLS * return clutter_test_run (); * } * ]| - * - * Since: 1.18 */ #define CLUTTER_TEST_SUITE(units) \ int \