@girs/gdk-4.0 4.3.0 → 4.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.md +1 -1
  2. package/gdk-4.0.d.ts +175 -0
  3. package/package.json +12 -12
package/README.md CHANGED
@@ -5,7 +5,7 @@
5
5
  ![downloads/week](https://img.shields.io/npm/dw/@girs/gdk-4.0)
6
6
 
7
7
 
8
- GJS TypeScript type definitions for Gdk-4.0 using [ts-for-gir](https://github.com/gjsify/ts-for-gir) v4.3.0.
8
+ GJS TypeScript type definitions for Gdk-4.0 using [ts-for-gir](https://github.com/gjsify/ts-for-gir) v4.4.0.
9
9
 
10
10
  ## Install
11
11
 
package/gdk-4.0.d.ts CHANGED
@@ -8210,6 +8210,7 @@ export namespace Gdk {
8210
8210
  * The returned context is guaranteed to be valid until
8211
8211
  * {@link Gdk.DrawContext.end_frame} is called.
8212
8212
  * @returns a Cairo context to draw on `GdkSurface
8213
+ * @deprecated since 4.18: Drawing content with Cairo should be done via Cairo rendernodes, not by using renderers.
8213
8214
  */
8214
8215
  cairo_create(): cairo.Context | null;
8215
8216
  }
@@ -8414,6 +8415,7 @@ export namespace Gdk {
8414
8415
  * supported by GTK. In that case, `NULL` is returned, and `error` is set
8415
8416
  * with an error message that can be presented to the user.
8416
8417
  * @returns A newly allocated {@link Gdk.ColorState}
8418
+ * @since 4.16
8417
8419
  */
8418
8420
  build_color_state(): ColorState;
8419
8421
 
@@ -8421,30 +8423,35 @@ export namespace Gdk {
8421
8423
  * Returns the value of the color-primaries property
8422
8424
  * of `self`.
8423
8425
  * @returns the color-primaries value
8426
+ * @since 4.16
8424
8427
  */
8425
8428
  get_color_primaries(): number;
8426
8429
 
8427
8430
  /**
8428
8431
  * Gets the matrix-coefficients property of `self`.
8429
8432
  * @returns the matrix-coefficients value
8433
+ * @since 4.16
8430
8434
  */
8431
8435
  get_matrix_coefficients(): number;
8432
8436
 
8433
8437
  /**
8434
8438
  * Gets the range property of `self`.
8435
8439
  * @returns the range value
8440
+ * @since 4.16
8436
8441
  */
8437
8442
  get_range(): CicpRange;
8438
8443
 
8439
8444
  /**
8440
8445
  * Gets the transfer-function property of `self`.
8441
8446
  * @returns the transfer-function value
8447
+ * @since 4.16
8442
8448
  */
8443
8449
  get_transfer_function(): number;
8444
8450
 
8445
8451
  /**
8446
8452
  * Sets the color-primaries property of `self`.
8447
8453
  * @param color_primaries the new color primaries value
8454
+ * @since 4.16
8448
8455
  */
8449
8456
  set_color_primaries(color_primaries: number): void;
8450
8457
 
@@ -8452,18 +8459,21 @@ export namespace Gdk {
8452
8459
  * `self` a {@link Gdk.CicpParams}
8453
8460
  * Sets the matrix-coefficients property of `self`.
8454
8461
  * @param matrix_coefficients the new matrix-coefficients value
8462
+ * @since 4.16
8455
8463
  */
8456
8464
  set_matrix_coefficients(matrix_coefficients: number): void;
8457
8465
 
8458
8466
  /**
8459
8467
  * Sets the range property of `self`
8460
8468
  * @param range the range value
8469
+ * @since 4.16
8461
8470
  */
8462
8471
  set_range(range: CicpRange): void;
8463
8472
 
8464
8473
  /**
8465
8474
  * Sets the transfer-function property of `self`.
8466
8475
  * @param transfer_function the new transfer-function value
8476
+ * @since 4.16
8467
8477
  */
8468
8478
  set_transfer_function(transfer_function: number): void;
8469
8479
  }
@@ -9017,6 +9027,7 @@ export namespace Gdk {
9017
9027
  * pointer indicating the function `res` was created by).
9018
9028
  * @param source_tag an application-defined tag
9019
9029
  * @returns `TRUE` if `res` has the indicated `source_tag`, `FALSE` if not.
9030
+ * @since 2.34
9020
9031
  */
9021
9032
  is_tagged(source_tag: null): boolean;
9022
9033
 
@@ -9032,6 +9043,7 @@ export namespace Gdk {
9032
9043
  * set by virtual methods should also be extracted by virtual methods,
9033
9044
  * to enable subclasses to chain up correctly.
9034
9045
  * @returns `TRUE` if `error` is has been filled in with an error from `res`, `FALSE` if not.
9046
+ * @since 2.34
9035
9047
  */
9036
9048
  legacy_propagate_error(): boolean;
9037
9049
 
@@ -9051,6 +9063,7 @@ export namespace Gdk {
9051
9063
  * Checks if `res` has the given `source_tag` (generally a function
9052
9064
  * pointer indicating the function `res` was created by).
9053
9065
  * @param source_tag an application-defined tag
9066
+ * @since 2.34
9054
9067
  * @virtual
9055
9068
  */
9056
9069
  vfunc_is_tagged(source_tag: null): boolean;
@@ -9455,6 +9468,7 @@ export namespace Gdk {
9455
9468
  * pointer indicating the function `res` was created by).
9456
9469
  * @param source_tag an application-defined tag
9457
9470
  * @returns `TRUE` if `res` has the indicated `source_tag`, `FALSE` if not.
9471
+ * @since 2.34
9458
9472
  */
9459
9473
  is_tagged(source_tag: null): boolean;
9460
9474
 
@@ -9470,6 +9484,7 @@ export namespace Gdk {
9470
9484
  * set by virtual methods should also be extracted by virtual methods,
9471
9485
  * to enable subclasses to chain up correctly.
9472
9486
  * @returns `TRUE` if `error` is has been filled in with an error from `res`, `FALSE` if not.
9487
+ * @since 2.34
9473
9488
  */
9474
9489
  legacy_propagate_error(): boolean;
9475
9490
 
@@ -9489,6 +9504,7 @@ export namespace Gdk {
9489
9504
  * Checks if `res` has the given `source_tag` (generally a function
9490
9505
  * pointer indicating the function `res` was created by).
9491
9506
  * @param source_tag an application-defined tag
9507
+ * @since 2.34
9492
9508
  * @virtual
9493
9509
  */
9494
9510
  vfunc_is_tagged(source_tag: null): boolean;
@@ -10201,6 +10217,7 @@ export namespace Gdk {
10201
10217
  *
10202
10218
  * This is only relevant for keyboard devices.
10203
10219
  * @returns The layout index of the active layout or -1.
10220
+ * @since 4.18
10204
10221
  */
10205
10222
  get_active_layout_index(): number;
10206
10223
 
@@ -10249,6 +10266,7 @@ export namespace Gdk {
10249
10266
  *
10250
10267
  * This is only relevant for keyboard devices.
10251
10268
  * @returns `null`-terminated array of strings of layouts,
10269
+ * @since 4.18
10252
10270
  */
10253
10271
  get_layout_names(): string[] | null;
10254
10272
 
@@ -10327,6 +10345,7 @@ export namespace Gdk {
10327
10345
  * events for a device that are not received from the OS, and will not
10328
10346
  * update the timestamp).
10329
10347
  * @returns the timestamp of the last activity for this device
10348
+ * @since 4.2
10330
10349
  */
10331
10350
  get_timestamp(): number;
10332
10351
 
@@ -10702,6 +10721,7 @@ export namespace Gdk {
10702
10721
  * Before using the returned {@link Gdk.GLContext}, you will need to
10703
10722
  * call {@link Gdk.GLContext.make_current} or {@link Gdk.GLContext.realize}.
10704
10723
  * @returns the newly created {@link Gdk.GLContext}
10724
+ * @since 4.6
10705
10725
  */
10706
10726
  create_gl_context(): GLContext;
10707
10727
 
@@ -10761,6 +10781,7 @@ export namespace Gdk {
10761
10781
  *
10762
10782
  * This function is threadsafe. It can be called from any thread.
10763
10783
  * @returns a {@link Gdk.DmabufFormats} object
10784
+ * @since 4.14
10764
10785
  */
10765
10786
  get_dmabuf_formats(): DmabufFormats;
10766
10787
 
@@ -10812,6 +10833,7 @@ export namespace Gdk {
10812
10833
  * Gets the startup notification ID for a Wayland display, or `null`
10813
10834
  * if no ID has been defined.
10814
10835
  * @returns the startup notification ID for `display`
10836
+ * @deprecated since 4.10
10815
10837
  */
10816
10838
  get_startup_notification_id(): string | null;
10817
10839
 
@@ -10903,6 +10925,7 @@ export namespace Gdk {
10903
10925
  * [gtk_window_set_auto_startup_notification()](../gtk4/method.Window.set_auto_startup_notification.html)
10904
10926
  * is called to disable that feature.
10905
10927
  * @param startup_id a startup-notification identifier, for which notification process should be completed
10928
+ * @deprecated since 4.10: Using {@link Gdk.Toplevel.set_startup_id} is sufficient
10906
10929
  */
10907
10930
  notify_startup_complete(startup_id: string): void;
10908
10931
 
@@ -10922,12 +10945,14 @@ export namespace Gdk {
10922
10945
  * as needed. But you can use it as a check when setting up code that
10923
10946
  * might make use of OpenGL.
10924
10947
  * @returns `true` if the display supports OpenGL
10948
+ * @since 4.4
10925
10949
  */
10926
10950
  prepare_gl(): boolean;
10927
10951
 
10928
10952
  /**
10929
10953
  * Adds the given event to the event queue for `display`.
10930
10954
  * @param event a {@link Gdk.Event}
10955
+ * @deprecated since 4.10: This function is only useful in very special situations and should not be used by applications.
10931
10956
  */
10932
10957
  put_event(event: Event): void;
10933
10958
 
@@ -10948,6 +10973,7 @@ export namespace Gdk {
10948
10973
  * If `true` is returned the application decides if it wants to draw shadows.
10949
10974
  * If `false` is returned, the compositor decides if it wants to draw shadows.
10950
10975
  * @returns `true` if surfaces can draw shadows or `false` if the display does not support this functionality.
10976
+ * @since 4.14
10951
10977
  */
10952
10978
  supports_shadow_width(): boolean;
10953
10979
 
@@ -11433,6 +11459,7 @@ export namespace Gdk {
11433
11459
  * makes sense to transfer the {@link GLib.Variant} between processes on the same machine,
11434
11460
  * (as opposed to over the network), and within the same file system namespace.
11435
11461
  * @returns a {@link GLib.Variant}, or `null` when serialization fails. The {@link GLib.Variant} will not be floating.
11462
+ * @since 2.38
11436
11463
  */
11437
11464
  serialize(): GLib.Variant | null;
11438
11465
 
@@ -11454,6 +11481,7 @@ export namespace Gdk {
11454
11481
  * - If `icon` is a {@link Gio.ThemedIcon} with exactly one name and no fallbacks,
11455
11482
  * the encoding is simply the name (such as `network-server`).
11456
11483
  * @returns An allocated NUL-terminated UTF8 string or `null` if `icon` can't be serialized. Use `g_free()` to free.
11484
+ * @since 2.20
11457
11485
  */
11458
11486
  to_string(): string | null;
11459
11487
 
@@ -11476,6 +11504,7 @@ export namespace Gdk {
11476
11504
  * As serialization will avoid using raw icon data when possible, it only
11477
11505
  * makes sense to transfer the {@link GLib.Variant} between processes on the same machine,
11478
11506
  * (as opposed to over the network), and within the same file system namespace.
11507
+ * @since 2.38
11479
11508
  * @virtual
11480
11509
  */
11481
11510
  vfunc_serialize(): GLib.Variant | null;
@@ -11483,6 +11512,7 @@ export namespace Gdk {
11483
11512
  /**
11484
11513
  * Serializes the `icon` into string tokens.
11485
11514
  * This is can be invoked when `g_icon_new_for_string()` is called.
11515
+ * @since 2.20
11486
11516
  * @virtual
11487
11517
  */
11488
11518
  vfunc_to_tokens(): [boolean, string[], number];
@@ -11823,12 +11853,14 @@ export namespace Gdk {
11823
11853
  * possibly with changing properties in between.
11824
11854
  * @param data user data to pass to the destroy function
11825
11855
  * @returns a newly built {@link Gdk.Texture} or `NULL` if the format is not supported
11856
+ * @since 4.14
11826
11857
  */
11827
11858
  build(data: null): Texture | null;
11828
11859
 
11829
11860
  /**
11830
11861
  * Gets the color state previously set via `gdk_dmabuf_texture_builder_set_color_state()`.
11831
11862
  * @returns the color state
11863
+ * @since 4.16
11832
11864
  */
11833
11865
  get_color_state(): ColorState | null;
11834
11866
 
@@ -11836,6 +11868,7 @@ export namespace Gdk {
11836
11868
  * Returns the display that this texture builder is
11837
11869
  * associated with.
11838
11870
  * @returns the display
11871
+ * @since 4.14
11839
11872
  */
11840
11873
  get_display(): Display;
11841
11874
 
@@ -11843,6 +11876,7 @@ export namespace Gdk {
11843
11876
  * Gets the file descriptor for a plane or -1 if none.
11844
11877
  * @param plane the plane to get the fd for
11845
11878
  * @returns the file descriptor
11879
+ * @since 4.14
11846
11880
  */
11847
11881
  get_fd(plane: number): number;
11848
11882
 
@@ -11852,6 +11886,7 @@ export namespace Gdk {
11852
11886
  *
11853
11887
  * The format is specified as a fourcc code.
11854
11888
  * @returns The format
11889
+ * @since 4.14
11855
11890
  */
11856
11891
  get_fourcc(): number;
11857
11892
 
@@ -11859,18 +11894,21 @@ export namespace Gdk {
11859
11894
  * Gets the height previously set via `gdk_dmabuf_texture_builder_set_height()` or
11860
11895
  * 0 if the height wasn't set.
11861
11896
  * @returns The height
11897
+ * @since 4.14
11862
11898
  */
11863
11899
  get_height(): number;
11864
11900
 
11865
11901
  /**
11866
11902
  * Gets the modifier value.
11867
11903
  * @returns the modifier
11904
+ * @since 4.14
11868
11905
  */
11869
11906
  get_modifier(): number;
11870
11907
 
11871
11908
  /**
11872
11909
  * Gets the number of planes.
11873
11910
  * @returns The number of planes
11911
+ * @since 4.14
11874
11912
  */
11875
11913
  get_n_planes(): number;
11876
11914
 
@@ -11878,12 +11916,14 @@ export namespace Gdk {
11878
11916
  * Gets the offset value for a plane.
11879
11917
  * @param plane the plane to get the offset for
11880
11918
  * @returns the offset
11919
+ * @since 4.14
11881
11920
  */
11882
11921
  get_offset(plane: number): number;
11883
11922
 
11884
11923
  /**
11885
11924
  * Whether the data is premultiplied.
11886
11925
  * @returns whether the data is premultiplied
11926
+ * @since 4.14
11887
11927
  */
11888
11928
  get_premultiplied(): boolean;
11889
11929
 
@@ -11891,6 +11931,7 @@ export namespace Gdk {
11891
11931
  * Gets the stride value for a plane.
11892
11932
  * @param plane the plane to get the stride for
11893
11933
  * @returns the stride
11934
+ * @since 4.14
11894
11935
  */
11895
11936
  get_stride(plane: number): number;
11896
11937
 
@@ -11898,6 +11939,7 @@ export namespace Gdk {
11898
11939
  * Gets the region previously set via `gdk_dmabuf_texture_builder_set_update_region()` or
11899
11940
  * `null` if none was set.
11900
11941
  * @returns The region
11942
+ * @since 4.14
11901
11943
  */
11902
11944
  get_update_region(): cairo.Region | null;
11903
11945
 
@@ -11905,6 +11947,7 @@ export namespace Gdk {
11905
11947
  * Gets the texture previously set via `gdk_dmabuf_texture_builder_set_update_texture()` or
11906
11948
  * `null` if none was set.
11907
11949
  * @returns The texture
11950
+ * @since 4.14
11908
11951
  */
11909
11952
  get_update_texture(): Texture | null;
11910
11953
 
@@ -11912,6 +11955,7 @@ export namespace Gdk {
11912
11955
  * Gets the width previously set via `gdk_dmabuf_texture_builder_set_width()` or
11913
11956
  * 0 if the width wasn't set.
11914
11957
  * @returns The width
11958
+ * @since 4.14
11915
11959
  */
11916
11960
  get_width(): number;
11917
11961
 
@@ -11922,6 +11966,7 @@ export namespace Gdk {
11922
11966
  * correct colorstate based on the format.
11923
11967
  * If you don't know what colorstates are, this is probably the right thing.
11924
11968
  * @param color_state a {@link Gdk.ColorState} or `NULL` to unset the colorstate.
11969
+ * @since 4.16
11925
11970
  */
11926
11971
  set_color_state(color_state: ColorState | null): void;
11927
11972
 
@@ -11932,6 +11977,7 @@ export namespace Gdk {
11932
11977
  * The display is used to determine the supported
11933
11978
  * dma-buf formats.
11934
11979
  * @param display the display
11980
+ * @since 4.14
11935
11981
  */
11936
11982
  set_display(display: Display): void;
11937
11983
 
@@ -11939,6 +11985,7 @@ export namespace Gdk {
11939
11985
  * Sets the file descriptor for a plane or to -1 to unset it.
11940
11986
  * @param plane the plane to set the fd for
11941
11987
  * @param fd the file descriptor
11988
+ * @since 4.14
11942
11989
  */
11943
11990
  set_fd(plane: number, fd: number): void;
11944
11991
 
@@ -11949,6 +11996,7 @@ export namespace Gdk {
11949
11996
  *
11950
11997
  * The format must be set before calling {@link Gdk.DmabufTextureBuilder.build}.
11951
11998
  * @param fourcc the texture's format or 0 to unset
11999
+ * @since 4.14
11952
12000
  */
11953
12001
  set_fourcc(fourcc: number): void;
11954
12002
 
@@ -11957,18 +12005,21 @@ export namespace Gdk {
11957
12005
  *
11958
12006
  * The height must be set before calling {@link Gdk.DmabufTextureBuilder.build}.
11959
12007
  * @param height the texture's height or 0 to unset
12008
+ * @since 4.14
11960
12009
  */
11961
12010
  set_height(height: number): void;
11962
12011
 
11963
12012
  /**
11964
12013
  * Sets the modifier.
11965
12014
  * @param modifier the modifier value
12015
+ * @since 4.14
11966
12016
  */
11967
12017
  set_modifier(modifier: bigint | number): void;
11968
12018
 
11969
12019
  /**
11970
12020
  * Sets the number of planes of the texture.
11971
12021
  * @param n_planes the number of planes
12022
+ * @since 4.14
11972
12023
  */
11973
12024
  set_n_planes(n_planes: number): void;
11974
12025
 
@@ -11976,6 +12027,7 @@ export namespace Gdk {
11976
12027
  * Sets the offset for a plane.
11977
12028
  * @param plane the plane to set the offset for
11978
12029
  * @param offset the offset value
12030
+ * @since 4.14
11979
12031
  */
11980
12032
  set_offset(plane: number, offset: number): void;
11981
12033
 
@@ -11985,6 +12037,7 @@ export namespace Gdk {
11985
12037
  * Unless otherwise specified, all formats including alpha channels are assumed
11986
12038
  * to be premultiplied.
11987
12039
  * @param premultiplied whether the data is premultiplied
12040
+ * @since 4.14
11988
12041
  */
11989
12042
  set_premultiplied(premultiplied: boolean): void;
11990
12043
 
@@ -11994,6 +12047,7 @@ export namespace Gdk {
11994
12047
  * The stride must be set for all planes before calling {@link Gdk.DmabufTextureBuilder.build}.
11995
12048
  * @param plane the plane to set the stride for
11996
12049
  * @param stride the stride value
12050
+ * @since 4.14
11997
12051
  */
11998
12052
  set_stride(plane: number, stride: number): void;
11999
12053
 
@@ -12009,6 +12063,7 @@ export namespace Gdk {
12009
12063
  *
12010
12064
  * An example would be a screen recording where only the mouse pointer moves.
12011
12065
  * @param region the region to update
12066
+ * @since 4.14
12012
12067
  */
12013
12068
  set_update_region(region: cairo.Region | null): void;
12014
12069
 
@@ -12016,6 +12071,7 @@ export namespace Gdk {
12016
12071
  * Sets the texture to be updated by this texture. See
12017
12072
  * {@link Gdk.DmabufTextureBuilder.set_update_region} for an explanation.
12018
12073
  * @param texture the texture to update
12074
+ * @since 4.14
12019
12075
  */
12020
12076
  set_update_texture(texture: Texture | null): void;
12021
12077
 
@@ -12024,6 +12080,7 @@ export namespace Gdk {
12024
12080
  *
12025
12081
  * The width must be set before calling {@link Gdk.DmabufTextureBuilder.build}.
12026
12082
  * @param width The texture's width or 0 to unset
12083
+ * @since 4.14
12027
12084
  */
12028
12085
  set_width(width: number): void;
12029
12086
  }
@@ -12373,6 +12430,7 @@ export namespace Gdk {
12373
12430
  * use of [GskRenderer](../gsk4/class.Renderer.html)s, so application code
12374
12431
  * does not need to call these functions explicitly.
12375
12432
  * @param region minimum region that should be drawn
12433
+ * @deprecated since 4.16: Drawing directly to the surface is no longer recommended. Use `GskRenderNode` and `GskRenderer`.
12376
12434
  */
12377
12435
  begin_frame(region: cairo.Region): void;
12378
12436
 
@@ -12385,6 +12443,7 @@ export namespace Gdk {
12385
12443
  * When using a {@link Gdk.GLContext}, this function may call `glFlush()`
12386
12444
  * implicitly before returning; it is not recommended to call `glFlush()`
12387
12445
  * explicitly before calling this function.
12446
+ * @deprecated since 4.16: Drawing directly to the surface is no longer recommended. Use `GskRenderNode` and `GskRenderer`.
12388
12447
  */
12389
12448
  end_frame(): void;
12390
12449
 
@@ -12404,6 +12463,7 @@ export namespace Gdk {
12404
12463
  * If `context` is not in between calls to {@link Gdk.DrawContext.begin_frame}
12405
12464
  * and {@link Gdk.DrawContext.end_frame}, `null` will be returned.
12406
12465
  * @returns a Cairo region
12466
+ * @deprecated since 4.16: Drawing directly to the surface is no longer recommended. Use `GskRenderNode` and `GskRenderer`.
12407
12467
  */
12408
12468
  get_frame_region(): cairo.Region | null;
12409
12469
 
@@ -12420,6 +12480,7 @@ export namespace Gdk {
12420
12480
  * and {@link Gdk.DrawContext.end_frame}. In this situation, drawing commands
12421
12481
  * may be effecting the contents of the `context`'s surface.
12422
12482
  * @returns `true` if the context is between {@link Gdk.DrawContext.begin_frame} and {@link Gdk.DrawContext.end_frame} calls.
12483
+ * @deprecated since 4.16: Drawing directly to the surface is no longer recommended. Use `GskRenderNode` and `GskRenderer`.
12423
12484
  */
12424
12485
  is_in_frame(): boolean;
12425
12486
  }
@@ -13378,6 +13439,7 @@ export namespace Gdk {
13378
13439
  /**
13379
13440
  * Gets the allowed APIs set via `gdk_gl_context_set_allowed_apis()`.
13380
13441
  * @returns the allowed APIs
13442
+ * @since 4.6
13381
13443
  */
13382
13444
  get_allowed_apis(): GLAPI;
13383
13445
 
@@ -13386,6 +13448,7 @@ export namespace Gdk {
13386
13448
  *
13387
13449
  * If the renderer has not been realized yet, 0 is returned.
13388
13450
  * @returns the currently used API
13451
+ * @since 4.6
13389
13452
  */
13390
13453
  get_api(): GLAPI;
13391
13454
 
@@ -13427,6 +13490,7 @@ export namespace Gdk {
13427
13490
  * As many contexts can share data now and no single shared context exists
13428
13491
  * anymore, this function has been deprecated and now always returns `null`.
13429
13492
  * @returns `null`
13493
+ * @deprecated since 4.4: Use {@link Gdk.GLContext.is_shared} to check if contexts can be shared.
13430
13494
  */
13431
13495
  get_shared_context(): GLContext | null;
13432
13496
 
@@ -13485,6 +13549,7 @@ export namespace Gdk {
13485
13549
  * is not, this function will return `false`.
13486
13550
  * @param other the {@link Gdk.GLContext} that should be compatible with `self`
13487
13551
  * @returns `true` if the two GL contexts are compatible.
13552
+ * @since 4.4
13488
13553
  */
13489
13554
  is_shared(other: GLContext): boolean;
13490
13555
 
@@ -13510,6 +13575,7 @@ export namespace Gdk {
13510
13575
  *
13511
13576
  * By default, all APIs are allowed.
13512
13577
  * @param apis the allowed APIs
13578
+ * @since 4.6
13513
13579
  */
13514
13580
  set_allowed_apis(apis: GLAPI): void;
13515
13581
 
@@ -13569,6 +13635,7 @@ export namespace Gdk {
13569
13635
  * after calling {@link Gdk.GLContext.realize} to decide whether to use
13570
13636
  * the OpenGL or OpenGL ES API, extensions, or shaders.
13571
13637
  * @param use_es whether the context should use OpenGL ES instead of OpenGL, or -1 to allow auto-detection
13638
+ * @deprecated since 4.6
13572
13639
  */
13573
13640
  set_use_es(use_es: number): void;
13574
13641
  }
@@ -13869,6 +13936,7 @@ export namespace Gdk {
13869
13936
  * makes sense to transfer the {@link GLib.Variant} between processes on the same machine,
13870
13937
  * (as opposed to over the network), and within the same file system namespace.
13871
13938
  * @returns a {@link GLib.Variant}, or `null` when serialization fails. The {@link GLib.Variant} will not be floating.
13939
+ * @since 2.38
13872
13940
  */
13873
13941
  serialize(): GLib.Variant | null;
13874
13942
 
@@ -13890,6 +13958,7 @@ export namespace Gdk {
13890
13958
  * - If `icon` is a {@link Gio.ThemedIcon} with exactly one name and no fallbacks,
13891
13959
  * the encoding is simply the name (such as `network-server`).
13892
13960
  * @returns An allocated NUL-terminated UTF8 string or `null` if `icon` can't be serialized. Use `g_free()` to free.
13961
+ * @since 2.20
13893
13962
  */
13894
13963
  to_string(): string | null;
13895
13964
 
@@ -13912,6 +13981,7 @@ export namespace Gdk {
13912
13981
  * As serialization will avoid using raw icon data when possible, it only
13913
13982
  * makes sense to transfer the {@link GLib.Variant} between processes on the same machine,
13914
13983
  * (as opposed to over the network), and within the same file system namespace.
13984
+ * @since 2.38
13915
13985
  * @virtual
13916
13986
  */
13917
13987
  vfunc_serialize(): GLib.Variant | null;
@@ -13919,6 +13989,7 @@ export namespace Gdk {
13919
13989
  /**
13920
13990
  * Serializes the `icon` into string tokens.
13921
13991
  * This is can be invoked when `g_icon_new_for_string()` is called.
13992
+ * @since 2.20
13922
13993
  * @virtual
13923
13994
  */
13924
13995
  vfunc_to_tokens(): [boolean, string[], number];
@@ -14201,12 +14272,14 @@ export namespace Gdk {
14201
14272
  * possibly with changing properties in between.
14202
14273
  * @param data user data to pass to the destroy function
14203
14274
  * @returns a newly built {@link Gdk.Texture}
14275
+ * @since 4.12
14204
14276
  */
14205
14277
  build(data: null): Texture;
14206
14278
 
14207
14279
  /**
14208
14280
  * Gets the color state previously set via `gdk_gl_texture_builder_set_color_state()`.
14209
14281
  * @returns the color state
14282
+ * @since 4.16
14210
14283
  */
14211
14284
  get_color_state(): ColorState;
14212
14285
 
@@ -14214,18 +14287,21 @@ export namespace Gdk {
14214
14287
  * Gets the context previously set via `gdk_gl_texture_builder_set_context()` or
14215
14288
  * `null` if none was set.
14216
14289
  * @returns The context
14290
+ * @since 4.12
14217
14291
  */
14218
14292
  get_context(): GLContext | null;
14219
14293
 
14220
14294
  /**
14221
14295
  * Gets the format previously set via `gdk_gl_texture_builder_set_format()`.
14222
14296
  * @returns The format
14297
+ * @since 4.12
14223
14298
  */
14224
14299
  get_format(): MemoryFormat;
14225
14300
 
14226
14301
  /**
14227
14302
  * Gets whether the texture has a mipmap.
14228
14303
  * @returns Whether the texture has a mipmap
14304
+ * @since 4.12
14229
14305
  */
14230
14306
  get_has_mipmap(): boolean;
14231
14307
 
@@ -14233,6 +14309,7 @@ export namespace Gdk {
14233
14309
  * Gets the height previously set via `gdk_gl_texture_builder_set_height()` or
14234
14310
  * 0 if the height wasn't set.
14235
14311
  * @returns The height
14312
+ * @since 4.12
14236
14313
  */
14237
14314
  get_height(): number;
14238
14315
 
@@ -14240,12 +14317,14 @@ export namespace Gdk {
14240
14317
  * Gets the texture id previously set via `gdk_gl_texture_builder_set_id()` or
14241
14318
  * 0 if the id wasn't set.
14242
14319
  * @returns The id
14320
+ * @since 4.12
14243
14321
  */
14244
14322
  get_id(): number;
14245
14323
 
14246
14324
  /**
14247
14325
  * Gets the `GLsync` previously set via `gdk_gl_texture_builder_set_sync()`.
14248
14326
  * @returns the `GLSync`
14327
+ * @since 4.12
14249
14328
  */
14250
14329
  get_sync(): null;
14251
14330
 
@@ -14253,6 +14332,7 @@ export namespace Gdk {
14253
14332
  * Gets the region previously set via `gdk_gl_texture_builder_set_update_region()` or
14254
14333
  * `null` if none was set.
14255
14334
  * @returns The region
14335
+ * @since 4.12
14256
14336
  */
14257
14337
  get_update_region(): cairo.Region | null;
14258
14338
 
@@ -14260,6 +14340,7 @@ export namespace Gdk {
14260
14340
  * Gets the texture previously set via `gdk_gl_texture_builder_set_update_texture()` or
14261
14341
  * `null` if none was set.
14262
14342
  * @returns The texture
14343
+ * @since 4.12
14263
14344
  */
14264
14345
  get_update_texture(): Texture | null;
14265
14346
 
@@ -14267,6 +14348,7 @@ export namespace Gdk {
14267
14348
  * Gets the width previously set via `gdk_gl_texture_builder_set_width()` or
14268
14349
  * 0 if the width wasn't set.
14269
14350
  * @returns The width
14351
+ * @since 4.12
14270
14352
  */
14271
14353
  get_width(): number;
14272
14354
 
@@ -14276,6 +14358,7 @@ export namespace Gdk {
14276
14358
  * By default, the sRGB colorstate is used. If you don't know what
14277
14359
  * colorstates are, this is probably the right thing.
14278
14360
  * @param color_state a {@link Gdk.ColorState}
14361
+ * @since 4.16
14279
14362
  */
14280
14363
  set_color_state(color_state: ColorState): void;
14281
14364
 
@@ -14285,6 +14368,7 @@ export namespace Gdk {
14285
14368
  *
14286
14369
  * The context must be set before calling {@link Gdk.GLTextureBuilder.build}.
14287
14370
  * @param context The context the texture belongs to or `null` to unset
14371
+ * @since 4.12
14288
14372
  */
14289
14373
  set_context(context: GLContext | null): void;
14290
14374
 
@@ -14306,6 +14390,7 @@ export namespace Gdk {
14306
14390
  * Non-RGBA textures need to have swizzling parameters set up properly to be usable
14307
14391
  * in GSK's shaders.
14308
14392
  * @param format The texture's format
14393
+ * @since 4.12
14309
14394
  */
14310
14395
  set_format(format: MemoryFormat): void;
14311
14396
 
@@ -14315,6 +14400,7 @@ export namespace Gdk {
14315
14400
  *
14316
14401
  * Typically, the `glGenerateMipmap` function is used to generate a mimap.
14317
14402
  * @param has_mipmap Whether the texture has a mipmap
14403
+ * @since 4.12
14318
14404
  */
14319
14405
  set_has_mipmap(has_mipmap: boolean): void;
14320
14406
 
@@ -14323,6 +14409,7 @@ export namespace Gdk {
14323
14409
  *
14324
14410
  * The height must be set before calling {@link Gdk.GLTextureBuilder.build}.
14325
14411
  * @param height The texture's height or 0 to unset
14412
+ * @since 4.12
14326
14413
  */
14327
14414
  set_height(height: number): void;
14328
14415
 
@@ -14333,6 +14420,7 @@ export namespace Gdk {
14333
14420
  *
14334
14421
  * The id must be set before calling {@link Gdk.GLTextureBuilder.build}.
14335
14422
  * @param id The texture id to be used for creating the texture
14423
+ * @since 4.12
14336
14424
  */
14337
14425
  set_id(id: number): void;
14338
14426
 
@@ -14346,6 +14434,7 @@ export namespace Gdk {
14346
14434
  * The texture builder does not destroy it and it is the callers
14347
14435
  * responsibility to make sure it doesn't leak.
14348
14436
  * @param sync the GLSync object
14437
+ * @since 4.12
14349
14438
  */
14350
14439
  set_sync(sync: null): void;
14351
14440
 
@@ -14361,6 +14450,7 @@ export namespace Gdk {
14361
14450
  *
14362
14451
  * An example would be a screen recording where only the mouse pointer moves.
14363
14452
  * @param region the region to update
14453
+ * @since 4.12
14364
14454
  */
14365
14455
  set_update_region(region: cairo.Region | null): void;
14366
14456
 
@@ -14368,6 +14458,7 @@ export namespace Gdk {
14368
14458
  * Sets the texture to be updated by this texture. See
14369
14459
  * {@link Gdk.GLTextureBuilder.set_update_region} for an explanation.
14370
14460
  * @param texture the texture to update
14461
+ * @since 4.12
14371
14462
  */
14372
14463
  set_update_texture(texture: Texture | null): void;
14373
14464
 
@@ -14376,6 +14467,7 @@ export namespace Gdk {
14376
14467
  *
14377
14468
  * The width must be set before calling {@link Gdk.GLTextureBuilder.build}.
14378
14469
  * @param width The texture's width or 0 to unset
14470
+ * @since 4.12
14379
14471
  */
14380
14472
  set_width(width: number): void;
14381
14473
  }
@@ -14800,6 +14892,7 @@ export namespace Gdk {
14800
14892
  * makes sense to transfer the {@link GLib.Variant} between processes on the same machine,
14801
14893
  * (as opposed to over the network), and within the same file system namespace.
14802
14894
  * @returns a {@link GLib.Variant}, or `null` when serialization fails. The {@link GLib.Variant} will not be floating.
14895
+ * @since 2.38
14803
14896
  */
14804
14897
  serialize(): GLib.Variant | null;
14805
14898
 
@@ -14821,6 +14914,7 @@ export namespace Gdk {
14821
14914
  * - If `icon` is a {@link Gio.ThemedIcon} with exactly one name and no fallbacks,
14822
14915
  * the encoding is simply the name (such as `network-server`).
14823
14916
  * @returns An allocated NUL-terminated UTF8 string or `null` if `icon` can't be serialized. Use `g_free()` to free.
14917
+ * @since 2.20
14824
14918
  */
14825
14919
  to_string(): string | null;
14826
14920
 
@@ -14843,6 +14937,7 @@ export namespace Gdk {
14843
14937
  * As serialization will avoid using raw icon data when possible, it only
14844
14938
  * makes sense to transfer the {@link GLib.Variant} between processes on the same machine,
14845
14939
  * (as opposed to over the network), and within the same file system namespace.
14940
+ * @since 2.38
14846
14941
  * @virtual
14847
14942
  */
14848
14943
  vfunc_serialize(): GLib.Variant | null;
@@ -14850,6 +14945,7 @@ export namespace Gdk {
14850
14945
  /**
14851
14946
  * Serializes the `icon` into string tokens.
14852
14947
  * This is can be invoked when `g_icon_new_for_string()` is called.
14948
+ * @since 2.20
14853
14949
  * @virtual
14854
14950
  */
14855
14951
  vfunc_to_tokens(): [boolean, string[], number];
@@ -15099,6 +15195,7 @@ export namespace Gdk {
15099
15195
  * It is possible to call this function multiple times to create multiple textures,
15100
15196
  * possibly with changing properties in between.
15101
15197
  * @returns a newly built {@link Gdk.Texture}
15198
+ * @since 4.16
15102
15199
  */
15103
15200
  build(): Texture;
15104
15201
 
@@ -15106,18 +15203,21 @@ export namespace Gdk {
15106
15203
  * Gets the bytes previously set via `gdk_memory_texture_builder_set_bytes()`
15107
15204
  * or `null` if none was set.
15108
15205
  * @returns The bytes
15206
+ * @since 4.16
15109
15207
  */
15110
15208
  get_bytes(): GLib.Bytes | null;
15111
15209
 
15112
15210
  /**
15113
15211
  * Gets the colorstate previously set via `gdk_memory_texture_builder_set_color_state()`.
15114
15212
  * @returns The colorstate
15213
+ * @since 4.16
15115
15214
  */
15116
15215
  get_color_state(): ColorState;
15117
15216
 
15118
15217
  /**
15119
15218
  * Gets the format previously set via `gdk_memory_texture_builder_set_format()`.
15120
15219
  * @returns The format
15220
+ * @since 4.16
15121
15221
  */
15122
15222
  get_format(): MemoryFormat;
15123
15223
 
@@ -15125,6 +15225,7 @@ export namespace Gdk {
15125
15225
  * Gets the height previously set via `gdk_memory_texture_builder_set_height()`
15126
15226
  * or 0 if the height wasn't set.
15127
15227
  * @returns The height
15228
+ * @since 4.16
15128
15229
  */
15129
15230
  get_height(): number;
15130
15231
 
@@ -15132,12 +15233,14 @@ export namespace Gdk {
15132
15233
  * Gets the offset previously set via `gdk_memory_texture_builder_set_offset()`.
15133
15234
  * @param plane a plane
15134
15235
  * @returns The offset associated to a `plane`
15236
+ * @since 4.20
15135
15237
  */
15136
15238
  get_offset(plane: number): number;
15137
15239
 
15138
15240
  /**
15139
15241
  * Gets the stride previously set via `gdk_memory_texture_builder_set_stride()`.
15140
15242
  * @returns the stride
15243
+ * @since 4.16
15141
15244
  */
15142
15245
  get_stride(): number;
15143
15246
 
@@ -15145,6 +15248,7 @@ export namespace Gdk {
15145
15248
  * Gets the stride previously set via `gdk_memory_texture_builder_set_stride_for_plane()`.
15146
15249
  * @param plane a plane
15147
15250
  * @returns The stride associated to a `plane`
15251
+ * @since 4.20
15148
15252
  */
15149
15253
  get_stride_for_plane(plane: number): number;
15150
15254
 
@@ -15152,6 +15256,7 @@ export namespace Gdk {
15152
15256
  * Gets the region previously set via `gdk_memory_texture_builder_set_update_region()`
15153
15257
  * or `null` if none was set.
15154
15258
  * @returns The update region
15259
+ * @since 4.16
15155
15260
  */
15156
15261
  get_update_region(): cairo.Region | null;
15157
15262
 
@@ -15159,6 +15264,7 @@ export namespace Gdk {
15159
15264
  * Gets the texture previously set via `gdk_memory_texture_builder_set_update_texture()`
15160
15265
  * or `null` if none was set.
15161
15266
  * @returns The update texture
15267
+ * @since 4.16
15162
15268
  */
15163
15269
  get_update_texture(): Texture | null;
15164
15270
 
@@ -15166,6 +15272,7 @@ export namespace Gdk {
15166
15272
  * Gets the width previously set via `gdk_memory_texture_builder_set_width()`
15167
15273
  * or 0 if the width wasn't set.
15168
15274
  * @returns The width
15275
+ * @since 4.16
15169
15276
  */
15170
15277
  get_width(): number;
15171
15278
 
@@ -15174,6 +15281,7 @@ export namespace Gdk {
15174
15281
  *
15175
15282
  * The bytes must be set before calling {@link Gdk.MemoryTextureBuilder.build}.
15176
15283
  * @param bytes The bytes the texture shows or `null` to unset
15284
+ * @since 4.16
15177
15285
  */
15178
15286
  set_bytes(bytes: GLib.Bytes | Uint8Array | null): void;
15179
15287
 
@@ -15183,6 +15291,7 @@ export namespace Gdk {
15183
15291
  * By default, the sRGB colorstate is used. If you don't know
15184
15292
  * what colorstates are, this is probably the right thing.
15185
15293
  * @param color_state The colorstate describing the data
15294
+ * @since 4.16
15186
15295
  */
15187
15296
  set_color_state(color_state: ColorState): void;
15188
15297
 
@@ -15191,6 +15300,7 @@ export namespace Gdk {
15191
15300
  *
15192
15301
  * The default is `GDK_MEMORY_R8G8B8A8_PREMULTIPLIED`.
15193
15302
  * @param format The texture's format
15303
+ * @since 4.16
15194
15304
  */
15195
15305
  set_format(format: MemoryFormat): void;
15196
15306
 
@@ -15200,6 +15310,7 @@ export namespace Gdk {
15200
15310
  * The height must be set before calling {@link Gdk.MemoryTextureBuilder.build}
15201
15311
  * and conform to size requirements of the provided format.
15202
15312
  * @param height The texture's height or 0 to unset
15313
+ * @since 4.16
15203
15314
  */
15204
15315
  set_height(height: number): void;
15205
15316
 
@@ -15207,6 +15318,7 @@ export namespace Gdk {
15207
15318
  * Sets the offset of the texture for `plane`.
15208
15319
  * @param plane a plane
15209
15320
  * @param offset the texture's offset for `plane`
15321
+ * @since 4.20
15210
15322
  */
15211
15323
  set_offset(plane: number, offset: bigint | number): void;
15212
15324
 
@@ -15215,6 +15327,7 @@ export namespace Gdk {
15215
15327
  *
15216
15328
  * The rowstride must be set before calling {@link Gdk.MemoryTextureBuilder.build}.
15217
15329
  * @param stride the stride or 0 to unset
15330
+ * @since 4.16
15218
15331
  */
15219
15332
  set_stride(stride: bigint | number): void;
15220
15333
 
@@ -15222,6 +15335,7 @@ export namespace Gdk {
15222
15335
  * Sets the stride of the texture for `plane`.
15223
15336
  * @param plane a plane
15224
15337
  * @param stride the texture's stride for `plane`
15338
+ * @since 4.20
15225
15339
  */
15226
15340
  set_stride_for_plane(plane: number, stride: bigint | number): void;
15227
15341
 
@@ -15238,6 +15352,7 @@ export namespace Gdk {
15238
15352
  *
15239
15353
  * An example would be a screen recording where only the mouse pointer moves.
15240
15354
  * @param region the region to update
15355
+ * @since 4.16
15241
15356
  */
15242
15357
  set_update_region(region: cairo.Region | null): void;
15243
15358
 
@@ -15246,6 +15361,7 @@ export namespace Gdk {
15246
15361
  *
15247
15362
  * See {@link Gdk.MemoryTextureBuilder.set_update_region} for an explanation.
15248
15363
  * @param texture the texture to update
15364
+ * @since 4.16
15249
15365
  */
15250
15366
  set_update_texture(texture: Texture | null): void;
15251
15367
 
@@ -15255,6 +15371,7 @@ export namespace Gdk {
15255
15371
  * The width must be set before calling {@link Gdk.MemoryTextureBuilder.build}
15256
15372
  * and conform to size requirements of the provided format.
15257
15373
  * @param width The texture's width or 0 to unset
15374
+ * @since 4.16
15258
15375
  */
15259
15376
  set_width(width: number): void;
15260
15377
  }
@@ -15495,6 +15612,7 @@ export namespace Gdk {
15495
15612
  *
15496
15613
  * This can be used to identify a monitor in the UI.
15497
15614
  * @returns the monitor description
15615
+ * @since 4.10
15498
15616
  */
15499
15617
  get_description(): string | null;
15500
15618
 
@@ -15554,6 +15672,7 @@ export namespace Gdk {
15554
15672
  * particular monitor, but most of the time you’re drawing to a surface
15555
15673
  * where it is better to use {@link Gdk.Surface.get_scale} instead.
15556
15674
  * @returns the scale
15675
+ * @since 4.14
15557
15676
  */
15558
15677
  get_scale(): number;
15559
15678
 
@@ -15753,6 +15872,7 @@ export namespace Gdk {
15753
15872
  /**
15754
15873
  * Extracts the scroll direction relative to the physical motion.
15755
15874
  * @returns the relative scroll direction.
15875
+ * @since 4.20
15756
15876
  */
15757
15877
  get_relative_direction(): ScrollRelativeDirection;
15758
15878
 
@@ -15762,6 +15882,7 @@ export namespace Gdk {
15762
15882
  * The unit will always be {@link Gdk.ScrollUnit.WHEEL} if the scroll direction is not
15763
15883
  * {@link Gdk.ScrollDirection.SMOOTH}.
15764
15884
  * @returns the scroll unit.
15885
+ * @since 4.8
15765
15886
  */
15766
15887
  get_unit(): ScrollUnit;
15767
15888
 
@@ -16144,6 +16265,7 @@ export namespace Gdk {
16144
16265
  /**
16145
16266
  * Creates a new {@link Gdk.CairoContext} for rendering on `surface`.
16146
16267
  * @returns the newly created {@link Gdk.CairoContext}
16268
+ * @deprecated since 4.18: Drawing content with Cairo should be done via Cairo rendernodes, not by using the Cairo renderer.
16147
16269
  */
16148
16270
  create_cairo_context(): CairoContext;
16149
16271
 
@@ -16178,12 +16300,14 @@ export namespace Gdk {
16178
16300
  * @param width width of the new surface
16179
16301
  * @param height height of the new surface
16180
16302
  * @returns a pointer to the newly allocated surface. The caller owns the surface and should call `cairo_surface_destroy()` when done with it.
16303
+ * @deprecated since 4.12: Create a suitable cairo image surface yourself
16181
16304
  */
16182
16305
  create_similar_surface(content: cairo.Content, width: number, height: number): cairo.Surface;
16183
16306
 
16184
16307
  /**
16185
16308
  * Sets an error and returns `null`.
16186
16309
  * @returns `null`
16310
+ * @deprecated since 4.14: GTK does not expose any Vulkan internals. This function is a leftover that was accidentally exposed.
16187
16311
  */
16188
16312
  create_vulkan_context(): VulkanContext;
16189
16313
 
@@ -16281,6 +16405,7 @@ export namespace Gdk {
16281
16405
  *
16282
16406
  * The scale may change during the lifetime of the surface.
16283
16407
  * @returns the scale
16408
+ * @since 4.12
16284
16409
  */
16285
16410
  get_scale(): number;
16286
16411
 
@@ -16403,6 +16528,7 @@ export namespace Gdk {
16403
16528
  * background is not opaque, please update this property in your
16404
16529
  * [GtkWidgetClass.css_changed](../gtk4/vfunc.Widget.css_changed.html) handler.
16405
16530
  * @param region a region, or `null` to make the entire surface opaque
16531
+ * @deprecated since 4.16: GDK can figure out the opaque parts of a window itself by inspecting the contents that are drawn.
16406
16532
  */
16407
16533
  set_opaque_region(region: cairo.Region | null): void;
16408
16534
 
@@ -16567,6 +16693,7 @@ export namespace Gdk {
16567
16693
  /**
16568
16694
  * Returns the color state associated with the texture.
16569
16695
  * @returns the color state of the {@link Gdk.Texture}
16696
+ * @since 4.16
16570
16697
  */
16571
16698
  get_color_state(): ColorState;
16572
16699
 
@@ -16581,6 +16708,7 @@ export namespace Gdk {
16581
16708
  * of the texture and is useful to determine the best format for
16582
16709
  * downloading the texture.
16583
16710
  * @returns the preferred format for the texture's data
16711
+ * @since 4.10
16584
16712
  */
16585
16713
  get_format(): MemoryFormat;
16586
16714
 
@@ -16625,6 +16753,7 @@ export namespace Gdk {
16625
16753
  * might also want to consider {@link Gdk.Texture.save_to_tiff_bytes}
16626
16754
  * instead.
16627
16755
  * @returns a newly allocated {@link GLib.Bytes} containing PNG data
16756
+ * @since 4.6
16628
16757
  */
16629
16758
  save_to_png_bytes(): GLib.Bytes;
16630
16759
 
@@ -16634,6 +16763,7 @@ export namespace Gdk {
16634
16763
  * GTK will attempt to store data without loss.
16635
16764
  * @param filename the filename to store to
16636
16765
  * @returns `true` if saving succeeded, `false` on failure.
16766
+ * @since 4.6
16637
16767
  */
16638
16768
  save_to_tiff(filename: string): boolean;
16639
16769
 
@@ -16651,6 +16781,7 @@ export namespace Gdk {
16651
16781
  * smaller size and a more portable format, you might want to
16652
16782
  * use {@link Gdk.Texture.save_to_png_bytes}.
16653
16783
  * @returns a newly allocated {@link GLib.Bytes} containing TIFF data
16784
+ * @since 4.6
16654
16785
  */
16655
16786
  save_to_tiff_bytes(): GLib.Bytes;
16656
16787
 
@@ -16891,6 +17022,7 @@ export namespace Gdk {
16891
17022
  * makes sense to transfer the {@link GLib.Variant} between processes on the same machine,
16892
17023
  * (as opposed to over the network), and within the same file system namespace.
16893
17024
  * @returns a {@link GLib.Variant}, or `null` when serialization fails. The {@link GLib.Variant} will not be floating.
17025
+ * @since 2.38
16894
17026
  */
16895
17027
  serialize(): GLib.Variant | null;
16896
17028
 
@@ -16912,6 +17044,7 @@ export namespace Gdk {
16912
17044
  * - If `icon` is a {@link Gio.ThemedIcon} with exactly one name and no fallbacks,
16913
17045
  * the encoding is simply the name (such as `network-server`).
16914
17046
  * @returns An allocated NUL-terminated UTF8 string or `null` if `icon` can't be serialized. Use `g_free()` to free.
17047
+ * @since 2.20
16915
17048
  */
16916
17049
  to_string(): string | null;
16917
17050
 
@@ -16934,6 +17067,7 @@ export namespace Gdk {
16934
17067
  * As serialization will avoid using raw icon data when possible, it only
16935
17068
  * makes sense to transfer the {@link GLib.Variant} between processes on the same machine,
16936
17069
  * (as opposed to over the network), and within the same file system namespace.
17070
+ * @since 2.38
16937
17071
  * @virtual
16938
17072
  */
16939
17073
  vfunc_serialize(): GLib.Variant | null;
@@ -16941,6 +17075,7 @@ export namespace Gdk {
16941
17075
  /**
16942
17076
  * Serializes the `icon` into string tokens.
16943
17077
  * This is can be invoked when `g_icon_new_for_string()` is called.
17078
+ * @since 2.20
16944
17079
  * @virtual
16945
17080
  */
16946
17081
  vfunc_to_tokens(): [boolean, string[], number];
@@ -17226,6 +17361,7 @@ export namespace Gdk {
17226
17361
  * Returns the color state object representing the oklab color space.
17227
17362
  *
17228
17363
  * This is a perceptually uniform color state.
17364
+ * @since 4.18
17229
17365
  */
17230
17366
  static get_oklab(): ColorState;
17231
17367
 
@@ -17234,6 +17370,7 @@ export namespace Gdk {
17234
17370
  *
17235
17371
  * This is the polar variant of oklab, in which the hue is encoded as
17236
17372
  * a polar coordinate.
17373
+ * @since 4.18
17237
17374
  */
17238
17375
  static get_oklch(): ColorState;
17239
17376
 
@@ -17247,6 +17384,7 @@ export namespace Gdk {
17247
17384
  *
17248
17385
  * See e.g. [the CSS HDR Module](https://drafts.csswg.org/css-color-hdr/#valdef-color-rec2100-linear)
17249
17386
  * for details about this colorstate.
17387
+ * @since 4.16
17250
17388
  */
17251
17389
  static get_rec2100_linear(): ColorState;
17252
17390
 
@@ -17260,6 +17398,7 @@ export namespace Gdk {
17260
17398
  *
17261
17399
  * See e.g. [the CSS HDR Module](https://drafts.csswg.org/css-color-hdr/#valdef-color-rec2100-pq)
17262
17400
  * for details about this colorstate.
17401
+ * @since 4.16
17263
17402
  */
17264
17403
  static get_rec2100_pq(): ColorState;
17265
17404
 
@@ -17273,6 +17412,7 @@ export namespace Gdk {
17273
17412
  *
17274
17413
  * See e.g. [the CSS Color Module](https://www.w3.org/TR/css-color-4/#predefined-sRGB)
17275
17414
  * for details about this colorstate.
17415
+ * @since 4.16
17276
17416
  */
17277
17417
  static get_srgb(): ColorState;
17278
17418
 
@@ -17285,6 +17425,7 @@ export namespace Gdk {
17285
17425
  *
17286
17426
  * See e.g. [the CSS Color Module](https://www.w3.org/TR/css-color-4/#predefined-sRGB-linear)
17287
17427
  * for details about this colorstate.
17428
+ * @since 4.16
17288
17429
  */
17289
17430
  static get_srgb_linear(): ColorState;
17290
17431
 
@@ -17296,6 +17437,7 @@ export namespace Gdk {
17296
17437
  * represented with Cicp parameters. If that is the case,
17297
17438
  * this function returns `NULL`.
17298
17439
  * @returns A new {@link Gdk.CicpParams}
17440
+ * @since 4.16
17299
17441
  */
17300
17442
  create_cicp_params(): CicpParams | null;
17301
17443
 
@@ -17307,6 +17449,7 @@ export namespace Gdk {
17307
17449
  * color states will never compare equal.
17308
17450
  * @param other another `GdkColorStatee`
17309
17451
  * @returns `true` if the two color states compare equal
17452
+ * @since 4.16
17310
17453
  */
17311
17454
  equal(other: ColorState): boolean;
17312
17455
 
@@ -17317,12 +17460,14 @@ export namespace Gdk {
17317
17460
  * even though they may not be equal in the sense of {@link Gdk.ColorState.equal}.
17318
17461
  * @param other another `GdkColorStatee`
17319
17462
  * @returns `true` if the two color states are equivalent
17463
+ * @since 4.20
17320
17464
  */
17321
17465
  equivalent(other: ColorState): boolean;
17322
17466
 
17323
17467
  /**
17324
17468
  * Increase the reference count of `self`.
17325
17469
  * @returns the object that was passed in
17470
+ * @since 4.16
17326
17471
  */
17327
17472
  ref(): ColorState;
17328
17473
 
@@ -17331,6 +17476,7 @@ export namespace Gdk {
17331
17476
  *
17332
17477
  * Unless `self` is static, it will be freed
17333
17478
  * when the reference count reaches zero.
17479
+ * @since 4.16
17334
17480
  */
17335
17481
  unref(): void;
17336
17482
  }
@@ -17396,6 +17542,7 @@ export namespace Gdk {
17396
17542
  * If `string` does not describe valid content formats, `null`
17397
17543
  * is returned.
17398
17544
  * @param string the string to parse
17545
+ * @since 4.4
17399
17546
  */
17400
17547
  static parse(string: string): ContentFormats | null;
17401
17548
 
@@ -17435,6 +17582,7 @@ export namespace Gdk {
17435
17582
  /**
17436
17583
  * Returns whether the content formats contain any formats.
17437
17584
  * @returns true if `formats` contains no mime types and no GTypes
17585
+ * @since 4.18
17438
17586
  */
17439
17587
  is_empty(): boolean;
17440
17588
 
@@ -17676,6 +17824,7 @@ export namespace Gdk {
17676
17824
  * @param fourcc a format code
17677
17825
  * @param modifier a format modifier
17678
17826
  * @returns `TRUE` if the format specified by the arguments is part of `formats`
17827
+ * @since 4.14
17679
17828
  */
17680
17829
  contains(fourcc: number, modifier: bigint | number): boolean;
17681
17830
 
@@ -17684,6 +17833,7 @@ export namespace Gdk {
17684
17833
  * same dmabuf formats, in the same order.
17685
17834
  * @param formats2 another {@link Gdk.DmabufFormats}
17686
17835
  * @returns `TRUE` if `formats1` and `formats2` are equal
17836
+ * @since 4.14
17687
17837
  */
17688
17838
  equal(formats2: DmabufFormats | null): boolean;
17689
17839
 
@@ -17691,6 +17841,7 @@ export namespace Gdk {
17691
17841
  * Gets the fourcc code and modifier for a format
17692
17842
  * that is contained in `formats`.
17693
17843
  * @param idx the index of the format to return
17844
+ * @since 4.14
17694
17845
  */
17695
17846
  get_format(idx: bigint | number): [number, number];
17696
17847
 
@@ -17702,12 +17853,14 @@ export namespace Gdk {
17702
17853
  * platforms, {@link Gdk.DmabufFormats.get_n_formats} will
17703
17854
  * always return zero.
17704
17855
  * @returns the number of formats
17856
+ * @since 4.14
17705
17857
  */
17706
17858
  get_n_formats(): number;
17707
17859
 
17708
17860
  /**
17709
17861
  * Increases the reference count of `formats`.
17710
17862
  * @returns the passed-in object
17863
+ * @since 4.14
17711
17864
  */
17712
17865
  ref(): DmabufFormats;
17713
17866
 
@@ -17716,6 +17869,7 @@ export namespace Gdk {
17716
17869
  *
17717
17870
  * When the reference count reaches zero,
17718
17871
  * the object is freed.
17872
+ * @since 4.14
17719
17873
  */
17720
17874
  unref(): void;
17721
17875
  }
@@ -17754,6 +17908,7 @@ export namespace Gdk {
17754
17908
  * Sets the size the drag surface prefers to be resized to.
17755
17909
  * @param width the width
17756
17910
  * @param height the height
17911
+ * @since 4.12
17757
17912
  */
17758
17913
  set_size(width: number, height: number): void;
17759
17914
  }
@@ -17799,6 +17954,7 @@ export namespace Gdk {
17799
17954
  *
17800
17955
  * This function is meant for language bindings.
17801
17956
  * @returns the files inside the list
17957
+ * @since 4.6
17802
17958
  */
17803
17959
  get_files(): Gio.File[];
17804
17960
  }
@@ -17904,6 +18060,7 @@ export namespace Gdk {
17904
18060
  * available at all. Looking at the result of the timings gives
17905
18061
  * an explanation for why a value is not available.
17906
18062
  * @returns The result of the frame these timings have been recorded for.
18063
+ * @since 4.24
17907
18064
  */
17908
18065
  get_result(): FrameResult;
17909
18066
 
@@ -18069,6 +18226,7 @@ export namespace Gdk {
18069
18226
 
18070
18227
  /**
18071
18228
  * Obtains the shadow widths of this layout.
18229
+ * @since 4.2
18072
18230
  */
18073
18231
  get_shadow_width(): [number, number, number, number];
18074
18232
 
@@ -18125,6 +18283,7 @@ export namespace Gdk {
18125
18283
  * @param right width of the right part of the shadow
18126
18284
  * @param top height of the top part of the shadow
18127
18285
  * @param bottom height of the bottom part of the shadow
18286
+ * @since 4.2
18128
18287
  */
18129
18288
  set_shadow_width(left: number, right: number, top: number, bottom: number): void;
18130
18289
 
@@ -18250,6 +18409,7 @@ export namespace Gdk {
18250
18409
  * Appends a representation of `rgba` to `string`.
18251
18410
  * @param string the string to print to
18252
18411
  * @returns A newly allocated text string
18412
+ * @since 4.22
18253
18413
  */
18254
18414
  print(string: GLib.String): GLib.String;
18255
18415
 
@@ -18403,6 +18563,7 @@ export namespace Gdk {
18403
18563
  *
18404
18564
  * This function is meant for language bindings.
18405
18565
  * @returns A copy of the downloader
18566
+ * @since 4.10
18406
18567
  */
18407
18568
  copy(): TextureDownloader;
18408
18569
 
@@ -18418,6 +18579,7 @@ export namespace Gdk {
18418
18579
  * This function cannot be used with a multiplanar format. Use
18419
18580
  * {@link Gdk.TextureDownloader.download_bytes_with_planes} for that purpose.
18420
18581
  * @returns The downloaded pixels
18582
+ * @since 4.10
18421
18583
  */
18422
18584
  download_bytes(): [GLib.Bytes, number];
18423
18585
 
@@ -18428,6 +18590,7 @@ export namespace Gdk {
18428
18590
  * If the format does have less than 4 planes, the remaining offsets and strides will be
18429
18591
  * set to `0`.
18430
18592
  * @returns The downloaded pixels
18593
+ * @since 4.20
18431
18594
  */
18432
18595
  download_bytes_with_planes(): [GLib.Bytes, number[], number[]];
18433
18596
 
@@ -18437,29 +18600,34 @@ export namespace Gdk {
18437
18600
  * This function cannot be used with a multiplanar format.
18438
18601
  * @param data pointer to enough memory to be filled with the downloaded data of the texture
18439
18602
  * @param stride rowstride in bytes
18603
+ * @since 4.10
18440
18604
  */
18441
18605
  download_into(data: Uint8Array | string, stride: bigint | number): void;
18442
18606
 
18443
18607
  /**
18444
18608
  * Frees the given downloader and all its associated resources.
18609
+ * @since 4.10
18445
18610
  */
18446
18611
  free(): void;
18447
18612
 
18448
18613
  /**
18449
18614
  * Gets the color state that the data will be downloaded in.
18450
18615
  * @returns The color state of the download
18616
+ * @since 4.16
18451
18617
  */
18452
18618
  get_color_state(): ColorState;
18453
18619
 
18454
18620
  /**
18455
18621
  * Gets the format that the data will be downloaded in.
18456
18622
  * @returns The format of the download
18623
+ * @since 4.10
18457
18624
  */
18458
18625
  get_format(): MemoryFormat;
18459
18626
 
18460
18627
  /**
18461
18628
  * Gets the texture that the downloader will download.
18462
18629
  * @returns The texture to download
18630
+ * @since 4.10
18463
18631
  */
18464
18632
  get_texture(): Texture;
18465
18633
 
@@ -18469,6 +18637,7 @@ export namespace Gdk {
18469
18637
  * By default, the sRGB colorstate returned by {@link ColorState.get_srgb}
18470
18638
  * is used.
18471
18639
  * @param color_state the color state to use
18640
+ * @since 4.16
18472
18641
  */
18473
18642
  set_color_state(color_state: ColorState): void;
18474
18643
 
@@ -18477,12 +18646,14 @@ export namespace Gdk {
18477
18646
  *
18478
18647
  * By default, GDK_MEMORY_DEFAULT is set.
18479
18648
  * @param format the format to use
18649
+ * @since 4.10
18480
18650
  */
18481
18651
  set_format(format: MemoryFormat): void;
18482
18652
 
18483
18653
  /**
18484
18654
  * Changes the texture the downloader will download.
18485
18655
  * @param texture the new texture to download
18656
+ * @since 4.10
18486
18657
  */
18487
18658
  set_texture(texture: Texture): void;
18488
18659
  }
@@ -19409,6 +19580,7 @@ export namespace Gdk {
19409
19580
  /**
19410
19581
  * The capabilities that are available for this toplevel.
19411
19582
  * @returns the capabilities of the {@link Gdk.Toplevel}.
19583
+ * @since 4.20
19412
19584
  */
19413
19585
  get_capabilities(): ToplevelCapabilities;
19414
19586
 
@@ -19416,6 +19588,7 @@ export namespace Gdk {
19416
19588
  * Returns the gravity that is used when changing the toplevel
19417
19589
  * size programmatically.
19418
19590
  * @returns the gravity
19591
+ * @since 4.20
19419
19592
  */
19420
19593
  get_gravity(): Gravity;
19421
19594
 
@@ -19515,6 +19688,7 @@ export namespace Gdk {
19515
19688
  * Sets the gravity that is used when changing the toplevel
19516
19689
  * size programmatically.
19517
19690
  * @param gravity the new gravity
19691
+ * @since 4.20
19518
19692
  */
19519
19693
  set_gravity(gravity: Gravity): void;
19520
19694
 
@@ -19602,6 +19776,7 @@ export namespace Gdk {
19602
19776
  * Performs a title bar gesture.
19603
19777
  * @param gesture a {@link Gdk.TitlebarGesture}
19604
19778
  * @returns whether the gesture was performed
19779
+ * @since 4.4
19605
19780
  */
19606
19781
  titlebar_gesture(gesture: TitlebarGesture): boolean;
19607
19782
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@girs/gdk-4.0",
3
- "version": "4.3.0",
3
+ "version": "4.4.0",
4
4
  "description": "GJS TypeScript type definitions for Gdk-4.0",
5
5
  "type": "module",
6
6
  "module": "gdk-4.0.js",
@@ -31,17 +31,17 @@
31
31
  "test": "tsc --project tsconfig.json"
32
32
  },
33
33
  "dependencies": {
34
- "@girs/gjs": "^4.3.0",
35
- "@girs/cairo-1.0": "^4.3.0",
36
- "@girs/gobject-2.0": "^4.3.0",
37
- "@girs/glib-2.0": "^4.3.0",
38
- "@girs/pangocairo-1.0": "^4.3.0",
39
- "@girs/pango-1.0": "^4.3.0",
40
- "@girs/harfbuzz-0.0": "^4.3.0",
41
- "@girs/freetype2-2.0": "^4.3.0",
42
- "@girs/gio-2.0": "^4.3.0",
43
- "@girs/gmodule-2.0": "^4.3.0",
44
- "@girs/gdkpixbuf-2.0": "^4.3.0" },
34
+ "@girs/gjs": "^4.4.0",
35
+ "@girs/cairo-1.0": "^4.4.0",
36
+ "@girs/gobject-2.0": "^4.4.0",
37
+ "@girs/glib-2.0": "^4.4.0",
38
+ "@girs/pangocairo-1.0": "^4.4.0",
39
+ "@girs/pango-1.0": "^4.4.0",
40
+ "@girs/harfbuzz-0.0": "^4.4.0",
41
+ "@girs/freetype2-2.0": "^4.4.0",
42
+ "@girs/gio-2.0": "^4.4.0",
43
+ "@girs/gmodule-2.0": "^4.4.0",
44
+ "@girs/gdkpixbuf-2.0": "^4.4.0" },
45
45
  "devDependencies": {
46
46
  "typescript": "*"
47
47
  },