@girs/cogl-7 4.2.0 → 4.4.0

package/cogl-7.d.ts

@@ -1794,27 +1794,32 @@ export namespace Cogl {
          * Parses an image file enough to extract the width and height
          * of the bitmap.
          * @param filename the file to check
+         * @since 1.0
          */
         static get_size_from_file(filename: string): [boolean, number, number];
 
         // Methods
         /**
          * @returns the {@link Cogl.PixelFormat} that the data for the bitmap is in.
+         * @since 1.10
          */
         get_format(): PixelFormat;
 
         /**
          * @returns the height of the bitmap
+         * @since 1.10
          */
         get_height(): number;
 
         /**
          * @returns 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
          */
         get_rowstride(): number;
 
         /**
          * @returns the width of the bitmap
+         * @since 1.10
          */
         get_width(): number;
     }
@@ -1904,6 +1909,7 @@ export namespace Cogl {
          * Gets the frame counter for the {@link Cogl.Onscreen} that corresponds
          * to this frame.
          * @returns The frame counter value
+         * @since 1.14
          */
         get_frame_counter(): number;
 
@@ -1919,6 +1925,7 @@ export namespace Cogl {
          * OpenGL driver. Also some buggy Mesa drivers up to 9.0.1 may also
          * incorrectly report non-monotonic timestamps.</note>
          * @returns the presentation time for the frame
+         * @since 1.14
          */
         get_presentation_time(): number;
 
@@ -1932,6 +1939,7 @@ export namespace Cogl {
          * more reliable than using `cogl_frame_info_get_output()` followed by
          * `cogl_output_get_refresh_rate()`.</note>
          * @returns the refresh rate in Hertz
+         * @since 1.14
          */
         get_refresh_rate(): number;
     }
@@ -2009,6 +2017,7 @@ export namespace Cogl {
          * program will abort with an error message if there is an error during
          * automatic allocation.</note>
          * @returns `true` if there were no error allocating the framebuffer, else `false`.
+         * @since 1.8
          */
         allocate(): boolean;
 
@@ -2017,6 +2026,7 @@ export namespace Cogl {
          * that includes the color buffer then the specified `color` is used.
          * @param buffers A mask of {@link Cogl.BufferBit}<!-- -->'s identifying which auxiliary   buffers to clear
          * @param color The color to clear the color buffer too if specified in         `buffers`.
+         * @since 1.8
          */
         clear(buffers: bigint | number, color: Color): void;
 
@@ -2028,6 +2038,7 @@ export namespace Cogl {
          * @param green The green component of color to clear the color buffer too if         specified in `buffers`.
          * @param blue The blue component of color to clear the color buffer too if        specified in `buffers`.
          * @param alpha The alpha component of color to clear the color buffer too if         specified in `buffers`.
+         * @since 1.8
          */
         clear4f(buffers: bigint | number, red: number, green: number, blue: number, alpha: number): void;
 
@@ -2049,6 +2060,7 @@ export namespace Cogl {
          * framebuffer, and it's not meaningful to try and discard the color buffer of
          * a {@link Cogl.Offscreen} framebuffer since they are single-buffered.
          * @param buffers A {@link Cogl.BufferBit} mask of which ancillary buffers you want           to discard.
+         * @since 1.8
          */
         discard_buffers(buffers: bigint | number): void;
 
@@ -2098,6 +2110,7 @@ export namespace Cogl {
          * @param y_2 y coordinate lower right on screen.
          * @param tex_coords An array containing groups of   4 float values: [s_1, t_1, s_2, t_2] that are interpreted as two texture   coordinates; one for the top left texel, and one for the bottom right   texel. Each value should be between 0.0 and 1.0, where the coordinate   (0.0, 0.0) represents the top left of the texture, and (1.0, 1.0) the   bottom right.
          * @param tex_coords_len The length of the `tex_coords` array. (For one layer   and one group of texture coordinates, this would be 4)
+         * @since 1.10
          */
         draw_multitextured_rectangle(pipeline: Pipeline, x_1: number, y_1: number, x_2: number, y_2: number, tex_coords: number[], tex_coords_len: number): void;
 
@@ -2118,6 +2131,7 @@ export namespace Cogl {
          * @param y_1 Y coordinate of the top-left corner
          * @param x_2 X coordinate of the bottom-right corner
          * @param y_2 Y coordinate of the bottom-right corner
+         * @since 1.10
          */
         draw_rectangle(pipeline: Pipeline, x_1: number, y_1: number, x_2: number, y_2: number): void;
 
@@ -2144,6 +2158,7 @@ export namespace Cogl {
          * @param pipeline A {@link Cogl.Pipeline} state object
          * @param coordinates an array of coordinates   containing groups of 4 float values: [x_1, y_1, x_2, y_2] that are   interpreted as two position coordinates; one for the top left of   the rectangle (x1, y1), and one for the bottom right of the   rectangle (x2, y2).
          * @param n_rectangles number of rectangles defined in `coordinates`.
+         * @since 1.10
          */
         draw_rectangles(pipeline: Pipeline, coordinates: number[], n_rectangles: number): void;
 
@@ -2183,6 +2198,7 @@ export namespace Cogl {
          * @param t_1 T texture coordinate of the top-left coorner
          * @param s_2 S texture coordinate of the bottom-right coorner
          * @param t_2 T texture coordinate of the bottom-right coorner
+         * @since 1.10
          */
         draw_textured_rectangle(pipeline: Pipeline, x_1: number, y_1: number, x_2: number, y_2: number, s_1: number, t_1: number, s_2: number, t_2: number): void;
 
@@ -2224,6 +2240,7 @@ export namespace Cogl {
          * @param pipeline A {@link Cogl.Pipeline} state object
          * @param coordinates an array containing   groups of 8 float values: [x_1, y_1, x_2, y_2, s_1, t_1, s_2, t_2]   that have the same meaning as the arguments for   `cogl_framebuffer_draw_textured_rectangle()`.
          * @param n_rectangles number of rectangles to `coordinates` to draw
+         * @since 1.10
          */
         draw_textured_rectangles(pipeline: Pipeline, coordinates: number[], n_rectangles: number): void;
 
@@ -2237,6 +2254,7 @@ export namespace Cogl {
          * 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.
+         * @since 1.10
          */
         finish(): void;
 
@@ -2258,18 +2276,21 @@ export namespace Cogl {
          * @param top Y position of the top clipping plane where it intersects   the near clipping plane
          * @param z_near The distance to the near clipping plane (Must be positive)
          * @param z_far The distance to the far clipping plane (Must be positive)
+         * @since 1.10
          */
         frustum(left: number, right: number, bottom: number, top: number, z_near: number, z_far: number): void;
 
         /**
          * Retrieves the number of alpha bits of `framebuffer`
          * @returns the number of bits
+         * @since 1.8
          */
         get_alpha_bits(): number;
 
         /**
          * Retrieves the number of blue bits of `framebuffer`
          * @returns the number of bits
+         * @since 1.8
          */
         get_blue_bits(): number;
 
@@ -2278,12 +2299,14 @@ export namespace Cogl {
          * instantiated within. This is the {@link Cogl.Context} that was passed to
          * `cogl_onscreen_new()` for example.
          * @returns The {@link Cogl.Context} that the given               `framebuffer` was instantiated within.
+         * @since 1.8
          */
         get_context(): Context;
 
         /**
          * Retrieves the number of depth bits of `framebuffer`
          * @returns the number of bits
+         * @since 2.0
          */
         get_depth_bits(): number;
 
@@ -2291,6 +2314,7 @@ export namespace Cogl {
          * Queries whether depth buffer writing is enabled for `framebuffer`. This
          * can be controlled via `cogl_framebuffer_set_depth_write_enabled()`.
          * @returns `true` if depth writing is enabled or `false` if not.
+         * @since 1.18
          */
         get_depth_write_enabled(): boolean;
 
@@ -2302,18 +2326,21 @@ export namespace Cogl {
          * display pipeline does not support dithering. This value only represents
          * the user's request for dithering.</note>
          * @returns `true` if dithering has been requested or `false` if not.
+         * @since 1.8
          */
         get_dither_enabled(): boolean;
 
         /**
          * Retrieves the number of green bits of `framebuffer`
          * @returns the number of bits
+         * @since 1.8
          */
         get_green_bits(): number;
 
         /**
          * Queries the current height of the given `framebuffer`.
          * @returns The height of `framebuffer`.
+         * @since 1.8
          */
         get_height(): number;
 
@@ -2321,17 +2348,20 @@ export namespace Cogl {
 
         /**
          * Stores the current model-view matrix in `matrix`.
+         * @since 1.10
          */
         get_modelview_matrix(): Matrix;
 
         /**
          * Stores the current projection matrix in `matrix`.
+         * @since 1.10
          */
         get_projection_matrix(): Matrix;
 
         /**
          * Retrieves the number of red bits of `framebuffer`
          * @returns the number of bits
+         * @since 1.8
          */
         get_red_bits(): number;
 
@@ -2349,6 +2379,7 @@ export namespace Cogl {
          * framebuffer has been allocated the value will reflect the actual
          * number of samples that will be made by the GPU.
          * @returns The number of point samples made per pixel when          rasterizing geometry or 0 if single-sample rendering          has been chosen.
+         * @since 1.10
          */
         get_samples_per_pixel(): number;
 
@@ -2356,6 +2387,7 @@ export namespace Cogl {
          * Gets the current {@link Cogl.StereoMode}, which defines which stereo buffers
          * should be drawn to. See `cogl_framebuffer_set_stereo_mode()`.
          * @returns A {@link Cogl.StereoMode}
+         * @since 1.20
          */
         get_stereo_mode(): StereoMode;
 
@@ -2364,6 +2396,7 @@ export namespace Cogl {
          * using `cogl_framebuffer_set_viewport()` or the default values which are 0, 0,
          * framebuffer_width and framebuffer_height.  The values are written into the
          * given `viewport` array.
+         * @since 1.8
          */
         get_viewport4fv(): number[];
 
@@ -2371,6 +2404,7 @@ export namespace Cogl {
          * Queries the height of the viewport as set using `cogl_framebuffer_set_viewport()`
          * or the default value which is the height of the framebuffer.
          * @returns The height of the viewport.
+         * @since 1.8
          */
         get_viewport_height(): number;
 
@@ -2378,6 +2412,7 @@ export namespace Cogl {
          * Queries the width of the viewport as set using `cogl_framebuffer_set_viewport()`
          * or the default value which is the width of the framebuffer.
          * @returns The width of the viewport.
+         * @since 1.8
          */
         get_viewport_width(): number;
 
@@ -2385,6 +2420,7 @@ export namespace Cogl {
          * Queries the x coordinate of the viewport origin as set using `cogl_framebuffer_set_viewport()`
          * or the default value which is 0.
          * @returns The x coordinate of the viewport origin.
+         * @since 1.8
          */
         get_viewport_x(): number;
 
@@ -2392,17 +2428,20 @@ export namespace Cogl {
          * Queries the y coordinate of the viewport origin as set using `cogl_framebuffer_set_viewport()`
          * or the default value which is 0.
          * @returns The y coordinate of the viewport origin.
+         * @since 1.8
          */
         get_viewport_y(): number;
 
         /**
          * Queries the current width of the given `framebuffer`.
          * @returns The width of `framebuffer`.
+         * @since 1.8
          */
         get_width(): number;
 
         /**
          * Resets the current model-view matrix to the identity matrix.
+         * @since 1.10
          */
         identity_matrix(): void;
 
@@ -2415,6 +2454,7 @@ export namespace Cogl {
          * @param y_2 The y coordinate for the second horizontal clipping plane
          * @param near The <emphasis>distance</emphasis> to the near clipping   plane (will be <emphasis>negative</emphasis> if the plane is   behind the viewer)
          * @param far The <emphasis>distance</emphasis> to the far clipping   plane (will be <emphasis>negative</emphasis> if the plane is   behind the viewer)
+         * @since 1.10
          */
         orthographic(x_1: number, y_1: number, x_2: number, y_2: number, near: number, far: number): void;
 
@@ -2430,6 +2470,7 @@ export namespace Cogl {
          * @param aspect The (width over height) aspect ratio for display
          * @param z_near The distance to the near clipping plane (Must be positive,   and must not be 0)
          * @param z_far The distance to the far clipping plane (Must be positive)
+         * @since 1.10
          */
         perspective(fov_y: number, aspect: number, z_near: number, z_far: number): void;
 
@@ -2437,17 +2478,20 @@ export namespace Cogl {
          * 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
          */
         pop_clip(): void;
 
         /**
          * Restores the model-view matrix on the top of the matrix stack.
+         * @since 1.10
          */
         pop_matrix(): void;
 
         /**
          * Copies the current model-view matrix onto the matrix stack. The matrix
          * can later be restored with `cogl_framebuffer_pop_matrix()`.
+         * @since 1.10
          */
         push_matrix(): void;
 
@@ -2464,6 +2508,7 @@ export namespace Cogl {
          * @param y_1 y coordinate for top left corner of the clip rectangle
          * @param x_2 x coordinate for bottom right corner of the clip rectangle
          * @param y_2 y coordinate for bottom right corner of the clip rectangle
+         * @since 1.10
          */
         push_rectangle_clip(x_1: number, y_1: number, x_2: number, y_2: number): void;
 
@@ -2485,6 +2530,7 @@ export namespace Cogl {
          * @param y top edge of the clip rectangle in window coordinates
          * @param width width of the clip rectangle
          * @param height height of the clip rectangle
+         * @since 1.10
          */
         push_scissor_clip(x: number, y: number, width: number, height: number): void;
 
@@ -2522,6 +2568,7 @@ export namespace Cogl {
          * @param format The pixel format to store the data in
          * @param pixels The address of the buffer to store the data in
          * @returns `true` if the read succeeded or `false` otherwise.
+         * @since 1.10
          */
         read_pixels(x: number, y: number, width: number, height: number, format: PixelFormat, pixels: number): boolean;
 
@@ -2541,6 +2588,7 @@ export namespace Cogl {
          * @param source Identifies which auxiliary buffer you want to read          (only COGL_READ_PIXELS_COLOR_BUFFER supported currently)
          * @param bitmap The bitmap to store the results in.
          * @returns `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
          */
         read_pixels_into_bitmap(x: number, y: number, source: ReadPixelsFlags, bitmap: Bitmap): boolean;
 
@@ -2565,6 +2613,7 @@ export namespace Cogl {
          * If you are performing incremental updates to a framebuffer you
          * should consider using `cogl_framebuffer_resolve_samples_region()`
          * instead to avoid resolving redundant pixels.
+         * @since 1.8
          */
         resolve_samples(): void;
 
@@ -2594,6 +2643,7 @@ export namespace Cogl {
          * @param y top-left y coordinate of region to resolve
          * @param width width of region to resolve
          * @param height height of region to resolve
+         * @since 1.8
          */
         resolve_samples_region(x: number, y: number, width: number, height: number): void;
 
@@ -2607,6 +2657,7 @@ export namespace Cogl {
          * @param x X-component of vertex to rotate around.
          * @param y Y-component of vertex to rotate around.
          * @param z Z-component of vertex to rotate around.
+         * @since 1.10
          */
         rotate(angle: number, x: number, y: number, z: number): void;
 
@@ -2614,6 +2665,7 @@ export namespace Cogl {
          * Multiplies the current model-view matrix by one that rotates
          * according to the rotation described by `euler`.
          * @param euler A {@link Graphene.Euler}
+         * @since 2.0
          */
         rotate_euler(euler: Graphene.Euler): void;
 
@@ -2623,6 +2675,7 @@ export namespace Cogl {
          * @param x Amount to scale along the x-axis
          * @param y Amount to scale along the y-axis
          * @param z Amount to scale along the z-axis
+         * @since 1.10
          */
         scale(x: number, y: number, z: number): void;
 
@@ -2634,6 +2687,7 @@ export namespace Cogl {
          * 
          * Depth buffer writing is enabled by default.
          * @param depth_write_enabled `true` to enable depth writing or `false` to disable
+         * @since 1.18
          */
         set_depth_write_enabled(depth_write_enabled: boolean): void;
 
@@ -2652,18 +2706,21 @@ export namespace Cogl {
          * 
          * Dithering is enabled by default.
          * @param dither_enabled `true` to enable dithering or `false` to disable
+         * @since 1.8
          */
         set_dither_enabled(dither_enabled: boolean): void;
 
         /**
          * Sets `matrix` as the new model-view matrix.
          * @param matrix the new model-view matrix
+         * @since 1.10
          */
         set_modelview_matrix(matrix: Matrix): void;
 
         /**
          * Sets `matrix` as the new projection matrix.
          * @param matrix the new projection matrix
+         * @since 1.10
          */
         set_projection_matrix(matrix: Matrix): void;
 
@@ -2701,6 +2758,7 @@ export namespace Cogl {
          * framebuffer has changed this can lead to redundant work being
          * done.</note>
          * @param samples_per_pixel The minimum number of samples per pixel
+         * @since 1.8
          */
         set_samples_per_pixel(samples_per_pixel: number): void;
 
@@ -2713,6 +2771,7 @@ export namespace Cogl {
          * enabled. (See `cogl_onscreen_template_set_stereo_enabled()`,
          * `cogl_framebuffer_get_is_stereo()`.)
          * @param stereo_mode A {@link Cogl.StereoMode} specifying which stereo buffers               should be drawn tow.
+         * @since 1.20
          */
         set_stereo_mode(stereo_mode: StereoMode): void;
 
@@ -2736,12 +2795,14 @@ export namespace Cogl {
          * @param y The top-left y coordinate of the viewport origin (only integers     supported currently)
          * @param width The width of the viewport (only integers supported currently)
          * @param height The height of the viewport (only integers supported currently)
+         * @since 1.8
          */
         set_viewport(x: number, y: number, width: number, height: number): void;
 
         /**
          * Multiplies the current model-view matrix by the given matrix.
          * @param matrix the matrix to multiply with the current model-view
+         * @since 1.10
          */
         transform(matrix: Matrix): void;
 
@@ -2751,6 +2812,7 @@ export namespace Cogl {
          * @param x Distance to translate along the x-axis
          * @param y Distance to translate along the y-axis
          * @param z Distance to translate along the z-axis
+         * @since 1.10
          */
         translate(x: number, y: number, z: number): void;
     }
@@ -2804,6 +2866,7 @@ export namespace Cogl {
          * @param callback A callback function to call for dirty events
          * @param destroy An optional callback to destroy `user_data` when the           `callback` is removed or `onscreen` is freed.
          * @returns a {@link Cogl.OnscreenDirtyClosure} pointer that can be used to               remove the callback and associated `user_data` later.
+         * @since 1.16
          */
         add_dirty_callback(callback: OnscreenDirtyCallback, destroy: UserDataDestroyCallback | null): OnscreenDirtyClosure;
 
@@ -2834,6 +2897,7 @@ export namespace Cogl {
          * @param callback A callback function to call for frame events
          * @param destroy An optional callback to destroy `user_data`           when the `callback` is removed or `onscreen` is freed.
          * @returns a {@link Cogl.FrameClosure} pointer that can be used to               remove the callback and associated `user_data` later.
+         * @since 1.14
          */
         add_frame_callback(callback: FrameCallback, destroy: UserDataDestroyCallback | null): FrameClosure;
 
@@ -2859,6 +2923,7 @@ export namespace Cogl {
          * @param callback A {@link Cogl.OnscreenResizeCallback} to call when            the `onscreen` changes size.
          * @param destroy An optional callback to destroy `user_data`           when the `callback` is removed or `onscreen` is freed.
          * @returns a {@link Cogl.OnscreenResizeClosure} pointer that can be used to               remove the callback and associated `user_data` later.
+         * @since 2.0
          */
         add_resize_callback(callback: OnscreenResizeCallback, destroy: UserDataDestroyCallback | null): OnscreenResizeClosure;
 
@@ -2902,6 +2967,7 @@ export namespace Cogl {
          * age of {@link Cogl.Onscreen} back buffer contents. If this feature is
          * missing then this function will always return 0.</note>
          * @returns The age of the buffer contents or 0 when the buffer               contents are undefined.
+         * @since 1.14
          */
         get_buffer_age(): number;
 
@@ -2911,6 +2977,7 @@ export namespace Cogl {
          * `cogl_onscreen_swap_buffers()` or `cogl_onscreen_swap_region()`
          * is called.
          * @returns the current frame counter value
+         * @since 1.14
          */
         get_frame_counter(): number;
 
@@ -2930,6 +2997,7 @@ export namespace Cogl {
          * meaningful with your window system, only whether the `onscreen` has
          * been marked as resizable.</note>
          * @returns Returns whether `onscreen` has been marked as               resizable or not.
+         * @since 2.0
          */
         get_resizable(): boolean;
 
@@ -2948,6 +3016,7 @@ export namespace Cogl {
          * 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.</note>
+         * @since 2.0
          */
         hide(): void;
 
@@ -2959,6 +3028,7 @@ export namespace Cogl {
          * `cogl_onscreen_add_dirty_callback()` to destroy the user data then
          * this will also get called.
          * @param closure A {@link Cogl.OnscreenDirtyClosure} returned from           `cogl_onscreen_add_dirty_callback()`
+         * @since 1.16
          */
         remove_dirty_callback(closure: OnscreenDirtyClosure): void;
 
@@ -2970,6 +3040,7 @@ export namespace Cogl {
          * `cogl_onscreen_add_frame_callback()` to destroy the user data then
          * this will get called.
          * @param closure A {@link Cogl.FrameClosure} returned from           `cogl_onscreen_add_frame_callback()`
+         * @since 1.14
          */
         remove_frame_callback(closure: FrameClosure): void;
 
@@ -2977,6 +3048,7 @@ export namespace Cogl {
          * Removes a resize `callback` and `user_data` pair that were previously
          * associated with `onscreen` via `cogl_onscreen_add_resize_callback()`.
          * @param closure An identifier returned from `cogl_onscreen_add_resize_callback()`
+         * @since 2.0
          */
         remove_resize_callback(closure: OnscreenResizeClosure): void;
 
@@ -3004,6 +3076,7 @@ export namespace Cogl {
          * resize handler using `cogl_onscreen_add_resize_callback()` so that it
          * can track when the viewport has been changed automatically.</note>
          * @param resizable 
+         * @since 2.0
          */
         set_resizable(resizable: boolean): void;
 
@@ -3028,6 +3101,7 @@ export namespace Cogl {
          * 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.</note>
+         * @since 2.0
          */
         show(): void;
 
@@ -3046,6 +3120,7 @@ export namespace Cogl {
          * perform incremental updates to older buffers instead of having to
          * render a full buffer for every frame.</note>
          * @param frame_info 
+         * @since 1.10
          */
         swap_buffers(frame_info: FrameInfo): void;
 
@@ -3090,6 +3165,7 @@ export namespace Cogl {
          * @param rectangles An array of integer 4-tuples representing damaged              rectangles as (x, y, width, height) tuples.
          * @param n_rectangles The number of 4-tuples to be read from `rectangles`
          * @param info 
+         * @since 1.16
          */
         swap_buffers_with_damage(rectangles: number, n_rectangles: number, info: FrameInfo): void;
 
@@ -3106,6 +3182,7 @@ export namespace Cogl {
          * @param rectangles An array of integer 4-tuples representing rectangles as              (x, y, width, height) tuples.
          * @param n_rectangles The number of 4-tuples to be read from `rectangles`
          * @param info 
+         * @since 1.10
          */
         swap_region(rectangles: number, n_rectangles: number, info: FrameInfo): void;
 
@@ -3121,6 +3198,7 @@ export namespace Cogl {
          * program will abort with an error message if there is an error during
          * automatic allocation.</note>
          * @returns `true` if there were no error allocating the framebuffer, else `false`.
+         * @since 1.8
          */
         allocate(): boolean;
 
@@ -3129,6 +3207,7 @@ export namespace Cogl {
          * that includes the color buffer then the specified `color` is used.
          * @param buffers A mask of {@link Cogl.BufferBit}<!-- -->'s identifying which auxiliary   buffers to clear
          * @param color The color to clear the color buffer too if specified in         `buffers`.
+         * @since 1.8
          */
         clear(buffers: bigint | number, color: Color): void;
 
@@ -3140,6 +3219,7 @@ export namespace Cogl {
          * @param green The green component of color to clear the color buffer too if         specified in `buffers`.
          * @param blue The blue component of color to clear the color buffer too if        specified in `buffers`.
          * @param alpha The alpha component of color to clear the color buffer too if         specified in `buffers`.
+         * @since 1.8
          */
         clear4f(buffers: bigint | number, red: number, green: number, blue: number, alpha: number): void;
 
@@ -3161,6 +3241,7 @@ export namespace Cogl {
          * framebuffer, and it's not meaningful to try and discard the color buffer of
          * a {@link Cogl.Offscreen} framebuffer since they are single-buffered.
          * @param buffers A {@link Cogl.BufferBit} mask of which ancillary buffers you want           to discard.
+         * @since 1.8
          */
         discard_buffers(buffers: bigint | number): void;
 
@@ -3210,6 +3291,7 @@ export namespace Cogl {
          * @param y_2 y coordinate lower right on screen.
          * @param tex_coords An array containing groups of   4 float values: [s_1, t_1, s_2, t_2] that are interpreted as two texture   coordinates; one for the top left texel, and one for the bottom right   texel. Each value should be between 0.0 and 1.0, where the coordinate   (0.0, 0.0) represents the top left of the texture, and (1.0, 1.0) the   bottom right.
          * @param tex_coords_len The length of the `tex_coords` array. (For one layer   and one group of texture coordinates, this would be 4)
+         * @since 1.10
          */
         draw_multitextured_rectangle(pipeline: Pipeline, x_1: number, y_1: number, x_2: number, y_2: number, tex_coords: number[], tex_coords_len: number): void;
 
@@ -3230,6 +3312,7 @@ export namespace Cogl {
          * @param y_1 Y coordinate of the top-left corner
          * @param x_2 X coordinate of the bottom-right corner
          * @param y_2 Y coordinate of the bottom-right corner
+         * @since 1.10
          */
         draw_rectangle(pipeline: Pipeline, x_1: number, y_1: number, x_2: number, y_2: number): void;
 
@@ -3256,6 +3339,7 @@ export namespace Cogl {
          * @param pipeline A {@link Cogl.Pipeline} state object
          * @param coordinates an array of coordinates   containing groups of 4 float values: [x_1, y_1, x_2, y_2] that are   interpreted as two position coordinates; one for the top left of   the rectangle (x1, y1), and one for the bottom right of the   rectangle (x2, y2).
          * @param n_rectangles number of rectangles defined in `coordinates`.
+         * @since 1.10
          */
         draw_rectangles(pipeline: Pipeline, coordinates: number[], n_rectangles: number): void;
 
@@ -3295,6 +3379,7 @@ export namespace Cogl {
          * @param t_1 T texture coordinate of the top-left coorner
          * @param s_2 S texture coordinate of the bottom-right coorner
          * @param t_2 T texture coordinate of the bottom-right coorner
+         * @since 1.10
          */
         draw_textured_rectangle(pipeline: Pipeline, x_1: number, y_1: number, x_2: number, y_2: number, s_1: number, t_1: number, s_2: number, t_2: number): void;
 
@@ -3336,6 +3421,7 @@ export namespace Cogl {
          * @param pipeline A {@link Cogl.Pipeline} state object
          * @param coordinates an array containing   groups of 8 float values: [x_1, y_1, x_2, y_2, s_1, t_1, s_2, t_2]   that have the same meaning as the arguments for   `cogl_framebuffer_draw_textured_rectangle()`.
          * @param n_rectangles number of rectangles to `coordinates` to draw
+         * @since 1.10
          */
         draw_textured_rectangles(pipeline: Pipeline, coordinates: number[], n_rectangles: number): void;
 
@@ -3349,6 +3435,7 @@ export namespace Cogl {
          * 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.
+         * @since 1.10
          */
         finish(): void;
 
@@ -3370,18 +3457,21 @@ export namespace Cogl {
          * @param top Y position of the top clipping plane where it intersects   the near clipping plane
          * @param z_near The distance to the near clipping plane (Must be positive)
          * @param z_far The distance to the far clipping plane (Must be positive)
+         * @since 1.10
          */
         frustum(left: number, right: number, bottom: number, top: number, z_near: number, z_far: number): void;
 
         /**
          * Retrieves the number of alpha bits of `framebuffer`
          * @returns the number of bits
+         * @since 1.8
          */
         get_alpha_bits(): number;
 
         /**
          * Retrieves the number of blue bits of `framebuffer`
          * @returns the number of bits
+         * @since 1.8
          */
         get_blue_bits(): number;
 
@@ -3390,12 +3480,14 @@ export namespace Cogl {
          * instantiated within. This is the {@link Cogl.Context} that was passed to
          * `cogl_onscreen_new()` for example.
          * @returns The {@link Cogl.Context} that the given               `framebuffer` was instantiated within.
+         * @since 1.8
          */
         get_context(): Context;
 
         /**
          * Retrieves the number of depth bits of `framebuffer`
          * @returns the number of bits
+         * @since 2.0
          */
         get_depth_bits(): number;
 
@@ -3403,6 +3495,7 @@ export namespace Cogl {
          * Queries whether depth buffer writing is enabled for `framebuffer`. This
          * can be controlled via `cogl_framebuffer_set_depth_write_enabled()`.
          * @returns `true` if depth writing is enabled or `false` if not.
+         * @since 1.18
          */
         get_depth_write_enabled(): boolean;
 
@@ -3414,18 +3507,21 @@ export namespace Cogl {
          * display pipeline does not support dithering. This value only represents
          * the user's request for dithering.</note>
          * @returns `true` if dithering has been requested or `false` if not.
+         * @since 1.8
          */
         get_dither_enabled(): boolean;
 
         /**
          * Retrieves the number of green bits of `framebuffer`
          * @returns the number of bits
+         * @since 1.8
          */
         get_green_bits(): number;
 
         /**
          * Queries the current height of the given `framebuffer`.
          * @returns The height of `framebuffer`.
+         * @since 1.8
          */
         get_height(): number;
 
@@ -3433,17 +3529,20 @@ export namespace Cogl {
 
         /**
          * Stores the current model-view matrix in `matrix`.
+         * @since 1.10
          */
         get_modelview_matrix(): Matrix;
 
         /**
          * Stores the current projection matrix in `matrix`.
+         * @since 1.10
          */
         get_projection_matrix(): Matrix;
 
         /**
          * Retrieves the number of red bits of `framebuffer`
          * @returns the number of bits
+         * @since 1.8
          */
         get_red_bits(): number;
 
@@ -3461,6 +3560,7 @@ export namespace Cogl {
          * framebuffer has been allocated the value will reflect the actual
          * number of samples that will be made by the GPU.
          * @returns The number of point samples made per pixel when          rasterizing geometry or 0 if single-sample rendering          has been chosen.
+         * @since 1.10
          */
         get_samples_per_pixel(): number;
 
@@ -3468,6 +3568,7 @@ export namespace Cogl {
          * Gets the current {@link Cogl.StereoMode}, which defines which stereo buffers
          * should be drawn to. See `cogl_framebuffer_set_stereo_mode()`.
          * @returns A {@link Cogl.StereoMode}
+         * @since 1.20
          */
         get_stereo_mode(): StereoMode;
 
@@ -3476,6 +3577,7 @@ export namespace Cogl {
          * using `cogl_framebuffer_set_viewport()` or the default values which are 0, 0,
          * framebuffer_width and framebuffer_height.  The values are written into the
          * given `viewport` array.
+         * @since 1.8
          */
         get_viewport4fv(): number[];
 
@@ -3483,6 +3585,7 @@ export namespace Cogl {
          * Queries the height of the viewport as set using `cogl_framebuffer_set_viewport()`
          * or the default value which is the height of the framebuffer.
          * @returns The height of the viewport.
+         * @since 1.8
          */
         get_viewport_height(): number;
 
@@ -3490,6 +3593,7 @@ export namespace Cogl {
          * Queries the width of the viewport as set using `cogl_framebuffer_set_viewport()`
          * or the default value which is the width of the framebuffer.
          * @returns The width of the viewport.
+         * @since 1.8
          */
         get_viewport_width(): number;
 
@@ -3497,6 +3601,7 @@ export namespace Cogl {
          * Queries the x coordinate of the viewport origin as set using `cogl_framebuffer_set_viewport()`
          * or the default value which is 0.
          * @returns The x coordinate of the viewport origin.
+         * @since 1.8
          */
         get_viewport_x(): number;
 
@@ -3504,17 +3609,20 @@ export namespace Cogl {
          * Queries the y coordinate of the viewport origin as set using `cogl_framebuffer_set_viewport()`
          * or the default value which is 0.
          * @returns The y coordinate of the viewport origin.
+         * @since 1.8
          */
         get_viewport_y(): number;
 
         /**
          * Queries the current width of the given `framebuffer`.
          * @returns The width of `framebuffer`.
+         * @since 1.8
          */
         get_width(): number;
 
         /**
          * Resets the current model-view matrix to the identity matrix.
+         * @since 1.10
          */
         identity_matrix(): void;
 
@@ -3527,6 +3635,7 @@ export namespace Cogl {
          * @param y_2 The y coordinate for the second horizontal clipping plane
          * @param near The <emphasis>distance</emphasis> to the near clipping   plane (will be <emphasis>negative</emphasis> if the plane is   behind the viewer)
          * @param far The <emphasis>distance</emphasis> to the far clipping   plane (will be <emphasis>negative</emphasis> if the plane is   behind the viewer)
+         * @since 1.10
          */
         orthographic(x_1: number, y_1: number, x_2: number, y_2: number, near: number, far: number): void;
 
@@ -3542,6 +3651,7 @@ export namespace Cogl {
          * @param aspect The (width over height) aspect ratio for display
          * @param z_near The distance to the near clipping plane (Must be positive,   and must not be 0)
          * @param z_far The distance to the far clipping plane (Must be positive)
+         * @since 1.10
          */
         perspective(fov_y: number, aspect: number, z_near: number, z_far: number): void;
 
@@ -3549,17 +3659,20 @@ export namespace Cogl {
          * 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
          */
         pop_clip(): void;
 
         /**
          * Restores the model-view matrix on the top of the matrix stack.
+         * @since 1.10
          */
         pop_matrix(): void;
 
         /**
          * Copies the current model-view matrix onto the matrix stack. The matrix
          * can later be restored with `cogl_framebuffer_pop_matrix()`.
+         * @since 1.10
          */
         push_matrix(): void;
 
@@ -3576,6 +3689,7 @@ export namespace Cogl {
          * @param y_1 y coordinate for top left corner of the clip rectangle
          * @param x_2 x coordinate for bottom right corner of the clip rectangle
          * @param y_2 y coordinate for bottom right corner of the clip rectangle
+         * @since 1.10
          */
         push_rectangle_clip(x_1: number, y_1: number, x_2: number, y_2: number): void;
 
@@ -3597,6 +3711,7 @@ export namespace Cogl {
          * @param y top edge of the clip rectangle in window coordinates
          * @param width width of the clip rectangle
          * @param height height of the clip rectangle
+         * @since 1.10
          */
         push_scissor_clip(x: number, y: number, width: number, height: number): void;
 
@@ -3634,6 +3749,7 @@ export namespace Cogl {
          * @param format The pixel format to store the data in
          * @param pixels The address of the buffer to store the data in
          * @returns `true` if the read succeeded or `false` otherwise.
+         * @since 1.10
          */
         read_pixels(x: number, y: number, width: number, height: number, format: PixelFormat, pixels: number): boolean;
 
@@ -3653,6 +3769,7 @@ export namespace Cogl {
          * @param source Identifies which auxiliary buffer you want to read          (only COGL_READ_PIXELS_COLOR_BUFFER supported currently)
          * @param bitmap The bitmap to store the results in.
          * @returns `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
          */
         read_pixels_into_bitmap(x: number, y: number, source: ReadPixelsFlags, bitmap: Bitmap): boolean;
 
@@ -3677,6 +3794,7 @@ export namespace Cogl {
          * If you are performing incremental updates to a framebuffer you
          * should consider using `cogl_framebuffer_resolve_samples_region()`
          * instead to avoid resolving redundant pixels.
+         * @since 1.8
          */
         resolve_samples(): void;
 
@@ -3706,6 +3824,7 @@ export namespace Cogl {
          * @param y top-left y coordinate of region to resolve
          * @param width width of region to resolve
          * @param height height of region to resolve
+         * @since 1.8
          */
         resolve_samples_region(x: number, y: number, width: number, height: number): void;
 
@@ -3719,6 +3838,7 @@ export namespace Cogl {
          * @param x X-component of vertex to rotate around.
          * @param y Y-component of vertex to rotate around.
          * @param z Z-component of vertex to rotate around.
+         * @since 1.10
          */
         rotate(angle: number, x: number, y: number, z: number): void;
 
@@ -3726,6 +3846,7 @@ export namespace Cogl {
          * Multiplies the current model-view matrix by one that rotates
          * according to the rotation described by `euler`.
          * @param euler A {@link Graphene.Euler}
+         * @since 2.0
          */
         rotate_euler(euler: Graphene.Euler): void;
 
@@ -3735,6 +3856,7 @@ export namespace Cogl {
          * @param x Amount to scale along the x-axis
          * @param y Amount to scale along the y-axis
          * @param z Amount to scale along the z-axis
+         * @since 1.10
          */
         scale(x: number, y: number, z: number): void;
 
@@ -3746,6 +3868,7 @@ export namespace Cogl {
          * 
          * Depth buffer writing is enabled by default.
          * @param depth_write_enabled `true` to enable depth writing or `false` to disable
+         * @since 1.18
          */
         set_depth_write_enabled(depth_write_enabled: boolean): void;
 
@@ -3764,18 +3887,21 @@ export namespace Cogl {
          * 
          * Dithering is enabled by default.
          * @param dither_enabled `true` to enable dithering or `false` to disable
+         * @since 1.8
          */
         set_dither_enabled(dither_enabled: boolean): void;
 
         /**
          * Sets `matrix` as the new model-view matrix.
          * @param matrix the new model-view matrix
+         * @since 1.10
          */
         set_modelview_matrix(matrix: Matrix): void;
 
         /**
          * Sets `matrix` as the new projection matrix.
          * @param matrix the new projection matrix
+         * @since 1.10
          */
         set_projection_matrix(matrix: Matrix): void;
 
@@ -3813,6 +3939,7 @@ export namespace Cogl {
          * framebuffer has changed this can lead to redundant work being
          * done.</note>
          * @param samples_per_pixel The minimum number of samples per pixel
+         * @since 1.8
          */
         set_samples_per_pixel(samples_per_pixel: number): void;
 
@@ -3825,6 +3952,7 @@ export namespace Cogl {
          * enabled. (See `cogl_onscreen_template_set_stereo_enabled()`,
          * `cogl_framebuffer_get_is_stereo()`.)
          * @param stereo_mode A {@link Cogl.StereoMode} specifying which stereo buffers               should be drawn tow.
+         * @since 1.20
          */
         set_stereo_mode(stereo_mode: StereoMode): void;
 
@@ -3848,12 +3976,14 @@ export namespace Cogl {
          * @param y The top-left y coordinate of the viewport origin (only integers     supported currently)
          * @param width The width of the viewport (only integers supported currently)
          * @param height The height of the viewport (only integers supported currently)
+         * @since 1.8
          */
         set_viewport(x: number, y: number, width: number, height: number): void;
 
         /**
          * Multiplies the current model-view matrix by the given matrix.
          * @param matrix the matrix to multiply with the current model-view
+         * @since 1.10
          */
         transform(matrix: Matrix): void;
 
@@ -3863,6 +3993,7 @@ export namespace Cogl {
          * @param x Distance to translate along the x-axis
          * @param y Distance to translate along the y-axis
          * @param z Distance to translate along the z-axis
+         * @since 1.10
          */
         translate(x: number, y: number, z: number): void;
     }
@@ -3908,32 +4039,38 @@ export namespace Cogl {
          * keep track of a pipelines ancestry which we may use to help minimize GPU
          * state changes.
          * @returns a pointer to the newly allocated {@link Cogl.Pipeline}
+         * @since 2.0
          */
         copy(): Pipeline;
 
         /**
          * Iterates all the layer indices of the given `pipeline`.
          * @param callback A {@link Cogl.PipelineLayerCallback} to be            called for each layer index
+         * @since 2.0
          */
         foreach_layer(callback: PipelineLayerCallback): void;
 
         /**
          * @returns The alpha test function of `pipeline`.
+         * @since 2.0
          */
         get_alpha_test_function(): PipelineAlphaFunc;
 
         /**
          * @returns The alpha test reference value of `pipeline`.
+         * @since 2.0
          */
         get_alpha_test_reference(): number;
 
         /**
          * Retrieves the current pipeline color.
+         * @since 2.0
          */
         get_color(): Color;
 
         /**
          * @returns the cull face mode that was previously set with `cogl_pipeline_set_cull_face_mode()`. Status: Unstable
+         * @since 2.0
          */
         get_cull_face_mode(): PipelineCullFaceMode;
 
@@ -3946,6 +4083,7 @@ export namespace Cogl {
          * {@link Cogl.Winding.CLOCKWISE} sets them to be clockwise. The default is
          * {@link Cogl.Winding.COUNTER_CLOCKWISE}.
          * @returns The `pipeline` front face winding Status: Unstable
+         * @since 2.0
          */
         get_front_face_winding(): Winding;
 
@@ -3958,6 +4096,7 @@ export namespace Cogl {
          * changed using `cogl_pipeline_set_layer_filters()`.
          * @param layer_index the layer number to change.
          * @returns The magnification {@link Cogl.PipelineFilter} for the               specified layer.
+         * @since 1.10
          */
         get_layer_mag_filter(layer_index: number): PipelineFilter;
 
@@ -3970,6 +4109,7 @@ export namespace Cogl {
          * changed using `cogl_pipeline_set_layer_filters()`.
          * @param layer_index the layer number to change.
          * @returns The minification {@link Cogl.PipelineFilter} for the               specified layer.
+         * @since 1.10
          */
         get_layer_min_filter(layer_index: number): PipelineFilter;
 
@@ -3978,12 +4118,14 @@ export namespace Cogl {
          * texture layer.
          * @param layer_index the layer number to check.
          * @returns whether the texture coordinates will be replaced with point sprite coordinates.
+         * @since 2.0
          */
         get_layer_point_sprite_coords_enabled(layer_index: number): boolean;
 
         /**
          * @param layer_index the index of the layer
          * @returns the texture that was set for the   given layer of the pipeline or `null` if no texture was set.
+         * @since 1.10
          */
         get_layer_texture(layer_index: number): Texture;
 
@@ -3992,6 +4134,7 @@ export namespace Cogl {
          * layer.
          * @param layer_index the layer number to change.
          * @returns the wrap mode for the 's' coordinate of texture lookups on this layer.
+         * @since 1.6
          */
         get_layer_wrap_mode_s(layer_index: number): PipelineWrapMode;
 
@@ -4000,17 +4143,20 @@ export namespace Cogl {
          * layer.
          * @param layer_index the layer number to change.
          * @returns the wrap mode for the 't' coordinate of texture lookups on this layer.
+         * @since 1.6
          */
         get_layer_wrap_mode_t(layer_index: number): PipelineWrapMode;
 
         /**
          * Retrieves the number of layers defined for the given `pipeline`
          * @returns the number of layers
+         * @since 2.0
          */
         get_n_layers(): number;
 
         /**
          * @returns `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()`.
+         * @since 2.0
          */
         get_per_vertex_point_size(): boolean;
 
@@ -4018,6 +4164,7 @@ export namespace Cogl {
          * Get the size of points drawn when {@link Cogl.VerticesMode.POINTS} is
          * used with the vertex buffer API.
          * @returns the point size of the `pipeline`.
+         * @since 2.0
          */
         get_point_size(): number;
 
@@ -4033,6 +4180,7 @@ export namespace Cogl {
          * before calling this function.
          * @param uniform_name The name of a uniform
          * @returns A integer representing the location of the given uniform.
+         * @since 2.0
          */
         get_uniform_location(uniform_name: string): number;
 
@@ -4040,12 +4188,14 @@ export namespace Cogl {
          * Queries what user program has been associated with the given
          * `pipeline` using `cogl_pipeline_set_user_program()`.
          * @returns The current user program or `null`.
+         * @since 2.0
          */
         get_user_program(): Handle;
 
         /**
          * This function removes a layer from your pipeline
          * @param layer_index Specifies the layer you want to remove
+         * @since 1.10
          */
         remove_layer(layer_index: number): void;
 
@@ -4059,6 +4209,7 @@ export namespace Cogl {
          * The default is {@link Cogl.PipelineAlphaFunc.ALWAYS}
          * @param alpha_func A `CoglPipelineAlphaFunc` constant
          * @param alpha_reference A reference point that the chosen alpha function uses   to compare incoming fragments to.
+         * @since 2.0
          */
         set_alpha_test_function(alpha_func: PipelineAlphaFunc, alpha_reference: number): void;
 
@@ -4130,6 +4281,7 @@ export namespace Cogl {
          * is in premultiplied form.
          * @param blend_string A <link linkend="cogl-Blend-Strings">Cogl blend string</link>   describing the desired blend function.
          * @returns `true` if the blend string was successfully parsed, and the   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
          */
         set_blend(blend_string: string): boolean;
 
@@ -4137,6 +4289,7 @@ export namespace Cogl {
          * When blending is setup to reference a CONSTANT blend factor then
          * blending will depend on the constant set with this function.
          * @param constant_color The constant color you want
+         * @since 2.0
          */
         set_blend_constant(constant_color: Color): void;
 
@@ -4150,6 +4303,7 @@ export namespace Cogl {
          * 
          * The default value is (1.0, 1.0, 1.0, 1.0)
          * @param color The components of the color
+         * @since 2.0
          */
         set_color(color: Color): void;
 
@@ -4161,6 +4315,7 @@ export namespace Cogl {
          * @param green The green component
          * @param blue The blue component
          * @param alpha The alpha component
+         * @since 2.0
          */
         set_color4f(red: number, green: number, blue: number, alpha: number): void;
 
@@ -4172,6 +4327,7 @@ export namespace Cogl {
          * @param green The green component
          * @param blue The blue component
          * @param alpha The alpha component
+         * @since 2.0
          */
         set_color4ub(red: number, green: number, blue: number, alpha: number): void;
 
@@ -4191,6 +4347,7 @@ export namespace Cogl {
          * 
          * Status: Unstable
          * @param cull_face_mode The new mode to set
+         * @since 2.0
          */
         set_cull_face_mode(cull_face_mode: PipelineCullFaceMode): void;
 
@@ -4205,6 +4362,7 @@ export namespace Cogl {
          * 
          * Status: Unstable
          * @param front_winding the winding order
+         * @since 2.0
          */
         set_front_face_winding(front_winding: Winding): void;
 
@@ -4288,6 +4446,7 @@ export namespace Cogl {
          * @param layer_index Specifies the layer you want define a combine function for
          * @param blend_string A <link linkend="cogl-Blend-Strings">Cogl blend string</link>    describing the desired texture combine function.
          * @returns `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
          */
         set_layer_combine(layer_index: number, blend_string: string): boolean;
 
@@ -4296,6 +4455,7 @@ export namespace Cogl {
          * description then you can use this function to define its value.
          * @param layer_index Specifies the layer you want to specify a constant used               for texture combining
          * @param constant The constant color you want
+         * @since 2.0
          */
         set_layer_combine_constant(layer_index: number, constant: Color): void;
 
@@ -4310,6 +4470,7 @@ export namespace Cogl {
          * @param layer_index the layer number to change.
          * @param min_filter the filter used when scaling a texture down.
          * @param mag_filter the filter used when magnifying a texture.
+         * @since 1.10
          */
         set_layer_filters(layer_index: number, min_filter: PipelineFilter, mag_filter: PipelineFilter): void;
 
@@ -4318,6 +4479,7 @@ export namespace Cogl {
          * and rotate a single layer of a pipeline used to fill your geometry.
          * @param layer_index the index for the layer inside `pipeline`
          * @param matrix the transformation matrix for the layer
+         * @since 1.10
          */
         set_layer_matrix(layer_index: number, matrix: Matrix): void;
 
@@ -4337,6 +4499,7 @@ export namespace Cogl {
          * specify the texture type so that any pipeline copies can share the
          * internal texture type state for efficiency.
          * @param layer_index The layer number to modify
+         * @since 1.10
          */
         set_layer_null_texture(layer_index: number): void;
 
@@ -4350,6 +4513,7 @@ export namespace Cogl {
          * @param layer_index the layer number to change.
          * @param enable whether to enable point sprite coord generation.
          * @returns `true` if the function succeeds, `false` otherwise.
+         * @since 2.0
          */
         set_layer_point_sprite_coords_enabled(layer_index: number, enable: boolean): boolean;
 
@@ -4366,6 +4530,7 @@ export namespace Cogl {
          * `cogl_pipeline_set_layer_wrap_mode_t()` separately.
          * @param layer_index the layer number to change.
          * @param mode the new wrap mode
+         * @since 2.0
          */
         set_layer_wrap_mode(layer_index: number, mode: PipelineWrapMode): void;
 
@@ -4373,6 +4538,7 @@ export namespace Cogl {
          * Sets the wrap mode for the 's' coordinate of texture lookups on this layer.
          * @param layer_index the layer number to change.
          * @param mode the new wrap mode
+         * @since 2.0
          */
         set_layer_wrap_mode_s(layer_index: number, mode: PipelineWrapMode): void;
 
@@ -4380,6 +4546,7 @@ export namespace Cogl {
          * Sets the wrap mode for the 't' coordinate of texture lookups on this layer.
          * @param layer_index the layer number to change.
          * @param mode the new wrap mode
+         * @since 2.0
          */
         set_layer_wrap_mode_t(layer_index: number, mode: PipelineWrapMode): void;
 
@@ -4396,6 +4563,7 @@ export namespace Cogl {
          * undefined.
          * @param enable whether to enable per-vertex point size
          * @returns `true` if the change succeeded or `false` otherwise
+         * @since 2.0
          */
         set_per_vertex_point_size(enable: boolean): boolean;
 
@@ -4413,6 +4581,7 @@ export namespace Cogl {
          * if an application wants to draw points it must make sure to use a
          * pipeline that has an explicit point size set on it.
          * @param point_size the new point size.
+         * @since 2.0
          */
         set_point_size(point_size: number): void;
 
@@ -4429,6 +4598,7 @@ export namespace Cogl {
          * uniform.
          * @param uniform_location The uniform's location identifier
          * @param value The new value for the uniform
+         * @since 2.0
          */
         set_uniform_1f(uniform_location: number, value: number): void;
 
@@ -4445,6 +4615,7 @@ export namespace Cogl {
          * uniform or a sampler uniform.
          * @param uniform_location The uniform's location identifier
          * @param value The new value for the uniform
+         * @since 2.0
          */
         set_uniform_1i(uniform_location: number, value: number): void;
 
@@ -4465,6 +4636,7 @@ export namespace Cogl {
          * @param n_components The number of components in the corresponding uniform's type
          * @param count The number of values to set
          * @param value Pointer to the new values to set
+         * @since 2.0
          */
         set_uniform_float(uniform_location: number, n_components: number, count: number, value: number): void;
 
@@ -4485,6 +4657,7 @@ export namespace Cogl {
          * @param n_components The number of components in the corresponding uniform's type
          * @param count The number of values to set
          * @param value Pointer to the new values to set
+         * @since 2.0
          */
         set_uniform_int(uniform_location: number, n_components: number, count: number, value: number): void;
 
@@ -4511,6 +4684,7 @@ export namespace Cogl {
          * @param count The number of values to set
          * @param transpose Whether to transpose the matrix
          * @param value Pointer to the new values to set
+         * @since 2.0
          */
         set_uniform_matrix(uniform_location: number, dimensions: number, count: number, transpose: boolean, value: number): void;
 
@@ -4551,6 +4725,7 @@ export namespace Cogl {
          * meantime we hope this will handle most practical GLSL and ARBfp
          * requirements.
          * @param program A {@link Cogl.Handle} to a linked CoglProgram
+         * @since 2.0
          */
         set_user_program(program: Handle): void;
     }
@@ -4617,6 +4792,7 @@ export namespace Cogl {
          * is {@link Cogl.TextureComponents.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
          */
         get_components(): TextureComponents;
 
@@ -4663,6 +4839,7 @@ export namespace Cogl {
          * 
          * By default the pre-multipled state is `TRUE`.
          * @returns `true` if red, green and blue components are               internally stored pre-multiplied by the alpha               value or `false` if not.
+         * @since 1.18
          */
         get_premultiplied(): boolean;
 
@@ -4695,6 +4872,8 @@ export namespace Cogl {
          * @param sub_width Width in pixels of the subregion
          * @param sub_height Height in pixels of the subregion
          * @returns A newly created {@link Cogl.Texture} or               `null` on failure
+         * @since 1.2
+         * @deprecated since 1.18: Use `cogl_sub_texture_new()`
          */
         new_from_sub_texture(sub_x: number, sub_y: number, sub_width: number, sub_height: number): Texture;
 
@@ -4719,6 +4898,7 @@ export namespace Cogl {
          * an image format as long as {@link Cogl.TextureComponents.RG} isn't used
          * as the texture's components.
          * @param components 
+         * @since 1.18
          */
         set_components(components: TextureComponents): void;
 
@@ -4796,6 +4976,7 @@ export namespace Cogl {
          * 
          * By default the `premultipled` state is `TRUE`.
          * @param premultiplied Whether any internally stored red, green or blue                 components are pre-multiplied by an alpha                 component.
+         * @since 1.18
          */
         set_premultiplied(premultiplied: boolean): void;
 
@@ -4833,6 +5014,7 @@ export namespace Cogl {
          * @param dst_height height of destination region to write. (Must be less   than or equal to the bitmap height)
          * @param bitmap The source bitmap to read from
          * @returns `true` if the subregion upload was successful, and   `false` otherwise
+         * @since 1.8
          */
         set_region_from_bitmap(src_x: number, src_y: number, dst_x: number, dst_y: number, dst_width: number, dst_height: number, bitmap: Bitmap): boolean;
     }
@@ -4891,6 +5073,7 @@ export namespace Cogl {
          * is {@link Cogl.TextureComponents.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
          */
         get_components(): TextureComponents;
 
@@ -4937,6 +5120,7 @@ export namespace Cogl {
          * 
          * By default the pre-multipled state is `TRUE`.
          * @returns `true` if red, green and blue components are               internally stored pre-multiplied by the alpha               value or `false` if not.
+         * @since 1.18
          */
         get_premultiplied(): boolean;
 
@@ -4969,6 +5153,8 @@ export namespace Cogl {
          * @param sub_width Width in pixels of the subregion
          * @param sub_height Height in pixels of the subregion
          * @returns A newly created {@link Cogl.Texture} or               `null` on failure
+         * @since 1.2
+         * @deprecated since 1.18: Use `cogl_sub_texture_new()`
          */
         new_from_sub_texture(sub_x: number, sub_y: number, sub_width: number, sub_height: number): Texture;
 
@@ -4993,6 +5179,7 @@ export namespace Cogl {
          * an image format as long as {@link Cogl.TextureComponents.RG} isn't used
          * as the texture's components.
          * @param components 
+         * @since 1.18
          */
         set_components(components: TextureComponents): void;
 
@@ -5070,6 +5257,7 @@ export namespace Cogl {
          * 
          * By default the `premultipled` state is `TRUE`.
          * @param premultiplied Whether any internally stored red, green or blue                 components are pre-multiplied by an alpha                 component.
+         * @since 1.18
          */
         set_premultiplied(premultiplied: boolean): void;
 
@@ -5107,6 +5295,7 @@ export namespace Cogl {
          * @param dst_height height of destination region to write. (Must be less   than or equal to the bitmap height)
          * @param bitmap The source bitmap to read from
          * @returns `true` if the subregion upload was successful, and   `false` otherwise
+         * @since 1.8
          */
         set_region_from_bitmap(src_x: number, src_y: number, dst_x: number, dst_y: number, dst_width: number, dst_height: number, bitmap: Bitmap): boolean;
     }
@@ -5135,6 +5324,7 @@ export namespace Cogl {
          * parameter, when using {@link Cogl.Color}<!-- -->s as keys in a {@link GLib.HashTable}.
          * @param v1 a {@link Cogl.Color}
          * @param v2 a {@link Cogl.Color}
+         * @since 1.0
          */
         static equal(v1: null, v2: null): boolean;
 
@@ -5144,6 +5334,7 @@ export namespace Cogl {
          * @param hue hue value, in the 0 .. 360 range
          * @param saturation saturation value, in the 0 .. 1 range
          * @param luminance luminance value, in the 0 .. 1 range
+         * @since 1.16
          */
         static init_from_hsl(hue: number, saturation: number, luminance: number): Color;
 
@@ -5151,11 +5342,13 @@ export namespace Cogl {
         /**
          * Creates a copy of `color`
          * @returns a newly-allocated {@link Cogl.Color}. Use `cogl_color_free()`   to free the allocate resources
+         * @since 1.0
          */
         copy(): Color;
 
         /**
          * Frees the resources allocated by `cogl_color_new()` and `cogl_color_copy()`
+         * @since 1.0
          */
         free(): void;
 
@@ -5163,6 +5356,7 @@ export namespace Cogl {
          * Retrieves the alpha channel of `color` as a fixed point
          * value between 0 and 1.0.
          * @returns the alpha channel of the passed color
+         * @since 1.0
          */
         get_alpha(): number;
 
@@ -5170,6 +5364,7 @@ export namespace Cogl {
          * Retrieves the alpha channel of `color` as a byte value
          * between 0 and 255
          * @returns the alpha channel of the passed color
+         * @since 1.0
          */
         get_alpha_byte(): number;
 
@@ -5177,6 +5372,7 @@ export namespace Cogl {
          * Retrieves the alpha channel of `color` as a floating point
          * value between 0.0 and 1.0
          * @returns the alpha channel of the passed color
+         * @since 1.0
          */
         get_alpha_float(): number;
 
@@ -5184,6 +5380,7 @@ export namespace Cogl {
          * Retrieves the blue channel of `color` as a fixed point
          * value between 0 and 1.0.
          * @returns the blue channel of the passed color
+         * @since 1.0
          */
         get_blue(): number;
 
@@ -5191,6 +5388,7 @@ export namespace Cogl {
          * Retrieves the blue channel of `color` as a byte value
          * between 0 and 255
          * @returns the blue channel of the passed color
+         * @since 1.0
          */
         get_blue_byte(): number;
 
@@ -5198,6 +5396,7 @@ export namespace Cogl {
          * Retrieves the blue channel of `color` as a floating point
          * value between 0.0 and 1.0
          * @returns the blue channel of the passed color
+         * @since 1.0
          */
         get_blue_float(): number;
 
@@ -5205,6 +5404,7 @@ export namespace Cogl {
          * Retrieves the green channel of `color` as a fixed point
          * value between 0 and 1.0.
          * @returns the green channel of the passed color
+         * @since 1.0
          */
         get_green(): number;
 
@@ -5212,6 +5412,7 @@ export namespace Cogl {
          * Retrieves the green channel of `color` as a byte value
          * between 0 and 255
          * @returns the green channel of the passed color
+         * @since 1.0
          */
         get_green_byte(): number;
 
@@ -5219,6 +5420,7 @@ export namespace Cogl {
          * Retrieves the green channel of `color` as a floating point
          * value between 0.0 and 1.0
          * @returns the green channel of the passed color
+         * @since 1.0
          */
         get_green_float(): number;
 
@@ -5226,6 +5428,7 @@ export namespace Cogl {
          * Retrieves the red channel of `color` as a fixed point
          * value between 0 and 1.0.
          * @returns the red channel of the passed color
+         * @since 1.0
          */
         get_red(): number;
 
@@ -5233,6 +5436,7 @@ export namespace Cogl {
          * Retrieves the red channel of `color` as a byte value
          * between 0 and 255
          * @returns the red channel of the passed color
+         * @since 1.0
          */
         get_red_byte(): number;
 
@@ -5240,6 +5444,7 @@ export namespace Cogl {
          * Retrieves the red channel of `color` as a floating point
          * value between 0.0 and 1.0
          * @returns the red channel of the passed color
+         * @since 1.0
          */
         get_red_float(): number;
 
@@ -5249,12 +5454,14 @@ export namespace Cogl {
          * @param green value of the green channel, between 0 and 1.0
          * @param blue value of the blue channel, between 0 and 1.0
          * @param alpha value of the alpha channel, between 0 and 1.0
+         * @since 1.4
          */
         init_from_4f(red: number, green: number, blue: number, alpha: number): void;
 
         /**
          * Sets the values of the passed channels into a {@link Cogl.Color}
          * @param color_array a pointer to an array of 4 float color components
+         * @since 1.4
          */
         init_from_4fv(color_array: number): void;
 
@@ -5264,6 +5471,7 @@ export namespace Cogl {
          * @param green value of the green channel, between 0 and 255
          * @param blue value of the blue channel, between 0 and 255
          * @param alpha value of the alpha channel, between 0 and 255
+         * @since 1.4
          */
         init_from_4ub(red: number, green: number, blue: number, alpha: number): void;
 
@@ -5271,78 +5479,91 @@ export namespace Cogl {
          * 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
          */
         premultiply(): void;
 
         /**
          * Sets the alpha channel of `color` to `alpha`.
          * @param alpha a float value between 0.0f and 1.0f
+         * @since 1.4
          */
         set_alpha(alpha: number): void;
 
         /**
          * Sets the alpha channel of `color` to `alpha`.
          * @param alpha a byte value between 0 and 255
+         * @since 1.4
          */
         set_alpha_byte(alpha: number): void;
 
         /**
          * Sets the alpha channel of `color` to `alpha`.
          * @param alpha a float value between 0.0f and 1.0f
+         * @since 1.4
          */
         set_alpha_float(alpha: number): void;
 
         /**
          * Sets the blue channel of `color` to `blue`.
          * @param blue a float value between 0.0f and 1.0f
+         * @since 1.4
          */
         set_blue(blue: number): void;
 
         /**
          * Sets the blue channel of `color` to `blue`.
          * @param blue a byte value between 0 and 255
+         * @since 1.4
          */
         set_blue_byte(blue: number): void;
 
         /**
          * Sets the blue channel of `color` to `blue`.
          * @param blue a float value between 0.0f and 1.0f
+         * @since 1.4
          */
         set_blue_float(blue: number): void;
 
         /**
          * Sets the green channel of `color` to `green`.
          * @param green a float value between 0.0f and 1.0f
+         * @since 1.4
          */
         set_green(green: number): void;
 
         /**
          * Sets the green channel of `color` to `green`.
          * @param green a byte value between 0 and 255
+         * @since 1.4
          */
         set_green_byte(green: number): void;
 
         /**
          * Sets the green channel of `color` to `green`.
          * @param green a float value between 0.0f and 1.0f
+         * @since 1.4
          */
         set_green_float(green: number): void;
 
         /**
          * Sets the red channel of `color` to `red`.
          * @param red a float value between 0.0f and 1.0f
+         * @since 1.4
          */
         set_red(red: number): void;
 
         /**
          * Sets the red channel of `color` to `red`.
          * @param red a byte value between 0 and 255
+         * @since 1.4
          */
         set_red_byte(red: number): void;
 
         /**
          * Sets the red channel of `color` to `red`.
          * @param red a float value between 0.0f and 1.0f
+         * @since 1.4
          */
         set_red_float(red: number): void;
 
@@ -5351,6 +5572,7 @@ export namespace Cogl {
          * 
          * The `hue` value is in the 0 .. 360 range. The `luminance` and
          * `saturation` values are in the 0 .. 1 range.
+         * @since 1.16
          */
         to_hsl(): [number, number, number];
 
@@ -5358,6 +5580,7 @@ export namespace Cogl {
          * 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
          */
         unpremultiply(): void;
     }
@@ -5414,6 +5637,8 @@ export namespace Cogl {
          * The default is {@link Cogl.MaterialAlphaFunc.ALWAYS}
          * @param alpha_func A `CoglMaterialAlphaFunc` constant
          * @param alpha_reference A reference point that the chosen alpha function uses   to compare incoming fragments to.
+         * @since 1.0
+         * @deprecated since 1.16: Use `cogl_pipeline_set_alpha_test_function()` instead
          */
         set_alpha_test_function(alpha_func: MaterialAlphaFunc, alpha_reference: number): void;
 
@@ -5488,6 +5713,8 @@ export namespace Cogl {
          * is in premultiplied form.
          * @param blend_string A <link linkend="cogl-Blend-Strings">Cogl blend string</link>   describing the desired blend function.
          * @returns `true` if the blend string was successfully parsed, and the   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 1.0
+         * @deprecated since 1.16: Use `cogl_pipeline_set_blend()` instead
          */
         set_blend(blend_string: string): boolean;
 
@@ -5495,6 +5722,8 @@ export namespace Cogl {
          * When blending is setup to reference a CONSTANT blend factor then
          * blending will depend on the constant set with this function.
          * @param constant_color The constant color you want
+         * @since 1.0
+         * @deprecated since 1.16: Use `cogl_pipeline_set_blend_constant()` instead
          */
         set_blend_constant(constant_color: Color): void;
 
@@ -5508,6 +5737,8 @@ export namespace Cogl {
          * 
          * The default value is (1.0, 1.0, 1.0, 1.0)
          * @param color The components of the color
+         * @since 1.0
+         * @deprecated since 1.16: Use `cogl_pipeline_set_color()` instead
          */
         set_color(color: Color): void;
 
@@ -5519,6 +5750,8 @@ export namespace Cogl {
          * @param green The green component
          * @param blue The blue component
          * @param alpha The alpha component
+         * @since 1.0
+         * @deprecated since 1.16: Use `cogl_pipeline_set_color4ub()` instead
          */
         set_color4ub(red: number, green: number, blue: number, alpha: number): void;
 
@@ -5535,6 +5768,8 @@ export namespace Cogl {
          * as purely GLSL based layers.</note>
          * @param layer_index the index of the layer
          * @param texture a {@link Cogl.Handle} for the layer object
+         * @since 1.0
+         * @deprecated since 1.16: Use `cogl_pipeline_set_layer()` instead
          */
         set_layer(layer_index: number, texture: Handle): void;
 
@@ -5617,6 +5852,8 @@ export namespace Cogl {
          * @param layer_index Specifies the layer you want define a combine function for
          * @param blend_string A <link linkend="cogl-Blend-Strings">Cogl blend string</link>    describing the desired texture combine function.
          * @returns `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 1.0
+         * @deprecated since 1.16: Use `cogl_pipeline_set_layer_combine()` instead
          */
         set_layer_combine(layer_index: number, blend_string: string): boolean;
 
@@ -5625,6 +5862,8 @@ export namespace Cogl {
          * description then you can use this function to define its value.
          * @param layer_index Specifies the layer you want to specify a constant used               for texture combining
          * @param constant The constant color you want
+         * @since 1.0
+         * @deprecated since 1.16: Use `cogl_pipeline_set_layer_combine_constant()` instead
          */
         set_layer_combine_constant(layer_index: number, constant: Color): void;
 
@@ -5634,6 +5873,7 @@ export namespace Cogl {
          * @param layer_index the layer number to change.
          * @param min_filter the filter used when scaling a texture down.
          * @param mag_filter the filter used when magnifying a texture.
+         * @deprecated since 1.16: Use `cogl_pipeline_set_layer_filters()` instead
          */
         set_layer_filters(layer_index: number, min_filter: MaterialFilter, mag_filter: MaterialFilter): void;
 
@@ -5642,6 +5882,7 @@ export namespace Cogl {
          * and rotate a single layer of a material used to fill your geometry.
          * @param layer_index the index for the layer inside `material`
          * @param matrix the transformation matrix for the layer
+         * @deprecated since 1.16: Use `cogl_pipeline_set_layer_matrix()` instead
          */
         set_layer_matrix(layer_index: number, matrix: Matrix): void;
 
@@ -5655,6 +5896,8 @@ export namespace Cogl {
          * @param layer_index the layer number to change.
          * @param enable whether to enable point sprite coord generation.
          * @returns `true` if the function succeeds, `false` otherwise.
+         * @since 1.4
+         * @deprecated since 1.16: Use `cogl_pipeline_set_layer_point_sprite_coords_enabled()`                  instead
          */
         set_layer_point_sprite_coords_enabled(layer_index: number, enable: boolean): boolean;
 
@@ -5667,6 +5910,8 @@ export namespace Cogl {
          * screen space so it will be the same regardless of any
          * transformations. The default point size is 1.0.
          * @param point_size the new point size.
+         * @since 1.4
+         * @deprecated since 1.16: Use `cogl_pipeline_set_point_size()` instead
          */
         set_point_size(point_size: number): void;
 
@@ -5707,6 +5952,8 @@ export namespace Cogl {
          * meantime we hope this will handle most practical GLSL and ARBfp
          * requirements.
          * @param program A {@link Cogl.Handle} to a linked CoglProgram
+         * @since 1.4
+         * @deprecated since 1.16: Use `CoglSnippet` api instead instead
          */
         set_user_program(program: Handle): void;
     }
@@ -5793,6 +6040,7 @@ export namespace Cogl {
          * inverse matrix these are not considered in the comparison.
          * @param v1 A 4x4 transformation matrix
          * @param v2 A 4x4 transformation matrix
+         * @since 1.4
          */
         static equal(v1: null, v2: null): boolean;
 
@@ -5801,12 +6049,14 @@ export namespace Cogl {
          * Allocates a new {@link Cogl.Matrix} on the heap and initializes it with
          * the same values as `matrix`.
          * @returns A newly allocated {@link Cogl.Matrix} which should be freed using `cogl_matrix_free()`
+         * @since 1.6
          */
         copy(): Matrix;
 
         /**
          * Frees a {@link Cogl.Matrix} that was previously allocated via a call to
          * `cogl_matrix_copy()`.
+         * @since 1.6
          */
         free(): void;
 
@@ -5837,6 +6087,7 @@ export namespace Cogl {
          * {@link Cogl.Matrix} so that subsequent requests for the inverse transform may
          * avoid costly inversion calculations.</note>
          * @returns `true` if the inverse was successfully calculated or `false`   for degenerate transformations that can't be inverted (in this case the   `inverse` matrix will simply be initialized with the identity matrix)
+         * @since 1.2
          */
         get_inverse(): [boolean, Matrix];
 
@@ -5880,12 +6131,14 @@ export namespace Cogl {
          * @param tx x coordinate of the translation vector
          * @param ty y coordinate of the translation vector
          * @param tz z coordinate of the translation vector
+         * @since 2.0
          */
         init_translation(tx: number, ty: number, tz: number): void;
 
         /**
          * Determines if the given matrix is an identity matrix.
          * @returns `true` if `matrix` is an identity matrix else `false`
+         * @since 1.8
          */
         is_identity(): boolean;
 
@@ -5925,6 +6178,7 @@ export namespace Cogl {
          * @param world_up_x The X component of the world's up direction vector
          * @param world_up_y The Y component of the world's up direction vector
          * @param world_up_z The Z component of the world's up direction vector
+         * @since 1.8
          */
         look_at(eye_position_x: number, eye_position_y: number, eye_position_z: number, object_x: number, object_y: number, object_z: number, world_up_x: number, world_up_y: number, world_up_z: number): void;
 
@@ -5947,6 +6201,7 @@ export namespace Cogl {
          * @param y_2 The y coordinate for the second horizontal clipping plane
          * @param near The <emphasis>distance</emphasis> to the near clipping   plane (will be <emphasis>negative</emphasis> if the plane is   behind the viewer)
          * @param far The <emphasis>distance</emphasis> to the far clipping   plane (will be <emphasis>negative</emphasis> if the plane is   behind the viewer)
+         * @since 1.10
          */
         orthographic(x_1: number, y_1: number, x_2: number, y_2: number, near: number, far: number): void;
 
@@ -6022,6 +6277,7 @@ export namespace Cogl {
          * Multiplies `matrix` with a rotation transformation described by the
          * given {@link Graphene.Euler}.
          * @param euler A euler describing a rotation
+         * @since 2.0
          */
         rotate_euler(euler: Graphene.Euler): void;
 
@@ -6103,6 +6359,7 @@ export namespace Cogl {
         /**
          * Replaces `matrix` with its transpose. Ie, every element (i,j) in the
          * new matrix is taken from element (j,i) in the old matrix.
+         * @since 1.10
          */
         transpose(): void;
 
@@ -6126,6 +6383,7 @@ export namespace Cogl {
          * @param z_2d The distance to the 2D plane. (Should always be positive and   be between `z_near` and the z_far value that was passed to   `cogl_matrix_frustum()`)
          * @param width_2d The width of the 2D coordinate system
          * @param height_2d The height of the 2D coordinate system
+         * @since 1.8
          */
         view_2d_in_frustum(left: number, right: number, bottom: number, top: number, z_near: number, z_2d: number, width_2d: number, height_2d: number): void;
 
@@ -6147,6 +6405,7 @@ export namespace Cogl {
          * @param z_2d The distance to the 2D plane. (Should always be positive and   be between `z_near` and the z_far value that was passed to   `cogl_matrix_frustum()`)
          * @param width_2d The width of the 2D coordinate system
          * @param height_2d The height of the 2D coordinate system
+         * @since 1.8
          */
         view_2d_in_perspective(fov_y: number, aspect: number, z_near: number, z_2d: number, width_2d: number, height_2d: number): void;
     }
@@ -6377,6 +6636,7 @@ export namespace Cogl {
          * program will abort with an error message if there is an error during
          * automatic allocation.</note>
          * @returns `true` if there were no error allocating the framebuffer, else `false`.
+         * @since 1.8
          */
         allocate(): boolean;
 
@@ -6385,6 +6645,7 @@ export namespace Cogl {
          * that includes the color buffer then the specified `color` is used.
          * @param buffers A mask of {@link Cogl.BufferBit}<!-- -->'s identifying which auxiliary   buffers to clear
          * @param color The color to clear the color buffer too if specified in         `buffers`.
+         * @since 1.8
          */
         clear(buffers: bigint | number, color: Color): void;
 
@@ -6396,6 +6657,7 @@ export namespace Cogl {
          * @param green The green component of color to clear the color buffer too if         specified in `buffers`.
          * @param blue The blue component of color to clear the color buffer too if        specified in `buffers`.
          * @param alpha The alpha component of color to clear the color buffer too if         specified in `buffers`.
+         * @since 1.8
          */
         clear4f(buffers: bigint | number, red: number, green: number, blue: number, alpha: number): void;
 
@@ -6417,6 +6679,7 @@ export namespace Cogl {
          * framebuffer, and it's not meaningful to try and discard the color buffer of
          * a {@link Cogl.Offscreen} framebuffer since they are single-buffered.
          * @param buffers A {@link Cogl.BufferBit} mask of which ancillary buffers you want           to discard.
+         * @since 1.8
          */
         discard_buffers(buffers: bigint | number): void;
 
@@ -6466,6 +6729,7 @@ export namespace Cogl {
          * @param y_2 y coordinate lower right on screen.
          * @param tex_coords An array containing groups of   4 float values: [s_1, t_1, s_2, t_2] that are interpreted as two texture   coordinates; one for the top left texel, and one for the bottom right   texel. Each value should be between 0.0 and 1.0, where the coordinate   (0.0, 0.0) represents the top left of the texture, and (1.0, 1.0) the   bottom right.
          * @param tex_coords_len The length of the `tex_coords` array. (For one layer   and one group of texture coordinates, this would be 4)
+         * @since 1.10
          */
         draw_multitextured_rectangle(pipeline: Pipeline, x_1: number, y_1: number, x_2: number, y_2: number, tex_coords: number[], tex_coords_len: number): void;
 
@@ -6486,6 +6750,7 @@ export namespace Cogl {
          * @param y_1 Y coordinate of the top-left corner
          * @param x_2 X coordinate of the bottom-right corner
          * @param y_2 Y coordinate of the bottom-right corner
+         * @since 1.10
          */
         draw_rectangle(pipeline: Pipeline, x_1: number, y_1: number, x_2: number, y_2: number): void;
 
@@ -6512,6 +6777,7 @@ export namespace Cogl {
          * @param pipeline A {@link Cogl.Pipeline} state object
          * @param coordinates an array of coordinates   containing groups of 4 float values: [x_1, y_1, x_2, y_2] that are   interpreted as two position coordinates; one for the top left of   the rectangle (x1, y1), and one for the bottom right of the   rectangle (x2, y2).
          * @param n_rectangles number of rectangles defined in `coordinates`.
+         * @since 1.10
          */
         draw_rectangles(pipeline: Pipeline, coordinates: number[], n_rectangles: number): void;
 
@@ -6551,6 +6817,7 @@ export namespace Cogl {
          * @param t_1 T texture coordinate of the top-left coorner
          * @param s_2 S texture coordinate of the bottom-right coorner
          * @param t_2 T texture coordinate of the bottom-right coorner
+         * @since 1.10
          */
         draw_textured_rectangle(pipeline: Pipeline, x_1: number, y_1: number, x_2: number, y_2: number, s_1: number, t_1: number, s_2: number, t_2: number): void;
 
@@ -6592,6 +6859,7 @@ export namespace Cogl {
          * @param pipeline A {@link Cogl.Pipeline} state object
          * @param coordinates an array containing   groups of 8 float values: [x_1, y_1, x_2, y_2, s_1, t_1, s_2, t_2]   that have the same meaning as the arguments for   `cogl_framebuffer_draw_textured_rectangle()`.
          * @param n_rectangles number of rectangles to `coordinates` to draw
+         * @since 1.10
          */
         draw_textured_rectangles(pipeline: Pipeline, coordinates: number[], n_rectangles: number): void;
 
@@ -6605,6 +6873,7 @@ export namespace Cogl {
          * 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.
+         * @since 1.10
          */
         finish(): void;
 
@@ -6626,18 +6895,21 @@ export namespace Cogl {
          * @param top Y position of the top clipping plane where it intersects   the near clipping plane
          * @param z_near The distance to the near clipping plane (Must be positive)
          * @param z_far The distance to the far clipping plane (Must be positive)
+         * @since 1.10
          */
         frustum(left: number, right: number, bottom: number, top: number, z_near: number, z_far: number): void;
 
         /**
          * Retrieves the number of alpha bits of `framebuffer`
          * @returns the number of bits
+         * @since 1.8
          */
         get_alpha_bits(): number;
 
         /**
          * Retrieves the number of blue bits of `framebuffer`
          * @returns the number of bits
+         * @since 1.8
          */
         get_blue_bits(): number;
 
@@ -6646,12 +6918,14 @@ export namespace Cogl {
          * instantiated within. This is the {@link Cogl.Context} that was passed to
          * `cogl_onscreen_new()` for example.
          * @returns The {@link Cogl.Context} that the given               `framebuffer` was instantiated within.
+         * @since 1.8
          */
         get_context(): Context;
 
         /**
          * Retrieves the number of depth bits of `framebuffer`
          * @returns the number of bits
+         * @since 2.0
          */
         get_depth_bits(): number;
 
@@ -6659,6 +6933,7 @@ export namespace Cogl {
          * Queries whether depth buffer writing is enabled for `framebuffer`. This
          * can be controlled via `cogl_framebuffer_set_depth_write_enabled()`.
          * @returns `true` if depth writing is enabled or `false` if not.
+         * @since 1.18
          */
         get_depth_write_enabled(): boolean;
 
@@ -6670,18 +6945,21 @@ export namespace Cogl {
          * display pipeline does not support dithering. This value only represents
          * the user's request for dithering.</note>
          * @returns `true` if dithering has been requested or `false` if not.
+         * @since 1.8
          */
         get_dither_enabled(): boolean;
 
         /**
          * Retrieves the number of green bits of `framebuffer`
          * @returns the number of bits
+         * @since 1.8
          */
         get_green_bits(): number;
 
         /**
          * Queries the current height of the given `framebuffer`.
          * @returns The height of `framebuffer`.
+         * @since 1.8
          */
         get_height(): number;
 
@@ -6689,17 +6967,20 @@ export namespace Cogl {
 
         /**
          * Stores the current model-view matrix in `matrix`.
+         * @since 1.10
          */
         get_modelview_matrix(): Matrix;
 
         /**
          * Stores the current projection matrix in `matrix`.
+         * @since 1.10
          */
         get_projection_matrix(): Matrix;
 
         /**
          * Retrieves the number of red bits of `framebuffer`
          * @returns the number of bits
+         * @since 1.8
          */
         get_red_bits(): number;
 
@@ -6717,6 +6998,7 @@ export namespace Cogl {
          * framebuffer has been allocated the value will reflect the actual
          * number of samples that will be made by the GPU.
          * @returns The number of point samples made per pixel when          rasterizing geometry or 0 if single-sample rendering          has been chosen.
+         * @since 1.10
          */
         get_samples_per_pixel(): number;
 
@@ -6724,6 +7006,7 @@ export namespace Cogl {
          * Gets the current {@link Cogl.StereoMode}, which defines which stereo buffers
          * should be drawn to. See `cogl_framebuffer_set_stereo_mode()`.
          * @returns A {@link Cogl.StereoMode}
+         * @since 1.20
          */
         get_stereo_mode(): StereoMode;
 
@@ -6732,6 +7015,7 @@ export namespace Cogl {
          * using `cogl_framebuffer_set_viewport()` or the default values which are 0, 0,
          * framebuffer_width and framebuffer_height.  The values are written into the
          * given `viewport` array.
+         * @since 1.8
          */
         get_viewport4fv(): number[];
 
@@ -6739,6 +7023,7 @@ export namespace Cogl {
          * Queries the height of the viewport as set using `cogl_framebuffer_set_viewport()`
          * or the default value which is the height of the framebuffer.
          * @returns The height of the viewport.
+         * @since 1.8
          */
         get_viewport_height(): number;
 
@@ -6746,6 +7031,7 @@ export namespace Cogl {
          * Queries the width of the viewport as set using `cogl_framebuffer_set_viewport()`
          * or the default value which is the width of the framebuffer.
          * @returns The width of the viewport.
+         * @since 1.8
          */
         get_viewport_width(): number;
 
@@ -6753,6 +7039,7 @@ export namespace Cogl {
          * Queries the x coordinate of the viewport origin as set using `cogl_framebuffer_set_viewport()`
          * or the default value which is 0.
          * @returns The x coordinate of the viewport origin.
+         * @since 1.8
          */
         get_viewport_x(): number;
 
@@ -6760,17 +7047,20 @@ export namespace Cogl {
          * Queries the y coordinate of the viewport origin as set using `cogl_framebuffer_set_viewport()`
          * or the default value which is 0.
          * @returns The y coordinate of the viewport origin.
+         * @since 1.8
          */
         get_viewport_y(): number;
 
         /**
          * Queries the current width of the given `framebuffer`.
          * @returns The width of `framebuffer`.
+         * @since 1.8
          */
         get_width(): number;
 
         /**
          * Resets the current model-view matrix to the identity matrix.
+         * @since 1.10
          */
         identity_matrix(): void;
 
@@ -6783,6 +7073,7 @@ export namespace Cogl {
          * @param y_2 The y coordinate for the second horizontal clipping plane
          * @param near The <emphasis>distance</emphasis> to the near clipping   plane (will be <emphasis>negative</emphasis> if the plane is   behind the viewer)
          * @param far The <emphasis>distance</emphasis> to the far clipping   plane (will be <emphasis>negative</emphasis> if the plane is   behind the viewer)
+         * @since 1.10
          */
         orthographic(x_1: number, y_1: number, x_2: number, y_2: number, near: number, far: number): void;
 
@@ -6798,6 +7089,7 @@ export namespace Cogl {
          * @param aspect The (width over height) aspect ratio for display
          * @param z_near The distance to the near clipping plane (Must be positive,   and must not be 0)
          * @param z_far The distance to the far clipping plane (Must be positive)
+         * @since 1.10
          */
         perspective(fov_y: number, aspect: number, z_near: number, z_far: number): void;
 
@@ -6805,17 +7097,20 @@ export namespace Cogl {
          * 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
          */
         pop_clip(): void;
 
         /**
          * Restores the model-view matrix on the top of the matrix stack.
+         * @since 1.10
          */
         pop_matrix(): void;
 
         /**
          * Copies the current model-view matrix onto the matrix stack. The matrix
          * can later be restored with `cogl_framebuffer_pop_matrix()`.
+         * @since 1.10
          */
         push_matrix(): void;
 
@@ -6832,6 +7127,7 @@ export namespace Cogl {
          * @param y_1 y coordinate for top left corner of the clip rectangle
          * @param x_2 x coordinate for bottom right corner of the clip rectangle
          * @param y_2 y coordinate for bottom right corner of the clip rectangle
+         * @since 1.10
          */
         push_rectangle_clip(x_1: number, y_1: number, x_2: number, y_2: number): void;
 
@@ -6853,6 +7149,7 @@ export namespace Cogl {
          * @param y top edge of the clip rectangle in window coordinates
          * @param width width of the clip rectangle
          * @param height height of the clip rectangle
+         * @since 1.10
          */
         push_scissor_clip(x: number, y: number, width: number, height: number): void;
 
@@ -6890,6 +7187,7 @@ export namespace Cogl {
          * @param format The pixel format to store the data in
          * @param pixels The address of the buffer to store the data in
          * @returns `true` if the read succeeded or `false` otherwise.
+         * @since 1.10
          */
         read_pixels(x: number, y: number, width: number, height: number, format: PixelFormat, pixels: number): boolean;
 
@@ -6909,6 +7207,7 @@ export namespace Cogl {
          * @param source Identifies which auxiliary buffer you want to read          (only COGL_READ_PIXELS_COLOR_BUFFER supported currently)
          * @param bitmap The bitmap to store the results in.
          * @returns `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
          */
         read_pixels_into_bitmap(x: number, y: number, source: ReadPixelsFlags, bitmap: Bitmap): boolean;
 
@@ -6933,6 +7232,7 @@ export namespace Cogl {
          * If you are performing incremental updates to a framebuffer you
          * should consider using `cogl_framebuffer_resolve_samples_region()`
          * instead to avoid resolving redundant pixels.
+         * @since 1.8
          */
         resolve_samples(): void;
 
@@ -6962,6 +7262,7 @@ export namespace Cogl {
          * @param y top-left y coordinate of region to resolve
          * @param width width of region to resolve
          * @param height height of region to resolve
+         * @since 1.8
          */
         resolve_samples_region(x: number, y: number, width: number, height: number): void;
 
@@ -6975,6 +7276,7 @@ export namespace Cogl {
          * @param x X-component of vertex to rotate around.
          * @param y Y-component of vertex to rotate around.
          * @param z Z-component of vertex to rotate around.
+         * @since 1.10
          */
         rotate(angle: number, x: number, y: number, z: number): void;
 
@@ -6982,6 +7284,7 @@ export namespace Cogl {
          * Multiplies the current model-view matrix by one that rotates
          * according to the rotation described by `euler`.
          * @param euler A {@link Graphene.Euler}
+         * @since 2.0
          */
         rotate_euler(euler: Graphene.Euler): void;
 
@@ -6991,6 +7294,7 @@ export namespace Cogl {
          * @param x Amount to scale along the x-axis
          * @param y Amount to scale along the y-axis
          * @param z Amount to scale along the z-axis
+         * @since 1.10
          */
         scale(x: number, y: number, z: number): void;
 
@@ -7002,6 +7306,7 @@ export namespace Cogl {
          * 
          * Depth buffer writing is enabled by default.
          * @param depth_write_enabled `true` to enable depth writing or `false` to disable
+         * @since 1.18
          */
         set_depth_write_enabled(depth_write_enabled: boolean): void;
 
@@ -7020,18 +7325,21 @@ export namespace Cogl {
          * 
          * Dithering is enabled by default.
          * @param dither_enabled `true` to enable dithering or `false` to disable
+         * @since 1.8
          */
         set_dither_enabled(dither_enabled: boolean): void;
 
         /**
          * Sets `matrix` as the new model-view matrix.
          * @param matrix the new model-view matrix
+         * @since 1.10
          */
         set_modelview_matrix(matrix: Matrix): void;
 
         /**
          * Sets `matrix` as the new projection matrix.
          * @param matrix the new projection matrix
+         * @since 1.10
          */
         set_projection_matrix(matrix: Matrix): void;
 
@@ -7069,6 +7377,7 @@ export namespace Cogl {
          * framebuffer has changed this can lead to redundant work being
          * done.</note>
          * @param samples_per_pixel The minimum number of samples per pixel
+         * @since 1.8
          */
         set_samples_per_pixel(samples_per_pixel: number): void;
 
@@ -7081,6 +7390,7 @@ export namespace Cogl {
          * enabled. (See `cogl_onscreen_template_set_stereo_enabled()`,
          * `cogl_framebuffer_get_is_stereo()`.)
          * @param stereo_mode A {@link Cogl.StereoMode} specifying which stereo buffers               should be drawn tow.
+         * @since 1.20
          */
         set_stereo_mode(stereo_mode: StereoMode): void;
 
@@ -7104,12 +7414,14 @@ export namespace Cogl {
          * @param y The top-left y coordinate of the viewport origin (only integers     supported currently)
          * @param width The width of the viewport (only integers supported currently)
          * @param height The height of the viewport (only integers supported currently)
+         * @since 1.8
          */
         set_viewport(x: number, y: number, width: number, height: number): void;
 
         /**
          * Multiplies the current model-view matrix by the given matrix.
          * @param matrix the matrix to multiply with the current model-view
+         * @since 1.10
          */
         transform(matrix: Matrix): void;
 
@@ -7119,6 +7431,7 @@ export namespace Cogl {
          * @param x Distance to translate along the x-axis
          * @param y Distance to translate along the y-axis
          * @param z Distance to translate along the z-axis
+         * @since 1.10
          */
         translate(x: number, y: number, z: number): void;
     }
@@ -7192,6 +7505,7 @@ export namespace Cogl {
          * is {@link Cogl.TextureComponents.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
          */
         get_components(): TextureComponents;
 
@@ -7238,6 +7552,7 @@ export namespace Cogl {
          * 
          * By default the pre-multipled state is `TRUE`.
          * @returns `true` if red, green and blue components are               internally stored pre-multiplied by the alpha               value or `false` if not.
+         * @since 1.18
          */
         get_premultiplied(): boolean;
 
@@ -7270,6 +7585,8 @@ export namespace Cogl {
          * @param sub_width Width in pixels of the subregion
          * @param sub_height Height in pixels of the subregion
          * @returns A newly created {@link Cogl.Texture} or               `null` on failure
+         * @since 1.2
+         * @deprecated since 1.18: Use `cogl_sub_texture_new()`
          */
         new_from_sub_texture(sub_x: number, sub_y: number, sub_width: number, sub_height: number): Texture;
 
@@ -7294,6 +7611,7 @@ export namespace Cogl {
          * an image format as long as {@link Cogl.TextureComponents.RG} isn't used
          * as the texture's components.
          * @param components 
+         * @since 1.18
          */
         set_components(components: TextureComponents): void;
 
@@ -7371,6 +7689,7 @@ export namespace Cogl {
          * 
          * By default the `premultipled` state is `TRUE`.
          * @param premultiplied Whether any internally stored red, green or blue                 components are pre-multiplied by an alpha                 component.
+         * @since 1.18
          */
         set_premultiplied(premultiplied: boolean): void;
 
@@ -7408,6 +7727,7 @@ export namespace Cogl {
          * @param dst_height height of destination region to write. (Must be less   than or equal to the bitmap height)
          * @param bitmap The source bitmap to read from
          * @returns `true` if the subregion upload was successful, and   `false` otherwise
+         * @since 1.8
          */
         set_region_from_bitmap(src_x: number, src_y: number, dst_x: number, dst_y: number, dst_width: number, dst_height: number, bitmap: Bitmap): boolean;
     }