@girs/gdk-4.0 4.2.0 → 4.4.0

package/gdk-4.0.d.ts

@@ -215,7 +215,7 @@ export namespace Gdk {
         /**
          * crossing because of a device switch (i.e.
          *   a mouse taking control of the pointer after a touch device), this event
-         *   is synthetic as the pointer didn’t leave the surface.
+         *   is synthetic as the pointer didn’t leave the surface.
          */
         DEVICE_SWITCH,
     }
@@ -506,6 +506,80 @@ export namespace Gdk {
     }
 
 
+    /**
+     * @gir-type Enum
+     */
+    export namespace FrameResult {
+        export const $gtype: GObject.GType<FrameResult>;
+    }
+
+    /**
+     * An enumeration describing the process of rendering a frame.
+     * Rendering a frame starts with the frame clock cycle and then follows
+     * the rendered frame (if there was one) through the display server
+     * until it appears on screen.
+     * 
+     * It is relevant in particular for {@link Gdk.FrameTimings} which
+     * may still be waiting for values to be filled in.
+     * @gir-type Enum
+     * @since 4.24
+     */
+    enum FrameResult {
+        /**
+         * The frame is currently being prepared and rendered by GTK.
+         * This is the initial state.
+         */
+        PREPARING,
+        /**
+         * GTK has determined that nothing needs to be rendered because
+         * there are no visual changes. No rendering will be submitted to
+         * the display server and because of that no information will
+         * be forthcoming from the display server.
+         * 
+         * The frame is complete.
+         */
+        SKIPPED,
+        /**
+         * GTK has determined that nothing needs to be rendered because
+         * there are no visual changes. This information has been submitted
+         * to the display server. The presentation time has been updated to
+         * reflect when this frame would have been displayed.
+         * 
+         * The frame is complete.
+         */
+        EMPTY,
+        /**
+         * A frame has been drawn and submitted to the display server, but
+         * the display server will not provide any further feedback about when
+         * or how the frame is going to be displayed.
+         * 
+         * The frame is complete.
+         */
+        SUBMITTED,
+        /**
+         * The frame has been drawn and submitted to the display server, but the
+         * display server has not yet replied what is going to happen with the
+         * rendered image.
+         */
+        OUTSTANDING,
+        /**
+         * The frame has been drawn and submitted to the display server, but the
+         * display server has not displayed it. No presentation time will be available.
+         * 
+         * The frame is complete.
+         */
+        DISCARDED,
+        /**
+         * The frame has been drawn and submitted to the display server, and the
+         * display server has rendered it and displayed the result. The presentation
+         * time is accurately reflecting when that happened.
+         * 
+         * The frame is complete.
+         */
+        PRESENTED,
+    }
+
+
     /**
      * @gir-type Enum
      */
@@ -1425,6 +1499,14 @@ export namespace Gdk {
          * The format is opaque.
          */
         XRGB2101010,
+        /**
+         * 4 bytes per pixel
+         * 
+         * Bits 31..30 contain the alpha channel, 29..20 blue, 19..10 green
+         * and 9..0 red.
+         * 
+         * The color values are premultiplied with the alpha value.
+         */
         ABGR2101010_PREMULTIPLIED,
         /**
          * 4 bytes per pixel
@@ -7162,12 +7244,26 @@ export namespace Gdk {
      * 
      * The names are the same as those in the
      * `gdk/gdkkeysyms.h` header file
-     * but without the leading &#x201C;GDK_KEY_&#x201D;.
+     * but without the leading “GDK_KEY_”.
      * @param keyval_name a key name
      * @returns the corresponding key value, or `GDK_KEY_VoidSymbol`   if the key name is not a valid key
      */
     function keyval_from_name(keyval_name: string): number;
 
+    /**
+     * Gets keyvals that are 'aliases' for `keyval`.
+     * 
+     * Aliases are meant to be functionally equivalent and
+     * should be treated the same with respect to keyboard
+     * shortcuts, etc. An example are keypad keys that are
+     * aliases for their normal counterpart, such as
+     * `GDK_KEY_KP_Left` and `GDK_KEY_Left`.
+     * @param keyval the keyval to get aliases for
+     * @returns an array of keyvals
+     * @since 4.24
+     */
+    function keyval_get_aliases(keyval: number): number[] | null;
+
     /**
      * Returns true if the given key value is in lower case.
      * @param keyval a key value.
@@ -7187,7 +7283,7 @@ export namespace Gdk {
      * 
      * The names are the same as those in the
      * `gdk/gdkkeysyms.h` header file
-     * but without the leading &#x201C;GDK_KEY_&#x201D;.
+     * but without the leading “GDK_KEY_”.
      * @param keyval a key value
      * @returns a string containing the name   of the key
      */
@@ -8114,6 +8210,7 @@ export namespace Gdk {
          * The returned context is guaranteed to be valid until
          * {@link Gdk.DrawContext.end_frame} is called.
          * @returns a Cairo context   to draw on `GdkSurface
+         * @deprecated since 4.18: Drawing content with Cairo should be done via   Cairo rendernodes, not by using renderers.
          */
         cairo_create(): cairo.Context | null;
     }
@@ -8318,6 +8415,7 @@ export namespace Gdk {
          * supported by GTK. In that case, `NULL` is returned, and `error` is set
          * with an error message that can be presented to the user.
          * @returns A newly allocated {@link Gdk.ColorState}
+         * @since 4.16
          */
         build_color_state(): ColorState;
 
@@ -8325,30 +8423,35 @@ export namespace Gdk {
          * Returns the value of the color-primaries property
          * of `self`.
          * @returns the color-primaries value
+         * @since 4.16
          */
         get_color_primaries(): number;
 
         /**
          * Gets the matrix-coefficients property of `self`.
          * @returns the matrix-coefficients value
+         * @since 4.16
          */
         get_matrix_coefficients(): number;
 
         /**
          * Gets the range property of `self`.
          * @returns the range value
+         * @since 4.16
          */
         get_range(): CicpRange;
 
         /**
          * Gets the transfer-function property of `self`.
          * @returns the transfer-function value
+         * @since 4.16
          */
         get_transfer_function(): number;
 
         /**
          * Sets the color-primaries property of `self`.
          * @param color_primaries the new color primaries value
+         * @since 4.16
          */
         set_color_primaries(color_primaries: number): void;
 
@@ -8356,18 +8459,21 @@ export namespace Gdk {
          * `self` a {@link Gdk.CicpParams}
          * Sets the matrix-coefficients property of `self`.
          * @param matrix_coefficients the new matrix-coefficients value
+         * @since 4.16
          */
         set_matrix_coefficients(matrix_coefficients: number): void;
 
         /**
          * Sets the range property of `self`
          * @param range the range value
+         * @since 4.16
          */
         set_range(range: CicpRange): void;
 
         /**
          * Sets the transfer-function property of `self`.
          * @param transfer_function the new transfer-function value
+         * @since 4.16
          */
         set_transfer_function(transfer_function: number): void;
     }
@@ -8921,6 +9027,7 @@ export namespace Gdk {
          * pointer indicating the function `res` was created by).
          * @param source_tag an application-defined tag
          * @returns `TRUE` if `res` has the indicated `source_tag`, `FALSE` if   not.
+         * @since 2.34
          */
         is_tagged(source_tag: null): boolean;
 
@@ -8936,6 +9043,7 @@ export namespace Gdk {
          * set by virtual methods should also be extracted by virtual methods,
          * to enable subclasses to chain up correctly.
          * @returns `TRUE` if `error` is has been filled in with an error from   `res`, `FALSE` if not.
+         * @since 2.34
          */
         legacy_propagate_error(): boolean;
 
@@ -8955,6 +9063,7 @@ export namespace Gdk {
          * Checks if `res` has the given `source_tag` (generally a function
          * pointer indicating the function `res` was created by).
          * @param source_tag an application-defined tag
+         * @since 2.34
          * @virtual
          */
         vfunc_is_tagged(source_tag: null): boolean;
@@ -9359,6 +9468,7 @@ export namespace Gdk {
          * pointer indicating the function `res` was created by).
          * @param source_tag an application-defined tag
          * @returns `TRUE` if `res` has the indicated `source_tag`, `FALSE` if   not.
+         * @since 2.34
          */
         is_tagged(source_tag: null): boolean;
 
@@ -9374,6 +9484,7 @@ export namespace Gdk {
          * set by virtual methods should also be extracted by virtual methods,
          * to enable subclasses to chain up correctly.
          * @returns `TRUE` if `error` is has been filled in with an error from   `res`, `FALSE` if not.
+         * @since 2.34
          */
         legacy_propagate_error(): boolean;
 
@@ -9393,6 +9504,7 @@ export namespace Gdk {
          * Checks if `res` has the given `source_tag` (generally a function
          * pointer indicating the function `res` was created by).
          * @param source_tag an application-defined tag
+         * @since 2.34
          * @virtual
          */
         vfunc_is_tagged(source_tag: null): boolean;
@@ -9810,6 +9922,8 @@ export namespace Gdk {
          * Will be -1 if there is no valid active layout.
          * 
          * This is only relevant for keyboard devices.
+         * 
+         * Value changes from compositor events, connect to notify if needed.
          * @since 4.18
          * @read-only
          * @default 0
@@ -9822,6 +9936,8 @@ export namespace Gdk {
          * Will be -1 if there is no valid active layout.
          * 
          * This is only relevant for keyboard devices.
+         * 
+         * Value changes from compositor events, connect to notify if needed.
          * @since 4.18
          * @read-only
          * @default 0
@@ -9897,6 +10013,8 @@ export namespace Gdk {
          * The names of the keyboard layouts of a {@link Gdk.Device}.
          * 
          * This is only relevant for keyboard devices.
+         * 
+         * Value changes from compositor events, connect to notify if needed.
          * @since 4.18
          * @read-only
          */
@@ -9906,6 +10024,8 @@ export namespace Gdk {
          * The names of the keyboard layouts of a {@link Gdk.Device}.
          * 
          * This is only relevant for keyboard devices.
+         * 
+         * Value changes from compositor events, connect to notify if needed.
          * @since 4.18
          * @read-only
          */
@@ -10097,6 +10217,7 @@ export namespace Gdk {
          * 
          * This is only relevant for keyboard devices.
          * @returns The layout index of the active layout or -1.
+         * @since 4.18
          */
         get_active_layout_index(): number;
 
@@ -10145,6 +10266,7 @@ export namespace Gdk {
          * 
          * This is only relevant for keyboard devices.
          * @returns `null`-terminated array of strings of layouts,
+         * @since 4.18
          */
         get_layout_names(): string[] | null;
 
@@ -10223,6 +10345,7 @@ export namespace Gdk {
          * events for a device that are not received from the OS, and will not
          * update the timestamp).
          * @returns the timestamp of the last activity for this device
+         * @since 4.2
          */
         get_timestamp(): number;
 
@@ -10598,6 +10721,7 @@ export namespace Gdk {
          * Before using the returned {@link Gdk.GLContext}, you will need to
          * call {@link Gdk.GLContext.make_current} or {@link Gdk.GLContext.realize}.
          * @returns the newly created {@link Gdk.GLContext}
+         * @since 4.6
          */
         create_gl_context(): GLContext;
 
@@ -10657,6 +10781,7 @@ export namespace Gdk {
          * 
          * This function is threadsafe. It can be called from any thread.
          * @returns a {@link Gdk.DmabufFormats} object
+         * @since 4.14
          */
         get_dmabuf_formats(): DmabufFormats;
 
@@ -10708,6 +10833,7 @@ export namespace Gdk {
          * Gets the startup notification ID for a Wayland display, or `null`
          * if no ID has been defined.
          * @returns the startup notification ID for `display`
+         * @deprecated since 4.10
          */
         get_startup_notification_id(): string | null;
 
@@ -10737,7 +10863,7 @@ export namespace Gdk {
          * alpha channel.
          * 
          * Even if a `true` is returned, it is possible that the
-         * surface&#x2019;s alpha channel won&#x2019;t be honored when displaying the
+         * surface’s alpha channel won’t be honored when displaying the
          * surface on the screen: in particular, for X an appropriate
          * windowing manager and compositing manager must be running to
          * provide appropriate display. Use {@link Gdk.Display.is_composited}
@@ -10799,6 +10925,7 @@ export namespace Gdk {
          * [gtk_window_set_auto_startup_notification()](../gtk4/method.Window.set_auto_startup_notification.html)
          * is called to disable that feature.
          * @param startup_id a startup-notification identifier, for which   notification process should be completed
+         * @deprecated since 4.10: Using {@link Gdk.Toplevel.set_startup_id} is sufficient
          */
         notify_startup_complete(startup_id: string): void;
 
@@ -10818,12 +10945,14 @@ export namespace Gdk {
          * as needed. But you can use it as a check when setting up code that
          * might make use of OpenGL.
          * @returns `true` if the display supports OpenGL
+         * @since 4.4
          */
         prepare_gl(): boolean;
 
         /**
          * Adds the given event to the event queue for `display`.
          * @param event a {@link Gdk.Event}
+         * @deprecated since 4.10: This function is only useful in very special situations and should not be used by applications.
          */
         put_event(event: Event): void;
 
@@ -10844,6 +10973,7 @@ export namespace Gdk {
          * If `true` is returned the application decides if it wants to draw shadows.
          * If `false` is returned, the compositor decides if it wants to draw shadows.
          * @returns `true` if surfaces can draw shadows or   `false` if the display does not support this functionality.
+         * @since 4.14
          */
         supports_shadow_width(): boolean;
 
@@ -11329,6 +11459,7 @@ export namespace Gdk {
          * makes sense to transfer the {@link GLib.Variant} between processes on the same machine,
          * (as opposed to over the network), and within the same file system namespace.
          * @returns a {@link GLib.Variant}, or `null` when serialization fails. The {@link GLib.Variant} will not be floating.
+         * @since 2.38
          */
         serialize(): GLib.Variant | null;
 
@@ -11350,6 +11481,7 @@ export namespace Gdk {
          * - If `icon` is a {@link Gio.ThemedIcon} with exactly one name and no fallbacks,
          *   the encoding is simply the name (such as `network-server`).
          * @returns An allocated NUL-terminated UTF8 string or `null` if `icon` can't be serialized. Use `g_free()` to free.
+         * @since 2.20
          */
         to_string(): string | null;
 
@@ -11372,6 +11504,7 @@ export namespace Gdk {
          * As serialization will avoid using raw icon data when possible, it only
          * makes sense to transfer the {@link GLib.Variant} between processes on the same machine,
          * (as opposed to over the network), and within the same file system namespace.
+         * @since 2.38
          * @virtual
          */
         vfunc_serialize(): GLib.Variant | null;
@@ -11379,6 +11512,7 @@ export namespace Gdk {
         /**
          * Serializes the `icon` into string tokens.
          * This is can be invoked when `g_icon_new_for_string()` is called.
+         * @since 2.20
          * @virtual
          */
         vfunc_to_tokens(): [boolean, string[], number];
@@ -11719,12 +11853,14 @@ export namespace Gdk {
          * possibly with changing properties in between.
          * @param data user data to pass to the destroy function
          * @returns a newly built {@link Gdk.Texture} or `NULL`   if the format is not supported
+         * @since 4.14
          */
         build(data: null): Texture | null;
 
         /**
          * Gets the color state previously set via `gdk_dmabuf_texture_builder_set_color_state()`.
          * @returns the color state
+         * @since 4.16
          */
         get_color_state(): ColorState | null;
 
@@ -11732,6 +11868,7 @@ export namespace Gdk {
          * Returns the display that this texture builder is
          * associated with.
          * @returns the display
+         * @since 4.14
          */
         get_display(): Display;
 
@@ -11739,6 +11876,7 @@ export namespace Gdk {
          * Gets the file descriptor for a plane or -1 if none.
          * @param plane the plane to get the fd for
          * @returns the file descriptor
+         * @since 4.14
          */
         get_fd(plane: number): number;
 
@@ -11748,6 +11886,7 @@ export namespace Gdk {
          * 
          * The format is specified as a fourcc code.
          * @returns The format
+         * @since 4.14
          */
         get_fourcc(): number;
 
@@ -11755,18 +11894,21 @@ export namespace Gdk {
          * Gets the height previously set via `gdk_dmabuf_texture_builder_set_height()` or
          * 0 if the height wasn't set.
          * @returns The height
+         * @since 4.14
          */
         get_height(): number;
 
         /**
          * Gets the modifier value.
          * @returns the modifier
+         * @since 4.14
          */
         get_modifier(): number;
 
         /**
          * Gets the number of planes.
          * @returns The number of planes
+         * @since 4.14
          */
         get_n_planes(): number;
 
@@ -11774,12 +11916,14 @@ export namespace Gdk {
          * Gets the offset value for a plane.
          * @param plane the plane to get the offset for
          * @returns the offset
+         * @since 4.14
          */
         get_offset(plane: number): number;
 
         /**
          * Whether the data is premultiplied.
          * @returns whether the data is premultiplied
+         * @since 4.14
          */
         get_premultiplied(): boolean;
 
@@ -11787,6 +11931,7 @@ export namespace Gdk {
          * Gets the stride value for a plane.
          * @param plane the plane to get the stride for
          * @returns the stride
+         * @since 4.14
          */
         get_stride(plane: number): number;
 
@@ -11794,6 +11939,7 @@ export namespace Gdk {
          * Gets the region previously set via `gdk_dmabuf_texture_builder_set_update_region()` or
          * `null` if none was set.
          * @returns The region
+         * @since 4.14
          */
         get_update_region(): cairo.Region | null;
 
@@ -11801,6 +11947,7 @@ export namespace Gdk {
          * Gets the texture previously set via `gdk_dmabuf_texture_builder_set_update_texture()` or
          * `null` if none was set.
          * @returns The texture
+         * @since 4.14
          */
         get_update_texture(): Texture | null;
 
@@ -11808,6 +11955,7 @@ export namespace Gdk {
          * Gets the width previously set via `gdk_dmabuf_texture_builder_set_width()` or
          * 0 if the width wasn't set.
          * @returns The width
+         * @since 4.14
          */
         get_width(): number;
 
@@ -11818,6 +11966,7 @@ export namespace Gdk {
          * correct colorstate based on the format.
          * If you don't know what colorstates are, this is probably the right thing.
          * @param color_state a {@link Gdk.ColorState} or `NULL` to unset the colorstate.
+         * @since 4.16
          */
         set_color_state(color_state: ColorState | null): void;
 
@@ -11828,6 +11977,7 @@ export namespace Gdk {
          * The display is used to determine the supported
          * dma-buf formats.
          * @param display the display
+         * @since 4.14
          */
         set_display(display: Display): void;
 
@@ -11835,6 +11985,7 @@ export namespace Gdk {
          * Sets the file descriptor for a plane or to -1 to unset it.
          * @param plane the plane to set the fd for
          * @param fd the file descriptor
+         * @since 4.14
          */
         set_fd(plane: number, fd: number): void;
 
@@ -11845,6 +11996,7 @@ export namespace Gdk {
          * 
          * The format must be set before calling {@link Gdk.DmabufTextureBuilder.build}.
          * @param fourcc the texture's format or 0 to unset
+         * @since 4.14
          */
         set_fourcc(fourcc: number): void;
 
@@ -11853,18 +12005,21 @@ export namespace Gdk {
          * 
          * The height must be set before calling {@link Gdk.DmabufTextureBuilder.build}.
          * @param height the texture's height or 0 to unset
+         * @since 4.14
          */
         set_height(height: number): void;
 
         /**
          * Sets the modifier.
          * @param modifier the modifier value
+         * @since 4.14
          */
         set_modifier(modifier: bigint | number): void;
 
         /**
          * Sets the number of planes of the texture.
          * @param n_planes the number of planes
+         * @since 4.14
          */
         set_n_planes(n_planes: number): void;
 
@@ -11872,6 +12027,7 @@ export namespace Gdk {
          * Sets the offset for a plane.
          * @param plane the plane to set the offset for
          * @param offset the offset value
+         * @since 4.14
          */
         set_offset(plane: number, offset: number): void;
 
@@ -11881,6 +12037,7 @@ export namespace Gdk {
          * Unless otherwise specified, all formats including alpha channels are assumed
          * to be premultiplied.
          * @param premultiplied whether the data is premultiplied
+         * @since 4.14
          */
         set_premultiplied(premultiplied: boolean): void;
 
@@ -11890,6 +12047,7 @@ export namespace Gdk {
          * The stride must be set for all planes before calling {@link Gdk.DmabufTextureBuilder.build}.
          * @param plane the plane to set the stride for
          * @param stride the stride value
+         * @since 4.14
          */
         set_stride(plane: number, stride: number): void;
 
@@ -11905,6 +12063,7 @@ export namespace Gdk {
          * 
          * An example would be a screen recording where only the mouse pointer moves.
          * @param region the region to update
+         * @since 4.14
          */
         set_update_region(region: cairo.Region | null): void;
 
@@ -11912,6 +12071,7 @@ export namespace Gdk {
          * Sets the texture to be updated by this texture. See
          * {@link Gdk.DmabufTextureBuilder.set_update_region} for an explanation.
          * @param texture the texture to update
+         * @since 4.14
          */
         set_update_texture(texture: Texture | null): void;
 
@@ -11920,6 +12080,7 @@ export namespace Gdk {
          * 
          * The width must be set before calling {@link Gdk.DmabufTextureBuilder.build}.
          * @param width The texture's width or 0 to unset
+         * @since 4.14
          */
         set_width(width: number): void;
     }
@@ -12269,6 +12430,7 @@ export namespace Gdk {
          * use of [GskRenderer](../gsk4/class.Renderer.html)s, so application code
          * does not need to call these functions explicitly.
          * @param region minimum region that should be drawn
+         * @deprecated since 4.16: Drawing directly to the surface is no longer recommended.   Use `GskRenderNode` and `GskRenderer`.
          */
         begin_frame(region: cairo.Region): void;
 
@@ -12281,6 +12443,7 @@ export namespace Gdk {
          * When using a {@link Gdk.GLContext}, this function may call `glFlush()`
          * implicitly before returning; it is not recommended to call `glFlush()`
          * explicitly before calling this function.
+         * @deprecated since 4.16: Drawing directly to the surface is no longer recommended.   Use `GskRenderNode` and `GskRenderer`.
          */
         end_frame(): void;
 
@@ -12300,6 +12463,7 @@ export namespace Gdk {
          * If `context` is not in between calls to {@link Gdk.DrawContext.begin_frame}
          * and {@link Gdk.DrawContext.end_frame}, `null` will be returned.
          * @returns a Cairo region
+         * @deprecated since 4.16: Drawing directly to the surface is no longer recommended.   Use `GskRenderNode` and `GskRenderer`.
          */
         get_frame_region(): cairo.Region | null;
 
@@ -12316,6 +12480,7 @@ export namespace Gdk {
          * and {@link Gdk.DrawContext.end_frame}. In this situation, drawing commands
          * may be effecting the contents of the `context`'s surface.
          * @returns `true` if the context is between {@link Gdk.DrawContext.begin_frame}   and {@link Gdk.DrawContext.end_frame} calls.
+         * @deprecated since 4.16: Drawing directly to the surface is no longer recommended.   Use `GskRenderNode` and `GskRenderer`.
          */
         is_in_frame(): boolean;
     }
@@ -12967,7 +13132,7 @@ export namespace Gdk {
      * as `g_get_monotonic_time()`. The frame time does not advance during
      * the time a frame is being painted, and outside of a frame, an attempt
      * is made so that all calls to {@link Gdk.FrameClock.get_frame_time} that
-     * are called at a &#x201C;similar&#x201D; time get the same value. This means that
+     * are called at a “similar” time get the same value. This means that
      * if different animations are timed by looking at the difference in
      * time between an initial value from {@link Gdk.FrameClock.get_frame_time}
      * and the value inside the `Gdk.FrameClock::update` signal of the clock,
@@ -13046,10 +13211,10 @@ export namespace Gdk {
         /**
          * Gets the time that should currently be used for animations.
          * 
-         * Inside the processing of a frame, it&#x2019;s the time used to compute the
+         * Inside the processing of a frame, it’s the time used to compute the
          * animation position of everything in a frame. Outside of a frame, it's
-         * the time of the conceptual &#x201C;previous frame,&#x201D; which may be either
-         * the actual previous frame time, or if that&#x2019;s too old, an updated
+         * the time of the conceptual “previous frame,” which may be either
+         * the actual previous frame time, or if that’s too old, an updated
          * time.
          * @returns a timestamp in microseconds, in the timescale of  of `g_get_monotonic_time()`.
          */
@@ -13274,6 +13439,7 @@ export namespace Gdk {
         /**
          * Gets the allowed APIs set via `gdk_gl_context_set_allowed_apis()`.
          * @returns the allowed APIs
+         * @since 4.6
          */
         get_allowed_apis(): GLAPI;
 
@@ -13282,6 +13448,7 @@ export namespace Gdk {
          * 
          * If the renderer has not been realized yet, 0 is returned.
          * @returns the currently used API
+         * @since 4.6
          */
         get_api(): GLAPI;
 
@@ -13323,6 +13490,7 @@ export namespace Gdk {
          * As many contexts can share data now and no single shared context exists
          * anymore, this function has been deprecated and now always returns `null`.
          * @returns `null`
+         * @deprecated since 4.4: Use {@link Gdk.GLContext.is_shared} to check if contexts   can be shared.
          */
         get_shared_context(): GLContext | null;
 
@@ -13381,6 +13549,7 @@ export namespace Gdk {
          * is not, this function will return `false`.
          * @param other the {@link Gdk.GLContext} that should be compatible with `self`
          * @returns `true` if the two GL contexts are compatible.
+         * @since 4.4
          */
         is_shared(other: GLContext): boolean;
 
@@ -13406,6 +13575,7 @@ export namespace Gdk {
          * 
          * By default, all APIs are allowed.
          * @param apis the allowed APIs
+         * @since 4.6
          */
         set_allowed_apis(apis: GLAPI): void;
 
@@ -13465,6 +13635,7 @@ export namespace Gdk {
          * after calling {@link Gdk.GLContext.realize} to decide whether to use
          * the OpenGL or OpenGL ES API, extensions, or shaders.
          * @param use_es whether the context should use OpenGL ES instead of OpenGL,   or -1 to allow auto-detection
+         * @deprecated since 4.6
          */
         set_use_es(use_es: number): void;
     }
@@ -13765,6 +13936,7 @@ export namespace Gdk {
          * makes sense to transfer the {@link GLib.Variant} between processes on the same machine,
          * (as opposed to over the network), and within the same file system namespace.
          * @returns a {@link GLib.Variant}, or `null` when serialization fails. The {@link GLib.Variant} will not be floating.
+         * @since 2.38
          */
         serialize(): GLib.Variant | null;
 
@@ -13786,6 +13958,7 @@ export namespace Gdk {
          * - If `icon` is a {@link Gio.ThemedIcon} with exactly one name and no fallbacks,
          *   the encoding is simply the name (such as `network-server`).
          * @returns An allocated NUL-terminated UTF8 string or `null` if `icon` can't be serialized. Use `g_free()` to free.
+         * @since 2.20
          */
         to_string(): string | null;
 
@@ -13808,6 +13981,7 @@ export namespace Gdk {
          * As serialization will avoid using raw icon data when possible, it only
          * makes sense to transfer the {@link GLib.Variant} between processes on the same machine,
          * (as opposed to over the network), and within the same file system namespace.
+         * @since 2.38
          * @virtual
          */
         vfunc_serialize(): GLib.Variant | null;
@@ -13815,6 +13989,7 @@ export namespace Gdk {
         /**
          * Serializes the `icon` into string tokens.
          * This is can be invoked when `g_icon_new_for_string()` is called.
+         * @since 2.20
          * @virtual
          */
         vfunc_to_tokens(): [boolean, string[], number];
@@ -14097,12 +14272,14 @@ export namespace Gdk {
          * possibly with changing properties in between.
          * @param data user data to pass to the destroy function
          * @returns a newly built {@link Gdk.Texture}
+         * @since 4.12
          */
         build(data: null): Texture;
 
         /**
          * Gets the color state previously set via `gdk_gl_texture_builder_set_color_state()`.
          * @returns the color state
+         * @since 4.16
          */
         get_color_state(): ColorState;
 
@@ -14110,18 +14287,21 @@ export namespace Gdk {
          * Gets the context previously set via `gdk_gl_texture_builder_set_context()` or
          * `null` if none was set.
          * @returns The context
+         * @since 4.12
          */
         get_context(): GLContext | null;
 
         /**
          * Gets the format previously set via `gdk_gl_texture_builder_set_format()`.
          * @returns The format
+         * @since 4.12
          */
         get_format(): MemoryFormat;
 
         /**
          * Gets whether the texture has a mipmap.
          * @returns Whether the texture has a mipmap
+         * @since 4.12
          */
         get_has_mipmap(): boolean;
 
@@ -14129,6 +14309,7 @@ export namespace Gdk {
          * Gets the height previously set via `gdk_gl_texture_builder_set_height()` or
          * 0 if the height wasn't set.
          * @returns The height
+         * @since 4.12
          */
         get_height(): number;
 
@@ -14136,12 +14317,14 @@ export namespace Gdk {
          * Gets the texture id previously set via `gdk_gl_texture_builder_set_id()` or
          * 0 if the id wasn't set.
          * @returns The id
+         * @since 4.12
          */
         get_id(): number;
 
         /**
          * Gets the `GLsync` previously set via `gdk_gl_texture_builder_set_sync()`.
          * @returns the `GLSync`
+         * @since 4.12
          */
         get_sync(): null;
 
@@ -14149,6 +14332,7 @@ export namespace Gdk {
          * Gets the region previously set via `gdk_gl_texture_builder_set_update_region()` or
          * `null` if none was set.
          * @returns The region
+         * @since 4.12
          */
         get_update_region(): cairo.Region | null;
 
@@ -14156,6 +14340,7 @@ export namespace Gdk {
          * Gets the texture previously set via `gdk_gl_texture_builder_set_update_texture()` or
          * `null` if none was set.
          * @returns The texture
+         * @since 4.12
          */
         get_update_texture(): Texture | null;
 
@@ -14163,6 +14348,7 @@ export namespace Gdk {
          * Gets the width previously set via `gdk_gl_texture_builder_set_width()` or
          * 0 if the width wasn't set.
          * @returns The width
+         * @since 4.12
          */
         get_width(): number;
 
@@ -14172,6 +14358,7 @@ export namespace Gdk {
          * By default, the sRGB colorstate is used. If you don't know what
          * colorstates are, this is probably the right thing.
          * @param color_state a {@link Gdk.ColorState}
+         * @since 4.16
          */
         set_color_state(color_state: ColorState): void;
 
@@ -14181,6 +14368,7 @@ export namespace Gdk {
          * 
          * The context must be set before calling {@link Gdk.GLTextureBuilder.build}.
          * @param context The context the texture belongs to or `null` to unset
+         * @since 4.12
          */
         set_context(context: GLContext | null): void;
 
@@ -14202,6 +14390,7 @@ export namespace Gdk {
          * Non-RGBA textures need to have swizzling parameters set up properly to be usable
          * in GSK's shaders.
          * @param format The texture's format
+         * @since 4.12
          */
         set_format(format: MemoryFormat): void;
 
@@ -14211,6 +14400,7 @@ export namespace Gdk {
          * 
          * Typically, the `glGenerateMipmap` function is used to generate a mimap.
          * @param has_mipmap Whether the texture has a mipmap
+         * @since 4.12
          */
         set_has_mipmap(has_mipmap: boolean): void;
 
@@ -14219,6 +14409,7 @@ export namespace Gdk {
          * 
          * The height must be set before calling {@link Gdk.GLTextureBuilder.build}.
          * @param height The texture's height or 0 to unset
+         * @since 4.12
          */
         set_height(height: number): void;
 
@@ -14229,6 +14420,7 @@ export namespace Gdk {
          * 
          * The id must be set before calling {@link Gdk.GLTextureBuilder.build}.
          * @param id The texture id to be used for creating the texture
+         * @since 4.12
          */
         set_id(id: number): void;
 
@@ -14242,6 +14434,7 @@ export namespace Gdk {
          * The texture builder does not destroy it and it is the callers
          * responsibility to make sure it doesn't leak.
          * @param sync the GLSync object
+         * @since 4.12
          */
         set_sync(sync: null): void;
 
@@ -14257,6 +14450,7 @@ export namespace Gdk {
          * 
          * An example would be a screen recording where only the mouse pointer moves.
          * @param region the region to update
+         * @since 4.12
          */
         set_update_region(region: cairo.Region | null): void;
 
@@ -14264,6 +14458,7 @@ export namespace Gdk {
          * Sets the texture to be updated by this texture. See
          * {@link Gdk.GLTextureBuilder.set_update_region} for an explanation.
          * @param texture the texture to update
+         * @since 4.12
          */
         set_update_texture(texture: Texture | null): void;
 
@@ -14272,6 +14467,7 @@ export namespace Gdk {
          * 
          * The width must be set before calling {@link Gdk.GLTextureBuilder.build}.
          * @param width The texture's width or 0 to unset
+         * @since 4.12
          */
         set_width(width: number): void;
     }
@@ -14696,6 +14892,7 @@ export namespace Gdk {
          * makes sense to transfer the {@link GLib.Variant} between processes on the same machine,
          * (as opposed to over the network), and within the same file system namespace.
          * @returns a {@link GLib.Variant}, or `null` when serialization fails. The {@link GLib.Variant} will not be floating.
+         * @since 2.38
          */
         serialize(): GLib.Variant | null;
 
@@ -14717,6 +14914,7 @@ export namespace Gdk {
          * - If `icon` is a {@link Gio.ThemedIcon} with exactly one name and no fallbacks,
          *   the encoding is simply the name (such as `network-server`).
          * @returns An allocated NUL-terminated UTF8 string or `null` if `icon` can't be serialized. Use `g_free()` to free.
+         * @since 2.20
          */
         to_string(): string | null;
 
@@ -14739,6 +14937,7 @@ export namespace Gdk {
          * As serialization will avoid using raw icon data when possible, it only
          * makes sense to transfer the {@link GLib.Variant} between processes on the same machine,
          * (as opposed to over the network), and within the same file system namespace.
+         * @since 2.38
          * @virtual
          */
         vfunc_serialize(): GLib.Variant | null;
@@ -14746,6 +14945,7 @@ export namespace Gdk {
         /**
          * Serializes the `icon` into string tokens.
          * This is can be invoked when `g_icon_new_for_string()` is called.
+         * @since 2.20
          * @virtual
          */
         vfunc_to_tokens(): [boolean, string[], number];
@@ -14995,6 +15195,7 @@ export namespace Gdk {
          * It is possible to call this function multiple times to create multiple textures,
          * possibly with changing properties in between.
          * @returns a newly built {@link Gdk.Texture}
+         * @since 4.16
          */
         build(): Texture;
 
@@ -15002,18 +15203,21 @@ export namespace Gdk {
          * Gets the bytes previously set via `gdk_memory_texture_builder_set_bytes()`
          * or `null` if none was set.
          * @returns The bytes
+         * @since 4.16
          */
         get_bytes(): GLib.Bytes | null;
 
         /**
          * Gets the colorstate previously set via `gdk_memory_texture_builder_set_color_state()`.
          * @returns The colorstate
+         * @since 4.16
          */
         get_color_state(): ColorState;
 
         /**
          * Gets the format previously set via `gdk_memory_texture_builder_set_format()`.
          * @returns The format
+         * @since 4.16
          */
         get_format(): MemoryFormat;
 
@@ -15021,6 +15225,7 @@ export namespace Gdk {
          * Gets the height previously set via `gdk_memory_texture_builder_set_height()`
          * or 0 if the height wasn't set.
          * @returns The height
+         * @since 4.16
          */
         get_height(): number;
 
@@ -15028,12 +15233,14 @@ export namespace Gdk {
          * Gets the offset previously set via `gdk_memory_texture_builder_set_offset()`.
          * @param plane a plane
          * @returns The offset associated to a `plane`
+         * @since 4.20
          */
         get_offset(plane: number): number;
 
         /**
          * Gets the stride previously set via `gdk_memory_texture_builder_set_stride()`.
          * @returns the stride
+         * @since 4.16
          */
         get_stride(): number;
 
@@ -15041,6 +15248,7 @@ export namespace Gdk {
          * Gets the stride previously set via `gdk_memory_texture_builder_set_stride_for_plane()`.
          * @param plane a plane
          * @returns The stride associated to a `plane`
+         * @since 4.20
          */
         get_stride_for_plane(plane: number): number;
 
@@ -15048,6 +15256,7 @@ export namespace Gdk {
          * Gets the region previously set via `gdk_memory_texture_builder_set_update_region()`
          * or `null` if none was set.
          * @returns The update region
+         * @since 4.16
          */
         get_update_region(): cairo.Region | null;
 
@@ -15055,6 +15264,7 @@ export namespace Gdk {
          * Gets the texture previously set via `gdk_memory_texture_builder_set_update_texture()`
          * or `null` if none was set.
          * @returns The update texture
+         * @since 4.16
          */
         get_update_texture(): Texture | null;
 
@@ -15062,6 +15272,7 @@ export namespace Gdk {
          * Gets the width previously set via `gdk_memory_texture_builder_set_width()`
          * or 0 if the width wasn't set.
          * @returns The width
+         * @since 4.16
          */
         get_width(): number;
 
@@ -15070,6 +15281,7 @@ export namespace Gdk {
          * 
          * The bytes must be set before calling {@link Gdk.MemoryTextureBuilder.build}.
          * @param bytes The bytes the texture shows or `null` to unset
+         * @since 4.16
          */
         set_bytes(bytes: GLib.Bytes | Uint8Array | null): void;
 
@@ -15079,6 +15291,7 @@ export namespace Gdk {
          * By default, the sRGB colorstate is used. If you don't know
          * what colorstates are, this is probably the right thing.
          * @param color_state The colorstate describing the data
+         * @since 4.16
          */
         set_color_state(color_state: ColorState): void;
 
@@ -15087,6 +15300,7 @@ export namespace Gdk {
          * 
          * The default is `GDK_MEMORY_R8G8B8A8_PREMULTIPLIED`.
          * @param format The texture's format
+         * @since 4.16
          */
         set_format(format: MemoryFormat): void;
 
@@ -15096,6 +15310,7 @@ export namespace Gdk {
          * The height must be set before calling {@link Gdk.MemoryTextureBuilder.build}
          * and conform to size requirements of the provided format.
          * @param height The texture's height or 0 to unset
+         * @since 4.16
          */
         set_height(height: number): void;
 
@@ -15103,6 +15318,7 @@ export namespace Gdk {
          * Sets the offset of the texture for `plane`.
          * @param plane a plane
          * @param offset the texture's offset for `plane`
+         * @since 4.20
          */
         set_offset(plane: number, offset: bigint | number): void;
 
@@ -15111,6 +15327,7 @@ export namespace Gdk {
          * 
          * The rowstride must be set before calling {@link Gdk.MemoryTextureBuilder.build}.
          * @param stride the stride or 0 to unset
+         * @since 4.16
          */
         set_stride(stride: bigint | number): void;
 
@@ -15118,6 +15335,7 @@ export namespace Gdk {
          * Sets the stride of the texture for `plane`.
          * @param plane a plane
          * @param stride the texture's stride for `plane`
+         * @since 4.20
          */
         set_stride_for_plane(plane: number, stride: bigint | number): void;
 
@@ -15134,6 +15352,7 @@ export namespace Gdk {
          * 
          * An example would be a screen recording where only the mouse pointer moves.
          * @param region the region to update
+         * @since 4.16
          */
         set_update_region(region: cairo.Region | null): void;
 
@@ -15142,6 +15361,7 @@ export namespace Gdk {
          * 
          * See {@link Gdk.MemoryTextureBuilder.set_update_region} for an explanation.
          * @param texture the texture to update
+         * @since 4.16
          */
         set_update_texture(texture: Texture | null): void;
 
@@ -15151,6 +15371,7 @@ export namespace Gdk {
          * The width must be set before calling {@link Gdk.MemoryTextureBuilder.build}
          * and conform to size requirements of the provided format.
          * @param width The texture's width or 0 to unset
+         * @since 4.16
          */
         set_width(width: number): void;
     }
@@ -15391,6 +15612,7 @@ export namespace Gdk {
          * 
          * This can be used to identify a monitor in the UI.
          * @returns the monitor description
+         * @since 4.10
          */
         get_description(): string | null;
 
@@ -15404,8 +15626,8 @@ export namespace Gdk {
          * Retrieves the size and position of the monitor within the
          * display coordinate space.
          * 
-         * The returned geometry is in  &#x201D;application pixels&#x201D;, not in
-         * &#x201D;device pixels&#x201D; (see {@link Gdk.Monitor.get_scale}).
+         * The returned geometry is in  ”application pixels”, not in
+         * ”device pixels” (see {@link Gdk.Monitor.get_scale}).
          */
         get_geometry(): Rectangle;
 
@@ -15447,9 +15669,10 @@ export namespace Gdk {
          * to device pixels.
          * 
          * This can be used if you want to create pixel based data for a
-         * particular monitor, but most of the time you&#x2019;re drawing to a surface
+         * particular monitor, but most of the time you’re drawing to a surface
          * where it is better to use {@link Gdk.Surface.get_scale} instead.
          * @returns the scale
+         * @since 4.14
          */
         get_scale(): number;
 
@@ -15461,7 +15684,7 @@ export namespace Gdk {
          * it can be a higher value (often 2).
          * 
          * This can be used if you want to create pixel based data for a
-         * particular monitor, but most of the time you&#x2019;re drawing to a surface
+         * particular monitor, but most of the time you’re drawing to a surface
          * where it is better to use {@link Gdk.Surface.get_scale_factor} instead.
          * @returns the scale factor
          */
@@ -15649,6 +15872,7 @@ export namespace Gdk {
         /**
          * Extracts the scroll direction relative to the physical motion.
          * @returns the relative scroll direction.
+         * @since 4.20
          */
         get_relative_direction(): ScrollRelativeDirection;
 
@@ -15658,6 +15882,7 @@ export namespace Gdk {
          * The unit will always be {@link Gdk.ScrollUnit.WHEEL} if the scroll direction is not
          * {@link Gdk.ScrollDirection.SMOOTH}.
          * @returns the scroll unit.
+         * @since 4.8
          */
         get_unit(): ScrollUnit;
 
@@ -15865,8 +16090,8 @@ export namespace Gdk {
              * Emitted when the size of `surface` is changed, or when relayout should
              * be performed.
              * 
-             * Surface size is reported in &#x201D;application pixels&#x201D;, not
-             * &#x201D;device pixels&#x201D; (see `gdk_surface_get_scale_factor()`).
+             * Surface size is reported in ”application pixels”, not
+             * ”device pixels” (see `gdk_surface_get_scale_factor()`).
              * @signal
              * @run-first
              */
@@ -15911,7 +16136,7 @@ export namespace Gdk {
     /**
      * Represents a rectangular region on the screen.
      * 
-     * It&#x2019;s a low-level object, used to implement high-level objects
+     * It’s a low-level object, used to implement high-level objects
      * such as [GtkWindow](../gtk4/class.Window.html).
      * 
      * The surfaces you see in practice are either {@link Gdk.Toplevel} or
@@ -16040,6 +16265,7 @@ export namespace Gdk {
         /**
          * Creates a new {@link Gdk.CairoContext} for rendering on `surface`.
          * @returns the newly created {@link Gdk.CairoContext}
+         * @deprecated since 4.18: Drawing content with Cairo should be done via   Cairo rendernodes, not by using the Cairo renderer.
          */
         create_cairo_context(): CairoContext;
 
@@ -16068,18 +16294,20 @@ export namespace Gdk {
          * have transparency, black otherwise.)
          * 
          * This function always returns a valid pointer, but it will return a
-         * pointer to a &#x201C;nil&#x201D; surface if `other` is already in an error state
+         * pointer to a “nil” surface if `other` is already in an error state
          * or any other error occurs.
          * @param content the content for the new surface
          * @param width width of the new surface
          * @param height height of the new surface
          * @returns a pointer to the newly allocated surface. The caller   owns the surface and should call `cairo_surface_destroy()` when done   with it.
+         * @deprecated since 4.12: Create a suitable cairo image surface yourself
          */
         create_similar_surface(content: cairo.Content, width: number, height: number): cairo.Surface;
 
         /**
          * Sets an error and returns `null`.
          * @returns `null`
+         * @deprecated since 4.14: GTK does not expose any Vulkan internals. This   function is a leftover that was accidentally exposed.
          */
         create_vulkan_context(): VulkanContext;
 
@@ -16088,7 +16316,7 @@ export namespace Gdk {
          * decrements `surface`'s reference count.
          * 
          * The window system resources for all children of `surface` are also
-         * destroyed, but the children&#x2019;s reference counts are not decremented.
+         * destroyed, but the children’s reference counts are not decremented.
          * 
          * Note that a surface will not be destroyed automatically when its
          * reference count reaches zero. You must call this function yourself
@@ -16149,8 +16377,8 @@ export namespace Gdk {
         /**
          * Returns the height of the given `surface`.
          * 
-         * Surface size is reported in &#x201D;application pixels&#x201D;, not
-         * &#x201D;device pixels&#x201D; (see {@link Gdk.Surface.get_scale_factor}).
+         * Surface size is reported in ”application pixels”, not
+         * ”device pixels” (see {@link Gdk.Surface.get_scale_factor}).
          * @returns The height of `surface`
          */
         get_height(): number;
@@ -16177,6 +16405,7 @@ export namespace Gdk {
          * 
          * The scale may change during the lifetime of the surface.
          * @returns the scale
+         * @since 4.12
          */
         get_scale(): number;
 
@@ -16199,8 +16428,8 @@ export namespace Gdk {
         /**
          * Returns the width of the given `surface`.
          * 
-         * Surface size is reported in &#x201D;application pixels&#x201D;, not
-         * &#x201D;device pixels&#x201D; (see {@link Gdk.Surface.get_scale_factor}).
+         * Surface size is reported in ”application pixels”, not
+         * ”device pixels” (see {@link Gdk.Surface.get_scale_factor}).
          * @returns The width of `surface`
          */
         get_width(): number;
@@ -16210,7 +16439,7 @@ export namespace Gdk {
          * 
          * For toplevel surfaces, withdraws them, so they will no longer be
          * known to the window manager; for all surfaces, unmaps them, so
-         * they won&#x2019;t be displayed. Normally done automatically as
+         * they won’t be displayed. Normally done automatically as
          * part of [gtk_widget_hide()](../gtk4/method.Widget.hide.html).
          */
         hide(): void;
@@ -16274,7 +16503,7 @@ export namespace Gdk {
          * An input region is typically used with RGBA surfaces. The alpha
          * channel of the surface defines which pixels are invisible and
          * allows for nicely antialiased borders, and the input region
-         * controls where the surface is &#x201C;clickable&#x201D;.
+         * controls where the surface is “clickable”.
          * 
          * Use {@link Gdk.Display.supports_input_shapes} to find out if
          * a particular backend supports input regions.
@@ -16299,6 +16528,7 @@ export namespace Gdk {
          * background is not opaque, please update this property in your
          * [GtkWidgetClass.css_changed](../gtk4/vfunc.Widget.css_changed.html) handler.
          * @param region a region, or `null` to make the entire   surface opaque
+         * @deprecated since 4.16: GDK can figure out the opaque parts of a window itself   by inspecting the contents that are drawn.
          */
         set_opaque_region(region: cairo.Region | null): void;
 
@@ -16463,6 +16693,7 @@ export namespace Gdk {
         /**
          * Returns the color state associated with the texture.
          * @returns the color state of the {@link Gdk.Texture}
+         * @since 4.16
          */
         get_color_state(): ColorState;
 
@@ -16477,6 +16708,7 @@ export namespace Gdk {
          * of the texture and is useful to determine the best format for
          * downloading the texture.
          * @returns the preferred format for the texture's data
+         * @since 4.10
          */
         get_format(): MemoryFormat;
 
@@ -16521,6 +16753,7 @@ export namespace Gdk {
          * might also want to consider {@link Gdk.Texture.save_to_tiff_bytes}
          * instead.
          * @returns a newly allocated {@link GLib.Bytes} containing PNG data
+         * @since 4.6
          */
         save_to_png_bytes(): GLib.Bytes;
 
@@ -16530,6 +16763,7 @@ export namespace Gdk {
          * GTK will attempt to store data without loss.
          * @param filename the filename to store to
          * @returns `true` if saving succeeded, `false` on failure.
+         * @since 4.6
          */
         save_to_tiff(filename: string): boolean;
 
@@ -16547,6 +16781,7 @@ export namespace Gdk {
          * smaller size and a more portable format, you might want to
          * use {@link Gdk.Texture.save_to_png_bytes}.
          * @returns a newly allocated {@link GLib.Bytes} containing TIFF data
+         * @since 4.6
          */
         save_to_tiff_bytes(): GLib.Bytes;
 
@@ -16787,6 +17022,7 @@ export namespace Gdk {
          * makes sense to transfer the {@link GLib.Variant} between processes on the same machine,
          * (as opposed to over the network), and within the same file system namespace.
          * @returns a {@link GLib.Variant}, or `null` when serialization fails. The {@link GLib.Variant} will not be floating.
+         * @since 2.38
          */
         serialize(): GLib.Variant | null;
 
@@ -16808,6 +17044,7 @@ export namespace Gdk {
          * - If `icon` is a {@link Gio.ThemedIcon} with exactly one name and no fallbacks,
          *   the encoding is simply the name (such as `network-server`).
          * @returns An allocated NUL-terminated UTF8 string or `null` if `icon` can't be serialized. Use `g_free()` to free.
+         * @since 2.20
          */
         to_string(): string | null;
 
@@ -16830,6 +17067,7 @@ export namespace Gdk {
          * As serialization will avoid using raw icon data when possible, it only
          * makes sense to transfer the {@link GLib.Variant} between processes on the same machine,
          * (as opposed to over the network), and within the same file system namespace.
+         * @since 2.38
          * @virtual
          */
         vfunc_serialize(): GLib.Variant | null;
@@ -16837,6 +17075,7 @@ export namespace Gdk {
         /**
          * Serializes the `icon` into string tokens.
          * This is can be invoked when `g_icon_new_for_string()` is called.
+         * @since 2.20
          * @virtual
          */
         vfunc_to_tokens(): [boolean, string[], number];
@@ -17081,11 +17320,26 @@ export namespace Gdk {
     }
 
 
+    /**
+     * @gir-type Alias
+     */
+    type AppLaunchContextClass = typeof AppLaunchContext;
+
+    /**
+     * @gir-type Alias
+     */
+    type CairoContextClass = typeof CairoContext;
+
     /**
      * @gir-type Alias
      */
     type CicpParamsClass = typeof CicpParams;
 
+    /**
+     * @gir-type Alias
+     */
+    type ClipboardClass = typeof Clipboard;
+
     /**
      * Provides information to interpret colors and pixels in a variety of ways.
      * 
@@ -17107,6 +17361,7 @@ export namespace Gdk {
          * Returns the color state object representing the oklab color space.
          * 
          * This is a perceptually uniform color state.
+         * @since 4.18
          */
         static get_oklab(): ColorState;
 
@@ -17115,6 +17370,7 @@ export namespace Gdk {
          * 
          * This is the polar variant of oklab, in which the hue is encoded as
          * a polar coordinate.
+         * @since 4.18
          */
         static get_oklch(): ColorState;
 
@@ -17128,6 +17384,7 @@ export namespace Gdk {
          * 
          * See e.g. [the CSS HDR Module](https://drafts.csswg.org/css-color-hdr/#valdef-color-rec2100-linear)
          * for details about this colorstate.
+         * @since 4.16
          */
         static get_rec2100_linear(): ColorState;
 
@@ -17141,6 +17398,7 @@ export namespace Gdk {
          * 
          * See e.g. [the CSS HDR Module](https://drafts.csswg.org/css-color-hdr/#valdef-color-rec2100-pq)
          * for details about this colorstate.
+         * @since 4.16
          */
         static get_rec2100_pq(): ColorState;
 
@@ -17154,6 +17412,7 @@ export namespace Gdk {
          * 
          * See e.g. [the CSS Color Module](https://www.w3.org/TR/css-color-4/#predefined-sRGB)
          * for details about this colorstate.
+         * @since 4.16
          */
         static get_srgb(): ColorState;
 
@@ -17166,6 +17425,7 @@ export namespace Gdk {
          * 
          * See e.g. [the CSS Color Module](https://www.w3.org/TR/css-color-4/#predefined-sRGB-linear)
          * for details about this colorstate.
+         * @since 4.16
          */
         static get_srgb_linear(): ColorState;
 
@@ -17177,6 +17437,7 @@ export namespace Gdk {
          * represented with Cicp parameters. If that is the case,
          * this function returns `NULL`.
          * @returns A new {@link Gdk.CicpParams}
+         * @since 4.16
          */
         create_cicp_params(): CicpParams | null;
 
@@ -17188,6 +17449,7 @@ export namespace Gdk {
          * color states will never compare equal.
          * @param other another `GdkColorStatee`
          * @returns `true` if the two color states compare equal
+         * @since 4.16
          */
         equal(other: ColorState): boolean;
 
@@ -17198,12 +17460,14 @@ export namespace Gdk {
          * even though they may not be equal in the sense of {@link Gdk.ColorState.equal}.
          * @param other another `GdkColorStatee`
          * @returns `true` if the two color states are equivalent
+         * @since 4.20
          */
         equivalent(other: ColorState): boolean;
 
         /**
          * Increase the reference count of `self`.
          * @returns the object that was passed in
+         * @since 4.16
          */
         ref(): ColorState;
 
@@ -17212,11 +17476,17 @@ export namespace Gdk {
          * 
          * Unless `self` is static, it will be freed
          * when the reference count reaches zero.
+         * @since 4.16
          */
         unref(): void;
     }
 
 
+    /**
+     * @gir-type Alias
+     */
+    type ContentDeserializerClass = typeof ContentDeserializer;
+
     /**
      * Used to advertise and negotiate the format of content.
      * 
@@ -17272,6 +17542,7 @@ export namespace Gdk {
          * If `string` does not describe valid content formats, `null`
          * is returned.
          * @param string the string to parse
+         * @since 4.4
          */
         static parse(string: string): ContentFormats | null;
 
@@ -17311,6 +17582,7 @@ export namespace Gdk {
         /**
          * Returns whether the content formats contain any formats.
          * @returns true if `formats` contains no mime types and no GTypes
+         * @since 4.18
          */
         is_empty(): boolean;
 
@@ -17477,11 +17749,49 @@ export namespace Gdk {
      */
     type ContentProviderClass = typeof ContentProvider;
 
+    /**
+     * @gir-type Alias
+     */
+    type ContentSerializerClass = typeof ContentSerializer;
+
+    /**
+     * @gir-type Alias
+     */
+    type CursorClass = typeof Cursor;
+
+    /**
+     * @gir-type Alias
+     */
+    type DeviceClass = typeof Device;
+
+    /**
+     * @gir-type Struct
+     */
+    abstract class DevicePadClass {
+        static $gtype: GObject.GType<DevicePadClass>;
+    }
+
+
     /**
      * @gir-type Alias
      */
     type DevicePadInterface = typeof DevicePad;
 
+    /**
+     * @gir-type Alias
+     */
+    type DeviceToolClass = typeof DeviceTool;
+
+    /**
+     * @gir-type Alias
+     */
+    type DisplayClass = typeof Display;
+
+    /**
+     * @gir-type Alias
+     */
+    type DisplayManagerClass = typeof DisplayManager;
+
     /**
      * Provides information about supported DMA buffer formats.
      * 
@@ -17514,6 +17824,7 @@ export namespace Gdk {
          * @param fourcc a format code
          * @param modifier a format modifier
          * @returns `TRUE` if the format specified by the arguments   is part of `formats`
+         * @since 4.14
          */
         contains(fourcc: number, modifier: bigint | number): boolean;
 
@@ -17522,6 +17833,7 @@ export namespace Gdk {
          * same dmabuf formats, in the same order.
          * @param formats2 another {@link Gdk.DmabufFormats}
          * @returns `TRUE` if `formats1` and `formats2` are equal
+         * @since 4.14
          */
         equal(formats2: DmabufFormats | null): boolean;
 
@@ -17529,6 +17841,7 @@ export namespace Gdk {
          * Gets the fourcc code and modifier for a format
          * that is contained in `formats`.
          * @param idx the index of the format to return
+         * @since 4.14
          */
         get_format(idx: bigint | number): [number, number];
 
@@ -17540,12 +17853,14 @@ export namespace Gdk {
          * platforms, {@link Gdk.DmabufFormats.get_n_formats} will
          * always return zero.
          * @returns the number of formats
+         * @since 4.14
          */
         get_n_formats(): number;
 
         /**
          * Increases the reference count of `formats`.
          * @returns the passed-in object
+         * @since 4.14
          */
         ref(): DmabufFormats;
 
@@ -17554,6 +17869,7 @@ export namespace Gdk {
          * 
          * When the reference count reaches zero,
          * the object is freed.
+         * @since 4.14
          */
         unref(): void;
     }
@@ -17569,6 +17885,11 @@ export namespace Gdk {
      */
     type DmabufTextureClass = typeof DmabufTexture;
 
+    /**
+     * @gir-type Alias
+     */
+    type DragClass = typeof Drag;
+
     /**
      * @gir-type Alias
      */
@@ -17587,11 +17908,22 @@ export namespace Gdk {
          * Sets the size the drag surface prefers to be resized to.
          * @param width the width
          * @param height the height
+         * @since 4.12
          */
         set_size(width: number, height: number): void;
     }
 
 
+    /**
+     * @gir-type Alias
+     */
+    type DrawContextClass = typeof DrawContext;
+
+    /**
+     * @gir-type Alias
+     */
+    type DropClass = typeof Drop;
+
     /**
      * An opaque type representing a sequence of related events.
      * @gir-type Struct
@@ -17622,6 +17954,7 @@ export namespace Gdk {
          * 
          * This function is meant for language bindings.
          * @returns the files inside the list
+         * @since 4.6
          */
         get_files(): Gio.File[];
     }
@@ -17633,21 +17966,13 @@ export namespace Gdk {
     type FrameClockClass = typeof FrameClock;
 
     /**
-     * @gir-type Struct
-     */
-    abstract class FrameClockPrivate {
-        static $gtype: GObject.GType<FrameClockPrivate>;
-    }
-
-
-    /**
-     * Holds timing information for a single frame of the application&#x2019;s displays.
+     * Holds timing information for a single frame of the application’s displays.
      * 
      * To retrieve {@link Gdk.FrameTimings} objects, use {@link Gdk.FrameClock.get_timings}
      * or {@link Gdk.FrameClock.get_current_timings}. The information in
      * {@link Gdk.FrameTimings} is useful for precise synchronization of video with
      * the event or audio streams, and for measuring quality metrics for the
-     * application&#x2019;s display, such as latency and jitter.
+     * application’s display, such as latency and jitter.
      * @gir-type Struct
      */
     abstract class FrameTimings {
@@ -17717,12 +18042,28 @@ export namespace Gdk {
          * Gets the natural interval between presentation times for
          * the display that this frame was displayed on.
          * 
-         * Frame presentation usually happens during the &#x201C;vertical
-         * blanking interval&#x201D;.
+         * Frame presentation usually happens during the “vertical
+         * blanking interval”.
          * @returns the refresh interval of the display, in microseconds,   or 0 if the refresh interval is not available.   See {@link Gdk.FrameTimings.get_complete}.
          */
         get_refresh_interval(): number;
 
+        /**
+         * Gets the result of the frame cycle that recorded these timings.
+         * 
+         * The timing information in a {@link Gdk.FrameTimings} is filled in
+         * incrementally as the frame as drawn and passed off to the
+         * window system for processing and display to the user. The
+         * accessor functions for {@link Gdk.FrameTimings} can return 0 to
+         * indicate an unavailable value for two reasons: either because
+         * the information is not yet available, or because it isn't
+         * available at all. Looking at the result of the timings gives
+         * an explanation for why a value is not available.
+         * @returns The result of the frame these timings have been recorded for.
+         * @since 4.24
+         */
+        get_result(): FrameResult;
+
         /**
          * Increases the reference count of `timings`.
          * @returns `timings`
@@ -17738,6 +18079,11 @@ export namespace Gdk {
     }
 
 
+    /**
+     * @gir-type Alias
+     */
+    type GLContextClass = typeof GLContext;
+
     /**
      * @gir-type Alias
      */
@@ -17880,6 +18226,7 @@ export namespace Gdk {
 
         /**
          * Obtains the shadow widths of this layout.
+         * @since 4.2
          */
         get_shadow_width(): [number, number, number, number];
 
@@ -17936,6 +18283,7 @@ export namespace Gdk {
          * @param right width of the right part of the shadow
          * @param top height of the top part of the shadow
          * @param bottom height of the bottom part of the shadow
+         * @since 4.2
          */
         set_shadow_width(left: number, right: number, top: number, bottom: number): void;
 
@@ -17953,10 +18301,10 @@ export namespace Gdk {
 
 
     /**
-     * Represents a color, in a way that is compatible with cairo&#x2019;s notion of color.
+     * Represents a color, in a way that is compatible with cairo’s notion of color.
      * 
-     * {@link Gdk.RGBA} is a convenient way to pass colors around. It&#x2019;s based on
-     * cairo&#x2019;s way to deal with colors and mirrors its behavior. All values
+     * {@link Gdk.RGBA} is a convenient way to pass colors around. It’s based on
+     * cairo’s way to deal with colors and mirrors its behavior. All values
      * are in the range from 0.0 to 1.0 inclusive. So the color
      * (0.0, 0.0, 0.0, 0.0) represents transparent black and
      * (1.0, 1.0, 1.0, 1.0) is opaque white. Other values will
@@ -18035,22 +18383,22 @@ export namespace Gdk {
          * The string can be either one of:
          * 
          * - A standard name (Taken from the CSS specification).
-         * - A hexadecimal value in the form &#x201C;\#rgb&#x201D;, &#x201C;\#rrggbb&#x201D;,
-         *   &#x201C;\#rrrgggbbb&#x201D; or &#x201D;\#rrrrggggbbbb&#x201D;
-         * - A hexadecimal value in the form &#x201C;\#rgba&#x201D;, &#x201C;\#rrggbbaa&#x201D;,
-         *   or &#x201D;\#rrrrggggbbbbaaaa&#x201D;
-         * - A RGB color in the form &#x201C;rgb(r,g,b)&#x201D; (In this case the color
+         * - A hexadecimal value in the form “\#rgb”, “\#rrggbb”,
+         *   “\#rrrgggbbb” or ”\#rrrrggggbbbb”
+         * - A hexadecimal value in the form “\#rgba”, “\#rrggbbaa”,
+         *   or ”\#rrrrggggbbbbaaaa”
+         * - A RGB color in the form “rgb(r,g,b)” (In this case the color
          *   will have full opacity)
-         * - A RGBA color in the form &#x201C;rgba(r,g,b,a)&#x201D;
-         * - A HSL color in the form &#x201C;hsl(h,s,l)&#x201D;
-         * - A HSLA color in the form &#x201C;hsla(h,s,l,a)&#x201D;
+         * - A RGBA color in the form “rgba(r,g,b,a)”
+         * - A HSL color in the form “hsl(h,s,l)”
+         * - A HSLA color in the form “hsla(h,s,l,a)”
          * 
-         * Where &#x201C;r&#x201D;, &#x201C;g&#x201D;, &#x201C;b&#x201D; and &#x201C;a&#x201D; are respectively the red, green,
-         * blue and alpha color values. In the last two cases, &#x201C;r&#x201D;, &#x201C;g&#x201D;,
-         * and &#x201C;b&#x201D; are either integers in the range 0 to 255 or percentage
+         * Where “r”, “g”, “b” and “a” are respectively the red, green,
+         * blue and alpha color values. In the last two cases, “r”, “g”,
+         * and “b” are either integers in the range 0 to 255 or percentage
          * values in the range 0% to 100%, and a is a floating point value
-         * in the range 0 to 1. The range for &#x201C;h&#x201D; is 0 to 360, and
-         * &#x201C;s&#x201D;, &#x201C;l&#x201D; can be either numbers in the range 0 to 100 or
+         * in the range 0 to 1. The range for “h” is 0 to 360, and
+         * “s”, “l” can be either numbers in the range 0 to 100 or
          * percentages.
          * @param spec the string specifying the color
          * @returns `true` if the parsing succeeded
@@ -18058,23 +18406,26 @@ export namespace Gdk {
         parse(spec: string): boolean;
 
         /**
-         * @param string 
+         * Appends a representation of `rgba` to `string`.
+         * @param string the string to print to
+         * @returns A newly allocated text string
+         * @since 4.22
          */
         print(string: GLib.String): GLib.String;
 
         /**
          * Returns a textual specification of `rgba` in the form
-         * `rgb(r,g,b)` or `rgba(r,g,b,a)`, where &#x201C;r&#x201D;, &#x201C;g&#x201D;, &#x201C;b&#x201D; and
-         * &#x201C;a&#x201D; represent the red, green, blue and alpha values
-         * respectively. &#x201C;r&#x201D;, &#x201C;g&#x201D;, and &#x201C;b&#x201D; are represented as integers
-         * in the range 0 to 255, and &#x201C;a&#x201D; is represented as a floating
+         * `rgb(r,g,b)` or `rgba(r,g,b,a)`, where “r”, “g”, “b” and
+         * “a” represent the red, green, blue and alpha values
+         * respectively. “r”, “g”, and “b” are represented as integers
+         * in the range 0 to 255, and “a” is represented as a floating
          * point value in the range 0 to 1.
          * 
          * These string forms are string forms that are supported by
          * the CSS3 colors module, and can be parsed by {@link Gdk.RGBA.parse}.
          * 
          * Note that this string representation may lose some precision,
-         * since &#x201C;r&#x201D;, &#x201C;g&#x201D; and &#x201C;b&#x201D; are represented as 8-bit integers. If
+         * since “r”, “g” and “b” are represented as 8-bit integers. If
          * this is a concern, you should use a different representation.
          * @returns A newly allocated text string
          */
@@ -18085,7 +18436,7 @@ export namespace Gdk {
     /**
      * Represents a rectangle.
      * 
-     * {@link Gdk.Rectangle} is identical to `cairo_rectangle_t`. Together with Cairo&#x2019;s
+     * {@link Gdk.Rectangle} is identical to `cairo_rectangle_t`. Together with Cairo’s
      * `cairo_region_t` data type, these are the central types for representing
      * sets of pixels.
      * 
@@ -18141,7 +18492,7 @@ export namespace Gdk {
          * Calculates the intersection of two rectangles.
          * 
          * It is allowed for `dest` to be the same as either `src1` or `src2`.
-         * If the rectangles do not intersect, `dest`&#x2019;s width and height is set
+         * If the rectangles do not intersect, `dest`’s width and height is set
          * to 0 and its x and y values are undefined. If you are only interested
          * in whether the rectangles intersect, but not in the intersecting area
          * itself, pass `null` for `dest`.
@@ -18165,6 +18516,11 @@ export namespace Gdk {
     }
 
 
+    /**
+     * @gir-type Alias
+     */
+    type SeatClass = typeof Seat;
+
     /**
      * @gir-type Alias
      */
@@ -18207,6 +18563,7 @@ export namespace Gdk {
          * 
          * This function is meant for language bindings.
          * @returns A copy of the downloader
+         * @since 4.10
          */
         copy(): TextureDownloader;
 
@@ -18222,6 +18579,7 @@ export namespace Gdk {
          * This function cannot be used with a multiplanar format. Use
          * {@link Gdk.TextureDownloader.download_bytes_with_planes} for that purpose.
          * @returns The downloaded pixels
+         * @since 4.10
          */
         download_bytes(): [GLib.Bytes, number];
 
@@ -18232,6 +18590,7 @@ export namespace Gdk {
          * If the format does have less than 4 planes, the remaining offsets and strides will be
          * set to `0`.
          * @returns The downloaded pixels
+         * @since 4.20
          */
         download_bytes_with_planes(): [GLib.Bytes, number[], number[]];
 
@@ -18241,29 +18600,34 @@ export namespace Gdk {
          * This function cannot be used with a multiplanar format.
          * @param data pointer to enough memory to be filled with the   downloaded data of the texture
          * @param stride rowstride in bytes
+         * @since 4.10
          */
         download_into(data: Uint8Array | string, stride: bigint | number): void;
 
         /**
          * Frees the given downloader and all its associated resources.
+         * @since 4.10
          */
         free(): void;
 
         /**
          * Gets the color state that the data will be downloaded in.
          * @returns The color state of the download
+         * @since 4.16
          */
         get_color_state(): ColorState;
 
         /**
          * Gets the format that the data will be downloaded in.
          * @returns The format of the download
+         * @since 4.10
          */
         get_format(): MemoryFormat;
 
         /**
          * Gets the texture that the downloader will download.
          * @returns The texture to download
+         * @since 4.10
          */
         get_texture(): Texture;
 
@@ -18273,6 +18637,7 @@ export namespace Gdk {
          * By default, the sRGB colorstate returned by {@link ColorState.get_srgb}
          * is used.
          * @param color_state the color state to use
+         * @since 4.16
          */
         set_color_state(color_state: ColorState): void;
 
@@ -18281,12 +18646,14 @@ export namespace Gdk {
          * 
          * By default, GDK_MEMORY_DEFAULT is set.
          * @param format the format to use
+         * @since 4.10
          */
         set_format(format: MemoryFormat): void;
 
         /**
          * Changes the texture the downloader will download.
          * @param texture the new texture to download
+         * @since 4.10
          */
         set_texture(texture: Texture): void;
     }
@@ -18481,6 +18848,11 @@ export namespace Gdk {
     }
 
 
+    /**
+     * @gir-type Alias
+     */
+    type VulkanContextClass = typeof VulkanContext;
+
     namespace DevicePad {
 
         // Constructor properties interface
@@ -19185,7 +19557,7 @@ export namespace Gdk {
         /**
          * Begins an interactive resize operation.
          * 
-         * You might use this function to implement a &#x201C;window resize grip.&#x201D;
+         * You might use this function to implement a “window resize grip.”
          * @param edge the edge or corner from which the drag is started
          * @param device the device used for the operation
          * @param button the button being used to drag, or 0 for a keyboard-initiated drag
@@ -19208,6 +19580,7 @@ export namespace Gdk {
         /**
          * The capabilities that are available for this toplevel.
          * @returns the capabilities of the {@link Gdk.Toplevel}.
+         * @since 4.20
          */
         get_capabilities(): ToplevelCapabilities;
 
@@ -19215,6 +19588,7 @@ export namespace Gdk {
          * Returns the gravity that is used when changing the toplevel
          * size programmatically.
          * @returns the gravity
+         * @since 4.20
          */
         get_gravity(): Gravity;
 
@@ -19314,6 +19688,7 @@ export namespace Gdk {
          * Sets the gravity that is used when changing the toplevel
          * size programmatically.
          * @param gravity the new gravity
+         * @since 4.20
          */
         set_gravity(gravity: Gravity): void;
 
@@ -19373,7 +19748,7 @@ export namespace Gdk {
          * on `parent` and keep `surface` above `parent`.
          * 
          * See [gtk_window_set_transient_for()](../gtk4/method.Window.set_transient_for.html)
-         * if you&#x2019;re using [GtkWindow](../gtk4/class.Window.html).
+         * if you’re using [GtkWindow](../gtk4/class.Window.html).
          * @param parent another toplevel {@link Gdk.Surface}
          */
         set_transient_for(parent: Surface): void;
@@ -19401,6 +19776,7 @@ export namespace Gdk {
          * Performs a title bar gesture.
          * @param gesture a {@link Gdk.TitlebarGesture}
          * @returns whether the gesture was performed
+         * @since 4.4
          */
         titlebar_gesture(gesture: TitlebarGesture): boolean;
     }