application: Bring back app menus

Being able to override the app menu is relevant on macOS, so
bring back the api needed to do that. All the machinery was
still around from when we stripped it before 4.0.

.gitlab-ci.yml

@@ -26,8 +26,7 @@ variables:
   BACKEND_FLAGS: "-Dx11-backend=true -Dwayland-backend=true -Dbroadway-backend=true"
   FEATURE_FLAGS: "-Dvulkan=enabled -Dcloudproviders=enabled -Dbuild-testsuite=true -Dintrospection=enabled"
   MESON_TEST_TIMEOUT_MULTIPLIER: 3
-  MESON_TEST_MAX_PROCESSES: 8
-  FEDORA_IMAGE: "registry.gitlab.gnome.org/gnome/gtk/fedora:v52"
+  FEDORA_IMAGE: "registry.gitlab.gnome.org/gnome/gtk/fedora:v49"
 
 workflow:
   rules:
@@ -118,11 +117,10 @@ release-build:
     EXTRA_MESON_FLAGS: "--buildtype=release"
   script:
     - .gitlab-ci/show-info-linux.sh
-    - mkdir _install
-    - export PATH="$HOME/.local/bin:${CI_PROJECT_DIR}/_install/bin:$PATH"
-    - .gitlab-ci/install-meson-project.sh --prefix ${CI_PROJECT_DIR}/_install https://gitlab.gnome.org/jadahl/catch.git main
+    - export PATH="$HOME/.local/bin:$PATH"
     - meson subprojects download
     - meson subprojects update --reset
+    - mkdir _install
     - meson setup
             --prefix=${CI_PROJECT_DIR}/_install
             ${COMMON_MESON_FLAGS}
@@ -415,12 +413,11 @@ static-scan:
 # Run tests with the address sanitizer. We need to turn off introspection
 # and f16c, since they are incompatible with asan
 asan-build:
-  extends: .build-fedora-default
+  image: $FEDORA_IMAGE
   tags: [ asan ]
   stage: analysis
   needs: []
   variables:
-    MESON_TEST_MAX_PROCESSES: 4
   script:
     - export PATH="$HOME/.local/bin:$PATH"
     - CC=clang meson setup
@@ -448,10 +445,10 @@ reference:
             --force-fallback-for=gdk-pixbuf,pango
             -Dintrospection=enabled
             -Ddocumentation=true
-            -Dman-pages=true
+            -Dgtk_doc=true
             -Dgdk-pixbuf:gtk_doc=true
-            -Dpango:documentation=true
-            -Dbuild-demos=true
+            -Dpango:gtk_doc=true
+            -Dbuild-demos=false
             -Dbuild-examples=false
             -Dbuild-tests=false
             -Dbuild-testsuite=false
@@ -463,7 +460,6 @@ reference:
     - mv _build/docs/reference/gdk/gdk4-wayland/ _reference/gdk4-wayland/
     - mv _build/docs/reference/gsk/gsk4/ _reference/gsk4/
     - mv _build/docs/reference/gtk/gtk4/ _reference/gtk4/
-    - mv _build/docs/reference/gtk/*.html _reference/gtk4/
     - mv _build/subprojects/pango/docs/Pango/ _reference/Pango/
     - mv _build/subprojects/pango/docs/PangoCairo/ _reference/PangoCairo/
     - mv _build/subprojects/pango/docs/PangoFc/ _reference/PangoFc/

.gitlab-ci/fedora.Dockerfile

@@ -1,4 +1,4 @@
-FROM fedora:40
+FROM fedora:39
 
 RUN dnf -y install \
     adwaita-icon-theme \
@@ -99,11 +99,8 @@ RUN dnf -y install \
     which \
     wireplumber \
     xorg-x11-server-Xvfb \
- && dnf -y update \
  && dnf clean all
 
-RUN rm /usr/share/vulkan/icd.d/powervr_mesa_icd.x86_64.json
-
 # Enable sudo for wheel users
 RUN sed -i -e 's/# %wheel/%wheel/' -e '0,/%wheel/{s/%wheel/# %wheel/}' /etc/sudoers
 

.gitlab-ci/flatpak-build.sh

@@ -24,7 +24,7 @@ flatpak build ${builddir} meson \
                 -Dbuild-examples=false \
                 -Dintrospection=disabled \
                 -Dbuild-demos=true \
-                -Dprofile=devel \
+                -Ddemo-profile=devel \
                 _flatpak_build
 
 flatpak build --env=CI_COMMIT_SHORT_SHA=$CI_COMMIT_SHORT_SHA ${builddir} ninja -C _flatpak_build install

.gitlab-ci/install-meson-project.sh

@@ -1,91 +0,0 @@
-#!/bin/bash
-
-set -e
-
-usage() {
-  cat <<-EOF
-	Usage: $(basename $0) [OPTION…] REPO_URL COMMIT
-
-	Check out and install a meson project
-
-	Options:
-	  -Dkey=val      Option to pass on to meson
-	  --prefix       Prefix to install to
-	  --subdir       Build subdirectory instead of whole project
-	  --prepare      Script to run before build
-
-	  -h, --help     Display this help
-
-	EOF
-}
-
-TEMP=$(getopt \
-  --name=$(basename $0) \
-  --options='D:h' \
-  --longoptions='prefix:' \
-  --longoptions='subdir:' \
-  --longoptions='prepare:' \
-  --longoptions='help' \
-  -- "$@")
-
-eval set -- "$TEMP"
-unset TEMP
-
-MESON_OPTIONS=()
-PREFIX=/usr
-SUBDIR=.
-PREPARE=:
-
-while true; do
-  case "$1" in
-    -D)
-      MESON_OPTIONS+=( -D$2 )
-      shift 2
-    ;;
-
-    --prefix)
-      PREFIX=$2
-      shift 2
-    ;;
-
-    --subdir)
-      SUBDIR=$2
-      shift 2
-    ;;
-
-    --prepare)
-      PREPARE=$2
-      shift 2
-    ;;
-
-    -h|--help)
-      usage
-      exit 0
-    ;;
-
-    --)
-      shift
-      break
-    ;;
-  esac
-done
-
-if [[ $# -lt 2 ]]; then
-  usage
-  exit 1
-fi
-
-REPO_URL="$1"
-COMMIT="$2"
-
-CHECKOUT_DIR=$(mktemp --directory)
-trap "rm -rf $CHECKOUT_DIR" EXIT
-
-git clone --depth 1 "$REPO_URL" -b "$COMMIT" "$CHECKOUT_DIR"
-
-pushd "$CHECKOUT_DIR/$SUBDIR"
-sh -c "$PREPARE"
-meson setup --prefix "$PREFIX" _build "${MESON_OPTIONS[@]}"
-meson compile -C _build
-meson install -C _build
-popd

.gitlab-ci/run-tests.sh

@@ -8,19 +8,17 @@ builddir=$1
 setup=$2
 suite=$3
 multiplier=${MESON_TEST_TIMEOUT_MULTIPLIER:-1}
-n_processes=${MESON_TEST_MAX_PROCESSES:-1}
 
 # Ignore memory leaks lower in dependencies
 export LSAN_OPTIONS=suppressions=$srcdir/lsan.supp:print_suppressions=0:detect_leaks=0:allocator_may_return_null=1
+export G_SLICE=always-malloc
 
 case "${setup}" in
   x11*)
-    dbus-run-session -- \
-       xvfb-run -a -s "-screen 0 1024x768x24 -noreset" \
+    xvfb-run -a -s "-screen 0 1024x768x24 -noreset" \
           meson test -C ${builddir} \
                 --quiet \
                 --timeout-multiplier "${multiplier}" \
-                --num-processes "${n_processes}" \
                 --print-errorlogs \
                 --setup=${setup} \
                 --suite=${suite//,/ --suite=} \
@@ -42,11 +40,9 @@ case "${setup}" in
     compositor=$!
     export WAYLAND_DISPLAY=wayland-5
 
-    dbus-run-session -- \
-          meson test -C ${builddir} \
+    meson test -C ${builddir} \
                 --quiet \
                 --timeout-multiplier "${multiplier}" \
-                --num-processes "${n_processes}" \
                 --print-errorlogs \
                 --setup=${setup} \
                 --suite=${suite//,/ --suite=} \
@@ -67,11 +63,9 @@ case "${setup}" in
     server=$!
     export BROADWAY_DISPLAY=:5
 
-    dbus-run-session -- \
-          meson test -C ${builddir} \
+    meson test -C ${builddir} \
                 --quiet \
                 --timeout-multiplier "${multiplier}" \
-                --num-processes "${n_processes}" \
                 --print-errorlogs \
                 --setup=${setup} \
                 --suite=${suite//,/ --suite=} \

CONTRIBUTING.md

@@ -100,16 +100,14 @@ development tools appropriate for your operating system, including:
  - Meson
  - Ninja
  - Gettext (19.7 or newer)
- - a [C99 compatible compiler][glib-toolchain-reqs]
+ - a [C99 compatible compiler](https://wiki.gnome.org/Projects/GLib/CompilerRequirements)
 
 Up-to-date instructions about developing GNOME applications and libraries
 can be found on [the GNOME Developer Center](https://developer.gnome.org).
 
 The GTK project uses GitLab for code hosting and for tracking issues. More
-information about using GitLab can be found on [the GNOME handbook][handbook].
-
-[glib-toolchain-reqs]: https://gitlab.gnome.org/GNOME/glib/-/blob/main/docs/toolchain-requirements.md
-[handbook]: https://handbook.gnome.org/infrastructure/gitlab.html
+information about using GitLab can be found [on the GNOME
+wiki](https://wiki.gnome.org/GitLab).
 
 ### Dependencies
 
@@ -133,7 +131,7 @@ GTK will attempt to download and build some of these dependencies if it
 cannot find them on your system.
 
 Additionally, you may want to look at projects that create a development
-environment for you, like [jhbuild](https://gitlab.gnome.org/GNOME/jhbuild)
+environment for you, like [jhbuild](https://wiki.gnome.org/HowDoI/Jhbuild)
 and [gvsbuild](https://github.com/wingtk/gvsbuild).
 
 ### Getting started

NEWS

@@ -1,490 +1,15 @@
-Overview of Changes in 4.16.1, 09-16-2024
+Overview of Changes in 4.15.0, xx-xx-xxxx
 =========================================
 
-* GtkFileChooser:
- - Plug a memory leak
-
-* GtkCalendar:
- - Avoid ending up with invalid dates
-
-* Printing:
- - Fix initial printer selection in the print dialog
-
-* Gsk:
- - Fix shadows for opaque textures
- - Fix a crash in a corner case
-
-* Css:
- - Make relative paths work again in theme files
-
-* Accessibility:
- - Fix detection of the Flatpak portal
-
-* MacOS:
- - Fix keyboard input in popovers
- - Keep DND icons above regular windows
- - Ignore events from DND icons
-
-* Translation updates
- Basque
- British English
- Bulgarian
- Czech
- Danish
- Georgian
- Hungarian
- Lithuanian
- Portuguese
- Spanish
- Swedish
-
-
-Overview of Changes in 4.16.0, 09-06-2024
-=========================================
-
-Note: This release changes the default GSK renderer to be Vulkan,
-on Wayland. Other platforms still use ngl. The intent of this change
-is to use the best available platform APIs. You can still override
-the renderer choice using the GSK_RENDERER environment variable.
-
-We believe that most of the problems reported with the new renderers
-during the 4.13 and 4.15 development cycles have been addressed by now.
-
-But the new renderers and dmabuf support are using graphics drivers
-in different ways than the old gl renderer, and trigger new driver bugs.
-Therefore, it is recommended to use the latest mesa release (24.2)
-with the new renderers.
-
-* GtkScale:
- - Fix positioning of scale values
-
-* GtkEmojiChooser:
- - Make Control-clicks work for the recent section
-
-* GtkPopover:
- - Make sure focus lands on the right widget when cascading
-
-* GtkSpinButton:
- - Disable Emoji input for numeric spin buttons
-
-* GtkSingleSelection:
- - Implement unselect_all
-
-* Accssibility:
- - Fix roles for radio buttons
- - Check if ATs are listening before exporting trees
- - Add a check for sandboxed accessibility bus
- - Fix handling of the error message relation
- - Turn criticals into debug messages
- - Set expanded states properly in menus
-
-* CSS:
- - Fix a few issues on bigendian systems
- - Avoid a crash with relative colors
-
-* GSK:
- - Use the right GL context when exporting textures
- - Don't let colors influence depth decisions
- - Allow uploading of mipmap levels when tiling textures
-
-* GDK:
- - Update keysyms from libX11 1.8.10
- - Implement cpu-side mipmapping
- - Use a thread pool for color conversions and mipmapping
-
-* Vulkan:
- - Fix drag surface offsets
-
-* Wayland:
- - Fix a crash
- - Associate EGL windows with context later
-
-* X11:
- - Fix initial EGL context creation
- - Fix a problem with GL context creation
-
-* Broadway:
- - Implement compute_size and request_layout
-
-* MacOS:
- - Set transparent backgroiund for toplevel windows
-
-* Windows:
- - Improve debug output
- - Detect Mesas d3d12 driver and request GDI compat
-
-* Demos:
- - Set window icons in demos
- - Add a 64k x 64k image to the image scaling demo
-
-* Translation updates
- Belarusian
- Brazilian Portuguese
- Catalan
- Czech
- Galician
- German
- Hebrew
- Indonesian
- Korean
- Lithuanian
- Persian
- Polish
- Portuguese
- Slovenian
- Spanish
- Turkish
- Ukrainian
-
-
-Overview of Changes in 4.15.6, 08-26-2024
-=========================================
-
-* GtkCheckButton:
- - Add a grouped style class for radio buttons
-
-* GtkScale:
- - Fix alignment and positioning problems
-
-* Css:
- - Fix crashes in the variable support
-
-* Gsk:
- - Make graphics offloading work better with kwin
- - Make colorstate transfer functions more robust
- - GC dead textures more agressively
- - Only use a single render pass per frame
-
-* GL:
- - Round damage rectangles properly
- - Use the shared context when creating textures
- - Fix a file descriptor leak in dmabuf export
-
-* Vulkan:
- - Round damage rectangles properly
-
-* Wayland:
- - Work with the kwin implementation of xx-color-management-v4
-
-* Windows:
- - Make gtk_show_uri use SHOpenWithDialog()
- - Enable incremental rendering with WGL
-
-* Macos:
- - Open context menus on Ctrl-left click
-
-* Debugging:
- - Show color state information in the inspector
- - Collect input event traces in the recorder
- - Add shortcuts for toggling recording: Super-r
-   and for screenshots: Super-c
- - Split the GDK_DEBUG env var into GDK_DEBUG and GDK_DISABLE
- - Add GDK_DISABLE=color-mgmt and GDK_DISABLE=offload
-
-* Tools:
- - Add a 'Paste as node' action in gtk4-node-editor
-
-* Translations updates
- Basque
- Belarusian
- Brazilian Portuguese
- Chinese (China)
- Georgian
- Hebrew
- Hindi
- Russian
- Slovenian
- Turkish
- Ukrainian
-
-
-Overview of Changes in 4.15.5, 11-08-2024
-=========================================
-
-* GtkTextView:
- - ADd GtkTextBufferCommitNotify
-
-* CSS:
- - Propagate color state information to GSK for many features:
-   colors, borders, shadows, text
-
-* Gdk:
- - Fix an fd leak in the Vulkan code
- - Fix a leak of EGLSurfaces and DMA buffers
- - Set the opaque region of surfaces automatically based on their content
-
-* Gsk:
- - Fix Emoji rendering in Vulkan
- - Rework color handling to take color states into account
- - Implement more powerful occlusion culling
- - Minimize our use of renderpasses
-
-* Macos:
- - Fix window transparency
-
-* Debugging:
- - The inspector shows details about color states
-
-* Deprecations:
- - gdk_draw_context_begin/end_frame
- - gdk_surface_set_opaque_region
-
-* Build:
- - Require gstreamer 1.24
-
-* Translation updates
- Romanian
-
-
-Overview of Changes in 4.15.4, 30-07-2024
-=========================================
-
-* GtkPopover:
- - Fix size allocation with wrapping labels
-
-* GtkColumnView:
- - Check column visibility when measuring
-
-* CSS:
- - Fix fallout from recent changes
- - Make implementation of currentcolor inheritance match browsers
-
-* Gdk:
- - Introduce GdkColorState for encoding color space information
-   Currently, we support srgb, srgb-linear, rec2100-pq and rec2100-linear
- - Add color states to GdkTexture, as well as to the texture builder
-   and downloader objects, and convert as necessary
- - Add GdkMemoryTextureBuilder
- - Attach color states when loading or saving textures
- - Add GdkCicpParams to create color state objects for cicp tuples
- - Drop GDK_DEBUG=vulkan-validate
-   Use VK_INSTEANCE_LAYERS=VK_LAYER_KHRONOS_validation instead
-
-* Gsk:
- - Improve caching of glyphs and textures
- - Remove the uber shader
- - Numerous bug fixes
- - Fix corner cases in offload handling
- - Implement occlusion culling for opaque content
- - Allow offloading (some) transformed textures
- - Take colorstate into account when compositing
- - Add GDK_DEBUG=linear to opt into linear compositing
- - Implement tiling for large textures
- - Stop using descriptors and go back to simpler texture
-   management that should work better with older GL
- - Use correct shader clip mode for glyphs
- - Improve shadow rendering
-
-* Media:
- - Attach color states to textures obtained from gstreamer
-
-* Wayland:
- - Allow offloading GL textures via dmabuf export
- - Suppot the xx-color-management-v4 protocol
-
-* Deprecations:
- - GskGLShader and the render node
-
-* Tools:
- - Improve the rendernode tool extract command
- - Add an image tool that is about manipulating textures
-
-* Build:
- - GTK now requires a C11 compiler
-
-* Translation updates
- Georgian
- Hebrew
- Hindi
- Occitan
- Slovenian
-
-
-Overview of Changes in 4.15.3, 29-06-2024
-=========================================
-
-* Accessibility:
- - Only emit notifications when cursor positions change in GtkText
- - Fix handling of help text properties
-
-* CSS:
- - Fix some crashes introduced in recent currentcolor changes
-
-* DND:
- - Avoid a critical
-
-* Documentation:
- - Fix many oversights and missing docs
-
-* maxOS:
- - Add native keyboard shortcuts
-
-
-Overview of Changes in 4.15.2, 28-06-2024
-=========================================
-
-* GtkFileChooserWidget:
- - Plug some memory leaks
- - Make Ctrl-Shift-N create a new folder
-
-* GtkPopover:
- - Handle resizing and position changes better
-
-* CSS:
- - Support color(), oklab(), etc (https://www.w3.org/TR/css-color-4/)
- - Support color-mix() (https://www.w3.org/TR/css-color-5/)
- - Support relative colors (https://www.w3.org/TR/css-color-5/)
- - Support more colorspaces in color()
- - Allow percentages for opacity
- - Handle currentcolor more correctly
-
-* Accessibility:
- - Avoid markup when reading labels
-
-* GSK:
- - Subset fonts when serializing node trees
- - Make ngl export render_texture results as dmabufs
-
-* Wayland:
- - Use xdg-dialog protocol for attached dialogs
-
-* Windows:
- - Build with UNICODE
-
-* macOS:
- - Implement fullscreen-on-monitor
-
-* Documentation:
- - Widget shortcuts and actions are now described in the docs
-
-* Debugging:
- - Add GTK_DEBUG=css for warning about deprecated css syntax
-
-* Tools:
- - rendernode-tool: Add an extract command for data urls
-
-* Deprecations:
- - CSS Color functions shade(), lighter(), darker(), alpha(), mix()
-
-* Translation updates:
- Czech
- Hebrew
- Serbian
-
-
-Overview of Changes in 4.15.1, 21-05-2024
-=========================================
-
-* GtkGraphicsOffload:
- - Don't crash without a child
-
-* GtkSpinner:
- - Don't animate when unmapped
-
-* CSS:
- - Support the :root selector
- - Support variables and custom properties (https://www.w3.org/TR/css-variables-1/)
- - Implement math functions (https://www.w3.org/TR/css-values-4/)
- - Support modern syntax and calc in rgb() and hsl()
-
-* Icontheme:
- - Make symbolic svg loading more efficient
- - Handle color-free symbolics more efficiently
-
-* Accessibility:
- - Make the gtk-demo sidebar search more accessible
- - Stop emitting focus events
- - Realize child contexts when necessary
-
-* GDK:
- - Support XDG_ACTIVATION_TOKEN
- - dmabuf: Be more defensive when importing unknown formats to GL
- - dmabuf: Use narrow range for YUV
- - vulkan: Recreate swapchains when necessary or beneficial
-
-* GSK:
- - Improve logging for GDK_DEBUG=offload
- - Improve logging for GSK_DEBUG=renderer
- - gpu: Warn about inefficient texture import
- - gpu: Handle tiny offscreens correctly
- - vulkan: Add profiler marks in various places
- - vulkan: Fix a problem with imported dmabufs showing up black
- - cairo: Speed up mask nodes, since we use them for symbolic icons
-
-* Wayland:
- - Use wl_compositor version 6
-
-* X11:
- - Implement a missing method
-
-* Build:
- - Fix many ubsan warnings
-
-* Debugging:
- - Show more texture details in the recorder
- - Use GTK_DEBUG=css to see CSS deprecations
-
-* macOS:
- - Fix problems with events handed back to the OS
- - Respect GDK_DEBUG=default-settings
- - Allow applictions to handle Dock > Quit
-
-* Deprecations:
- - Use of @name colors in CSS
-
-* Translation updates:
- Catalan
- Georgian
- Hungarian
- Korean
- Portuguese
- Turkish
-
-
-Overview of Changes in 4.15.0, 21-04-2024
-=========================================
-
-This release changes the default GSK renderer to be Vulkan, on
-Wayland. Other platforms still use ngl.
-
-The intent of this change is to get wider testing and verify that
-Vulkan drivers are good enough for us to rely on. If significant
-problems show up, we will revert this change for 4.16.
-
-You can still override the renderer choice using the GSK_RENDERER
-environment variable.
-
----
-
-This release also changes font rendering settings by introducing
-a new high-level gtk-font-rendering settings which gives GTK more
-freedom to decide on font rendering.
-
-You can still use the low-level font-related settings by changing
-the new property to 'manual'.
-
----
-
-* GtkColumnView:
- - Fix infinite loops in dispose
- - Fix problems with weak ref cycles in GtkExpression
-
-* GtkListView:
 * GtkShortcutManager:
  - Track the propagation phase of added controllers
 
 * GtkGLArea:
  - Produce dmabuf textures, so graphics offload is possible
 
-* GtkTextView:
- - Support text shadows
-
 * GtkGraphicsOffload:
  - Add a black-background property
 
-* Settings:
- - Add a new gtk-font-rendering setting
-
 * Accessibility:
  - Add support for GetRangeExtents to GtkAccessibleText
  - Add support for GetOffsetAtPoint to GtkAccessibleText
@@ -494,7 +19,6 @@ the new property to 'manual'.
  - Add a callback-based cursor API
 
 * GSK:
--  Use the Vulkan renderer by default
  - Avoid an infinite recursion with offscreens in some cases
  - Optimize graphics offload to make it more likely that compositors
    can use direct scanout
@@ -521,20 +45,13 @@ the new property to 'manual'.
  - Require pango 1.52
  - Require cairo 1.18
  - Add a missing dependency that was causing build failures
- - Drop deprecated build options:
-   gtk_doc -> documentation
-   update_screenshots -> screenshots
-   demo-profile -> profile
-   demos -> build-demos
 
 * Deprecations:
  - gdk_widget_set/get_font_options
- - gdk_wayland/x11_display_set_cursor_theme
 
 * Translation updates:
  Basque
  Brazilian Portuguese
- British English
  Chinese (China)
  Hebrew
  Kabyle

README.md

@@ -39,21 +39,18 @@ Nightly documentation can be found at
   - Gsk: https://gnome.pages.gitlab.gnome.org/gtk/gsk4/
 
 Nightly flatpaks of our demos can be installed from the
-[GNOME Nightly](https://nightly.gnome.org/) repository:
-
-```sh
-flatpak remote-add --if-not-exists gnome-nightly https://nightly.gnome.org/gnome-nightly.flatpakrepo
-flatpak install gnome-nightly org.gtk.Demo4
-flatpak install gnome-nightly org.gtk.WidgetFactory4
-flatpak install gnome-nightly org.gtk.IconBrowser4
-```
+[GNOME Nightly](https://wiki.gnome.org/Apps/Nightly) repository:
+  - `flatpak remote-add --if-not-exists gnome-nightly https://nightly.gnome.org/gnome-nightly.flatpakrepo`
+  - `flatpak install gnome-nightly org.gtk.Demo4`
+  - `flatpak install gnome-nightly org.gtk.WidgetFactory4`
+  - `flatpak install gnome-nightly org.gtk.IconBrowser4`
 
 Building and installing
 -----------------------
 
 In order to build GTK you will need:
 
-  - [a C11 compatible compiler](https://gitlab.gnome.org/GNOME/glib/-/blob/main/docs/toolchain-requirements.md)
+  - [a C99 compatible compiler](https://wiki.gnome.org/Projects/GLib/CompilerRequirements)
   - [Python 3](https://www.python.org/)
   - [Meson](http://mesonbuild.com)
   - [Ninja](https://ninja-build.org)

build-aux/flatpak/org.gtk.Demo4.json

@@ -186,7 +186,7 @@
             "config-opts" : [
                 "--libdir=/app/lib",
                 "-Dbuildtype=debugoptimized",
-                "-Dprofile=devel"
+                "-Ddemo-profile=devel"
             ],
             "sources" : [
                 {

build-aux/flatpak/org.gtk.IconBrowser4.json

@@ -115,7 +115,7 @@
             "config-opts" : [
                 "--libdir=/app/lib",
                 "-Dbuildtype=debugoptimized",
-                "-Dprofile=devel"
+                "-Ddemo-profile=devel"
             ],
             "sources" : [
                 {

build-aux/flatpak/org.gtk.WidgetFactory4.json

@@ -115,7 +115,7 @@
             "config-opts" : [
                 "--libdir=/app/lib",
                 "-Dbuildtype=debugoptimized",
-                "-Dprofile=devel"
+                "-Ddemo-profile=devel"
             ],
             "sources" : [
                 {

build-aux/flatpak/org.gtk.gtk4.NodeEditor.json

@@ -115,7 +115,7 @@
             "config-opts" : [
                 "--libdir=/app/lib",
                 "-Dbuildtype=debugoptimized",
-                "-Dprofile=devel"
+                "-Ddemo-profile=devel"
             ],
             "sources" : [
                 {

demos/gtk-demo/demo.gresource.xml

@@ -454,9 +454,6 @@
     <file>icons/16x16/categories/applications-other.png</file>
     <file>icons/48x48/status/starred.png</file>
     <file alias="icons/scalable/apps/org.gtk.Demo4.svg">data/scalable/apps/org.gtk.Demo4.svg</file>
-    <file>portland-rose-thumbnail.png</file>
-    <file>large-image-thumbnail.png</file>
-    <file compressed="true">large-image.png</file>
   </gresource>
   <gresource prefix="/org/gtk/Demo4/gtk">
     <file preprocess="xml-stripblanks">help-overlay.ui</file>

demos/gtk-demo/errorstates.c

@@ -55,7 +55,7 @@ mode_switch_state_set (GtkSwitch *sw,
     {
       gtk_widget_set_visible (label, TRUE);
       gtk_accessible_update_relation (GTK_ACCESSIBLE (sw),
-                                      GTK_ACCESSIBLE_RELATION_ERROR_MESSAGE, label, NULL,
+                                      GTK_ACCESSIBLE_RELATION_ERROR_MESSAGE, label,
                                       -1);
       gtk_accessible_update_state (GTK_ACCESSIBLE (sw),
                                    GTK_ACCESSIBLE_STATE_INVALID, GTK_ACCESSIBLE_INVALID_TRUE,

demos/gtk-demo/fishbowl.c

@@ -170,7 +170,6 @@ update_paintable (GtkWidget     *widget,
 static GtkWidget *
 create_cogs (void)
 {
-G_GNUC_BEGIN_IGNORE_DEPRECATIONS
   GtkWidget *picture;
   static GskGLShader *cog_shader = NULL;
   GdkPaintable *paintable;
@@ -183,7 +182,6 @@ G_GNUC_BEGIN_IGNORE_DEPRECATIONS
   gtk_widget_add_tick_callback (picture, update_paintable, NULL, NULL);
 
   return picture;
-G_GNUC_END_IGNORE_DEPRECATIONS
 }
 
 static gboolean

demos/gtk-demo/fontify.c

@@ -363,9 +363,7 @@ insert_markup_idle (gpointer data)
 
       if (g_get_monotonic_time () - begin > G_TIME_SPAN_MILLISECOND)
         {
-          guint id;
-          id = g_idle_add (insert_markup_idle, data);
-          g_source_set_name_by_id (id, "[gtk-demo] insert_markup_idle");
+          g_idle_add (insert_markup_idle, data);
           return G_SOURCE_REMOVE;
         }
 
@@ -400,9 +398,7 @@ parse_markup_idle (gpointer data)
   do {
     if (g_get_monotonic_time () - begin > G_TIME_SPAN_MILLISECOND)
       {
-        guint id;
-        id = g_idle_add (parse_markup_idle, data);
-        g_source_set_name_by_id (id, "[gtk-demo] parse_markup_idle");
+        g_idle_add (parse_markup_idle, data);
         return G_SOURCE_REMOVE;
       }
 

demos/gtk-demo/gltransition.c

@@ -20,8 +20,6 @@
 #include "gtkshadertoy.h"
 #include "gskshaderpaintable.h"
 
-G_GNUC_BEGIN_IGNORE_DEPRECATIONS
-
 static GtkWidget *demo_window = NULL;
 
 static void
@@ -362,5 +360,3 @@ do_gltransition (GtkWidget *do_widget)
 
   return demo_window;
 }
-
-G_GNUC_END_IGNORE_DEPRECATIONS

demos/gtk-demo/gskshaderpaintable.c

@@ -22,8 +22,6 @@
 #include <gtk/gtk.h>
 #include "gskshaderpaintable.h"
 
-G_GNUC_BEGIN_IGNORE_DEPRECATIONS
-
 /**
  * GskShaderPaintable:
  *
@@ -334,5 +332,3 @@ gsk_shader_paintable_update_time (GskShaderPaintable *self,
 
   g_bytes_unref (args);
 }
-
-G_GNUC_END_IGNORE_DEPRECATIONS

demos/gtk-demo/gskshaderpaintable.h

@@ -22,8 +22,6 @@
 #include <gdk/gdk.h>
 #include <gsk/gsk.h>
 
-G_GNUC_BEGIN_IGNORE_DEPRECATIONS
-
 G_BEGIN_DECLS
 
 #define GSK_TYPE_SHADER_PAINTABLE (gsk_shader_paintable_get_type ())
@@ -43,5 +41,3 @@ void             gsk_shader_paintable_update_time      (GskShaderPaintable *self
                                                         int                 time_idx,
                                                         gint64              frame_time);
 G_END_DECLS
-
-G_GNUC_END_IGNORE_DEPRECATIONS

demos/gtk-demo/gtkshaderbin.c

@@ -1,7 +1,5 @@
 #include "gtkshaderbin.h"
 
-G_GNUC_BEGIN_IGNORE_DEPRECATIONS
-
 typedef struct {
   GskGLShader *shader;
   GtkStateFlags state;
@@ -264,5 +262,3 @@ gtk_shader_bin_new (void)
 
   return GTK_WIDGET (self);
 }
-
-G_GNUC_END_IGNORE_DEPRECATIONS

demos/gtk-demo/gtkshaderbin.h

@@ -2,8 +2,6 @@
 
 #include <gtk/gtk.h>
 
-G_GNUC_BEGIN_IGNORE_DEPRECATIONS
-
 G_BEGIN_DECLS
 
 #define GTK_TYPE_SHADER_BIN      (gtk_shader_bin_get_type ())
@@ -20,5 +18,3 @@ void       gtk_shader_bin_set_child   (GtkShaderBin *self,
 GtkWidget *gtk_shader_bin_get_child   (GtkShaderBin *self);
 
 G_END_DECLS
-
-G_GNUC_END_IGNORE_DEPRECATIONS

demos/gtk-demo/gtkshaderstack.c

@@ -1,7 +1,5 @@
 #include "gtkshaderstack.h"
 
-G_GNUC_BEGIN_IGNORE_DEPRECATIONS
-
 struct _GtkShaderStack
 {
   GtkWidget parent_instance;
@@ -361,5 +359,3 @@ gtk_shader_stack_set_active (GtkShaderStack *self,
   self->current = MIN (index, self->children->len);
   update_child_visible (self);
 }
-
-G_GNUC_END_IGNORE_DEPRECATIONS

demos/gtk-demo/gtkshaderstack.h

@@ -2,8 +2,6 @@
 
 #include <gtk/gtk.h>
 
-G_GNUC_BEGIN_IGNORE_DEPRECATIONS
-
 G_BEGIN_DECLS
 
 #define GTK_TYPE_SHADER_STACK     (gtk_shader_stack_get_type ())
@@ -20,5 +18,3 @@ void        gtk_shader_stack_set_active   (GtkShaderStack *self,
                                            int             index);
 
 G_END_DECLS
-
-G_GNUC_END_IGNORE_DEPRECATIONS

demos/gtk-demo/image_scaling.c

@@ -14,103 +14,6 @@
 #include <gtk/gtk.h>
 #include "demo3widget.h"
 
-static GtkWidget *window = NULL;
-static GCancellable *cancellable = NULL;
-
-static void
-load_texture (GTask        *task,
-              gpointer      source_object,
-              gpointer      task_data,
-              GCancellable *cable)
-{
-  GFile *file = task_data;
-  GdkTexture *texture;
-  GError *error = NULL;
-
-  texture = gdk_texture_new_from_file (file, &error);
-
-  if (texture)
-    g_task_return_pointer (task, texture, g_object_unref);
-  else
-    g_task_return_error (task, error);
-}
-
-static void
-set_wait_cursor (GtkWidget *widget)
-{
-  gtk_widget_set_cursor_from_name (GTK_WIDGET (gtk_widget_get_root (widget)), "wait");
-}
-
-static void
-unset_wait_cursor (GtkWidget *widget)
-{
-  gtk_widget_set_cursor (GTK_WIDGET (gtk_widget_get_root (widget)), NULL);
-}
-
-static void
-texture_loaded (GObject      *source,
-                GAsyncResult *result,
-                gpointer      data)
-{
-  GdkTexture *texture;
-  GError *error = NULL;
-
-  texture = g_task_propagate_pointer (G_TASK (result), &error);
-
-  if (!texture)
-    {
-      g_print ("%s\n", error->message);
-      g_error_free (error);
-      return;
-    }
-
-  if (!window)
-    {
-      g_object_unref (texture);
-      return;
-    }
-
-  unset_wait_cursor (GTK_WIDGET (data));
-
-  g_object_set (G_OBJECT (data), "texture", texture, NULL);
-}
-
-static void
-open_file_async (GFile     *file,
-                 GtkWidget *demo)
-{
-  GTask *task;
-
-  set_wait_cursor (demo);
-
-  task = g_task_new (demo, cancellable, texture_loaded, demo);
-  g_task_set_task_data (task, g_object_ref (file), g_object_unref);
-  g_task_run_in_thread (task, load_texture);
-  g_object_unref (task);
-}
-
-static void
-open_portland_rose (GtkWidget *button,
-                    GtkWidget *demo)
-{
-  GFile *file;
-
-  file = g_file_new_for_uri ("resource:///transparent/portland-rose.jpg");
-  open_file_async (file, demo);
-  g_object_unref (file);
-}
-
-static void
-open_large_image (GtkWidget *button,
-                  GtkWidget *demo)
-{
-  GFile *file;
-
-  file = g_file_new_for_uri ("resource:///org/gtk/Demo4/large-image.png");
-  open_file_async (file, demo);
-  g_object_unref (file);
-}
-
 static void
 file_opened (GObject      *source,
              GAsyncResult *result,
@@ -118,6 +21,7 @@ file_opened (GObject      *source,
 {
   GFile *file;
   GError *error = NULL;
+  GdkTexture *texture;
 
   file = gtk_file_dialog_open_finish (GTK_FILE_DIALOG (source), result, &error);
 
@@ -128,9 +32,17 @@ file_opened (GObject      *source,
       return;
     }
 
-  open_file_async (file, data);
-
+  texture = gdk_texture_new_from_file (file, &error);
   g_object_unref (file);
+  if (!texture)
+    {
+      g_print ("%s\n", error->message);
+      g_error_free (error);
+      return;
+    }
+
+  g_object_set (G_OBJECT (data), "texture", texture, NULL);
+  g_object_unref (texture);
 }
 
 static void
@@ -204,26 +116,11 @@ transform_from (GBinding     *binding,
   return TRUE;
 }
 
-static void
-free_cancellable (gpointer data)
-{
-  g_cancellable_cancel (cancellable);
-  g_clear_object (&cancellable);
-}
-
-static gboolean
-cancel_load (GtkWidget *widget,
-             GVariant  *args,
-             gpointer   data)
-{
-  unset_wait_cursor (widget);
-  g_cancellable_cancel (G_CANCELLABLE (data));
-  return TRUE;
-}
-
 GtkWidget *
 do_image_scaling (GtkWidget *do_widget)
 {
+  static GtkWidget *window = NULL;
+
   if (!window)
     {
       GtkWidget *box;
@@ -233,7 +130,6 @@ do_image_scaling (GtkWidget *do_widget)
       GtkWidget *scale;
       GtkWidget *dropdown;
       GtkWidget *button;
-      GtkEventController *controller;
 
       window = gtk_window_new ();
       gtk_window_set_title (GTK_WINDOW (window), "Image Scaling");
@@ -242,20 +138,6 @@ do_image_scaling (GtkWidget *do_widget)
                               gtk_widget_get_display (do_widget));
       g_object_add_weak_pointer (G_OBJECT (window), (gpointer *)&window);
 
-      cancellable = g_cancellable_new ();
-      g_object_set_data_full (G_OBJECT (window), "cancellable",
-                              cancellable, free_cancellable);
-
-      controller = gtk_shortcut_controller_new ();
-      gtk_shortcut_controller_add_shortcut (GTK_SHORTCUT_CONTROLLER (controller),
-                                            gtk_shortcut_new (
-                                                gtk_keyval_trigger_new (GDK_KEY_Escape, 0),
-                                                gtk_callback_action_new (cancel_load, cancellable, NULL)
-                                                ));
-      gtk_shortcut_controller_set_scope (GTK_SHORTCUT_CONTROLLER (controller),
-                                         GTK_SHORTCUT_SCOPE_GLOBAL);
-      gtk_widget_add_controller (window, controller);
-
       box = gtk_box_new (GTK_ORIENTATION_VERTICAL, 0);
       gtk_window_set_child (GTK_WINDOW (window), box);
 
@@ -274,22 +156,6 @@ do_image_scaling (GtkWidget *do_widget)
       g_signal_connect (button, "clicked", G_CALLBACK (open_file), widget);
       gtk_box_append (GTK_BOX (box2), button);
 
-      button = gtk_button_new ();
-      gtk_button_set_child (GTK_BUTTON (button),
-                            gtk_image_new_from_resource ("/org/gtk/Demo4/portland-rose-thumbnail.png"));
-      gtk_widget_add_css_class (button, "image-button");
-      gtk_widget_set_tooltip_text (button, "Portland Rose");
-      g_signal_connect (button, "clicked", G_CALLBACK (open_portland_rose), widget);
-      gtk_box_append (GTK_BOX (box2), button);
-
-      button = gtk_button_new ();
-      gtk_button_set_child (GTK_BUTTON (button),
-                            gtk_image_new_from_resource ("/org/gtk/Demo4/large-image-thumbnail.png"));
-      gtk_widget_add_css_class (button, "image-button");
-      gtk_widget_set_tooltip_text (button, "Large image");
-      g_signal_connect (button, "clicked", G_CALLBACK (open_large_image), widget);
-      gtk_box_append (GTK_BOX (box2), button);
-
       button = gtk_button_new_from_icon_name ("object-rotate-right-symbolic");
       gtk_widget_set_tooltip_text (button, "Rotate");
       g_signal_connect (button, "clicked", G_CALLBACK (rotate), widget);
@@ -325,9 +191,7 @@ do_image_scaling (GtkWidget *do_widget)
   if (!gtk_widget_get_visible (window))
     gtk_widget_set_visible (window, TRUE);
   else
-    {
-      gtk_window_destroy (GTK_WINDOW (window));
-    }
+    gtk_window_destroy (GTK_WINDOW (window));
 
   return window;
 }

demos/gtk-demo/language-names.c

@@ -40,7 +40,7 @@ get_win32_all_locales_scripts (LPWSTR locale_w, DWORD flags, LPARAM param)
 {
   wchar_t *langname_w = NULL;
   wchar_t locale_abbrev_w[9];
-  gchar *langname, *locale_abbrev, *locale;
+  gchar *langname, *locale_abbrev, *locale, *p;
   gint i;
   const LCTYPE iso639_lctypes[] = { LOCALE_SISO639LANGNAME, LOCALE_SISO639LANGNAME2 };
   GHashTable *ht_scripts_langs = (GHashTable *) param;
@@ -59,6 +59,7 @@ get_win32_all_locales_scripts (LPWSTR locale_w, DWORD flags, LPARAM param)
   GetLocaleInfoEx (locale_w, LOCALE_SLOCALIZEDDISPLAYNAME, langname_w, langname_size);
   langname = g_utf16_to_utf8 (langname_w, -1, NULL, NULL, NULL);
   locale = g_utf16_to_utf8 (locale_w, -1, NULL, NULL, NULL);
+  p = strchr (locale, '-');
   lang = pango_language_from_string (locale);
   if (g_hash_table_lookup (ht_scripts_langs, lang) == NULL)
     g_hash_table_insert (ht_scripts_langs, lang, langname);

demos/gtk-demo/main.c

@@ -20,7 +20,6 @@
 #include "config.h"
 #include <gtk/gtk.h>
 #include <glib/gstdio.h>
-#include <glib/gi18n.h>
 
 #include "demos.h"
 #include "fontify.h"
@@ -924,34 +923,6 @@ clear_search (GtkSearchBar *bar)
     }
 }
 
-static void
-search_results_update (GObject    *filter_model,
-                       GParamSpec *pspec,
-                       GtkEntry   *entry)
-{
-  gsize n_items = g_list_model_get_n_items (G_LIST_MODEL (filter_model));
-
-  if (strlen (gtk_editable_get_text (GTK_EDITABLE (entry))) > 0)
-    {
-      char *text;
-
-      if (n_items > 0)
-        text = g_strdup_printf (ngettext ("%ld search result", "%ld search results", (long) n_items), (long) n_items);
-      else
-        text = g_strdup (_("No search results"));
-
-      gtk_accessible_update_property (GTK_ACCESSIBLE (entry),
-                                      GTK_ACCESSIBLE_PROPERTY_DESCRIPTION, text,
-                                      -1);
-
-      g_free (text);
-    }
-  else
-    {
-      gtk_accessible_reset_property (GTK_ACCESSIBLE (entry), GTK_ACCESSIBLE_PROPERTY_DESCRIPTION);
-    }
-}
-
 static void
 activate (GApplication *app)
 {
@@ -999,7 +970,6 @@ activate (GApplication *app)
 
   search_entry = GTK_WIDGET (gtk_builder_get_object (builder, "search-entry"));
   g_signal_connect (search_entry, "search-changed", G_CALLBACK (demo_search_changed_cb), filter);
-  g_signal_connect (filter_model, "notify::n-items", G_CALLBACK (search_results_update), search_entry);
 
   selection = gtk_single_selection_new (G_LIST_MODEL (filter_model));
   g_signal_connect (selection, "notify::selected-item", G_CALLBACK (selection_cb), NULL);
@@ -1068,8 +1038,6 @@ command_line (GApplication            *app,
 
   window = gtk_application_get_windows (GTK_APPLICATION (app))->data;
 
-  gtk_window_set_icon_name (GTK_WINDOW (window), "org.gtk.Demo4");
-
   if (name == NULL)
     goto out;
 

demos/gtk-demo/path_fill.c

@@ -225,8 +225,7 @@ print_ready (GObject      *source,
 
   if (!g_output_stream_close (stream, NULL, &error))
     {
-      if (!g_error_matches (error, GTK_DIALOG_ERROR, GTK_DIALOG_ERROR_DISMISSED))
-        g_print ("Error from close: %s\n", error->message);
+      g_print ("Error from close: %s\n", error->message);
       g_error_free (error);
     }
 

demos/icon-browser/iconbrowserapp.c

@@ -139,8 +139,6 @@ icon_browser_app_activate (GApplication *app)
   if (g_strcmp0 (PROFILE, "devel") == 0)
     gtk_widget_add_css_class (GTK_WIDGET (win), "devel");
 
-  gtk_window_set_icon_name (GTK_WINDOW (win), "org.gtk.IconBrowser4");
-
   gtk_window_present (GTK_WINDOW (win));
 }
 

demos/node-editor/node-editor-application.c

@@ -219,8 +219,6 @@ node_editor_application_activate (GApplication *app)
   if (g_strcmp0 (PROFILE, "devel") == 0)
     gtk_widget_add_css_class (GTK_WIDGET (win), "devel");
 
-  gtk_window_set_icon_name (GTK_WINDOW (win), "org.gtk.gtk4.NodeEditor");
-
   gtk_window_present (GTK_WINDOW (win));
 }
 
@@ -301,7 +299,7 @@ node_editor_application_new (void)
 
   app = g_object_new (NODE_EDITOR_APPLICATION_TYPE,
                       "application-id", "org.gtk.gtk4.NodeEditor",
-                      "flags", G_APPLICATION_HANDLES_OPEN | G_APPLICATION_NON_UNIQUE,
+                      "flags", G_APPLICATION_HANDLES_OPEN,
                       NULL);
 
   g_application_add_main_option (G_APPLICATION (app), "version", 0, 0,G_OPTION_ARG_NONE, "Show program version", NULL);

demos/node-editor/node-editor-window.c

@@ -1205,19 +1205,6 @@ node_editor_window_add_renderer (NodeEditorWindow *self,
   g_object_unref (paintable);
 }
 
-static void
-update_paste_action (GdkClipboard *clipboard,
-                     GParamSpec   *pspec,
-                     gpointer      data)
-{
-  GtkWidget *widget = GTK_WIDGET (data);
-  gboolean has_node;
-
-  has_node = gdk_content_formats_contain_mime_type (gdk_clipboard_get_formats (clipboard), "application/x-gtk-render-node");
-
-  gtk_widget_action_set_enabled (widget, "paste-node", has_node);
-}
-
 static void
 node_editor_window_realize (GtkWidget *widget)
 {
@@ -1255,7 +1242,6 @@ node_editor_window_realize (GtkWidget *widget)
   self->after_paint_handler = g_signal_connect (frameclock, "after-paint",
                                                 G_CALLBACK (after_paint), self);
 
-  g_signal_connect (gtk_widget_get_clipboard (widget), "notify::formats", G_CALLBACK (update_paste_action), widget);
 }
 
 static void
@@ -1265,8 +1251,6 @@ node_editor_window_unrealize (GtkWidget *widget)
   GdkFrameClock *frameclock;
   guint i;
 
-  g_signal_handlers_disconnect_by_func (gtk_widget_get_clipboard (widget), update_paste_action, widget);
-
   frameclock = gtk_widget_get_frame_clock (widget);
   g_signal_handler_disconnect (frameclock, self->after_paint_handler);
   self->after_paint_handler = 0;
@@ -1631,41 +1615,6 @@ edit_action_cb (GtkWidget  *widget,
   node_editor_window_edit (self, &start);
 }
 
-static void
-text_received (GObject      *source,
-               GAsyncResult *result,
-               gpointer      data)
-{
-  GdkClipboard *clipboard = GDK_CLIPBOARD (source);
-  NodeEditorWindow *self = NODE_EDITOR_WINDOW (data);
-  char *text;
-
-  text = gdk_clipboard_read_text_finish (clipboard, result, NULL);
-  if (text)
-    {
-      GtkTextBuffer *buffer;
-      GtkTextIter start, end;
-
-      buffer = gtk_text_view_get_buffer (GTK_TEXT_VIEW (self->text_view));
-      gtk_text_buffer_begin_user_action (buffer);
-      gtk_text_buffer_get_bounds (buffer, &start, &end);
-      gtk_text_buffer_delete (buffer, &start, &end);
-      gtk_text_buffer_insert (buffer, &start, text, -1);
-      gtk_text_buffer_end_user_action (buffer);
-      g_free (text);
-    }
-}
-
-static void
-paste_node_cb (GtkWidget  *widget,
-               const char *action_name,
-               GVariant   *parameter)
-{
-  GdkClipboard *clipboard = gtk_widget_get_clipboard (widget);
-
-  gdk_clipboard_read_text_async (clipboard, NULL, text_received, widget);
-}
-
 static void
 node_editor_window_set_property (GObject      *object,
                                  guint         prop_id,
@@ -1778,13 +1727,6 @@ node_editor_window_class_init (NodeEditorWindowClass *class)
   action = gtk_named_action_new ("smart-edit");
   shortcut = gtk_shortcut_new (trigger, action);
   gtk_widget_class_add_shortcut (widget_class, shortcut);
-
-  gtk_widget_class_install_action (widget_class, "paste-node", NULL, paste_node_cb);
-
-  trigger = gtk_keyval_trigger_new (GDK_KEY_v, GDK_CONTROL_MASK | GDK_SHIFT_MASK);
-  action = gtk_named_action_new ("paste-node");
-  shortcut = gtk_shortcut_new (trigger, action);
-  gtk_widget_class_add_shortcut (widget_class, shortcut);
 }
 
 static GtkWidget *

demos/node-editor/node-editor-window.ui

@@ -22,10 +22,6 @@
   </menu>
   <menu id="extra_menu">
     <section>
-      <item>
-        <attribute name="label" translatable="yes">Paste _Node</attribute>
-        <attribute name="action">paste-node</attribute>
-      </item>
       <item>
         <attribute name="label" translatable="yes">Assisted _Edit</attribute>
         <attribute name="action">smart-edit</attribute>

demos/node-editor/node-editor.gresource.xml

@@ -3,7 +3,7 @@
   <gresource prefix="/org/gtk/gtk4/node-editor">
     <file preprocess="xml-stripblanks">node-editor-window.ui</file>
     <file preprocess="xml-stripblanks">help-window.ui</file>
-    <file alias='node-format.md'>../../docs/reference/gtk/node-format.md</file>
+    <file>node-format.md</file>
     <file alias='icons/apps/org.gtk.gtk4.NodeEditor.svg'>data/scalable/apps/org.gtk.gtk4.NodeEditor.svg</file>
   </gresource>
 </gresources>

demos/node-editor/node-format.md

@@ -1,15 +1,13 @@
-Title: The Node file format
+# The Node file format
 
 GSK render nodes can be serialized and deserialized using APIs such as `gsk_render_node_serialize()` and `gsk_render_node_deserialize()`. The intended use for this is development - primarily the development of GTK - by allowing things such as creating testsuites and benchmarks, exchanging nodes in bug reports. GTK includes the `gtk4-node-editor` application for creating such test files.
 
 The format is a text format that follows the [CSS syntax rules](https://drafts.csswg.org/css-syntax-3/). In particular, this means that every array of bytes will produce a render node when parsed, as there is a defined error recovery method. For more details on error handling, please refer to the documentation of the parsing APIs.
 
 The grammar of a node text representation using [the CSS value definition syntax](https://drafts.csswg.org/css-values-3/#value-defs) looks like this:
-
-    document: <@-rule>*<node>
-    @-rule: @cicp "name" { <property>* }
-    node: container [ "name" ] { <document> } | <node-type> [ "name" ] { <property>* } | "name"
-    property: <property-name>: <node> | <value> ;
+**document**: `<node>\*`
+**node**: container [ "name" ] { <document> } | `<node-type> [ "name" ] { <property>* }` | "name"
+**property**: `<property-name>: <node> | <value> ;`
 
 Each node has its own `<node-type>` and supports a custom set of properties, each with their own `<property-name>` and syntax. The following paragraphs document each of the nodes and their properties.
 
@@ -27,59 +25,6 @@ Nodes can be given a name by adding a string after the `<node-type>` in their de
 
 Just like nodes, textures can be referenced by name. When defining a named texture, the name has to be placed in front of the URL.
 
-# Color states
-
-Color states are represented either by an ident (for builtin ones) or a string
-(for custom ones):
-
-    color-state: <ident> | <string>
-
-Custom color states can be defined at the beginning of the document, with an @‌cicp rule.
-
-The format for @‌cicp rules is
-
-    @‌cicp "name" {
-      ...
-    }
-
-The following properties can be set for custom color states:
-
-| property  | syntax           | default  | printed     |
-| --------- | ---------------- | -------- | ----------- |
-| primaries | `<integer>`      | 2        | always      |
-| transfer  | `<integer>`      | 2        | always      |
-| matrix    | `<integer>`      | 2        | always      |
-| range     | `<range>`        | full     | non-default |
-
-Note that the primaries, transfer and matrix properties always need
-to be specified, since GTK does not allow creating color state objects
-with these being set to 2 (== unspecified).
-
-Range can have the following values:
-
-    range: narrow | full
-
-# Colors
-
-Colors can be specified with a variation of the modern CSS color syntax:
-
-    color(<color-state> <number> <number> <number> ["/" <number>])
-
-The traditional syntax for sRGB colors still works as well:
-
-    rgba(<number>, <number>, <number>, <number)
-    rgb(<number, <number>, <number>)
-
-# Rectangles
-
-Rectangles can be specified just as four integers for x, y, width and height:
-
-    rect: <number> <number> <number> <number>
-
-Rounded rectangles use a CSS-like syntax:
-
-    rounded-rect: <rect> [ "/" <number>{1,4} [ "/" <number>{1,4} ] ]
-
 # Nodes
 
 ### container
@@ -96,13 +41,6 @@ The **container** node is a special node that allows specifying a list of child
 
 Creates a node like `gsk_blend_node_new()` with the given properties.
 
-Possible values for the mode property are:
-
-    blend-mode: normal | multiply | screen | overlay | darken |
-                lighten | color-dodge | color-burn | hard-light |
-                soft-light | difference | exclusion | color |
-                hue | saturation | luminosity
-
 ### blur
 
 | property | syntax           | default                | printed     |
@@ -222,10 +160,6 @@ Creates a node like `gsk_fill_node_new()` with the given properties.
 The default child node is the default color node, but created with the
 bounds of the path.
 
-Possible values for the fill-rule property are:
-
-    fill-rule: winding | even-odd
-
 ### glshader
 
 | property   | syntax             | default                | printed     |
@@ -277,10 +211,6 @@ Creates a node like `gsk_linear_gradient_node_new()` with the given properties.
 
 Creates a node like `gsk_mask_node_new()` with the given properties.
 
-Possible values for the mode property are:
-
-    mask-mode: alpha | inverted-alpha | luminance | inverted-luminance
-
 ### opacity
 
 | property | syntax           | default                | printed     |
@@ -319,11 +249,11 @@ Creates a node like `gsk_radial_gradient_node_new()` with the given properties.
 
 ### repeat
 
-| property     | syntax     | default                | printed     |
-| ------------ | ---------- | ---------------------- | ----------- |
-| bounds       | `<rect>`   | *bounds of child node* | non-default |
-| child        | `<node>`   | color { }              | always      |
-| child-bounds | `<rect>`   | *bounds of child node* | non-default |
+| property    | syntax           | default                | printed     |
+| ----------- | ---------------- | ---------------------- | ----------- |
+| bounds      | `<rect>`         | *bounds of child node* | non-default |
+| child       | `<node>`         | color { }              | always      |
+| child-bounds| `<rect>`         | *bounds of child node* | non-default |
 
 Creates a node like `gsk_repeat_node_new()` with the given properties.
 
@@ -390,14 +320,6 @@ Creates a node like `gsk_stroke_node_new()` with the given properties.
 The default child node is the default color node, but created with the
 stroke bounds of the path.
 
-Possible values for the line-cap property are:
-
-    line-cap: butt | round | square
-
-Possible values for the line-join property are:
-
-    line-join: miter | round | bevel
-
 ### text
 
 | property     | syntax              | default             | printed     |
@@ -406,9 +328,8 @@ Possible values for the line-join property are:
 | font         | `<string>` `<url>`? | "Cantarell 15px"    | always      |
 | glyphs       | `<glyphs>`          | "Hello"             | always      |
 | offset       | `<point>`           | 0 0                 | non-default |
-| hint-style   | `<hint-style>`      | slight              | non-default |
+| hint-style   | `<hint style>`      | slight              | non-default |
 | antialias    | `<antialias>`       | gray                | non-default |
-| hint-metrics | `<hint-metrics>`    | off                 | non-default |
 
 Creates a node like `gsk_text_node_new()` with the given properties.
 
@@ -423,17 +344,8 @@ be specified as well, like this: 40 10 0 0 color.
 If the given font does not exist or the given glyphs are invalid for the given
 font, an error node will be returned.
 
-Possible values for the hint-style property are:
-
-    hint-style: none | slight | full
-
-Possible value for the antialias property are:
-
-    antialias:  none | gray
-
-Possible value for hint-metrics are:
-
-    hint-metrics:  on | off
+Possible values for hint-style are none, slight or full.
+Possible value for antialias are none or gray.
 
 ### texture
 
@@ -459,15 +371,14 @@ representation for this texture is `url("data:image/png;base64,iVBORw0KGgoAAAANS
 | -------- | ---------------- | ---------------------- | ----------- |
 | bounds   | `<rect>`         | 50                     | always      |
 | texture  | `<url>`          | *see below*            | always      |
-| filter   | `filter`         | linear                 | non-default |
+| filter   | `filter`         | *see below*            | non-default |
 
 Creates a node like `gsk_texture_scale_node_new()` with the given properties.
 
 The default texture is a 10x10 checkerboard, just like for texture.
 
-Possible values for the filter property are:
-
-    filter: linear | nearest | trilinear
+The possible filter values are `linear`, `nearest` and `trilinear`, with
+`linear` being the default.
 
 ### transform
 

demos/print-editor/print-editor.c

@@ -798,7 +798,7 @@ activate (GApplication *app)
   if (g_strcmp0 (PROFILE, "devel") == 0)
     gtk_widget_add_css_class (GTK_WIDGET (main_window), "devel");
 
-  gtk_window_set_icon_name (GTK_WINDOW (main_window), "org.gtk.PrintEditor4");
+  gtk_window_set_icon_name (GTK_WINDOW (main_window), "text-editor");
   gtk_window_set_default_size (GTK_WINDOW (main_window), 400, 600);
   gtk_application_window_set_show_menubar (GTK_APPLICATION_WINDOW (main_window), TRUE);
   update_title (GTK_WINDOW (main_window));

demos/widget-factory/widget-factory.c

@@ -2241,7 +2241,6 @@ activate (GApplication *app)
   if (g_strcmp0 (PROFILE, "devel") == 0)
     gtk_widget_add_css_class (GTK_WIDGET (window), "devel");
 
-  gtk_window_set_icon_name (window, "org.gtk.WidgetFactory4");
   gtk_application_add_window (GTK_APPLICATION (app), window);
   g_action_map_add_action_entries (G_ACTION_MAP (window),
                                    win_entries, G_N_ELEMENTS (win_entries),

docs/reference/README.md

@@ -151,11 +151,10 @@ Checks whether the widget is set to be visible or not.
  - Methods are special functions whose first argument is always the instance
    of a certain class. The instance argument for newly written code should be
    called `self`.
- - If a method is a setter or a getter for an object property
-   `GtkClassName:prop-name`, and if its name does not match the naming scheme
-   `gtk_class_name_{g,s}et_prop_name`, you should add a `(set-property
-   prop-name)` or a `(get-property prop-name)` annotation to the method's
-   identifier
+ - If a method is a setter or a getter for an object property, you should
+   add an `(attributes org.gtk.Method.set_property=property-name)` or a
+   an `(attributes org.gtk.Method.get_property=property-name)` annotation
+   to the method's identifier
  - If a method changes one or more properties as side effect, link those
    properties in the method's description
  - If a method is a signal emitter, you should use the
@@ -193,10 +192,9 @@ Checks whether the widget is set to be visible or not.
    purposes.
  - Always note if setting a property has side effects, like causing another
    property to change state.
- - If a property `GtkClassName:prop-name` has a public getter or setter, and
-   they do not match the naming scheme `gtk_class_name_{g,s}et_prop_name` you
-   should annotate it with the `(setter setter_function)` and `(getter
-   getter_function)`.
+ - If the property has public accessors you should annotate it with
+   the `(attributes org.gtk.Property.set=setter_function)` and
+   `(attributes org.gtk.Property.get=getter_function)` attributes
  - The syntax for property documentation is:
 
 ```c

docs/reference/gdk/cairo.md

@@ -5,11 +5,8 @@ Title: Cairo interaction
 [Cairo](http://cairographics.org) is a graphics library that supports vector
 graphics and image compositing that can be used with GTK.
 
-GDK does not wrap the Cairo API and it is not possible to use cairo directly
-to draw on a [class@Gdk.Surface]. You can either use a
-[GtkDrawingArea](../gtk4/class.DrawingArea.html) widget or
-[gtk_snapshot_append_cairo](../gtk4/func.Snapshot.append_cairo.html)
-for drawing with cairo in a GTK4 application.
+GDK does not wrap the Cairo API; instead it allows to create Cairo
+drawing contexts which can be used to draw on [class@Gdk.Surface]s.
 
 Additional functions allow use [struct@Gdk.Rectangle]s with Cairo
 and to use [struct@Gdk.RGBA], `GdkPixbuf`, and [class@Gdk.Surface]

docs/reference/gdk/gdk4.toml.in

@@ -111,11 +111,3 @@ content_images = [
 ]
 content_base_url = "https://gitlab.gnome.org/GNOME/gtk/-/blob/main/docs/reference/gdk/"
 urlmap_file = "urlmap.js"
-
-[[object]]
-name = "DECLARE_INTERNAL_TYPE"
-hidden = true
-
-[[object]]
-pattern = "KEY_*"
-check_ignore = true

docs/reference/gdk/meson.build

@@ -29,18 +29,6 @@ if get_option('documentation')
     install_dir: docs_dir,
   )
 
-  test('doc-check-gdk',
-    gidocgen,
-    args: [
-      'check',
-      '--config', gdk4_toml,
-      '--add-include-path=@0@'.format(meson.current_build_dir() / '../../../gtk'),
-      gdk_gir[0],
-    ],
-    depends: gdk_gir[0],
-    suite: ['docs', 'failing'],
-  )
-
   if x11_enabled
     gdk4x11_toml = configure_file(
       input: 'gdk4-x11.toml.in',
@@ -99,17 +87,5 @@ if get_option('documentation')
       install: true,
       install_dir: docs_dir,
     )
-
-    test('doc-check-gdk-wayland',
-      gidocgen,
-      args: [
-        'check',
-        '--config', gdk4wayland_toml,
-        '--add-include-path=@0@'.format(meson.current_build_dir() / '../../../gtk'),
-        gdk_wayland_gir[0],
-      ],
-      depends: gdk_wayland_gir[0],
-      suite: ['docs'],
-    )
   endif
 endif

docs/reference/gsk/gsk4.toml.in

@@ -66,7 +66,3 @@ content_images = [
 ]
 content_base_url = "https://gitlab.gnome.org/GNOME/gtk/-/blob/main/docs/reference/gsk/"
 urlmap_file = "urlmap.js"
-
-[[object]]
-name = "INCLUDE_WARNING"
-hidden = true

docs/reference/gsk/meson.build

@@ -30,16 +30,4 @@ if get_option('documentation')
     install: true,
     install_dir: docs_dir,
   )
-
-  test('doc-check-gsk',
-    gidocgen,
-    args: [
-      'check',
-      '--config', gsk4_toml,
-      '--add-include-path=@0@'.format(meson.current_build_dir() / '../../../gtk'),
-      gsk_gir[0],
-    ],
-    depends: gsk_gir[0],
-    suite: ['docs'],
-  )
 endif

docs/reference/gtk/broadway.md

@@ -1,16 +1,12 @@
 Title: The Broadway windowing system
 Slug: broadway
 
+## Using GTK with Broadway
+
 The GDK Broadway backend provides support for displaying GTK applications in
 a web browser, using HTML5 and web sockets.
 
-Broadway was written as an experiment and is not the most actively developed
-backend. It supports the features that were required of GDK backends in GTK 4.0,
-but may not be up-to-date with the latest developments.
-
-## Using GTK with Broadway
-
-To run your application under Broadway, first run the broadway server,
+To run your application in this way, first run the broadway server,
 `gtk-broadwayd`, that ships with GTK:
 
 ```

docs/reference/gtk/building.md

@@ -140,7 +140,7 @@ Other libraries are maintained separately.
   file formats. It is available [here](ttps://download.gnome.org/sources/gdk-pixbuf/).
 - [Pango](http://www.pango.org) is a library for internationalized
   text handling. It is available [here](https://download.gnome.org/sources/pango/).
-- [GObject Introspection](https://gitlab.gnome.org/GNOME/gobject-introspection)
+- [GObject Introspection](https://wiki.gnome.org/Projects/GObjectIntrospection)
   is a framework for making introspection data available to language
   bindings. It is available [here](https://download.gnome.org/sources/gobject-introspection/).
 - The [GNU libiconv](https://www.gnu.org/software/libiconv/) library

docs/reference/gtk/css-overview.md

@@ -74,7 +74,6 @@ in a selector, widget names must be prefixed with a # character.
 | E:not(selector) | [CSS Selector Level 3](https://www.w3.org/TR/css3-selectors/#negation) | |
 | E:dir(ltr), E:dir(rtl) | [CSS Selector Level 4](https://drafts.csswg.org/selectors/#the-dir-pseudo) | |
 | E:drop(active) | [CSS Selector Level 4](https://drafts.csswg.org/selectors/#drag-pseudos) | |
-| E:root | [CSS Selector Level 3](https://www.w3.org/TR/selectors-3/#root-pseudo) | |
 | E F | [CSS Selector Level 3](https://www.w3.org/TR/css3-selectors/#descendent-combinators) | |
 | E > F | [CSS Selector Level 3](https://www.w3.org/TR/css3-selectors/#child-combinators) | |
 | E ~ F | [CSS Selector Level 3](https://www.w3.org/TR/css3-selectors/#general-sibling-combinators) | |

docs/reference/gtk/css-properties.md

@@ -15,16 +15,16 @@ spec.
 The following units are supported for basic datatypes:
 
 Length
-: px, pt, em, ex, rem, pc, in, cm, mm
+: px, pt, em, ex, rem, pc, in, cm, mm, calc()
 
 Percentage
-: %
+: %, calc()
 
 Angle
-: deg, rad, grad, turn
+: deg, grad, turn, calc()
 
 Time
-: s, ms
+: s, ms, calc()
 
 Length values with the em or ex units are resolved using the font
 size value, unless they occur in setting the font-size itself, in
@@ -33,15 +33,11 @@ which case they are resolved using the inherited font size value.
 The rem unit is resolved using the initial font size value, which is
 not quite the same as the CSS definition of rem.
 
-Length values using physical units (pt, pc, in, cm, mm) are translated
-to px using the dpi value specified by the -gtk-dpi property, which is
-different from the CSS definition, which uses a fixed dpi of 96.
-
-The calc() notation adds considerable expressive power to all of these
-datatypes. There are limits on what types can be combined in such an
-expression (e.g. it does not make sense to add a number and a time).
-For the full details, see the
-[CSS Values and Units](https://www.w3.org/TR/css-values-4/) spec.
+The calc() notation adds considerable expressive power. There are limits
+on what types can be combined in such an expression (e.g. it does not make
+sense to add a number and a time). For the full details, see the
+[CSS3 Values and Units](https://www.w3.org/TR/css3-values/#calc-notation)
+spec.
 
 A common pattern among shorthand properties (called 'four sides') is one
 where one to four values can be specified, to determine a value for each
@@ -60,80 +56,38 @@ follows:
 1 value:
 : all
 
-## Custom Properties
-
-GTK supports custom properties as defined in the
-[CSS Custom Properties for Cascading Variables](https://www.w3.org/TR/css-variables-1)
-spec.
-
-Custom properties are defined as follows:
-
-```css
---prop: red;
-```
-
-and used via the `var` keyword:
-
-```css
-color: var(--prop);
-```
-
-Custom properties can have a fallback for when the referred property is invalid:
-
-```css
-color: var(--prop, green);
-```
-
 ## Colors
 
-### CSS Colors
-
-Colors can be expressed in numerous ways in CSS (see the
-[Color Module](https://www.w3.org/TR/css-color-5/). GTK supports
-many (but not all) of these.
-
-You can use rgb(), rgba(), hsl() with both the legacy or the modern CSS
-syntax, and calc() can be used as well in color expressions. hwb(), oklab(),
-oklch(), color(), color-mix() and relative colors are supported as well.
-
-### Non-CSS Colors
-
-GTK  extends the CSS syntax with several additional ways to specify colors.
-
-These extensions are deprecated and should be replaced by the equivalent
-standard CSS notions.
+GTK extends the CSS syntax with several additional ways to specify colors.
 
 The first is a reference to a color defined via a @define-color rule in CSS.
 The syntax for @define-color rules is as follows:
 
 ```
-@define-color name color
+@define-color Name Color
 ```
 
 To refer to the color defined by a @define-color rule, prefix the name with @.
 
-The standard CSS mechanisms that should be used instead of @define-color are
-custom properties, :root and var().
-
 GTK also supports color expressions, which allow colors to be transformed to
 new ones. Color expressions can be nested, providing a rich language to
 define colors. Color expressions resemble functions, taking 1 or more colors
 and in some cases a number as arguments.
 
-`lighter(color)`
- : produces a brighter variant of `color`.
+`lighter(Color)`
+ : produces a brighter variant of Color
 
-`darker(color)`
- : produces a darker variant of `color`.
+`darker(Color)`
+ : produces a darker variant of Color
 
-`shade(color, number)`
- : changes the lightness of `color`. The `number` ranges from 0 for black to 2 for white.
+`shade(Color, Number)`
+ : changes the lightness of Color. The number ranges from 0 for black to 2 for white.
 
-`alpha(color, number)`
- : multiplies the alpha value of `color` by `number` (between 0 and 1).
+`alpha(Color, Number)`
+ : replaces the alpha value of color with number (between 0 and 1)
 
-`mix(color1, color2, number)`
- : interpolates between the two colors.
+`mix(Color1, Color2, Number)`
+ : interpolates between the two colors
 
 ## Images
 
@@ -141,7 +95,7 @@ GTK extends the CSS syntax for images and also uses it for specifying icons.
 To load a themed icon, use
 
 ```
--gtk-icontheme(name)
+-gtk-icontheme(Name)
 ```
 
 The specified icon name is used to look up a themed icon, while taking into
@@ -170,14 +124,14 @@ and the
 syntax makes this available. -gtk-recolor requires a url as first argument.
 The remaining arguments specify the color palette to use. If the palette is
 not explicitly specified, the current value of the -gtk-icon-palette property
-is used.
+is used. 
 
 GTK supports scaled rendering on hi-resolution displays. This works best if
 images can specify normal and hi-resolution variants. From CSS, this can be
 done with
 
 ```
--gtk-scaled(image1, image2)
+-gtk-scaled(Image1, Image2)
 ```
 
 ## GTK CSS Properties

docs/reference/gtk/drawing-model.md

@@ -66,8 +66,8 @@ The clock has several phases:
 - Layout
 - Paint
 
-The phases happen in this order and all phases will always run
-through before going back to the start.
+ The phases happens in this order and we will always run each
+ phase through before going back to the start.
 
 The Events phase is a stretch of time between each redraw where
 GTK processes input events from the user and other events
@@ -99,15 +99,16 @@ reaches the requested phase. However, in practice most things
 happen at higher levels:
 
 - If you are doing an animation, you can use
-  [method@Gtk.Widget.add_tick_callback] which will cause a regular
+  gtk_widget_add_tick_callback() which will cause a regular
   beating of the clock with a callback in the Update phase
   until you stop the tick.
 - If some state changes that causes the size of your widget to
-  change you call [method@Gtk.Widget.queue_resize] which will request
+  change you call gtk_widget_queue_resize() which will request
   a Layout phase and mark your widget as needing relayout.
-- If some state changes so you need to redraw your widget you
-  use [method@Gtk.Widget.queue_draw] to request a Paint phase for
-  your widget.
+- If some state changes so you need to redraw some area of
+  your widget you use the normal gtk_widget_queue_draw()
+  set of functions. These will request a Paint phase and
+  mark the region as needing redraw.
 
 There are also a lot of implicit triggers of these from the
 CSS layer (which does animations, resizes and repaints as needed).

docs/reference/gtk/getting_started.md

@@ -245,6 +245,9 @@ to connect the "clicked" signal with [method@Gtk.Window.destroy], then the funct
 would be called on `button` (which would not go well, since the function expects
 a `GtkWindow` as argument).
 
+More information about creating buttons can be found
+[here](https://wiki.gnome.org/HowDoI/Buttons).
+
 The rest of the code in `example-1.c` is identical to `example-0.c`. The next
 section will elaborate further on how to add several [class@Gtk.Widget]s to your
 GTK application.

docs/reference/gtk/gtk4-broadwayd.rst

@@ -8,10 +8,6 @@ gtk4-broadwayd
 The Broadway display server
 ---------------------------
 
-:Version: GTK
-:Manual section: 1
-:Manual group: GTK commands
-
 SYNOPSIS
 --------
 |   **gtk4-broadwayd** [OPTIONS...] <DISPLAY>

docs/reference/gtk/gtk4-builder-tool.rst

@@ -8,10 +8,6 @@ gtk4-builder-tool
 GtkBuilder File Utility
 -----------------------
 
-:Version: GTK
-:Manual section: 1
-:Manual group: GTK commands
-
 SYNOPSIS
 --------
 |   **gtk4-builder-tool** <COMMAND> [OPTIONS...] <FILE>

docs/reference/gtk/gtk4-demo-application.rst

@@ -8,9 +8,6 @@ gtk4-demo-application
 Demonstrate GtkApplication
 --------------------------
 
-:Version: GTK
-:Manual section: 1
-:Manual group: GTK commands
 
 SYNOPSIS
 --------

docs/reference/gtk/gtk4-demo.rst

@@ -8,10 +8,6 @@ gtk4-demo
 Demonstrate GTK widgets
 -----------------------
 
-:Version: GTK
-:Manual section: 1
-:Manual group: GTK commands
-
 SYNOPSIS
 --------
 

docs/reference/gtk/gtk4-encode-symbolic-svg.rst

@@ -8,10 +8,6 @@ gtk4-encode-symbolic-svg
 Symbolic icon conversion utility
 --------------------------------
 
-:Version: GTK
-:Manual section: 1
-:Manual group: GTK commands
-
 SYNOPSIS
 --------
 

docs/reference/gtk/gtk4-icon-browser.rst

@@ -8,10 +8,6 @@ gtk4-icon-browser
 List themed icons
 -----------------
 
-:Version: GTK
-:Manual section: 1
-:Manual group: GTK commands
-
 SYNOPSIS
 --------
 

docs/reference/gtk/gtk4-image-tool.rst

@@ -1,97 +0,0 @@
-.. _gtk4-image-tool(1):
-
-====================
-gtk4-image-tool
-====================
-
------------------------
-Image Utility
------------------------
-
-:Version: GTK
-:Manual section: 1
-:Manual group: GTK commands
-
-SYNOPSIS
---------
-|   **gtk4-image-tool** <COMMAND> [OPTIONS...] <FILE>...
-|
-|   **gtk4-image-tool** compare [OPTIONS...] <FILE1> <FILE2>
-|   **gtk4-image-tool** convert [OPTIONS...] <FILE1> <FILE2>
-|   **gtk4-image-tool** info [OPTIONS...] <FILE>
-|   **gtk4-image-tool** relabel [OPTIONS...] <FILE1> <FILE2>
-|   **gtk4-image-tool** show [OPTIONS...] <FILE>...
-
-DESCRIPTION
------------
-
-``gtk4-image-tool`` can perform various operations on images.
-
-COMMANDS
---------
-
-Information
-^^^^^^^^^^^
-
-The ``info`` command shows general information about the image, such
-as its format and color state.
-
-Showing
-^^^^^^^
-
-The ``show`` command displays one or more images, side-by-side.
-
-``--undecorated``
-
-Removes window decorations. This is meant for rendering of exactly the image
-without any titlebar.
-
-Compare
-^^^^^^^
-
-The ``compare`` command compares two images. If any differences are found,
-the exit code is 1. If the images are identical, it is 0.
-
-``--output=FILE``
-
-  Save the differences as a png image in ``FILE``.
-
-``--quiet``
-
-  Don't write results to stdout.
-
-Conversion
-^^^^^^^^^^
-
-The ``convert`` command converts the image to a different format or color state.
-
-``--format=FORMAT``
-
-  Convert to the given format. The supported formats can be listed
-  with ``--format=list``.
-
-``--color-state=COLORSTATE``
-
-  Convert to the given color state. The supported color states can be
-  listed with ``--format=list``.
-
-``--cicp=CICP``
-
-  Convert to a color state that is specified as a cicp tuple. The cicp tuple
-  must be specified as four numbers, separated by /, e.g. 1/13/6/0.
-
-Relabeling
-^^^^^^^^^^
-
-The ``relabel`` command changes the color state of an image without conversion.
-This can be useful to produce wrong color renderings for diagnostics.
-
-``--color-state=COLORSTATE``
-
-  Relabel to the given color state. The supported color states can be
-  listed with ``--format=list``.
-
-``--cicp=CICP``
-
-  Relabel to a color state that is specified as a cicp tuple. The cicp tuple
-  must be specified as four numbers, separated by /, e.g. 1/13/6/0.

docs/reference/gtk/gtk4-launch.rst

@@ -8,10 +8,6 @@ gtk4-launch
 Launch an application
 ---------------------
 
-:Version: GTK
-:Manual section: 1
-:Manual group: GTK commands
-
 SYNOPSIS
 --------
 

docs/reference/gtk/gtk4-node-editor.rst

@@ -8,10 +8,6 @@ gtk4-node-editor
 Editor render nodes
 -----------------
 
-:Version: GTK
-:Manual section: 1
-:Manual group: GTK commands
-
 SYNOPSIS
 --------
 

docs/reference/gtk/gtk4-path-tool.rst

@@ -8,10 +8,6 @@ gtk4-path-tool
 GskPath Utility
 -----------------------
 
-:Version: GTK
-:Manual section: 1
-:Manual group: GTK commands
-
 SYNOPSIS
 --------
 |   **gtk4-path-tool** <COMMAND> [OPTIONS...] <PATH>

docs/reference/gtk/gtk4-query-settings.rst

@@ -8,10 +8,6 @@ gtk4-query-settings
 Print name and value of GTK settings
 ------------------------------------
 
-:Version: GTK
-:Manual section: 1
-:Manual group: GTK commands
-
 SYNOPSIS
 --------
 

docs/reference/gtk/gtk4-rendernode-tool.rst

@@ -8,17 +8,12 @@ gtk4-rendernode-tool
 GskRenderNode Utility
 -----------------------
 
-:Version: GTK
-:Manual section: 1
-:Manual group: GTK commands
-
 SYNOPSIS
 --------
 |   **gtk4-rendernode-tool** <COMMAND> [OPTIONS...] <FILE>
 |
 |   **gtk4-rendernode-tool** benchmark [OPTIONS...] <FILE>
 |   **gtk4-rendernode-tool** compare [OPTIONS...] <FILE1> <FILE2>
-|   **gtk4-rendernode-tool** extract [OPTIONS...] <FILE>
 |   **gtk4-rendernode-tool** info [OPTIONS...] <FILE>
 |   **gtk4-rendernode-tool** render [OPTIONS...] <FILE> [<FILE>]
 |   **gtk4-rendernode-tool** show [OPTIONS...] <FILE>
@@ -50,14 +45,13 @@ without any titlebar.
 Rendering
 ^^^^^^^^^
 
-The ``render`` command saves a rendering of the rendernode as a png, tiff or svg
-image or as pdf document. The name of the file to write can be specified as a second
-FILE argument.
+The ``render`` command saves a rendering of the rendernode as a png or tiff image.
+The name of the file to write can be specified as a second FILE argument.
 
 ``--renderer=RENDERER``
 
   Use the given renderer. Use ``--renderer=help`` to get a information
-  about possible values for the ``RENDERER``.
+  about poassible values for the ``RENDERER``.
 
 Benchmark
 ^^^^^^^^^
@@ -99,16 +93,4 @@ exit code is 1. If the images are identical, it is 0.
 
 ``--quiet``
 
-  Don't write results to stdout.
-
-
-Extract
-^^^^^^^
-
-The ``extract`` command saves all the data urls found in a node file to a given
-directory. The file names for the extracted files are derived from the mimetype
-of the url.
-
-``--dir=DIRECTORY``
-
-  Save extracted files in ``DIRECTORY`` (defaults to the current directory).
+  Don't write results to stdout.`

docs/reference/gtk/gtk4-update-icon-cache.rst

@@ -8,10 +8,6 @@ gtk4-update-icon-cache
 Icon theme caching utility
 --------------------------
 
-:Version: GTK
-:Manual section: 1
-:Manual group: GTK commands
-
 SYNOPSIS
 --------
 

docs/reference/gtk/gtk4-widget-factory.rst

@@ -8,10 +8,6 @@ gtk4-widget-factory
 Showcase GTK widgets and styles
 -------------------------------
 
-:Version: GTK
-:Manual section: 1
-:Manual group: GTK commands
-
 SYNOPSIS
 --------
 

docs/reference/gtk/gtk4.toml.in

@@ -77,15 +77,12 @@ content_files = [
   "section-tree-widget.md",
   "migrating-2to4.md",
   "migrating-3to4.md",
-  "migrating-4to5.md",
   "broadway.md",
   "osx.md",
   "wayland.md",
   "windows.md",
   "x11.md",
-  "tools.md",
   "visual_index.md",
-  "node-format.md",
 ]
 content_images = [
   "../images/favicon.svg",
@@ -252,12 +249,3 @@ content_images = [
 ]
 content_base_url = "https://gitlab.gnome.org/GNOME/gtk/-/blob/main/docs/reference/gtk/"
 urlmap_file = "urlmap.js"
-
-[[object]]
-name = "StyleProvider"
-  [[object.signal]]
-  name = "gtk-private-changed"
-  hidden = true
-
-[check]
-ignore_deprecated = true

docs/reference/gtk/input-handling.md

@@ -140,11 +140,6 @@ capture phase, and key bindings locally, during the target phase.
 Under the hood, all shortcuts are represented as instances of `GtkShortcut`,
 and they are managed by `GtkShortcutController`.
 
-Note that GTK does not do anything to map the primary shortcut modifier
-to <kbd>Command</kbd> on macOS. If you want to let your application to follow
-macOS user experience conventions, you must create macOS-specific keyboard shortcuts.
-The <kbd>Command</kbd> is named `Meta` (`GDK_META_MASK`) in GTK.
-
 ## Text input
 
 When actual text input is needed (i.e. not just keyboard shortcuts),

docs/reference/gtk/meson.build

@@ -14,7 +14,6 @@ expand_content_md_files = [
   'running.md',
   'migrating-2to4.md',
   'migrating-3to4.md',
-  'migrating-4to5.md',
   'actions.md',
   'input-handling.md',
   'drawing-model.md',
@@ -26,8 +25,7 @@ expand_content_md_files = [
   'section-tree-widget.md',
   'section-list-widget.md',
   'question_index.md',
-  'visual_index.md',
-  'tools.md',
+  'visual_index.md'
 ]
 
 gtk_images = []
@@ -62,52 +60,39 @@ if get_option('documentation')
     build_by_default: true,
     install: true,
     install_dir: docs_dir,
-    install_tag: 'doc',
-  )
-
-  test('doc-check-gtk',
-    gidocgen,
-    args: [
-      'check',
-      '--config', gtk4_toml,
-      '--add-include-path=@0@'.format(meson.current_build_dir() / '../../../gtk'),
-      gtk_gir[0],
-    ],
-    depends: gtk_gir[0],
-    suite: ['docs', 'failing'],
   )
 endif
 
-rst2man = find_program('rst2man', 'rst2man.py', required: get_option('man-pages'))
-rst2html5 = find_program('rst2html5', 'rst2html5.py', required: get_option('documentation'))
+rst2man = find_program('rst2man', 'rst2man.py', required: false)
+if get_option('man-pages') and not rst2man.found()
+  error('No rst2man found, but man pages were explicitly enabled')
+endif
 
-rst_files = [
-  [ 'gtk4-broadwayd', '1' ],
-  [ 'gtk4-builder-tool', '1' ],
-  [ 'gtk4-encode-symbolic-svg', '1', ],
-  [ 'gtk4-image-tool', '1' ],
-  [ 'gtk4-launch', '1', ],
-  [ 'gtk4-query-settings', '1', ],
-  [ 'gtk4-rendernode-tool', '1' ],
-  [ 'gtk4-update-icon-cache', '1', ],
-  [ 'gtk4-path-tool', '1', ],
-]
-
-if get_option('build-demos')
-  rst_files += [
-    [ 'gtk4-demo', '1', ],
-    [ 'gtk4-demo-application', '1', ],
-    [ 'gtk4-widget-factory', '1', ],
-    [ 'gtk4-icon-browser', '1', ],
-    [ 'gtk4-node-editor', '1', ],
+if get_option('man-pages') and rst2man.found()
+  rst_files = [
+    [ 'gtk4-broadwayd', '1' ],
+    [ 'gtk4-builder-tool', '1' ],
+    [ 'gtk4-encode-symbolic-svg', '1', ],
+    [ 'gtk4-launch', '1', ],
+    [ 'gtk4-query-settings', '1', ],
+    [ 'gtk4-rendernode-tool', '1' ],
+    [ 'gtk4-update-icon-cache', '1', ],
+    [ 'gtk4-path-tool', '1', ],
   ]
-endif
 
-rst2x_flags = [
-  '--syntax-highlight=none',
-]
+  if get_option('demos')
+    rst_files += [
+      [ 'gtk4-demo', '1', ],
+      [ 'gtk4-demo-application', '1', ],
+      [ 'gtk4-widget-factory', '1', ],
+      [ 'gtk4-icon-browser', '1', ],
+      [ 'gtk4-node-editor', '1', ],
+    ]
+  endif
 
-if get_option('man-pages')
+  rst2man_flags = [
+    '--syntax-highlight=none',
+  ]
 
   foreach rst: rst_files
     man_name = rst[0]
@@ -118,34 +103,12 @@ if get_option('man-pages')
       output: '@0@.@1@'.format(man_name, man_section),
       command: [
         rst2man,
-        rst2x_flags,
+        rst2man_flags,
         '@INPUT@',
       ],
       capture: true,
       install: true,
       install_dir: get_option('mandir') / 'man@0@'.format(man_section),
-      install_tag: 'doc',
-    )
-  endforeach
-endif
-
-if get_option('documentation')
-
-  foreach rst: rst_files
-    man_name = rst[0]
-
-    custom_target(
-      input: '@0@.rst'.format(man_name),
-      output: '@0@.html'.format(man_name),
-      command: [
-        rst2html5,
-        rst2x_flags,
-        '@INPUT@',
-      ],
-      capture: true,
-      install: true,
-      install_dir: docs_dir / 'gtk4',
-      install_tag: 'doc',
     )
   endforeach
 endif

docs/reference/gtk/migrating-3to4.md

@@ -451,11 +451,11 @@ hint about how modifiers are expected to be used. It also promoted
 the use of `<Primary>` instead of `<Control>` to specify accelerators that
 adapt to platform conventions.
 
-In GTK 4, the meaning of modifiers has been fixed, and applications are
+In GTK 4, the meaning of modifiers has been fixed, and backends are
 expected to map the platform conventions to the existing modifiers.
 The expected use of modifiers in GTK 4 is:
 
-`GDK_CONTROL_MASK` (`GDK_META_MASK` on macOS)
+`GDK_CONTROL_MASK`
  : Primary accelerators
 
 `GDK_ALT_MASK`
@@ -464,7 +464,7 @@ The expected use of modifiers in GTK 4 is:
 `GDK_SHIFT_MASK`
  : Extending selections
 
-`GDK_CONTROL_MASK` (`GDK_META_MASK` on macOS)
+`GDK_CONTROL_MASK`
  : Modifying selections
 
 `GDK_CONTROL_MASK|GDK_ALT_MASK`
@@ -473,15 +473,9 @@ The expected use of modifiers in GTK 4 is:
 Consequently, `GdkModifierIntent` and related APIs have been removed,
 and `<Control>` is preferred over `<Primary>` in accelerators.
 
-In GTK 3 on macOS, the `<Primary>` modifier mapped to  the <kbd>Command</kbd> key.
-In GTK 4, this is no longer the case: `<Primary>` is synonymous to `<Control>`.
-If you want to make your application to feel native on macOS,
-you need to add accelerators for macOS that use the `<Meta>` modifier.
-
 A related change is that GTK 4 no longer supports the use of archaic
 X11 'real' modifiers with the names Mod1,..., Mod5, and `GDK_MOD1_MASK`
-has been renamed to `GDK_ALT_MASK` and `GDK_MOD2_MASK` has been renamed to
-`GDK_META_MASK`.
+has been renamed to `GDK_ALT_MASK`.
 
 ### Replace `GtkClipboard` with `GdkClipboard`
 

docs/reference/gtk/migrating-4to5.md

@@ -24,180 +24,83 @@ the motivation and goals of larger API changes.
 ## Cell renderers are going away
 
 Cell renderers were introduced in GTK 2 to support rendering of
-“big data” UIs, in particular treeviews. Over the years, more
-“data-like” widgets have started to use them, and cell renderers
+"big data" UIs, in particular treeviews. Over the years, more
+"data-like" widgets have started to use them, and cell renderers
 have grown into a shadowy, alternative rendering infrastructure
 that duplicates much of what widgets do, while duplicating the
 code and adding their own dose of bugs.
 
-In GTK 4, replacement widgets for `GtkTreeView`, `GtkIconView` and
-`GtkComboBox` have appeared: [class@Gtk.ListView], [class@Gtk.ColumnView], [class@Gtk.GridView]
-and [class@Gtk.DropDown]. For GTK 5, we will take the next step and remove
+In GTK 4, replacement widgets for GtkTreeView, GtkIconView and
+GtkComboBox have appeared: GtkListView, GtkColumnView, GtkGridView
+and GtkDropDown. For GTK 5, we will take the next step and remove
 all cell renderer-based widgets.
 
 ## Themed rendering APIs are going away
 
 The old GTK 2 era rendering APIs for theme components like
-`gtk_render_frame()` or `gtk_render_check()` have not been used by
+gtk_render_frame() or gtk_render_check() have not been used by
 GTK itself even in later GTK 3, but they have been kept around
-for the benefit of “external drawing” users — applications that
+for the benefit of "external drawing" users - applications that
 want their controls to look like GTK without using widgets.
 
 Supporting this is increasingly getting in the way of making
 the GTK CSS machinery fast and correct. One notable problem is
-that temporary style changes (using `gtk_style_context_save()`)
+that temporary style changes (using gtk_style_context_save())
 is breaking animations. Therefore, these APIs will be going away
-in GTK 5, together with their more modern [class@Gtk.Snapshot] variants
-like `gtk_snapshot_render_background()` or `gtk_snapshot_render_focus()`.
+in GTK 5, together with their more modern GtkSnapshot variants
+like gtk_snapshot_render_background() or gtk_snapshot_render_focus().
 
 The best way to render parts of your widget using CSS styling
 is to use subwidgets. For example, to show a piece of text with
 fonts, effects and shadows according to the current CSS style,
-use a [class@Gtk.Label].
+use a GtkLabel.
 
 If you have a need for custom drawing that fits into the current
 (dark or light) theme, e.g. for rendering a graph, you can still
 get the current style foreground color, using
-[method@Gtk.Widget.get_color].
+[method@Gtk.Widget.get_style_color].
 
 ## Local stylesheets are going away
 
-The cascading part of GTK’s CSS implementation is complicated by
+The cascading part of GTK's CSS implementation is complicated by
 the existence of local stylesheets (i.e. those added with
-`gtk_style_context_add_provider()`). And local stylesheets are
+gtk_style_context_add_provider()). And local stylesheets are
 unintuitive in that they do not apply to the whole subtree of
 widgets, but just to the one widget where the stylesheet was
 added.
 
-GTK 5 will no longer provide this functionality. The recommendation
-is to use a global stylesheet (i.e. [func@Gtk.StyleContext.add_provider_for_display])
+GTK 5 will no longer provide this functionality. The recommendations
+is to use a global stylesheet (i.e. gtk_style_context_add_provider_for_display())
 and rely on style classes to make your CSS apply only where desired.
 
-## Non-standard CSS extensions are going away
-
-GTK’s CSS machinery has a some non-standard extensions around colors:
-named colors with `@define-color` and color functions: `lighter()`, `darker()`,
-`shade()`, `alpha()`, `mix()`.
-
-GTK now implements equivalent functionality from the CSS specs.
-
-### `@define-color` is going away
-
-`@define-color` should be replaced by custom properties in the `:root` scope.
-
-Instead of
-
-```
-@define-color fg_color #2e3436
-
-...
-
-box {
-  color: @fg_color;
-}
-```
-
-use
-
-```
-:root {
-  --fg-color: #2e3436;
-}
-
-...
-
-box {
-  color: var(--fg-color);
-}
-```
-
-For more information about custom CSS properties and variables, see the
-[CSS Custom Properties for Cascading Variables](https://www.w3.org/TR/css-variables-1/)
-spec.
-
-### Color expressions are going away
-
-The color functions can all be replaced by combinations of `calc()` and `color-mix()`.
-
-`lighter(c)` and `darker(c)` are just `shade(c, 1.3)` or `shade(c, 0.7)`, respectively, and
-thus can be handled the same way as shade in the examples below.
-
-Replace
-
-```
-a {
-  color: mix(red, green, 0.8);
-}
-
-b {
-  color: alpha(green, 0.6);
-}
-
-c {
-  color: shade(red, 1.3);
-}
-
-d {
-  color: shade(red, 0.7);
-}
-```
-
-with
-
-```
-a {
-  color: color-mix(in srgb, red, green 80%);
-}
-
-b {
-  color: rgb(from green, r g b / calc(alpha * 0.6));
-}
-
-c {
-  color: hsl(from red, h calc(s * 1.3) calc(l * 1.3));
-}
-
-d {
-  color: hsl(from red, h calc(s * 0.7) calc(l * 0.7));
-}
-```
-
-Variations of these replacements are possible.
-
-Note that GTK has historically computed `mix()` and `shade()` values in the SRGB and HSL
-colorspaces, but using OKLAB instead might yield slightly better results.
-
-For more information about color-mix(), see the
-[CSS Color](https://drafts.csswg.org/css-color-5) spec.
-
 ## Chooser interfaces are going away
 
-The `GtkColorChooser`, `GtkFontChooser`, `GtkFileChooser` and `GtkAppChooser`
+The GtkColorChooser, GtkFontChooser, GtkFileChooser and GtkAppChooser
 interfaces and their implementations as dialogs, buttons and widgets
 are phased out. The are being replaced by a new family of async APIs
 that will be more convenient to use from language bindings, in particular
 for languages that have concepts like promises. The new APIs are
 [class@Gtk.ColorDialog], [class@Gtk.FontDialog] and [class@Gtk.FileDialog],
-There are also equivalents for some of the “button” widgets:
+There are also equivalents for some of the 'button' widgets:
 [class@Gtk.ColorDialogButton], [class@Gtk.FontDialogButton].
 
 ## GtkMessageDialog is going away
 
-Like the Chooser interfaces, `GtkMessageDialog` has been replaced by
+Like the Chooser interfaces, GtkMessageDialog has been replaced by
 a new async API that will be more convenient, in particular for
 language binding. The new API is [class@Gtk.AlertDialog].
 
 ## GtkDialog is going away
 
-After `gtk_dialog_run()` was removed, the usefulness of `GtkDialog`
-is much reduced, and it has awkward, archaic APIs. Therefore,
+After gtk_dialog_run() was removed, the usefulness of GtkDialog
+is much reduced, and it has awkward, archaice APIs. Therefore,
 it is dropped. The recommended replacement is to just create
 your own window and add buttons as required, either in the header
 or elsewhere.
 
 ## GtkInfoBar is going away
 
-`GtkInfoBar` had a dialog API, and with dialogs going away, it was time to
+GtkInfoBar had a dialog API, and with dialogs going away, it was time to
 retire it. If you need such a widget, it is relatively trivial to create one
 using a [class@Gtk.Revealer] with labels and buttons.
 
@@ -205,11 +108,11 @@ Other libraries, such as libadwaita, may provide replacements as well.
 
 ## gtk_show_uri is being replaced
 
-Instead of `gtk_show_uri()`, you should use [class@Gtk.UriLauncher]or [class@Gtk.FileLauncher].
+Instead of gtk_show_uri(), you should use GtkUriLauncher or GtkFileLauncher.
 
 ## GtkStatusbar is going away
 
-This is an old fashioned widget that does not do all that much any more, since
+This is an oldfashioned widget that does not do all that much anymore, since
 it no longer has a resize handle for the window.
 
 ## GtkLockButton and GtkVolumeButton are going away
@@ -217,22 +120,22 @@ it no longer has a resize handle for the window.
 These are very specialized widgets that should better live with the application
 where they are used.
 
-## Widget size API changes
+## Widget size api changes
 
-The functions `gtk_widget_get_allocated_width()` and `gtk_widget_get_allocated_height()`
+The functions gtk_widget_get_allocated_width() and gtk_widget_get_allocated_height()
 are going away. In most cases, [method@Gtk.Widget.get_width] and [method@Gtk.Widget.get_height]
 are suitable replacements. Note that the semantics are slightly different though:
 the old functions return the size of the CSS border area, while the new functions return
 the size of the widgets content area. In places where this difference matters, you can
 use `gtk_widget_compute_bounds (widget, widget, &bounds)` instead.
 
-The function `gtk_widget_get_allocation()` is also going away. It does not have a direct
+The function gtk_widget_get_allocation() is also going away. It does not have a direct
 replacement, but the previously mentioned alternatives can be used for it too.
 
-The function `gtk_widget_get_allocated_baseline()` has been renamed to [method@Gtk.Widget.get_baseline].
+The function gtk_widget_get_allocated_baseline() has been renamed to [method@Gtk.Widget.get_baseline].
 
 ## Stop using GdkPixbuf
 
-GTK is moving away from `GdkPixbuf` as the primary API for transporting image data, in favor
-of [class@Gdk.Texture]. APIs that are accepting or returning `GdkPixbuf`s are being replaced by equivalent
-APIs using `GdkTexture` or [iface@Gdk.Paintable] objects.
+GTK is moving away from GdkPixbuf as the primary API for transporting image data, in favor
+of GdkTexture. APIs that are accepting or returning GdkPixbufs are being replaced by equivalent
+APIs using GdkTexture or GdkPaintable objects.

docs/reference/gtk/osx.md

@@ -7,5 +7,5 @@ on top of the Quartz API.
 Currently, the macOS port does not use any additional commandline options
 or environment variables.
 
-For up-to-date information on building, installation, and bundling, see the
-[GTK website](https://www.gtk.org/docs/installations/macos).
+For up-to-date information about the current status of this port, see the
+[project page](https://wiki.gnome.org/Projects/GTK/OSX).

docs/reference/gtk/overview.md

@@ -64,6 +64,6 @@ GTK is divided into three parts:
 [cairo]: https://www.cairographics.org/manual/
 [opengl]: https://www.opengl.org/about/
 [vulkan]: https://www.vulkan.org/
-[pango]: https://docs.gtk.org/Pango/
+[pango]: https://docs.gtk.org/pango/
 [gdkpixbuf]: https://docs.gtk.org/gdk-pixbuf/
 [graphene]: https://ebassi.github.io/graphene/

docs/reference/gtk/running.md

@@ -5,12 +5,10 @@ Slug: gtk-running
 
 GTK inspects a number of environment variables in addition to
 standard variables like `LANG`, `PATH`, `HOME` or `DISPLAY`; mostly
-to determine paths to look for certain files. The
-[X11](https://docs.gtk.org/gtk4/x11.html#x11-specific-environment-variables),
-[Wayland](https://docs.gtk.org/gtk4/wayland.html#wayland-specific-environment-variables),
-[Windows](https://docs.gtk.org/gtk4/windows.html#windows-specific-environment-variables) and
-[Broadway](https://docs.gtk.org/gtk4/broadway.html#broadway-specific-environment-variables)
-GDK backends use some additional environment variables.
+to determine paths to look for certain files. The [X11](#x11-envar),
+[Wayland](#wayland-envar), [Windows](#win32-envar) and
+[Broadway](#broadway-envar) GDK backends use some additional
+environment variables.
 
 Note that environment variables are generally used for debugging
 purposes. They are not guaranteed to be API stable, and should not
@@ -19,7 +17,8 @@ be used for end-user configuration and customization.
 ### `GTK_DEBUG`
 
 This variable can be set to a list of debug options, which cause GTK to
-print out different types of debugging information.
+print out different types of debugging information. Some of these options
+are only available when GTK has been configured with `-Ddebug=true`.
 
 `actions`
 : Actions and menu models
@@ -64,7 +63,7 @@ print out different types of debugging information.
 : Layout managers
 
 `accessibility`
-: Accessibility state changes
+: Accessibility state changs
 
 A number of keys are influencing behavior instead of just logging:
 
@@ -168,7 +167,8 @@ The `loaders.cache` file is generated by the
 ### `GDK_DEBUG`
 
 This variable can be set to a list of debug options, which cause GDK to
-print out different types of debugging information.
+print out different types of debugging information. Some of these options
+are only available when GTK has been configured with `-Ddebug=true`.
 
 `misc`
 : Miscellaneous information
@@ -221,15 +221,36 @@ A number of options affect behavior instead of logging:
 : Force graphics offload for all textures, even when slower. This allows
   to debug offloading in the absence of dmabufs.
 
+`gl-disable`
+: Disable OpenGL support
+
 `gl-no-fractional`
 : Disable fractional scaling for OpenGL.
 
 `gl-debug`
 : Insert debugging information in OpenGL
 
+`gl-disable-gl`
+: Don't allow the use of OpenGL GL API. This forces GLES to be used
+
+`gl-disable-gles`
+: Don't allow the use of OpenGL GLES API. This forces GL to be used
+
 `gl-prefer-gl`
 : Prefer OpenGL over OpenGL ES. This was the default behavior before GTK 4.14.
 
+`gl-egl`
+: Use an EGL context on X11 or Windows
+
+`gl-glx`
+: Use GLX on X11
+
+`gl-wgl`
+: Use WGL on Windows
+
+`vulkan-disable`
+: Disable Vulkan support
+
 `vulkan-validate`
 : Load the Vulkan validation layer, if available
 
@@ -239,26 +260,27 @@ A number of options affect behavior instead of logging:
 `high-depth`
 : Use high bit depth rendering if possible
 
-`linear`
-: Enable linear rendering
-
-`hdr`
-: Force HDR rendering
-
 `no-vsync`
 : Repaint instantly (uses 100% CPU with animations)
 
+`dmabuf-disable`
+: Disable dmabuf support
+
 The special value `all` can be used to turn on all debug options. The special
 value `help` can be used to obtain a list of all supported debug options.
 
 ### `GSK_DEBUG`
 
 This variable can be set to a list of debug options, which cause GSK to
-print out different types of debugging information.
+print out different types of debugging information. Some of these options
+are only available when GTK has been configured with `-Ddebug=true`.
 
 `renderer`
 : General renderer information
 
+`opengl`
+: OpenGL renderer information
+
 `vulkan`
 : Check Vulkan errors
 
@@ -268,8 +290,8 @@ print out different types of debugging information.
 `fallback`
 : Information about fallback usage in renderers
 
-`cache`
-: Information about caching
+`glyphcache`
+: Information about glyph caching
 
 `verbose`
 : Print verbose output while rendering
@@ -285,12 +307,12 @@ A number of options affect behavior instead of logging:
 `staging`
 : Use a staging image for texture upload (Vulkan only)
 
+`offload-disable`
+: Disable graphics offload to subsurfaces
+
 `cairo`
 : Overlay error pattern over cairo drawing (finds fallbacks)
 
-`occlusion`
-: Overlay highlight over areas optimized via occlusion culling
-
 The special value `all` can be used to turn on all debug options. The special
 value `help` can be used to obtain a list of all supported debug options.
 
@@ -323,41 +345,6 @@ a `*`, which means: try all remaining backends. The special value
 backends. For more information about selecting backends,
 see the [func@Gdk.DisplayManager.get] function.
 
-### `GDK_DISABLE`
-
-This variable can be set to a list of values, which cause GDK to
-disable certain features.
-
-`gl`
-: Disable OpenGL support
-
-`gl-api`
-: Don't allow the use of OpenGL GL API. This forces GLES to be used
-
-`gles-api`
-: Don't allow the use of OpenGL GLES API. This forces GL to be used
-
-`egl`
-: Don't allow the use of an EGL context
-
-`glx`
-: Don't allow the use of GLX
-
-`wgl`
-: Don't allow the use of WGL
-
-`vulkan`
-: Disable Vulkan support
-
-`dmabuf`
-: Disable dmabuf support
-
-`offload`
-: Disable graphics offload to subsurfaces
-
-`color-mgmt`
-: Disable color management
-
 ### `GDK_GL_DISABLE`
 
 This variable can be set to a list of values, which cause GDK to
@@ -400,6 +387,15 @@ does not support them.
 `ycbr`
 : Do not support Ycbcr textures
 
+`descriptor-indexing`
+: Force slow descriptor set layout codepath
+
+`dynamic-indexing`
+: Hardcode small number of buffer and texture arrays
+
+`nonuniform-indexing`
+: Split draw calls to ensure uniform texture accesses
+
 `semaphore-export`
 : Disable sync of exported dmabufs
 
@@ -409,9 +405,6 @@ does not support them.
 `incremental-present`
 : Do not send damage regions
 
-`swapchain-maintenance`
-: Do not use advanced swapchain features
-
 The special value `all` can be used to turn on all values. The special
 value `help` can be used to obtain a list of all supported values.
 
@@ -466,12 +459,12 @@ using and the GDK backend supports them:
 This variable can be set to a list of values, which cause GSK to
 disable certain optimizations of the "ngl" and "vulkan" renderer.
 
+`uber`
+: Don't use the uber shader
+
 `clear`
 : Use shaders instead of vkCmdClearAttachment()/glClear()
 
-`merge`
-: USe one vkCmdDraw()/glDrawArrays() per operation
-
 `blit`
 : Use shaders instead of vkCmdBlit()/glBlitFramebuffer()
 
@@ -481,13 +474,6 @@ disable certain optimizations of the "ngl" and "vulkan" renderer.
 `mipmap`
 : Avoid creating mipmaps
 
-`to-image`
-: Don't fast-path creation of images for nodes
-
-`occlusion`
-: Disable occlusion culling via opacity tracking
-
-
 The special value `all` can be used to turn on all values. The special
 value `help` can be used to obtain a list of all supported values.
 
@@ -575,12 +561,6 @@ To enable the GTK inspector, you can use the <kbd>Control</kbd>+<kbd>Shift</kbd>
 <kbd>Control</kbd>+<kbd>Shift</kbd>+<kbd>D</kbd> keyboard shortcuts, or
 set the `GTK_DEBUG=interactive` environment variable.
 
-After opening the inspector, it listens for a few keyboard shortcuts that
-let you use its frame and event recording functionality without moving the
-focus away from the application window: <kbd>Super</kbd>+<kbd>R</kbd> turns
-the recording on and off, and <kbd>Super</kbd>+<kbd>C</kbd> records a single
-frame.
-
 There are a few more environment variables that can be set to influence
 how the inspector renders its UI. `GTK_INSPECTOR_DISPLAY` and
 `GTK_INSPECTOR_RENDERER` determine the GDK display and the GSK
@@ -591,7 +571,6 @@ the GTK inspector. The keyboard shortcuts can be disabled with the
 `enable-inspector-keybinding` key in the `org.gtk.Settings.Debug`
 GSettings schema.
 
-
 ## Profiling
 
 GTK supports profiling with sysprof. It exports timing information

docs/reference/gtk/section-accessibility.md

@@ -155,7 +155,6 @@ Each property name is part of the `GtkAccessibleProperty` enumeration.
 | %GTK_ACCESSIBLE_PROPERTY_VALUE_MIN | “aria-valuemin” | double |
 | %GTK_ACCESSIBLE_PROPERTY_VALUE_NOW | “aria-valuenow” | double |
 | %GTK_ACCESSIBLE_PROPERTY_VALUE_TEXT | “aria-valuetext” | translatable string |
-| %GTK_ACCESSIBLE_PROPERTY_HELP_TEXT | N/A | translatable string |
 
 #### List of accessible relations
 
@@ -171,7 +170,7 @@ Each relation name is part of the `GtkAccessibleRelation` enumeration.
 | %GTK_ACCESSIBLE_RELATION_CONTROLS | “aria-controls” | a list of `GtkAccessible` |
 | %GTK_ACCESSIBLE_RELATION_DESCRIBED_BY | “aria-describedby” | a list of `GtkAccessible` |
 | %GTK_ACCESSIBLE_RELATION_DETAILS | “aria-details” | a list of `GtkAccessible` |
-| %GTK_ACCESSIBLE_RELATION_ERROR_MESSAGE | “aria-errormessage” | a list of `GtkAccessible` |
+| %GTK_ACCESSIBLE_RELATION_ERROR_MESSAGE | “aria-errormessage” | `GtkAccessible` |
 | %GTK_ACCESSIBLE_RELATION_FLOW_TO | “aria-flowto” | a list of `GtkAccessible` |
 | %GTK_ACCESSIBLE_RELATION_LABELLED_BY | “aria-labelledby” | a list of `GtkAccessible` |
 | %GTK_ACCESSIBLE_RELATION_OWNS | “aria-owns” | a list of `GtkAccessible` |
@@ -217,10 +216,6 @@ are accessible as part of the development process. The GTK Inspector shows
 the accessible attributes of each widget, and also provides an overlay that
 can highlight accessibility issues.
 
-If you support some non-standard keyboard interactions for a widget, you
-**should** set an appropriate `GTK_ACCESSIBLE_PROPERTY_HELP_TEXT` to help
-discoverability of the behavior.
-
 It is possible to set accessible attributes in UI files as well:
 ```xml
 <object class="GtkButton" id="button1">
@@ -300,7 +295,7 @@ The attributes can also enhance the UI:
 
 ```c
 gtk_button_set_label (GTK_BUTTON (button), "Download");
-gtk_box_append (GTK_BOX (box), button);
+gtk_box_append (GTK_BOX (button), button);
 
 gtk_label_set_text (GTK_LABEL (label), "Final report.pdf");
 gtk_box_append (GTK_BOX (box), label);

docs/reference/gtk/tools.md

@@ -1,19 +0,0 @@
-Title: Tools and Demos
-
-GTK ships with a number of tools and demos that come with their own
-documentation in the form of man pages.
-
- - [gtk4-broadwayd](gtk4-broadwayd.html)
- - [gtk4-builder-tool](gtk4-builder-tool.html)
- - [gtk4-demo](gtk4-demo.html)
- - [gtk4-demo-application](gtk4-demo-application.html)
- - [gtk4-encode-symbolic-svg](gtk4-encode-symbolic-svg.html)
- - [gtk4-icon-browser](gtk4-icon-browser.html)
- - [gtk4-image-tool](gtk4-image-tool.html)
- - [gtk4-launch](gtk4-launch.html)
- - [gtk4-node-editor](gtk4-node-editor.html)
- - [gtk4-path-tool](gtk4-path-tool.html)
- - [gtk4-query-settings](gtk4-query-settings.html)
- - [gtk4-rendernode-tool](gtk4-rendernode-tool.html)
- - [gtk4-update-icon-cache](gtk4-update-icon-cache.html)
- - [gtk4-widget-factory](gtk4-widget-factory.html)

docs/reference/gtk/x11.md

@@ -43,7 +43,7 @@ X11 details, in particular the ICCCM and the Extended Window Manager
 Hints specifications. [freedesktop.org](http://www.freedesktop.org/standards/)
 has links to many relevant specifications.
 
-The GDK manual covers [using Xlib in a GTK program](https://docs.gtk.org/gdk4/x11.html).
+The GDK manual covers [using Xlib in a GTK program](#gdk-X-Window-System-Interaction).
 
 ### Server, client, window manager
 

gdk/broadway/gdkcairocontext-broadway.c

@@ -33,11 +33,9 @@ gdk_broadway_cairo_context_dispose (GObject *object)
 }
 
 static void
-gdk_broadway_cairo_context_begin_frame (GdkDrawContext  *draw_context,
-                                        GdkMemoryDepth   depth,
-                                        cairo_region_t  *region,
-                                        GdkColorState  **out_color_state,
-                                        GdkMemoryDepth  *out_depth)
+gdk_broadway_cairo_context_begin_frame (GdkDrawContext *draw_context,
+                                        GdkMemoryDepth  depth,
+                                        cairo_region_t *region)
 {
   GdkBroadwayCairoContext *self = GDK_BROADWAY_CAIRO_CONTEXT (draw_context);
   GdkSurface *surface = gdk_draw_context_get_surface (GDK_DRAW_CONTEXT (self));
@@ -61,9 +59,6 @@ gdk_broadway_cairo_context_begin_frame (GdkDrawContext  *draw_context,
   cairo_set_operator (cr, CAIRO_OPERATOR_CLEAR);
   cairo_fill (cr);
   cairo_destroy (cr);
-
-  *out_color_state = GDK_COLOR_STATE_SRGB;
-  *out_depth = gdk_color_state_get_depth (GDK_COLOR_STATE_SRGB);
 }
 
 static void

gdk/broadway/gdkdrawcontext-broadway.c

@@ -33,11 +33,9 @@ gdk_broadway_draw_context_dispose (GObject *object)
 }
 
 static void
-gdk_broadway_draw_context_begin_frame (GdkDrawContext  *draw_context,
-                                       GdkMemoryDepth   depth,
-                                       cairo_region_t  *region,
-                                       GdkColorState  **out_color_state,
-                                       GdkMemoryDepth  *out_depth)
+gdk_broadway_draw_context_begin_frame (GdkDrawContext *draw_context,
+                                       GdkMemoryDepth  depth,
+                                       cairo_region_t *region)
 {
   GdkBroadwayDrawContext *self = GDK_BROADWAY_DRAW_CONTEXT (draw_context);
   GdkSurface *surface = gdk_draw_context_get_surface (GDK_DRAW_CONTEXT (self));
@@ -54,9 +52,6 @@ gdk_broadway_draw_context_begin_frame (GdkDrawContext  *draw_context,
 
   self->nodes = g_array_new (FALSE, FALSE, sizeof(guint32));
   self->node_textures = g_ptr_array_new_with_free_func (g_object_unref);
-
-  *out_color_state = GDK_COLOR_STATE_SRGB;
-  *out_depth = gdk_color_state_get_depth (GDK_COLOR_STATE_SRGB);
 }
 
 static void

gdk/broadway/gdksurface-broadway.c

@@ -49,135 +49,6 @@
 
 G_DEFINE_TYPE (GdkBroadwaySurface, gdk_broadway_surface, GDK_TYPE_SURFACE)
 
-static void
-gdk_broadway_surface_toplevel_resize (GdkSurface *surface,
-                                      int         width,
-                                      int         height);
-
-static void
-gdk_broadway_surface_set_geometry_hints (GdkSurface        *surface,
-                                         const GdkGeometry *geometry,
-                                         GdkSurfaceHints    geom_mask);
-
-static void
-gdk_broadway_surface_move_resize_internal (GdkSurface *surface,
-                                           gboolean    with_move,
-                                           int         x,
-                                           int         y,
-                                           int         width,
-                                           int         height);
-
-static void
-compute_toplevel_size (GdkSurface *surface,
-                       gboolean    resizible,
-                       int        *width,
-                       int        *height)
-{
-  GdkBroadwaySurface *impl = GDK_BROADWAY_SURFACE (surface);
-  GdkDisplay *display = gdk_surface_get_display (surface);
-  GdkMonitor *monitor;
-  GdkToplevelSize size;
-  int bounds_width, bounds_height;
-  GdkGeometry geometry;
-  GdkSurfaceHints mask;
-
-  monitor = gdk_display_get_monitor_at_surface (display, surface);
-  if (monitor)
-    {
-      GdkRectangle monitor_geometry;
-
-      gdk_monitor_get_geometry (monitor, &monitor_geometry);
-      bounds_width = monitor_geometry.width;
-      bounds_height = monitor_geometry.height;
-    }
-  else
-    {
-      bounds_width = G_MAXINT;
-      bounds_height = G_MAXINT;
-    }
-
-  gdk_toplevel_size_init (&size, bounds_width, bounds_height);
-  gdk_toplevel_notify_compute_size (GDK_TOPLEVEL (surface), &size);
-  g_warn_if_fail (size.width > 0);
-  g_warn_if_fail (size.height > 0);
-  *width = size.width;
-  *height = size.height;
-  impl->resizible = (impl->resizible && resizible);
-
-  if (impl->resizible)
-    {
-      geometry.min_width = size.min_width;
-      geometry.min_height = size.min_height;
-      mask = GDK_HINT_MIN_SIZE;
-    }
-  else
-    {
-      geometry.max_width = geometry.min_width = size.width;
-      geometry.max_height = geometry.min_height = size.height;
-      mask = GDK_HINT_MIN_SIZE | GDK_HINT_MAX_SIZE;
-    }
-  gdk_broadway_surface_set_geometry_hints (surface, &geometry, mask);
-
-  if (!(surface->state & (GDK_TOPLEVEL_STATE_FULLSCREEN |
-                          GDK_TOPLEVEL_STATE_MAXIMIZED |
-                          GDK_TOPLEVEL_STATE_TILED |
-                          GDK_TOPLEVEL_STATE_TOP_TILED |
-                          GDK_TOPLEVEL_STATE_RIGHT_TILED |
-                          GDK_TOPLEVEL_STATE_BOTTOM_TILED |
-                          GDK_TOPLEVEL_STATE_LEFT_TILED |
-                          GDK_TOPLEVEL_STATE_MINIMIZED)))
-    {
-      gdk_surface_constrain_size (&geometry, mask,
-				  size.width, size.height,
-				  &size.width, &size.height);
-
-      if (impl->last_computed_width != size.width ||
-           impl->last_computed_height != size.height)
-        {
-          *width = size.width;
-          *height = size.height;
-          impl->last_computed_width = size.width;
-          impl->last_computed_height = size.height;
-
-	  gdk_broadway_surface_toplevel_resize (surface, *width, *height);
-        }
-    }
-
-  if (size.shadow.is_valid)
-    {
-      impl->shadow_left = size.shadow.left;
-      impl->shadow_right = size.shadow.right;
-      impl->shadow_top = size.shadow.top;
-      impl->shadow_bottom = size.shadow.bottom;
-    }
-}
-
-static gboolean
-compute_size_idle (gpointer user_data)
-{
-  GdkSurface *surface = user_data;
-  GdkBroadwaySurface *impl = GDK_BROADWAY_SURFACE (surface);
-  int width, height;
-
-  impl->compute_size_source_id = 0;
-  compute_toplevel_size (surface, TRUE, &width, &height);
-
-  return G_SOURCE_REMOVE;
-}
-
-static void
-on_frame_clock_after_update (GdkFrameClock *clock,
-                             GdkSurface    *surface)
-{
-  GdkBroadwaySurface *impl = GDK_BROADWAY_SURFACE (surface);
-
-  if (impl->compute_size_source_id)
-    {
-      g_clear_handle_id (&impl->compute_size_source_id, g_source_remove);
-      compute_size_idle (surface);
-    }
-}
-
 /* We need to flush in an idle rather than AFTER_PAINT, as the clock
    is frozen during e.g. surface resizes so the paint will not happen
    and the surface resize request is never flushed. */
@@ -241,8 +112,6 @@ connect_frame_clock (GdkSurface *surface)
 
   g_signal_connect (frame_clock, "before-paint",
                     G_CALLBACK (on_frame_clock_before_paint), surface);
-  g_signal_connect_after (frame_clock, "update",
-			  G_CALLBACK (on_frame_clock_after_update), surface);
   g_signal_connect (frame_clock, "after-paint",
                     G_CALLBACK (on_frame_clock_after_paint), surface);
 }
@@ -254,8 +123,6 @@ disconnect_frame_clock (GdkSurface *surface)
 
   g_signal_handlers_disconnect_by_func (frame_clock,
                                         on_frame_clock_before_paint, surface);
-  g_signal_handlers_disconnect_by_func (frame_clock,
-                                        on_frame_clock_after_update, surface);
   g_signal_handlers_disconnect_by_func (frame_clock,
                                         on_frame_clock_after_paint, surface);
 }
@@ -270,7 +137,6 @@ gdk_broadway_surface_constructed (GObject *object)
   if (!surface->parent)
     broadway_display->toplevels = g_list_prepend (broadway_display->toplevels, self);
 
-  self->resizible = TRUE;
   self->id = _gdk_broadway_server_new_surface (broadway_display->server,
                                                self->root_x,
                                                self->root_y,
@@ -450,7 +316,6 @@ gdk_broadway_surface_hide (GdkSurface *surface)
 
   _gdk_broadway_surface_grab_check_unmap (surface,
                                          _gdk_broadway_server_get_next_serial (broadway_display->server));
-  g_clear_handle_id (&impl->compute_size_source_id, g_source_remove);
 
   if (_gdk_broadway_server_surface_hide (broadway_display->server, impl->id))
     queue_flush (surface);
@@ -1144,8 +1009,6 @@ _gdk_broadway_moveresize_configure_done (GdkDisplay *display,
   BroadwayInputMsg *tmp_event;
   MoveResizeData *mv_resize = get_move_resize_data (display, FALSE);
 
-  gdk_surface_request_layout (surface);
-
   if (!mv_resize || surface != mv_resize->moveresize_surface)
     return FALSE;
 
@@ -1305,43 +1168,6 @@ gdk_broadway_surface_beep (GdkSurface *surface)
   return FALSE;
 }
 
-static void
-gdk_broadway_surface_request_layout (GdkSurface *surface)
-{
-  GdkBroadwaySurface *impl = GDK_BROADWAY_SURFACE (surface);
-
-  if (!impl->compute_size_source_id &&
-      GDK_IS_TOPLEVEL (surface))
-    {
-      impl->compute_size_source_id = g_idle_add_full (G_PRIORITY_HIGH - 10,
-                                                      compute_size_idle,
-                                                      surface,
-                                                      NULL);
-    }
-}
-
-static gboolean
-gdk_broadway_surface_compute_size (GdkSurface *surface)
-{
-  int width, height;
-
-  if (GDK_IS_TOPLEVEL (surface))
-    {
-      compute_toplevel_size (surface, TRUE, &width, &height);
-    }
-  else
-    {
-      width = gdk_surface_get_width(surface);
-      height = gdk_surface_get_height(surface);
-
-      gdk_broadway_surface_move_resize_internal (surface, FALSE,
-						 0, 0,
-						 width,
-						 height);
-    }
-  return FALSE;
-}
-
 static void
 gdk_broadway_surface_class_init (GdkBroadwaySurfaceClass *klass)
 {
@@ -1361,8 +1187,6 @@ gdk_broadway_surface_class_init (GdkBroadwaySurfaceClass *klass)
   impl_class->destroy_notify = gdk_broadway_surface_destroy_notify;
   impl_class->drag_begin = _gdk_broadway_surface_drag_begin;
   impl_class->get_scale = gdk_broadway_surface_get_scale;
-  impl_class->request_layout = gdk_broadway_surface_request_layout;
-  impl_class->compute_size = gdk_broadway_surface_compute_size;
 }
 
 #define LAST_PROP 1
@@ -1680,12 +1504,55 @@ gdk_broadway_toplevel_present (GdkToplevel       *toplevel,
                                GdkToplevelLayout *layout)
 {
   GdkSurface *surface = GDK_SURFACE (toplevel);
+  GdkBroadwaySurface *impl = GDK_BROADWAY_SURFACE (surface);
+  GdkDisplay *display = gdk_surface_get_display (surface);
+  GdkMonitor *monitor;
+  GdkToplevelSize size;
+  int bounds_width, bounds_height;
   int width, height;
+  GdkGeometry geometry;
+  GdkSurfaceHints mask;
   gboolean maximize;
 
   gdk_broadway_surface_unminimize (surface);
 
-  compute_toplevel_size (surface, gdk_toplevel_layout_get_resizable (layout), &width, &height);
+  monitor = gdk_display_get_monitor_at_surface (display, surface);
+  if (monitor)
+    {
+      GdkRectangle monitor_geometry;
+
+      gdk_monitor_get_geometry (monitor, &monitor_geometry);
+      bounds_width = monitor_geometry.width;
+      bounds_height = monitor_geometry.height;
+    }
+  else
+    {
+      bounds_width = G_MAXINT;
+      bounds_height = G_MAXINT;
+    }
+
+  gdk_toplevel_size_init (&size, bounds_width, bounds_height);
+  gdk_toplevel_notify_compute_size (toplevel, &size);
+  g_warn_if_fail (size.width > 0);
+  g_warn_if_fail (size.height > 0);
+  width = size.width;
+  height = size.height;
+
+  if (gdk_toplevel_layout_get_resizable (layout))
+    {
+      geometry.min_width = size.min_width;
+      geometry.min_height = size.min_height;
+      mask = GDK_HINT_MIN_SIZE;
+    }
+  else
+    {
+      geometry.max_width = geometry.min_width = width;
+      geometry.max_height = geometry.min_height = height;
+      mask = GDK_HINT_MIN_SIZE | GDK_HINT_MAX_SIZE;
+    }
+  gdk_broadway_surface_set_geometry_hints (surface, &geometry, mask);
+  gdk_surface_constrain_size (&geometry, mask, width, height, &width, &height);
+  gdk_broadway_surface_toplevel_resize (surface, width, height);
 
   if (gdk_toplevel_layout_get_maximized (layout, &maximize))
     {
@@ -1695,7 +1562,14 @@ gdk_broadway_toplevel_present (GdkToplevel       *toplevel,
         gdk_broadway_surface_unmaximize (surface);
     }
 
-  gdk_surface_request_layout (surface);
+  if (size.shadow.is_valid)
+    {
+      impl->shadow_left = size.shadow.left;
+      impl->shadow_right = size.shadow.right;
+      impl->shadow_top = size.shadow.top;
+      impl->shadow_bottom = size.shadow.bottom;
+    }
+
   show_surface (surface);
 }
 

gdk/broadway/gdksurface-broadway.h

@@ -76,13 +76,6 @@ struct _GdkBroadwaySurface
   int shadow_right;
   int shadow_top;
   int shadow_bottom;
-
-  int last_computed_width;
-  int last_computed_height;
-
-  guint compute_size_source_id;
-
-  gboolean resizible;
 };
 
 struct _GdkBroadwaySurfaceClass

gdk/gdk.c

@@ -43,14 +43,6 @@
 
 #include <fribidi.h>
 
-/* GTK has a general architectural assumption that gsize is pointer-sized
- * (equivalent to uintptr_t), making it non-portable to architectures like
- * CHERI where that isn't true. If a future release relaxes that
- * assumption, changes will be needed in numerous places.
- * See also https://gitlab.gnome.org/GNOME/glib/-/issues/2842 for the
- * equivalent in GLib, which would be a prerequisite. */
-G_STATIC_ASSERT (sizeof (gsize) == sizeof (void *));
-G_STATIC_ASSERT (G_ALIGNOF (gsize) == G_ALIGNOF (void *));
 
 /**
  * GDK_WINDOWING_X11:
@@ -128,87 +120,54 @@ static const GdkDebugKey gdk_debug_keys[] = {
   { "dmabuf",          GDK_DEBUG_DMABUF, "Information about dmabuf buffers" },
   { "offload",         GDK_DEBUG_OFFLOAD, "Information about subsurfaces and graphics offload" },
 
-  { "linear",          GDK_DEBUG_LINEAR, "Enable linear rendering" },
-  { "hdr",             GDK_DEBUG_HDR, "Force HDR rendering" },
   { "portals",         GDK_DEBUG_PORTALS, "Force use of portals" },
   { "no-portals",      GDK_DEBUG_NO_PORTALS, "Disable use of portals" },
   { "force-offload",   GDK_DEBUG_FORCE_OFFLOAD, "Force graphics offload for all textures" },
+  { "gl-disable",      GDK_DEBUG_GL_DISABLE, "Disable OpenGL support" },
   { "gl-no-fractional", GDK_DEBUG_GL_NO_FRACTIONAL, "Disable fractional scaling for OpenGL" },
   { "gl-debug",        GDK_DEBUG_GL_DEBUG, "Insert debugging information in OpenGL" },
+  { "gl-disable-gl",   GDK_DEBUG_GL_DISABLE_GL, "Only allow OpenGL GLES API" },
+  { "gl-disable-gles", GDK_DEBUG_GL_DISABLE_GLES, "Don't allow OpenGL GLES API" },
   { "gl-prefer-gl",    GDK_DEBUG_GL_PREFER_GL, "Prefer GL over GLES API" },
+  { "gl-egl",          GDK_DEBUG_GL_EGL, "Use EGL on X11 or Windows" },
+  { "gl-glx",          GDK_DEBUG_GL_GLX, "Use GLX on X11" },
+  { "gl-wgl",          GDK_DEBUG_GL_WGL, "Use WGL on Windows" },
+  { "vulkan-disable",  GDK_DEBUG_VULKAN_DISABLE, "Disable Vulkan support" },
+  { "vulkan-validate", GDK_DEBUG_VULKAN_VALIDATE, "Load the Vulkan validation layer" },
   { "default-settings",GDK_DEBUG_DEFAULT_SETTINGS, "Force default values for xsettings" },
   { "high-depth",      GDK_DEBUG_HIGH_DEPTH, "Use high bit depth rendering if possible" },
   { "no-vsync",        GDK_DEBUG_NO_VSYNC, "Repaint instantly (uses 100% CPU with animations)" },
+  { "dmabuf-disable",  GDK_DEBUG_DMABUF_DISABLE, "Disable dmabuf support" },
 };
 
-static const GdkDebugKey gdk_feature_keys[] = {
-  { "gl",         GDK_FEATURE_OPENGL,           "Disable OpenGL support" },
-  { "gl-api",     GDK_FEATURE_GL_API,           "Disable non-GLES GL API" },
-  { "gles-api",   GDK_FEATURE_GLES_API,         "Disable GLES GL API" },
-  { "egl",        GDK_FEATURE_EGL,              "Disable EGL" },
-  { "glx",        GDK_FEATURE_GLX,              "Disable GLX" },
-  { "wgl",        GDK_FEATURE_WGL,              "Disable WGL" },
-  { "vulkan",     GDK_FEATURE_VULKAN,           "Disable Vulkan support" },
-  { "dmabuf",     GDK_FEATURE_DMABUF,           "Disable dmabuf support" },
-  { "offload",    GDK_FEATURE_OFFLOAD,          "Disable graphics offload" },
-  { "color-mgmt", GDK_FEATURE_COLOR_MANAGEMENT, "Disable color management" },
-};
-
-
-static GdkFeatures gdk_features;
-
-gboolean
-gdk_has_feature (GdkFeatures features)
-{
-  return (features & gdk_features) == features;
-}
 
 #ifdef G_HAS_CONSTRUCTORS
 #ifdef G_DEFINE_CONSTRUCTOR_NEEDS_PRAGMA
-#pragma G_DEFINE_CONSTRUCTOR_PRAGMA_ARGS(stash_and_unset_environment)
+#pragma G_DEFINE_CONSTRUCTOR_PRAGMA_ARGS(stash_desktop_startup_notification_id)
 #endif
-G_DEFINE_CONSTRUCTOR(stash_and_unset_environment)
+G_DEFINE_CONSTRUCTOR(stash_desktop_startup_notification_id)
 #endif
 
 static char *startup_notification_id = NULL;
-static char *xdg_activation_token = NULL;
 
 static void
-stash_and_unset_environment (void)
+stash_desktop_startup_notification_id (void)
 {
-  /* Copies environment variables and unsets them so they won't be inherited by
-   * child processes and confuse things.
-   *
-   * Changing environment variables can be racy so we try to do this as early as
-   * possible in the program flow and before any printing that might involve
-   * environment variables.
-   */
-  struct {
-    const char *key;
-    char **dst;
-  } vars[] = {
-    { "DESKTOP_STARTUP_ID", &startup_notification_id },
-    { "XDG_ACTIVATION_TOKEN", &xdg_activation_token },
-  };
-  size_t i;
+  const char *desktop_startup_id;
 
-  for (i = 0; i < G_N_ELEMENTS (vars); i++)
-    *vars[i].dst = g_strdup (g_getenv (vars[i].key));
-
-  for (i = 0; i < G_N_ELEMENTS (vars); i++)
-    g_unsetenv (vars[i].key);
-
-  for (i = 0; i < G_N_ELEMENTS (vars); i++)
+  desktop_startup_id = g_getenv ("DESKTOP_STARTUP_ID");
+  if (desktop_startup_id && *desktop_startup_id != '\0')
     {
-      if (*vars[i].dst == NULL)
-        continue;
-
-      if (!g_utf8_validate (*vars[i].dst, -1, NULL))
-        {
-          g_warning ("%s contains invalid UTF-8", vars[i].key);
-          g_clear_pointer (vars[i].dst, g_free);
-        }
+      if (!g_utf8_validate (desktop_startup_id, -1, NULL))
+        g_warning ("DESKTOP_STARTUP_ID contains invalid UTF-8");
+      else
+        startup_notification_id = g_strdup (desktop_startup_id);
     }
+
+  /* Clear the environment variable so it won't be inherited by
+   * child processes and confuse things.
+   */
+  g_unsetenv ("DESKTOP_STARTUP_ID");
 }
 
 static gpointer
@@ -229,7 +188,6 @@ gdk_ensure_resources (void)
 
 guint
 gdk_parse_debug_var (const char        *variable,
-                     const char        *docs,
                      const GdkDebugKey *keys,
                      guint              nkeys)
 {
@@ -290,7 +248,6 @@ gdk_parse_debug_var (const char        *variable,
         max_width = MAX (max_width, strlen (keys[i].key));
       max_width += 4;
 
-      fprintf (stderr, "%s\n", docs);
       fprintf (stderr, "Supported %s values:\n", variable);
       for (i = 0; i < nkeys; i++) {
         fprintf (stderr, "  %s%*s%s\n", keys[i].key, (int)(max_width - strlen (keys[i].key)), " ", keys[i].help);
@@ -318,29 +275,24 @@ gdk_parse_debug_var (const char        *variable,
 void
 gdk_pre_parse (void)
 {
-  GdkFeatures disabled_features;
-
   gdk_initialized = TRUE;
 
   gdk_ensure_resources ();
 
   _gdk_debug_flags = gdk_parse_debug_var ("GDK_DEBUG",
-      "GDK_DEBUG can be set to values that make GDK print out different\n"
-      "types of debugging information or change the behavior of GDK for\n"
-      "debugging purposes.\n",
-      gdk_debug_keys,
-      G_N_ELEMENTS (gdk_debug_keys));
+                                          gdk_debug_keys,
+                                          G_N_ELEMENTS (gdk_debug_keys));
 
-  disabled_features = gdk_parse_debug_var ("GDK_DISABLE",
-      "GDK_DISABLE can be set to values which cause GDK to disable\n"
-      "certain features.\n",
-      gdk_feature_keys,
-      G_N_ELEMENTS (gdk_feature_keys));
-
-  gdk_features = GDK_ALL_FEATURES & ~disabled_features;
+  /* These are global */
+  if (_gdk_debug_flags & GDK_DEBUG_GL_EGL)
+    gdk_gl_backend_use (GDK_GL_EGL);
+  else if (_gdk_debug_flags & GDK_DEBUG_GL_GLX)
+    gdk_gl_backend_use (GDK_GL_GLX);
+  else if (_gdk_debug_flags & GDK_DEBUG_GL_WGL)
+    gdk_gl_backend_use (GDK_GL_WGL);
 
 #ifndef G_HAS_CONSTRUCTORS
-  stash_and_unset_environment ();
+  stash_desktop_startup_notification_id ();
 #endif
 }
 
@@ -374,20 +326,15 @@ gdk_display_open_default (void)
 /*< private >
  * gdk_get_startup_notification_id:
  *
- * Returns the original value of the XDG_ACTIVATION_TOKEN environment
- * variable if it was defined and valid, otherwise it returns the original
- * value of the DESKTOP_STARTUP_ID environment variable if it was defined
- * and valid, or %NULL if neither of them were defined and valid.
+ * Returns the original value of the DESKTOP_STARTUP_ID environment
+ * variable if it was defined and valid, or %NULL otherwise.
  *
  * Returns: (nullable) (transfer none): the original value of the
- *   XDG_ACTIVATION_TOKEN or DESKTOP_STARTUP_ID environment variable
+ *   DESKTOP_STARTUP_ID environment variable
  */
 const char *
 gdk_get_startup_notification_id (void)
 {
-  if (xdg_activation_token)
-    return xdg_activation_token;
-
   return startup_notification_id;
 }
 

gdk/gdk.h

@@ -29,9 +29,7 @@
 #include <gdk/gdkapplaunchcontext.h>
 #include <gdk/gdkcairo.h>
 #include <gdk/gdkcairocontext.h>
-#include <gdk/gdkcicpparams.h>
 #include <gdk/gdkclipboard.h>
-#include <gdk/gdkcolorstate.h>
 #include <gdk/gdkconfig.h>
 #include <gdk/gdkcontentdeserializer.h>
 #include <gdk/gdkcontentformats.h>
@@ -63,7 +61,6 @@
 #include <gdk/gdkkeys.h>
 #include <gdk/gdkkeysyms.h>
 #include <gdk/gdkmemorytexture.h>
-#include <gdk/gdkmemorytexturebuilder.h>
 #include <gdk/gdkmonitor.h>
 #include <gdk/gdkpaintable.h>
 #include <gdk/gdkpango.h>

gdk/gdkapplaunchcontext.c

@@ -120,7 +120,7 @@ gdk_app_launch_context_class_init (GdkAppLaunchContextClass *klass)
   context_class->launch_failed = gdk_app_launch_context_launch_failed;
 
   /**
-   * GdkAppLaunchContext:display:
+   * GdkAppLaunchContext:display: (attributes org.gtk.Property.get=gdk_app_launch_context_get_display)
    *
    * The display that the `GdkAppLaunchContext` is on.
    */
@@ -169,7 +169,7 @@ gdk_app_launch_context_get_display_name (GAppLaunchContext *context,
 }
 
 /**
- * gdk_app_launch_context_get_display:
+ * gdk_app_launch_context_get_display: (attributes org.gtk.Method.get_property=display)
  * @context: a `GdkAppLaunchContext`
  *
  * Gets the `GdkDisplay` that @context is for.

gdk/gdkarrayimpl.c

@@ -41,10 +41,8 @@ G_BEGIN_DECLS
 
 #ifdef GDK_ARRAY_NULL_TERMINATED
 #define GDK_ARRAY_REAL_SIZE(_size) ((_size) + 1)
-#define GDK_ARRAY_MAX_SIZE (G_MAXSIZE / sizeof (_T_) - 1)
 #else
 #define GDK_ARRAY_REAL_SIZE(_size) (_size)
-#define GDK_ARRAY_MAX_SIZE (G_MAXSIZE / sizeof (_T_))
 #endif
 
 /* make this readable */
@@ -179,23 +177,18 @@ G_GNUC_UNUSED static inline void
 gdk_array(reserve) (GdkArray *self,
                     gsize      n)
 {
-  gsize new_capacity, size, capacity;
+  gsize new_size, size;
 
-  if (G_UNLIKELY (n > GDK_ARRAY_MAX_SIZE))
-    g_error ("requesting array size of %zu, but maximum size is %zu", n, GDK_ARRAY_MAX_SIZE);
-
-  capacity = gdk_array(get_capacity) (self);
-  if (n <= capacity)
-     return;
+  if (n <= gdk_array(get_capacity) (self))
+    return;
 
   size = gdk_array(get_size) (self);
-  /* capacity * 2 can overflow, that's why we MAX() */
-  new_capacity = MAX (GDK_ARRAY_REAL_SIZE (n), capacity * 2);
+  new_size = ((gsize) 1) << g_bit_storage (MAX (GDK_ARRAY_REAL_SIZE (n), 16) - 1);
 
 #ifdef GDK_ARRAY_PREALLOC
   if (self->start == self->preallocated)
     {
-      self->start = g_new (_T_, new_capacity);
+      self->start = g_new (_T_, new_size);
       memcpy (self->start, self->preallocated, sizeof (_T_) * GDK_ARRAY_REAL_SIZE (size));
     }
   else
@@ -203,15 +196,15 @@ gdk_array(reserve) (GdkArray *self,
 #ifdef GDK_ARRAY_NULL_TERMINATED
   if (self->start == NULL)
     {
-      self->start = g_new (_T_, new_capacity);
+      self->start = g_new (_T_, new_size);
       *self->start = *(_T_[1]) { 0 };
     }
   else
 #endif
-    self->start = g_renew (_T_, self->start, new_capacity);
+    self->start = g_renew (_T_, self->start, new_size);
 
   self->end = self->start + size;
-  self->end_allocation = self->start + new_capacity;
+  self->end_allocation = self->start + new_size;
 #ifdef GDK_ARRAY_NULL_TERMINATED
   self->end_allocation--;
 #endif
@@ -319,7 +312,6 @@ gdk_array(get) (const GdkArray *self,
 #undef gdk_array_paste
 #undef gdk_array
 #undef GDK_ARRAY_REAL_SIZE
-#undef GDK_ARRAY_MAX_SIZE
 
 #undef GDK_ARRAY_BY_VALUE
 #undef GDK_ARRAY_ELEMENT_TYPE

gdk/gdkcairocontext.c

@@ -82,10 +82,8 @@ gdk_cairo_context_cairo_create (GdkCairoContext *self)
 
   draw_context = GDK_DRAW_CONTEXT (self);
 
-G_GNUC_BEGIN_IGNORE_DEPRECATIONS
   if (!gdk_draw_context_is_in_frame (draw_context))
     return NULL;
-G_GNUC_END_IGNORE_DEPRECATIONS
 
   cr = GDK_CAIRO_CONTEXT_GET_CLASS (self)->cairo_create (self);
 

gdk/gdkcairoprivate.h

@@ -1,159 +0,0 @@
-#pragma once
-
-#include "gdkcolorstateprivate.h"
-#include "gdkcolorprivate.h"
-
-#include "gdkmemoryformatprivate.h"
-#include "gdkmemorytexture.h"
-
-#include <cairo.h>
-#include <graphene.h>
-
-static inline cairo_format_t
-gdk_cairo_format_for_depth (GdkMemoryDepth depth)
-{
-  switch (depth)
-    {
-      case GDK_MEMORY_NONE:
-      case GDK_MEMORY_U8:
-        return CAIRO_FORMAT_ARGB32;
-
-      case GDK_MEMORY_U8_SRGB:
-      case GDK_MEMORY_U16:
-      case GDK_MEMORY_FLOAT16:
-      case GDK_MEMORY_FLOAT32:
-        return CAIRO_FORMAT_RGBA128F;
-
-      case GDK_N_DEPTHS:
-      default:
-        g_return_val_if_reached (CAIRO_FORMAT_ARGB32);
-    }
-}
-
-static inline GdkMemoryDepth
-gdk_cairo_depth_for_format (cairo_format_t format)
-{
-  switch (format)
-  {
-    case CAIRO_FORMAT_ARGB32:
-    case CAIRO_FORMAT_RGB24:
-    case CAIRO_FORMAT_RGB16_565:
-    case CAIRO_FORMAT_A1:
-    case CAIRO_FORMAT_A8:
-      return GDK_MEMORY_U8;
-
-    case CAIRO_FORMAT_RGB30:
-      return GDK_MEMORY_U16;
-
-    case CAIRO_FORMAT_RGB96F:
-    case CAIRO_FORMAT_RGBA128F:
-      return GDK_MEMORY_FLOAT32;
-
-    case CAIRO_FORMAT_INVALID:
-    default:
-      g_assert_not_reached ();
-      return GDK_MEMORY_NONE;
-  }
-}
-
-static GdkMemoryFormat
-gdk_cairo_format_to_memory_format (cairo_format_t format)
-{
-  switch (format)
-  {
-    case CAIRO_FORMAT_ARGB32:
-      return GDK_MEMORY_DEFAULT;
-
-    case CAIRO_FORMAT_RGB24:
-#if G_BYTE_ORDER == G_LITTLE_ENDIAN
-      return GDK_MEMORY_B8G8R8X8;
-#elif G_BYTE_ORDER == G_BIG_ENDIAN
-      return GDK_MEMORY_X8R8G8B8;
-#else
-#error "Unknown byte order for Cairo format"
-#endif
-    case CAIRO_FORMAT_A8:
-      return GDK_MEMORY_A8;
-    case CAIRO_FORMAT_RGB96F:
-      return GDK_MEMORY_R32G32B32_FLOAT;
-    case CAIRO_FORMAT_RGBA128F:
-      return GDK_MEMORY_R32G32B32A32_FLOAT_PREMULTIPLIED;
-
-    case CAIRO_FORMAT_RGB16_565:
-    case CAIRO_FORMAT_RGB30:
-    case CAIRO_FORMAT_INVALID:
-    case CAIRO_FORMAT_A1:
-    default:
-      g_assert_not_reached ();
-      return GDK_MEMORY_DEFAULT;
-  }
-}
-
-static inline void
-gdk_cairo_set_source_color (cairo_t        *cr,
-                            GdkColorState  *ccs,
-                            const GdkColor *color)
-{
-  float c[4];
-  gdk_color_to_float (color, ccs, c);
-  cairo_set_source_rgba (cr, c[0], c[1], c[2], c[3]);
-}
-
-static inline void
-gdk_cairo_set_source_rgba_ccs (cairo_t       *cr,
-                               GdkColorState *ccs,
-                               const GdkRGBA *rgba)
-{
-  GdkColor c;
-  gdk_color_init_from_rgba (&c, rgba);
-  gdk_cairo_set_source_color (cr, ccs, &c);
-  gdk_color_finish (&c);
-}
-
-static inline void
-gdk_cairo_pattern_add_color_stop_rgba_ccs (cairo_pattern_t *pattern,
-                                           GdkColorState   *ccs,
-                                           double           offset,
-                                           const GdkRGBA   *rgba)
-{
-  float color[4];
-
-  gdk_color_state_from_rgba (ccs, rgba, color);
-  cairo_pattern_add_color_stop_rgba (pattern, offset, color[0], color[1], color[2], color[3]);
-}
-
-static inline void
-gdk_cairo_rect (cairo_t               *cr,
-                const graphene_rect_t *rect)
-{
-  cairo_rectangle (cr,
-                   rect->origin.x, rect->origin.y,
-                   rect->size.width, rect->size.height);
-}
-
-static inline void
-gdk_cairo_surface_convert_color_state (cairo_surface_t *surface,
-                                       GdkColorState   *source,
-                                       GdkColorState   *target)
-{
-  cairo_surface_t *image_surface;
-
-  if (gdk_color_state_equal (source, target))
-    return;
-
-  image_surface = cairo_surface_map_to_image (surface, NULL);
-
-  gdk_memory_convert_color_state (cairo_image_surface_get_data (image_surface),
-                                  cairo_image_surface_get_stride (image_surface),
-                                  gdk_cairo_format_to_memory_format (cairo_image_surface_get_format (image_surface)),
-                                  source,
-                                  target,
-                                  cairo_image_surface_get_width (image_surface),
-                                  cairo_image_surface_get_height (image_surface));
-
-  cairo_surface_mark_dirty (image_surface);
-  cairo_surface_unmap_image (surface, image_surface);
-  /* https://gitlab.freedesktop.org/cairo/cairo/-/merge_requests/487 */
-  cairo_surface_mark_dirty (surface);
-}
-

gdk/gdkcicpparams.c

@@ -1,481 +0,0 @@
-/* gdkcicpparams.c
- *
- * Copyright 2024 Matthias Clasen
- *
- * This library is free software; you can redistribute it and/or
- * modify it under the terms of the GNU Lesser General Public
- * License as published by the Free Software Foundation; either
- * version 2 of the License, or (at your option) any later version.
- *
- * This library is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
- * Lesser General Public License for more details.
- *
- * You should have received a copy of the GNU Lesser General Public
- * License along with this library. If not, see <http://www.gnu.org/licenses/>.
- */
-
-#include "config.h"
-
-#include "gdkcicpparamsprivate.h"
-#include "gdkcolorstateprivate.h"
-#include "gdkenumtypes.h"
-
-/**
- * GdkCicpParams:
- *
- * The `GdkCicpParams` struct contains the parameters that define
- * a colorstate according to the ITU-T H.273
- * [specification](https://www.itu.int/rec/T-REC-H.273/en).
- *
- * See the documentation of individual properties for supported values.
- *
- * The 'unspecified' value (2) is not treated in any special way, and
- * must be replaced by a different value before creating a color state.
- *
- * `GdkCicpParams` can be used as a builder object to construct a color
- * state from Cicp data with [method@Gdk.CicpParams.build_color_state].
- * The function will return an error if the given parameters are not
- * supported.
- *
- * You can obtain a `GdkCicpParams` object from a color state with
- * [method@Gdk.ColorState.create_cicp_params]. This can be used to
- * create a variant of a color state, by changing just one of the cicp
- * parameters, or just to obtain information about the color state.
- *
- * Since: 4.16
- */
-
-/* {{{ GObject boilerplate */
-
-struct _GdkCicpParams
-{
-  GObject parent_instance;
-
-  GdkCicp cicp;
-};
-
-struct _GdkCicpParamsClass
-{
-  GObjectClass parent_class;
-};
-
-G_DEFINE_TYPE (GdkCicpParams, gdk_cicp_params, G_TYPE_OBJECT)
-
-enum
-{
-  PROP_COLOR_PRIMARIES = 1,
-  PROP_TRANSFER_FUNCTION,
-  PROP_MATRIX_COEFFICIENTS,
-  PROP_RANGE,
-
-  N_PROPERTIES,
-};
-
-static GParamSpec *properties[N_PROPERTIES] = { NULL, };
-
-static void
-gdk_cicp_params_init (GdkCicpParams *self)
-{
-  self->cicp.color_primaries = 2;
-  self->cicp.transfer_function = 2;
-  self->cicp.matrix_coefficients = 2;
-  self->cicp.range = GDK_CICP_RANGE_NARROW;
-}
-
-static void
-gdk_cicp_params_get_property (GObject    *object,
-                              guint       property_id,
-                              GValue     *value,
-                              GParamSpec *pspec)
-{
-  GdkCicpParams *self = GDK_CICP_PARAMS (object);
-
-  switch (property_id)
-    {
-    case PROP_COLOR_PRIMARIES:
-      g_value_set_uint (value, self->cicp.color_primaries);
-      break;
-
-    case PROP_TRANSFER_FUNCTION:
-      g_value_set_uint (value, self->cicp.transfer_function);
-      break;
-
-    case PROP_MATRIX_COEFFICIENTS:
-      g_value_set_uint (value, self->cicp.matrix_coefficients);
-      break;
-
-    case PROP_RANGE:
-      g_value_set_enum (value, self->cicp.range);
-      break;
-
-    default:
-      G_OBJECT_WARN_INVALID_PROPERTY_ID (object, property_id, pspec);
-      break;
-    }
-}
-
-static void
-gdk_cicp_params_set_property (GObject      *object,
-                              guint         property_id,
-                              const GValue *value,
-                              GParamSpec   *pspec)
-{
-  GdkCicpParams *self = GDK_CICP_PARAMS (object);
-
-  switch (property_id)
-    {
-    case PROP_COLOR_PRIMARIES:
-      gdk_cicp_params_set_color_primaries (self, g_value_get_uint (value));
-      break;
-
-    case PROP_TRANSFER_FUNCTION:
-      gdk_cicp_params_set_transfer_function (self, g_value_get_uint (value));
-      break;
-
-    case PROP_MATRIX_COEFFICIENTS:
-      gdk_cicp_params_set_matrix_coefficients (self, g_value_get_uint (value));
-      break;
-
-    case PROP_RANGE:
-      gdk_cicp_params_set_range (self, g_value_get_enum (value));
-      break;
-
-    default:
-      G_OBJECT_WARN_INVALID_PROPERTY_ID (object, property_id, pspec);
-      break;
-    }
-}
-
-static void
-gdk_cicp_params_class_init (GdkCicpParamsClass *klass)
-{
-  GObjectClass *object_class = G_OBJECT_CLASS (klass);
-
-  object_class->get_property = gdk_cicp_params_get_property;
-  object_class->set_property = gdk_cicp_params_set_property;
-
-  /**
-   * GdkCicpParams:color-primaries:
-   *
-   * The color primaries to use.
-   *
-   * Supported values:
-   *
-   * - 1: BT.709 / sRGB
-   * - 2: unspecified
-   * - 5: PAL
-   * - 6,7: BT.601 / NTSC
-   * - 9: BT.2020
-   * - 12: Display P3
-   *
-   * Since: 4.16
-   */
-  properties[PROP_COLOR_PRIMARIES] =
-    g_param_spec_uint ("color-primaries", NULL, NULL,
-                       0, 255, 2,
-                       G_PARAM_READWRITE | G_PARAM_EXPLICIT_NOTIFY | G_PARAM_STATIC_STRINGS);
-
-  /**
-   * GdkCicpParams:transfer-function:
-   *
-   * The transfer function to use.
-   *
-   * Supported values:
-   *
-   * - 1,6,14,15: BT.709, BT.601, BT.2020
-   * - 2: unspecified
-   * - 4: gamma 2.2
-   * - 5: gamma 2.8
-   * - 8: linear
-   * - 13: sRGB
-   * - 16: BT.2100 PQ
-   * - 18: BT.2100 HLG
-   *
-   * Since: 4.16
-   */
-  properties[PROP_TRANSFER_FUNCTION] =
-    g_param_spec_uint ("transfer-function", NULL, NULL,
-                       0, 255, 2,
-                       G_PARAM_READWRITE | G_PARAM_EXPLICIT_NOTIFY | G_PARAM_STATIC_STRINGS);
-
-  /**
-   * GdkCicpParams:matrix-coefficients:
-   *
-   * The matrix coefficients (for YUV to RGB conversion).
-   *
-   * Supported values:
-   *
-   * - 0: RGB
-   * - 2: unspecified
-   *
-   * Since: 4.16
-   */
-  properties[PROP_MATRIX_COEFFICIENTS] =
-    g_param_spec_uint ("matrix-coefficients", NULL, NULL,
-                       0, 255, 2,
-                       G_PARAM_READWRITE | G_PARAM_EXPLICIT_NOTIFY | G_PARAM_STATIC_STRINGS);
-
-  /**
-   * GdkCicpParams:range:
-   *
-   * Whether the data is using the full range of values.
-   *
-   * The range of the data.
-   *
-   * Since: 4.16
-   */
-  properties[PROP_RANGE] =
-    g_param_spec_enum ("range", NULL, NULL,
-                       GDK_TYPE_CICP_RANGE,
-                       GDK_CICP_RANGE_NARROW,
-                       G_PARAM_READWRITE | G_PARAM_EXPLICIT_NOTIFY | G_PARAM_STATIC_STRINGS);
-
-  g_object_class_install_properties (object_class, N_PROPERTIES, properties);
-}
-
-/* }}} */
-/* {{{ Public API */
-
-/**
- * gdk_cicp_params_new:
- *
- * Creates a new `GdkCicpParams` object.
- *
- * The initial values of the properties are the values for "undefined"
- * and need to be set before a color state object can be built.
- *
- * Returns: (transfer full): a new `GdkCicpParams`
- *
- * Since: 4.16
- */
-GdkCicpParams  *
-gdk_cicp_params_new (void)
-{
-  return g_object_new (GDK_TYPE_CICP_PARAMS, NULL);
-}
-
-/**
- * gdk_cicp_params_get_color_primaries:
- * @self: a `GdkCicpParams`
- *
- * Returns the value of the color-primaries property
- * of @self.
- *
- * Returns: the color-primaries value
- *
- * Since: 4.16
- */
-guint
-gdk_cicp_params_get_color_primaries (GdkCicpParams *self)
-{
-  g_return_val_if_fail (GDK_IS_CICP_PARAMS (self), 0);
-
-  return self->cicp.color_primaries;
-}
-
-/**
- * gdk_cicp_params_set_color_primaries:
- * @self: a `GdkCicpParams`
- * @color_primaries: the new color primaries value
- *
- * Sets the color-primaries property of @self.
- *
- * Since: 4.16
- */
-void
-gdk_cicp_params_set_color_primaries (GdkCicpParams *self,
-                                     guint          color_primaries)
-{
-  g_return_if_fail (GDK_IS_CICP_PARAMS (self));
-
-  if (self->cicp.color_primaries == color_primaries)
-    return;
-
-  self->cicp.color_primaries = color_primaries;
-  g_object_notify_by_pspec (G_OBJECT (self), properties[PROP_COLOR_PRIMARIES]);
-}
-
-/**
- * gdk_cicp_params_get_transfer_function:
- * @self: a `GdkCicpParams`
- *
- * Gets the transfer-function property of @self.
- *
- * Returns: the transfer-function value
- *
- * Since: 4.16
- */
-guint
-gdk_cicp_params_get_transfer_function (GdkCicpParams *self)
-{
-  g_return_val_if_fail (GDK_IS_CICP_PARAMS (self), 0);
-
-  return self->cicp.transfer_function;
-}
-
-/**
- * gdk_cicp_params_set_transfer_function:
- * @self: a `GdkCicpParams`
- * @transfer_function: the new transfer-function value
- *
- * Sets the transfer-function property of @self.
- *
- * Since: 4.16
- */
-void
-gdk_cicp_params_set_transfer_function (GdkCicpParams *self,
-                                       guint          transfer_function)
-{
-  g_return_if_fail (GDK_IS_CICP_PARAMS (self));
-
-  if (self->cicp.transfer_function == transfer_function)
-    return;
-
-  self->cicp.transfer_function = transfer_function;
-  g_object_notify_by_pspec (G_OBJECT (self), properties[PROP_TRANSFER_FUNCTION]);
-}
-
-/**
- * gdk_cicp_params_get_matrix_coefficients:
- * @self: a `GdkCicpParams`
- *
- * Gets the matrix-coefficients property of @self.
- *
- * Returns: the matrix-coefficients value
- *
- * Since: 4.16
- */
-guint
-gdk_cicp_params_get_matrix_coefficients (GdkCicpParams *self)
-{
-  g_return_val_if_fail (GDK_IS_CICP_PARAMS (self), 0);
-
-  return self->cicp.matrix_coefficients;
-}
-
-/**
- * gdk_cicp_params_set_matrix_coefficients:
- * @self a `GdkCicpParams`
- * @matrix_coefficients: the new matrix-coefficients value
- *
- * Sets the matrix-coefficients property of @self.
- *
- * Since: 4.16
- */
-void
-gdk_cicp_params_set_matrix_coefficients (GdkCicpParams *self,
-                                         guint          matrix_coefficients)
-{
-  g_return_if_fail (GDK_IS_CICP_PARAMS (self));
-
-  if (self->cicp.matrix_coefficients == matrix_coefficients)
-    return;
-
-  self->cicp.matrix_coefficients = matrix_coefficients;
-  g_object_notify_by_pspec (G_OBJECT (self), properties[PROP_MATRIX_COEFFICIENTS]);
-}
-
-/**
- * gdk_cicp_params_get_range:
- * @self: a `GdkCicpParams`
- *
- * Gets the range property of @self.
- *
- * Returns: the range value
- *
- * Since: 4.16
- */
-GdkCicpRange
-gdk_cicp_params_get_range (GdkCicpParams *self)
-{
-  g_return_val_if_fail (GDK_IS_CICP_PARAMS (self), GDK_CICP_RANGE_NARROW);
-
-  return self->cicp.range;
-}
-
-/**
- * gdk_cicp_params_set_range:
- * @self: a `GdkCipParams`
- * @range: the range value
- *
- * Sets the range property of @self
- *
- * Since: 4.16
- */
-void
-gdk_cicp_params_set_range (GdkCicpParams *self,
-                           GdkCicpRange   range)
-{
-  g_return_if_fail (GDK_IS_CICP_PARAMS (self));
-
-  if (self->cicp.range == range)
-    return;
-
-  self->cicp.range = range;
-  g_object_notify_by_pspec (G_OBJECT (self), properties[PROP_RANGE]);
-}
-
-/**
- * gdk_cicp_params_build_color_state:
- * @self: a `GdkCicpParams`
- * @error: return location for errors
- *
- * Creates a new `GdkColorState` object for the cicp parameters in @self.
- *
- * Note that this may fail if the cicp parameters in @self are not
- * 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: (transfer full) (nullable): A newly allocated `GdkColorState`
- *
- * Since: 4.16
- */
-GdkColorState *
-gdk_cicp_params_build_color_state (GdkCicpParams  *self,
-                                   GError        **error)
-{
-  return gdk_color_state_new_for_cicp (gdk_cicp_params_get_cicp (self), error);
-}
-
-/* }}} */
-/* {{{ Private API */
-
-/*< private >
- * gdk_cicp_params_new_for_cicp:
- * @cicp: a GdkCicp struct
- *
- * Create a `GdkCicpParams` from the values in @cicp.
- *
- * Returns: (transfer full): a new `GdkCicpParams` object
- */
-GdkCicpParams *
-gdk_cicp_params_new_for_cicp (const GdkCicp *cicp)
-{
-  return g_object_new (GDK_TYPE_CICP_PARAMS,
-                       "color-primaries", cicp->color_primaries,
-                       "transfer-function", cicp->transfer_function,
-                       "matrix-coefficients", cicp->matrix_coefficients,
-                       "range", cicp->range,
-                       NULL);
-}
-
-/*< private >
- * gdk_cicp_params_get_cicp:
- * @self: a `GdkCicpParams` object
- *
- * Gets the `GdkCicp` struct of @self.
- *
- * Returns: (transfer none): a `GdkCicp` struct containing
- *     the values of @self
- */
-const GdkCicp *
-gdk_cicp_params_get_cicp (GdkCicpParams *self)
-{
-  return &self->cicp;
-}
-
-/* }}} */
-
-/* vim:set foldmethod=marker expandtab: */

gdk/gdkcicpparams.h

@@ -1,90 +0,0 @@
-/* gdkcicpparams.h
- *
- * Copyright 2024 Red Hat, Inc.
- *
- * This library is free software; you can redistribute it and/or
- * modify it under the terms of the GNU Lesser General Public
- * License as published by the Free Software Foundation; either
- * version 2 of the License, or (at your option) any later version.
- *
- * This library is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
- * Lesser General Public License for more details.
- *
- * You should have received a copy of the GNU Lesser General Public
- * License along with this library. If not, see <http://www.gnu.org/licenses/>.
- */
-
-#pragma once
-
-#if !defined (__GDK_H_INSIDE__) && !defined (GTK_COMPILATION)
-#error "Only <gdk/gdk.h> can be included directly."
-#endif
-
-#include <gdk/gdktypes.h>
-
-G_BEGIN_DECLS
-
-
-#define GDK_TYPE_CICP_PARAMS (gdk_cicp_params_get_type ())
-GDK_AVAILABLE_IN_4_16
-GDK_DECLARE_INTERNAL_TYPE (GdkCicpParams, gdk_cicp_params, GDK, CICP_PARAMS, GObject)
-
-GDK_AVAILABLE_IN_4_16
-GdkCicpParams  *gdk_cicp_params_new                     (void);
-
-GDK_AVAILABLE_IN_4_16
-guint           gdk_cicp_params_get_color_primaries     (GdkCicpParams    *self);
-
-GDK_AVAILABLE_IN_4_16
-void            gdk_cicp_params_set_color_primaries     (GdkCicpParams    *self,
-                                                         guint             color_primaries);
-
-GDK_AVAILABLE_IN_4_16
-guint           gdk_cicp_params_get_transfer_function   (GdkCicpParams    *self);
-
-GDK_AVAILABLE_IN_4_16
-void            gdk_cicp_params_set_transfer_function   (GdkCicpParams    *self,
-                                                         guint             transfer_function);
-
-GDK_AVAILABLE_IN_4_16
-guint           gdk_cicp_params_get_matrix_coefficients (GdkCicpParams    *self);
-
-GDK_AVAILABLE_IN_4_16
-void            gdk_cicp_params_set_matrix_coefficients (GdkCicpParams    *self,
-                                                         guint             matrix_coefficients);
-
-/**
- * GdkCicpRange:
- * @GDK_CICP_RANGE_NARROW: The values use the range of 16-235 (for Y) and 16-240 for u and v.
- * @GDK_CICP_RANGE_FULL: The values use the full range.
- *
- * The values of this enumeration describe whether image data uses
- * the full range of 8-bit values.
- *
- * In digital broadcasting, it is common to reserve the lowest and
- * highest values. Typically the allowed values for the narrow range
- * are 16-235 for Y and 16-240 for u,v (when dealing with YUV data).
- *
- * Since: 4.16
- */
-typedef enum
-{
-  GDK_CICP_RANGE_NARROW,
-  GDK_CICP_RANGE_FULL,
-} GdkCicpRange;
-
-GDK_AVAILABLE_IN_4_16
-GdkCicpRange    gdk_cicp_params_get_range               (GdkCicpParams    *self);
-
-GDK_AVAILABLE_IN_4_16
-void            gdk_cicp_params_set_range               (GdkCicpParams    *self,
-                                                         GdkCicpRange      range);
-
-GDK_AVAILABLE_IN_4_16
-GdkColorState * gdk_cicp_params_build_color_state       (GdkCicpParams    *self,
-                                                         GError          **error);
-
-
-G_END_DECLS

gdk/gdkcicpparamsprivate.h

@@ -1,84 +0,0 @@
-#pragma once
-
-#include "gdkcicpparams.h"
-
-typedef struct _GdkCicp GdkCicp;
-
-struct _GdkCicp
-{
-  guint color_primaries;
-  guint transfer_function;
-  guint matrix_coefficients;
-  GdkCicpRange range;
-};
-
-/*< private >
- * gdk_cicp_equal:
- * @p1: a `GdkCicp`
- * @p2: another `GdkCicp`
- *
- * Compare two cicp tuples for equality.
- *
- * Note that several cicp values are 'functionally equivalent'.
- * If you are interested in that notion, use gdk_cicp_equivalent().
- *
- * Returns: whether @p1 and @p2 are equal
- */
-static inline gboolean
-gdk_cicp_equal (const GdkCicp *p1,
-                const GdkCicp *p2)
-{
-  return p1->color_primaries == p2->color_primaries &&
-         p1->transfer_function == p2->transfer_function &&
-         p1->matrix_coefficients == p2->matrix_coefficients &&
-         p1->range == p2->range;
-}
-
-static inline void
-gdk_cicp_normalize (const GdkCicp *orig,
-                    GdkCicp       *out)
-{
-  memcpy (out, orig, sizeof (GdkCicp));
-
-  /* ntsc */
-  if (out->color_primaries == 6)
-    out->color_primaries = 5;
-
-  /* bt709 */
-  if (out->transfer_function == 6 ||
-      out->transfer_function == 14 ||
-      out->transfer_function == 15)
-    out->transfer_function = 1;
-
-  /* bt601 */
-  if (out->matrix_coefficients == 6)
-    out->matrix_coefficients = 5;
-}
-
-/*< private >
- * gdk_cicp_equivalent:
- * @p1: a `GdkCicp`
- * @p2: another `GdkCicp`
- *
- * Determine whether two cicp tuples are functionally equivalent.
- *
- * Returns: whether @p1 and @p2 are functionally equivalent
- */
-static inline gboolean
-gdk_cicp_equivalent (const GdkCicp *p1,
-                     const GdkCicp *p2)
-{
-  GdkCicp n1, n2;
-
-  if (gdk_cicp_equal (p1, p2))
-    return TRUE;
-
-  gdk_cicp_normalize (p1, &n1);
-  gdk_cicp_normalize (p2, &n2);
-
-  return gdk_cicp_equal (&n1, &n2);
-}
-
-const GdkCicp * gdk_cicp_params_get_cicp (GdkCicpParams *params);
-
-GdkCicpParams * gdk_cicp_params_new_for_cicp (const GdkCicp  *cicp);

gdk/gdkclipboard.c

@@ -353,7 +353,7 @@ gdk_clipboard_class_init (GdkClipboardClass *class)
   class->read_finish = gdk_clipboard_read_local_finish;
 
   /**
-   * GdkClipboard:display:
+   * GdkClipboard:display: (attributes org.gtk.Property.get=gdk_clipboard_get_display)
    *
    * The `GdkDisplay` that the clipboard belongs to.
    */
@@ -366,7 +366,7 @@ gdk_clipboard_class_init (GdkClipboardClass *class)
                          G_PARAM_EXPLICIT_NOTIFY);
 
   /**
-   * GdkClipboard:formats:
+   * GdkClipboard:formats: (attributes org.gtk.Property.get=gdk_clipboard_get_formats)
    *
    * The possible formats that the clipboard can provide its data in.
    */
@@ -378,7 +378,7 @@ gdk_clipboard_class_init (GdkClipboardClass *class)
                         G_PARAM_EXPLICIT_NOTIFY);
 
   /**
-   * GdkClipboard:local: (getter is_local)
+   * GdkClipboard:local: (attributes org.gtk.Property.get=gdk_clipboard_is_local)
    *
    * %TRUE if the contents of the clipboard are owned by this process.
    */
@@ -390,7 +390,7 @@ gdk_clipboard_class_init (GdkClipboardClass *class)
                           G_PARAM_EXPLICIT_NOTIFY);
 
   /**
-   * GdkClipboard:content:
+   * GdkClipboard:content: (attributes org.gtk.Property.get=gdk_clipboard_get_content)
    *
    * The `GdkContentProvider` or %NULL if the clipboard is empty or contents are
    * provided otherwise.
@@ -429,7 +429,7 @@ gdk_clipboard_init (GdkClipboard *clipboard)
 }
 
 /**
- * gdk_clipboard_get_display:
+ * gdk_clipboard_get_display: (attributes org.gtk.Method.get_property=display)
  * @clipboard: a `GdkClipboard`
  *
  * Gets the `GdkDisplay` that the clipboard was created for.
@@ -447,7 +447,7 @@ gdk_clipboard_get_display (GdkClipboard *clipboard)
 }
 
 /**
- * gdk_clipboard_get_formats:
+ * gdk_clipboard_get_formats: (attributes org.gtk.Method.get_property=formats)
  * @clipboard: a `GdkClipboard`
  *
  * Gets the formats that the clipboard can provide its current contents in.
@@ -465,7 +465,7 @@ gdk_clipboard_get_formats (GdkClipboard *clipboard)
 }
 
 /**
- * gdk_clipboard_is_local: (get-property local)
+ * gdk_clipboard_is_local: (attributes org.gtk.Method.get_property=local)
  * @clipboard: a `GdkClipboard`
  *
  * Returns if the clipboard is local.
@@ -489,7 +489,7 @@ gdk_clipboard_is_local (GdkClipboard *clipboard)
 }
 
 /**
- * gdk_clipboard_get_content:
+ * gdk_clipboard_get_content: (attributes org.gtk.Method.get_property=content)
  * @clipboard: a `GdkClipboard`
  *
  * Returns the `GdkContentProvider` currently set on @clipboard.
@@ -515,13 +515,15 @@ gdk_clipboard_get_content (GdkClipboard *clipboard)
  * @clipboard: a `GdkClipboard`
  * @io_priority: the I/O priority of the request
  * @cancellable: (nullable): optional `GCancellable` object
- * @callback: (scope async) (closure user_data): callback to call when the request is satisfied
- * @user_data:: the data to pass to callback function
+ * @callback: (scope async): callback to call when the request is satisfied
+ * @user_data: (closure): the data to pass to callback function
  *
  * Asynchronously instructs the @clipboard to store its contents remotely.
  *
  * If the clipboard is not local, this function does nothing but report success.
  *
+ * The @callback must call [method@Gdk.Clipboard.store_finish].
+ *
  * The purpose of this call is to preserve clipboard contents beyond the
  * lifetime of an application, so this function is typically called on
  * exit. Depending on the platform, the functionality may not be available
@@ -630,12 +632,15 @@ gdk_clipboard_read_internal (GdkClipboard        *clipboard,
  * @mime_types: (array zero-terminated=1): a %NULL-terminated array of mime types to choose from
  * @io_priority: the I/O priority of the request
  * @cancellable: (nullable): optional `GCancellable` object
- * @callback: (scope async) (closure user_data): callback to call when the request is satisfied
- * @user_data: the data to pass to callback function
+ * @callback: (scope async): callback to call when the request is satisfied
+ * @user_data: (closure): the data to pass to callback function
  *
  * Asynchronously requests an input stream to read the @clipboard's
  * contents from.
  *
+ * When the operation is finished @callback will be called. You must then
+ * call [method@Gdk.Clipboard.read_finish] to get the result of the operation.
+ *
  * The clipboard will choose the most suitable mime type from the given list
  * to fulfill the request, preferring the ones listed first.
  */
@@ -823,12 +828,15 @@ gdk_clipboard_read_value_internal (GdkClipboard        *clipboard,
  * @type: a `GType` to read
  * @io_priority: the I/O priority of the request
  * @cancellable: (nullable): optional `GCancellable` object
- * @callback: (scope async) (closure user_data): callback to call when the request is satisfied
- * @user_data: the data to pass to callback function
+ * @callback: (scope async): callback to call when the request is satisfied
+ * @user_data: (closure): the data to pass to callback function
  *
  * Asynchronously request the @clipboard contents converted to the given
  * @type.
  *
+ * When the operation is finished @callback will be called. You must then call
+ * [method@Gdk.Clipboard.read_value_finish] to get the resulting `GValue`.
+ *
  * For local clipboard contents that are available in the given `GType`,
  * the value will be copied directly. Otherwise, GDK will try to use
  * [func@content_deserialize_async] to convert the clipboard's data.
@@ -882,11 +890,14 @@ gdk_clipboard_read_value_finish (GdkClipboard  *clipboard,
  * gdk_clipboard_read_texture_async:
  * @clipboard: a `GdkClipboard`
  * @cancellable: (nullable): optional `GCancellable` object, %NULL to ignore.
- * @callback: (scope async) (closure user_data): callback to call when the request is satisfied
- * @user_data: the data to pass to callback function
+ * @callback: (scope async): callback to call when the request is satisfied
+ * @user_data: (closure): the data to pass to callback function
  *
  * Asynchronously request the @clipboard contents converted to a `GdkPixbuf`.
  *
+ * When the operation is finished @callback will be called. You must then
+ * call [method@Gdk.Clipboard.read_texture_finish] to get the result.
+ *
  * This is a simple wrapper around [method@Gdk.Clipboard.read_value_async].
  * Use that function or [method@Gdk.Clipboard.read_async] directly if you
  * need more control over the operation.
@@ -944,11 +955,14 @@ gdk_clipboard_read_texture_finish (GdkClipboard  *clipboard,
  * gdk_clipboard_read_text_async:
  * @clipboard: a `GdkClipboard`
  * @cancellable: (nullable): optional `GCancellable` object
- * @callback: (scope async) (closure user_data): callback to call when the request is satisfied
- * @user_data: the data to pass to callback function
+ * @callback: (scope async): callback to call when the request is satisfied
+ * @user_data: (closure): the data to pass to callback function
  *
  * Asynchronously request the @clipboard contents converted to a string.
  *
+ * When the operation is finished @callback will be called. You must then
+ * call [method@Gdk.Clipboard.read_text_finish] to get the result.
+ *
  * This is a simple wrapper around [method@Gdk.Clipboard.read_value_async].
  * Use that function or [method@Gdk.Clipboard.read_async] directly if you
  * need more control over the operation.

gdk/gdkcolor.c

@@ -1,287 +0,0 @@
-/* GDK - The GIMP Drawing Kit
- *
- * Copyright (C) 2021 Benjamin Otte
- *
- * This library is free software; you can redistribute it and/or
- * modify it under the terms of the GNU Lesser General Public
- * License as published by the Free Software Foundation; either
- * version 2 of the License, or (at your option) any later version.
- *
- * This library is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
- * Lesser General Public License for more details.
- *
- * You should have received a copy of the GNU Lesser General Public
- * License along with this library. If not, see <http://www.gnu.org/licenses/>.
- */
-
-#include "config.h"
-
-#include "gdkcolorprivate.h"
-#include "gdkcolorstateprivate.h"
-#include "gdkrgbaprivate.h"
-
-/*< private >
- * GdkColor:
- * @color_state: the color state to interpret the values in
- * @values: the 3 coordinates that define the color, followed
- *   by the alpha value
- *
- * A `GdkColor` represents a color.
- *
- * The color state defines the meaning and range of the values.
- * E.g., the srgb color state has r, g, b components representing
- * red, green and blue with a range of [0,1], while the oklch color
- * state has l, c, h components representing luminosity, chromaticity
- * and hue, with l ranging from 0 to 1 and c from 0 to about 0.4, while
- * h is interpreted as angle in degrees.
- *
- * value[3] is always the alpha value with a range of [0,1].
- *
- * The values are also available under the names red, green, blue
- * and alpha, or r, g, b and a.
- */
-
-/*< private >
- * gdk_color_init:
- * @self: the `GdkColor` struct to initialize
- * @color_state: the color state
- * @values: the values
- *
- * Initializes the `GdkColor` with the given color state
- * and values.
- *
- * Note that this takes a reference on @color_state that
- * must be freed by calling [function@Gdk.Color.finish]
- * when the `GdkColor` is no longer needed.
- */
-void
-(gdk_color_init) (GdkColor      *self,
-                  GdkColorState *color_state,
-                  const float    values[4])
-{
-  _gdk_color_init (self, color_state, values);
-}
-
-/*< private >
- * gdk_color_init_copy:
- * @self: the `GdkColor` struct to initialize
- * @color: the `GdkColor` to copy
- *
- * Initializes the `GdkColor` by copying the contents
- * of another `GdkColor`.
- *
- * Note that this takes a reference on the color state
- * that must be freed by calling [function@Gdk.Color.finish]
- * when the `GdkColor` is no longer needed.
- */
-void
-(gdk_color_init_copy) (GdkColor      *self,
-                       const GdkColor *color)
-{
-  _gdk_color_init_copy (self, color);
-}
-
-/*< private >
- * gdk_color_init_from_rgba:
- * @self: the `GdkColor` struct to initialize
- * @rgba: the `GdkRGBA` to copy
- *
- * Initializes the `GdkColor` by copying the contents
- * of a `GdkRGBA`.
- *
- * Note that `GdkRGBA` colors are always in the sRGB
- * color state.
- *
- * Note that this takes a reference on the color state
- * that must be freed by calling [function@Gdk.Color.finish]
- * when the `GdkColor` is no longer needed.
- */
-void
-(gdk_color_init_from_rgba) (GdkColor       *self,
-                            const GdkRGBA  *rgba)
-{
-  _gdk_color_init_from_rgba (self, rgba);
-}
-
-/*< private >
- * @self: a `GdkColor`
- *
- * Drop the reference on the color state of @self.
- *
- * After this, @self is empty and can be initialized again
- * with [function@Gdk.Color.init] and its variants.
- */
-void
-(gdk_color_finish) (GdkColor *self)
-{
-  _gdk_color_finish (self);
-}
-
-/*< private >
- * gdk_color_equal:
- * @self: a `GdkColor`
- * @other: another `GdkColor`
- *
- * Compares two `GdkColor` structs for equality.
- *
- * Returns: `TRUE` if @self and @other are equal
- */
-gboolean
-(gdk_color_equal) (const GdkColor *self,
-                   const GdkColor *other)
-{
-  return _gdk_color_equal (self, other);
-}
-
-/*< private >
- * gdk_color_is_clear:
- * @self: a `GdkColor`
- *
- * Returns whether @self is fully transparent.
- *
- * Returns: `TRUE` if @self is transparent
- */
-gboolean
-(gdk_color_is_clear) (const GdkColor *self)
-{
-  return _gdk_color_is_clear (self);
-}
-
-/*< private >
- * gdk_color_is_opaque:
- * @self: a `GdkColor`
- *
- * Returns whether @self is fully opaque.
- *
- * Returns: `TRUE` if @self if opaque
- */
-gboolean
-(gdk_color_is_opaque) (const GdkColor *self)
-{
-  return _gdk_color_is_opaque (self);
-}
-
-/*< private >
- * gdk_color_convert:
- * @self: the `GdkColor` to store the result in
- * @color_state: the target color start
- * @other: the `GdkColor` to convert
- *
- * Converts a given `GdkColor` to another color state.
- *
- * After the conversion, @self will represent the same
- * color as @other in @color_state, to the degree possible.
- *
- * Different color states have different gamuts of colors
- * they can represent, and converting a color to a color
- * state with a smaller gamut may yield an 'out of gamut'
- * result.
- */
-void
-(gdk_color_convert) (GdkColor        *self,
-                     GdkColorState   *color_state,
-                     const GdkColor  *other)
-{
-  gdk_color_convert (self, color_state, other);
-}
-
-/*< private >
- * gdk_color_to_float:
- * @self: a `GdkColor`
- * @target: the color state to convert to
- * @values: the location to store the result in
- *
- * Converts a given `GdkColor to another color state
- * and stores the result in a `float[4]`.
- */
-void
-(gdk_color_to_float) (const GdkColor *self,
-                      GdkColorState  *target,
-                      float           values[4])
-{
-  gdk_color_to_float (self, target, values);
-}
-
-/*< private >
- * gdk_color_from_rgba:
- * @self: the `GdkColor` to store the result in
- * @color_state: the target color state
- * @rgba: the `GdkRGBA` to convert
- *
- * Converts a given `GdkRGBA` to the target @color_state.
- */
-void
-gdk_color_from_rgba (GdkColor        *self,
-                     GdkColorState   *color_state,
-                     const GdkRGBA   *rgba)
-{
-  GdkColor tmp = {
-    .color_state = GDK_COLOR_STATE_SRGB,
-    .r = rgba->red,
-    .g = rgba->green,
-    .b = rgba->blue,
-    .a = rgba->alpha
-  };
-
-  gdk_color_convert (self, color_state, &tmp);
-  gdk_color_finish (&tmp);
-}
-
-/*< private >
- * gdk_color_print:
- * @self: the `GdkColor` to print
- * @string: the string to print to
- *
- * Appends a representation of @self to @string.
- *
- * The representation is inspired by CSS3 colors,
- * but not 100% identical, and looks like this:
- *
- *     color(NAME R G B / A)
- *
- * where `NAME` identifies color state, and
- * `R`, `G`, `B` and `A` are the components of the color.
- *
- * The alpha may be omitted if it is 1.
- */
-void
-gdk_color_print (const GdkColor *self,
-                 GString        *string)
-{
-  if (gdk_color_state_equal (self->color_state, GDK_COLOR_STATE_SRGB))
-    {
-      gdk_rgba_print ((const GdkRGBA *) self->values, string);
-    }
-  else
-    {
-      g_string_append_printf (string, "color(%s %g %g %g",
-                              gdk_color_state_get_name (self->color_state),
-                              self->r, self->g, self->b);
-      if (self->a < 1)
-        g_string_append_printf (string, " / %g", self->a);
-      g_string_append_c (string, ')');
-    }
-}
-
-/*< private >
- * gdk_color_print:
- * @self: the `GdkColor` to print
- *
- * Create a string representation of @self.
- *
- * See [method@Gdk.Color.print] for details about
- * the format.
-
- * Returns: (transfer full): a newly-allocated string
- */
-char *
-gdk_color_to_string (const GdkColor *self)
-{
-  GString *string = g_string_new ("");
-  gdk_color_print (self, string);
-  return g_string_free (string, FALSE);
-}
-
-

gdk/gdkcolordefs.h

@@ -1,232 +0,0 @@
-/* gdkcolordefs.h
- *
- * Copyright 2024 Matthias Clasen
- *
- * This library is free software; you can redistribute it and/or
- * modify it under the terms of the GNU Lesser General Public
- * License as published by the Free Software Foundation; either
- * version 2 of the License, or (at your option) any later version.
- *
- * This library is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
- * Lesser General Public License for more details.
- *
- * You should have received a copy of the GNU Lesser General Public
- * License along with this library. If not, see <http://www.gnu.org/licenses/>.
- */
-
-/* Note that this header is shared between the color state implementation
- * and tests, and must not include other headers.
- */
-
-static inline int
-sign (float v)
-{
-  return v < 0 ? -1 : 1;
-}
-
-static inline float
-srgb_oetf (float v)
-{
-  if (fabsf (v) > 0.0031308f)
-    return sign (v) * (1.055f * powf (fabsf (v), 1.f / 2.4f) - 0.055f);
-  else
-    return 12.92f * v;
-}
-
-static inline float
-srgb_eotf (float v)
-{
-  if (fabsf (v) >= 0.04045f)
-    return sign (v) * powf (((fabsf (v) + 0.055f) / (1.f + 0.055f)), 2.4f);
-  else
-    return v / 12.92f;
-}
-
-static inline float
-gamma22_oetf (float v)
-{
-  return sign (v) * powf (fabsf (v), 1.f / 2.2f);
-}
-
-static inline float
-gamma22_eotf (float v)
-{
-  return sign (v) * powf (fabsf (v), 2.2f);
-}
-
-static inline float
-gamma28_oetf (float v)
-{
-  return sign (v) * powf (fabsf (v), 1.f / 2.8f);
-}
-
-static inline float
-gamma28_eotf (float v)
-{
-  return sign (v) * powf (fabsf (v), 2.8f);
-}
-
-static inline float
-pq_eotf (float v)
-{
-  float ninv = (1 << 14) / 2610.0;
-  float minv = (1 << 5) / 2523.0;
-  float c1 = 3424.0 / (1 << 12);
-  float c2 = 2413.0 / (1 << 7);
-  float c3 = 2392.0 / (1 << 7);
-
-  float x = powf (fabsf (v), minv);
-  x = powf (MAX ((x - c1), 0) / (c2 - (c3 * x)), ninv);
-
-  return sign (v) * x * 10000 / 203.0;
-}
-
-static inline float
-pq_oetf (float v)
-{
-  float x = v * 203.0 / 10000.0;
-  float n = 2610.0 / (1 << 14);
-  float m = 2523.0 / (1 << 5);
-  float c1 = 3424.0 / (1 << 12);
-  float c2 = 2413.0 / (1 << 7);
-  float c3 = 2392.0 / (1 << 7);
-
-  x = powf (fabsf (x), n);
-  return sign (v) * powf (((c1 + (c2 * x)) / (1 + (c3 * x))), m);
-}
-
-static inline float
-bt709_eotf (float v)
-{
-  const float a = 1.099;
-  const float d = 0.0812;
-
-  if (fabsf (v) < d)
-    return  v / 4.5f;
-  else
-    return sign (v) * powf ((fabsf (v) + (a - 1)) / a, 1 / 0.45f);
-}
-
-static inline float
-bt709_oetf (float v)
-{
-  const float a = 1.099;
-  const float b = 0.018;
-
-  if (fabsf (v) < b)
-    return v * 4.5f;
-  else
-    return sign (v) * (a * powf (fabsf (v), 0.45f) - (a - 1));
-}
-
-static inline float
-hlg_eotf (float v)
-{
-  const float a = 0.17883277;
-  const float b = 0.28466892;
-  const float c = 0.55991073;
-
-  if (fabsf (v) <= 0.5)
-    return sign (v) * (v * v) / 3;
-  else
-    return sign (v) * (expf ((fabsf (v) - c) / a) + b) / 12.0;
-}
-
-static inline float
-hlg_oetf (float v)
-{
-  const float a = 0.17883277;
-  const float b = 0.28466892;
-  const float c = 0.55991073;
-
-  if (fabsf (v) <= 1/12.0)
-    return sign (v) * sqrtf (3 * fabsf (v));
-  else
-    return sign (v) * (a * logf (12 * fabsf (v) - b) + c);
-}
-
-/* See http://www.brucelindbloom.com/index.html?Eqn_RGB_XYZ_Matrix.html
- * for how to derive the abc_to_xyz matrices from chromaticity coordinates.
- */
-
-static const float identity[9] = {
-  1, 0, 0,
-  0, 1, 0,
-  0, 0, 1,
-};
-
-static const float srgb_to_xyz[9] = {
-  0.4124564,  0.3575761,  0.1804375,
-  0.2126729,  0.7151522,  0.0721750,
-  0.0193339,  0.1191920,  0.9503041,
-};
-
-static const float xyz_to_srgb[9] = {
-  3.2404542, -1.5371385, -0.4985314,
- -0.9692660,  1.8760108,  0.0415560,
-  0.0556434, -0.2040259,  1.0572252,
-};
-
-static const float rec2020_to_xyz[9] = {
-  0.6369580,  0.1446169,  0.1688810,
-  0.2627002,  0.6779981,  0.0593017,
-  0.0000000,  0.0280727,  1.0609851,
-};
-
-static const float xyz_to_rec2020[9] = {
-  1.7166512, -0.3556708, -0.2533663,
- -0.6666844,  1.6164812,  0.0157685,
-  0.0176399, -0.0427706,  0.9421031,
-};
-
-static const float pal_to_xyz[9] = {
-  0.4305538,  0.3415498,  0.1783523,
-  0.2220043,  0.7066548,  0.0713409,
-  0.0201822,  0.1295534,  0.9393222,
-};
-
-static const float xyz_to_pal[9] = {
-  3.0633611, -1.3933902, -0.4758237,
- -0.9692436,  1.8759675,  0.0415551,
-  0.0678610, -0.2287993,  1.0690896,
-};
-
-static const float ntsc_to_xyz[9] = {
-  0.3935209,  0.3652581,  0.1916769,
-  0.2123764,  0.7010599,  0.0865638,
-  0.0187391,  0.1119339,  0.9583847,
-};
-
-static const float xyz_to_ntsc[9] = {
-  3.5060033, -1.7397907, -0.5440583,
- -1.0690476,  1.9777789,  0.0351714,
-  0.0563066, -0.1969757,  1.0499523,
-};
-
-static const float p3_to_xyz[9] = {
-  0.4865709,  0.2656677,  0.1982173,
-  0.2289746,  0.6917385,  0.0792869,
-  0.0000000,  0.0451134,  1.0439444,
-};
-
-static const float xyz_to_p3[9] = {
-  2.4934969, -0.9313836, -0.4027108,
- -0.8294890,  1.7626641,  0.0236247,
-  0.0358458, -0.0761724,  0.9568845,
-};
-
-/* premultiplied matrices for default conversions */
-
-static const float rec2020_to_srgb[9] = {
-  1.660227, -0.587548, -0.072838,
- -0.124553,  1.132926, -0.008350,
- -0.018155, -0.100603,  1.118998,
-};
-
-static const float srgb_to_rec2020[9] = {
-  0.627504, 0.329275, 0.043303,
-  0.069108, 0.919519, 0.011360,
-  0.016394, 0.088011, 0.895380,
-};

gdk/gdkcolorimpl.h

@@ -1,131 +0,0 @@
-/* GDK - The GIMP Drawing Kit
- *
- * Copyright (C) 2021 Benjamin Otte
- *
- * This library is free software; you can redistribute it and/or
- * modify it under the terms of the GNU Lesser General Public
- * License as published by the Free Software Foundation; either
- * version 2 of the License, or (at your option) any later version.
- *
- * This library is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
- * Lesser General Public License for more details.
- *
- * You should have received a copy of the GNU Lesser General Public
- * License along with this library. If not, see <http://www.gnu.org/licenses/>.
- */
-
-#pragma once
-
-#include "gdkcolorstateprivate.h"
-
-
-#define gdk_color_init(...) _gdk_color_init (__VA_ARGS__)
-static inline void
-_gdk_color_init (GdkColor        *self,
-                 GdkColorState   *color_state,
-                 const float      values[4])
-{
-  self->color_state = gdk_color_state_ref (color_state);
-  memcpy (self->values, values, sizeof (float) * 4);
-}
-
-#define gdk_color_init_copy(self, color) _gdk_color_init_copy ((self), (color))
-static inline void
-_gdk_color_init_copy (GdkColor       *self,
-                      const GdkColor *color)
-{
-  _gdk_color_init (self, color->color_state, color->values);
-}
-
-#define gdk_color_init_from_rgb(self, rgba) _gdk_color_init_from_rgba ((self), (rgba))
-static inline void
-_gdk_color_init_from_rgba (GdkColor      *self,
-                           const GdkRGBA *rgba)
-{
-  _gdk_color_init (self, GDK_COLOR_STATE_SRGB, (const float *) rgba);
-}
-
-#define gdk_color_finish(self) _gdk_color_finish ((self))
-static inline void
-_gdk_color_finish (GdkColor *self)
-{
-  gdk_color_state_unref (self->color_state);
-  self->color_state = NULL;
-}
-
-#define gdk_color_get_color_state(self) _gdk_color_get_color_state ((self))
-static inline GdkColorState *
-_gdk_color_get_color_state (const GdkColor *self)
-{
-  return self->color_state;
-}
-
-#define gdk_color_equal(self, other) _gdk_color_equal ((self), (other))
-static inline gboolean
-_gdk_color_equal (const GdkColor *self,
-                  const GdkColor *other)
-{
-  return self->values[0] == other->values[0] &&
-         self->values[1] == other->values[1] &&
-         self->values[2] == other->values[2] &&
-         self->values[3] == other->values[3] &&
-         gdk_color_state_equal (self->color_state, other->color_state);
-}
-
-#define gdk_color_is_clear(self) _gdk_color_is_clear ((self))
-static inline gboolean
-_gdk_color_is_clear (const GdkColor *self)
-{
-  return self->alpha < (255.f / 65535.f);
-}
-
-#define gdk_color_is_opaque(self) _gdk_color_is_opaque ((self))
-static inline gboolean
-_gdk_color_is_opaque (const GdkColor *self)
-{
-  return self->alpha > (65280.f / 65535.f);
-}
-
-#define gdk_color_convert(self, cs, other) _gdk_color_convert ((self), (cs), (other))
-static inline void
-_gdk_color_convert (GdkColor        *self,
-                    GdkColorState   *color_state,
-                    const GdkColor  *other)
-{
-  if (gdk_color_state_equal (color_state, other->color_state))
-    {
-      gdk_color_init_copy (self, other);
-      return;
-    }
-
-  self->color_state = gdk_color_state_ref (color_state);
-
-  gdk_color_state_convert_color (other->color_state,
-                                 other->values,
-                                 self->color_state,
-                                 self->values);
-}
-
-#define gdk_color_to_float(self, cs, values) _gdk_color_to_float ((self), (cs), (values))
-static inline void
-_gdk_color_to_float (const GdkColor  *self,
-                     GdkColorState   *color_state,
-                     float            values[4])
-{
-  if (gdk_color_state_equal (self->color_state, color_state))
-    {
-      values[0] = self->values[0];
-      values[1] = self->values[1];
-      values[2] = self->values[2];
-      values[3] = self->values[3];
-      return;
-    }
-
-  gdk_color_state_convert_color (self->color_state,
-                                 self->values,
-                                 color_state,
-                                 values);
-}
-

gdk/gdkcolorprivate.h

@@ -1,106 +0,0 @@
-/* GDK - The GIMP Drawing Kit
- *
- * Copyright (C) 2021 Benjamin Otte
- *
- * This library is free software; you can redistribute it and/or
- * modify it under the terms of the GNU Lesser General Public
- * License as published by the Free Software Foundation; either
- * version 2 of the License, or (at your option) any later version.
- *
- * This library is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
- * Lesser General Public License for more details.
- *
- * You should have received a copy of the GNU Lesser General Public
- * License along with this library. If not, see <http://www.gnu.org/licenses/>.
- */
-
-#pragma once
-
-#include <gdk/gdktypes.h>
-#include <gdk/gdkcolorstate.h>
-#include <gdk/gdkrgba.h>
-#include <gdk/gdkmemoryformatprivate.h>
-
-
-typedef struct _GdkColor GdkColor;
-
-/* The interpretation of the first 3 components depends on the color state.
- * values[3] is always alpha.
- */
-struct _GdkColor
-{
-  GdkColorState *color_state;
-  union {
-    float values[4];
-    struct {
-      float r;
-      float g;
-      float b;
-      float a;
-    };
-    struct {
-      float red;
-      float green;
-      float blue;
-      float alpha;
-    };
-  };
-};
-
-G_STATIC_ASSERT (G_STRUCT_OFFSET (GdkColor, r) == G_STRUCT_OFFSET (GdkColor, red));
-G_STATIC_ASSERT (G_STRUCT_OFFSET (GdkColor, g) == G_STRUCT_OFFSET (GdkColor, green));
-G_STATIC_ASSERT (G_STRUCT_OFFSET (GdkColor, b) == G_STRUCT_OFFSET (GdkColor, blue));
-G_STATIC_ASSERT (G_STRUCT_OFFSET (GdkColor, a) == G_STRUCT_OFFSET (GdkColor, alpha));
-
-/* The committee notes that since all known implementations but one "get it right"
- * this may well not be a defect at all.
- * https://open-std.org/JTC1/SC22/WG14/www/docs/n2396.htm#dr_496
- */
-#ifndef _MSC_VER
-G_STATIC_ASSERT (G_STRUCT_OFFSET (GdkColor, r) == G_STRUCT_OFFSET (GdkColor, values[0]));
-G_STATIC_ASSERT (G_STRUCT_OFFSET (GdkColor, g) == G_STRUCT_OFFSET (GdkColor, values[1]));
-G_STATIC_ASSERT (G_STRUCT_OFFSET (GdkColor, b) == G_STRUCT_OFFSET (GdkColor, values[2]));
-G_STATIC_ASSERT (G_STRUCT_OFFSET (GdkColor, a) == G_STRUCT_OFFSET (GdkColor, values[3]));
-#endif
-
-#define GDK_COLOR_SRGB(r,g,b,a) (GdkColor) { \
-  .color_state = GDK_COLOR_STATE_SRGB, \
-  .values = { (r), (g), (b), (a) } \
-}
-
-void              gdk_color_init                (GdkColor               *self,
-                                                 GdkColorState          *color_state,
-                                                 const float             values[4]);
-void              gdk_color_init_copy           (GdkColor               *self,
-                                                 const GdkColor         *color);
-void              gdk_color_init_from_rgba      (GdkColor               *self,
-                                                 const GdkRGBA          *rgba);
-void              gdk_color_finish              (GdkColor               *self);
-
-gboolean          gdk_color_equal               (const GdkColor         *color1,
-                                                 const GdkColor         *color2);
-gboolean          gdk_color_is_clear            (const GdkColor         *self);
-gboolean          gdk_color_is_opaque           (const GdkColor         *self);
-
-void              gdk_color_convert             (GdkColor               *self,
-                                                 GdkColorState          *color_state,
-                                                 const GdkColor         *other);
-
-void              gdk_color_to_float            (const GdkColor         *self,
-                                                 GdkColorState          *target,
-                                                 float                   values[4]);
-
-void              gdk_color_from_rgba           (GdkColor               *self,
-                                                 GdkColorState          *color_state,
-                                                 const GdkRGBA          *rgba);
-
-void              gdk_color_print               (const GdkColor         *self,
-                                                 GString                *string);
-
-char *            gdk_color_to_string           (const GdkColor         *self);
-
-#include "gdkcolorimpl.h"
-
-G_END_DECLS

gdk/gdkcolorstate.c

@@ -1,861 +0,0 @@
-/* gdkcolorstate.c
- *
- * Copyright 2024 Matthias Clasen
- *
- * This library is free software; you can redistribute it and/or
- * modify it under the terms of the GNU Lesser General Public
- * License as published by the Free Software Foundation; either
- * version 2 of the License, or (at your option) any later version.
- *
- * This library is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
- * Lesser General Public License for more details.
- *
- * You should have received a copy of the GNU Lesser General Public
- * License along with this library. If not, see <http://www.gnu.org/licenses/>.
- */
-
-#include "config.h"
-
-#include "gdkcolorstateprivate.h"
-
-#include <math.h>
-
-#include "gdkcolordefs.h"
-
-#include <glib/gi18n-lib.h>
-
-/**
- * GdkColorState:
- *
- * A `GdkColorState` object provides the information to interpret
- * colors and pixels in a variety of ways.
- *
- * They are also known as
- * [*color spaces*](https://en.wikipedia.org/wiki/Color_space).
- *
- * Crucially, GTK knows how to convert colors from one color
- * state to another.
- *
- * `GdkColorState` objects are immutable and therefore threadsafe.
- *
- * Since: 4.16
- */
-
-G_DEFINE_BOXED_TYPE (GdkColorState, gdk_color_state,
-                     gdk_color_state_ref, gdk_color_state_unref);
-
-/* {{{ Public API */
-
-/**
- * gdk_color_state_ref:
- * @self: a `GdkColorState`
- *
- * Increase the reference count of @self.
- *
- * Returns: the object that was passed in
- *
- * Since: 4.16
- */
-GdkColorState *
-(gdk_color_state_ref) (GdkColorState *self)
-{
-  return _gdk_color_state_ref (self);
-}
-
-/**
- * gdk_color_state_unref:
- * @self:a `GdkColorState`
- *
- * Decrease the reference count of @self.
- *
- * Unless @self is static, it will be freed
- * when the reference count reaches zero.
- *
- * Since: 4.16
- */
-void
-(gdk_color_state_unref) (GdkColorState *self)
-{
-  _gdk_color_state_unref (self);
-}
-
-/**
- * gdk_color_state_get_srgb:
- *
- * Returns the color state object representing the sRGB color space.
- *
- * This color state uses the primaries defined by BT.709-6 and the transfer function
- * defined by IEC 61966-2-1.
- *
- * It is equivalent to the [Cicp](class.CicpParams.html) tuple 1/13/0/1.
- *
- * See e.g. [the CSS Color Module](https://www.w3.org/TR/css-color-4/#predefined-sRGB)
- * for details about this colorstate.
- *
- * Returns: the color state object for sRGB
- *
- * Since: 4.16
- */
-GdkColorState *
-gdk_color_state_get_srgb (void)
-{
-  return GDK_COLOR_STATE_SRGB;
-}
-
-/**
- * gdk_color_state_get_srgb_linear:
- *
- * Returns the color state object representing the linearized sRGB color space.
- *
- * This color state uses the primaries defined by BT.709-6 and a linear transfer function.
- *
- * It is equivalent to the [Cicp](class.CicpParams.html) tuple 1/8/0/1.
- *
- * See e.g. [the CSS Color Module](https://www.w3.org/TR/css-color-4/#predefined-sRGB-linear)
- * for details about this colorstate.
- *
- * Returns: the color state object for linearized sRGB
- *
- * Since: 4.16
- */
-GdkColorState *
-gdk_color_state_get_srgb_linear (void)
-{
-  return GDK_COLOR_STATE_SRGB_LINEAR;
-}
-
-/**
- * gdk_color_state_get_rec2100_pq:
- *
- * Returns the color state object representing the rec2100-pq color space.
- *
- * This color state uses the primaries defined by BT.2020-2 and BT.2100-0 and the transfer
- * function defined by SMPTE ST 2084 and BT.2100-2.
- *
- * It is equivalent to the [Cicp](class.CicpParams.html) tuple 9/16/0/1.
- *
- * See e.g. [the CSS HDR Module](https://drafts.csswg.org/css-color-hdr/#valdef-color-rec2100-pq)
- * for details about this colorstate.
- *
- * Returns: the color state object for rec2100-pq
- *
- * Since: 4.16
- */
-GdkColorState *
-gdk_color_state_get_rec2100_pq (void)
-{
-  return GDK_COLOR_STATE_REC2100_PQ;
-}
-
-/**
- * gdk_color_state_get_rec2100_linear:
- *
- * Returns the color state object representing the linear rec2100 color space.
- *
- * This color state uses the primaries defined by BT.2020-2 and BT.2100-0 and a linear
- * transfer function.
- *
- * It is equivalent to the [Cicp](class.CicpParams.html) tuple 9/8/0/1.
- *
- * See e.g. [the CSS HDR Module](https://drafts.csswg.org/css-color-hdr/#valdef-color-rec2100-linear)
- * for details about this colorstate.
- *
- * Returns: the color state object for linearized rec2100
- *
- * Since: 4.16
- */
-GdkColorState *
-gdk_color_state_get_rec2100_linear (void)
-{
-  return GDK_COLOR_STATE_REC2100_LINEAR;
-}
-
-/**
- * gdk_color_state_equal:
- * @self: a `GdkColorState`
- * @other: another `GdkColorStatee`
- *
- * Compares two `GdkColorStates` for equality.
- *
- * Note that this function is not guaranteed to be perfect and two objects
- * describing the same color state may compare not equal. However, different
- * color states will never compare equal.
- *
- * Returns: %TRUE if the two color states compare equal
- *
- * Since: 4.16
- */
-gboolean
-(gdk_color_state_equal) (GdkColorState *self,
-                         GdkColorState *other)
-{
-  return _gdk_color_state_equal (self, other);
-}
-
-/**
- * gdk_color_state_create_cicp_params:
- * @self: a `GdkColorState`
- *
- * Create a [class@Gdk.CicpParams] representing the colorstate.
- *
- * It is not guaranteed that every `GdkColorState` can be
- * represented with Cicp parameters. If that is the case,
- * this function returns `NULL`.
- *
- * Returns: (transfer full) (nullable): A new [class@Gdk.CicpParams]
- *
- * Since: 4.16
- */
-GdkCicpParams *
-gdk_color_state_create_cicp_params (GdkColorState *self)
-{
-  const GdkCicp *cicp = gdk_color_state_get_cicp (self);
-
-  if (cicp)
-    return gdk_cicp_params_new_for_cicp (cicp);
-
-  return NULL;
-}
-
-/* }}} */
-/* {{{ Conversion functions */
-
-typedef float (* GdkTransferFunc) (float v);
-typedef const float GdkColorMatrix[9];
-
-#define IDENTITY ((float*)0)
-#define NONE ((GdkTransferFunc)0)
-
-#define TRANSFORM(name, eotf, matrix, oetf) \
-static void \
-name (GdkColorState  *self, \
-      float         (*values)[4], \
-      gsize           n_values) \
-{ \
-  for (gsize i = 0; i < n_values; i++) \
-    { \
-      if (eotf != NONE) \
-        { \
-          values[i][0] = eotf (values[i][0]); \
-          values[i][1] = eotf (values[i][1]); \
-          values[i][2] = eotf (values[i][2]); \
-        } \
-      if (matrix != IDENTITY) \
-        { \
-          float res[3]; \
-          res[0] = matrix[0] * values[i][0] + matrix[1] * values[i][1] + matrix[2] * values[i][2]; \
-          res[1] = matrix[3] * values[i][0] + matrix[4] * values[i][1] + matrix[5] * values[i][2]; \
-          res[2] = matrix[6] * values[i][0] + matrix[7] * values[i][1] + matrix[8] * values[i][2]; \
-          values[i][0] = res[0]; \
-          values[i][1] = res[1]; \
-          values[i][2] = res[2]; \
-        } \
-      if (oetf != NONE) \
-        { \
-          values[i][0] = oetf (values[i][0]); \
-          values[i][1] = oetf (values[i][1]); \
-          values[i][2] = oetf (values[i][2]); \
-        } \
-    } \
-}
-
-TRANSFORM(gdk_default_srgb_to_srgb_linear,           srgb_eotf, IDENTITY,        NONE);
-TRANSFORM(gdk_default_srgb_linear_to_srgb,           NONE,      IDENTITY,        srgb_oetf)
-TRANSFORM(gdk_default_rec2100_pq_to_rec2100_linear,  pq_eotf,   IDENTITY,        NONE)
-TRANSFORM(gdk_default_rec2100_linear_to_rec2100_pq,  NONE,      IDENTITY,        pq_oetf)
-TRANSFORM(gdk_default_srgb_linear_to_rec2100_linear, NONE,      srgb_to_rec2020, NONE)
-TRANSFORM(gdk_default_rec2100_linear_to_srgb_linear, NONE,      rec2020_to_srgb, NONE)
-TRANSFORM(gdk_default_srgb_to_rec2100_linear,        srgb_eotf, srgb_to_rec2020, NONE)
-TRANSFORM(gdk_default_rec2100_pq_to_srgb_linear,     pq_eotf,   rec2020_to_srgb, NONE)
-TRANSFORM(gdk_default_srgb_linear_to_rec2100_pq,     NONE,      srgb_to_rec2020, pq_oetf)
-TRANSFORM(gdk_default_rec2100_linear_to_srgb,        NONE,      rec2020_to_srgb, srgb_oetf)
-TRANSFORM(gdk_default_srgb_to_rec2100_pq,            srgb_eotf, srgb_to_rec2020, pq_oetf)
-TRANSFORM(gdk_default_rec2100_pq_to_srgb,            pq_eotf,   rec2020_to_srgb, srgb_oetf)
-
-/* }}} */
-/* {{{ Default implementation */
-/* {{{ Vfuncs */
-
-static gboolean
-gdk_default_color_state_equal (GdkColorState *self,
-                               GdkColorState *other)
-{
-  return self == other;
-}
-
-static const char *
-gdk_default_color_state_get_name (GdkColorState *color_state)
-{
-  GdkDefaultColorState *self = (GdkDefaultColorState *) color_state;
-
-  return self->name;
-}
-
-static GdkColorState *
-gdk_default_color_state_get_no_srgb_tf (GdkColorState *color_state)
-{
-  GdkDefaultColorState *self = (GdkDefaultColorState *) color_state;
-
-  return self->no_srgb;
-}
-
-static GdkFloatColorConvert
-gdk_default_color_state_get_convert_to (GdkColorState  *color_state,
-                                        GdkColorState  *target)
-{
-  GdkDefaultColorState *self = (GdkDefaultColorState *) color_state;
-
-  if (GDK_IS_DEFAULT_COLOR_STATE (target))
-    return self->convert_to[GDK_DEFAULT_COLOR_STATE_ID (target)];
-
-  return NULL;
-}
-
-static GdkFloatColorConvert
-gdk_default_color_state_get_convert_from (GdkColorState  *color_state,
-                                          GdkColorState  *source)
-{
-  /* This is ok because the default-to-default conversion functions
-   * don't use the passed colorstate at all.
-   */
-  return gdk_default_color_state_get_convert_to (source, color_state);
-}
-
-static const GdkCicp *
-gdk_default_color_state_get_cicp (GdkColorState *color_state)
-{
-  GdkDefaultColorState *self = (GdkDefaultColorState *) color_state;
-
-  return &self->cicp;
-}
-
-static gboolean
-gdk_color_state_check_inf_nan (const float src[4],
-                               float       dest[4])
-{
-  if (isnan (src[0]) ||
-      isnan (src[1]) ||
-      isnan (src[2]) ||
-      isnan (src[3]))
-    {
-      dest = (float[4]) { 1.0, 0.0, 0.8, 1.0 };
-      return TRUE;
-    }
-  if (isinf (src[0]) ||
-      isinf (src[1]) ||
-      isinf (src[2]) ||
-      isinf (src[3]))
-    {
-      dest = (float[4]) { 0.0, 0.8, 1.0, 1.0 };
-      return TRUE;
-    }
-
-  return FALSE;
-}
-
-static void
-gdk_color_state_clamp_0_1 (GdkColorState *self,
-                           const float    src[4],
-                           float          dest[4])
-{
-  if (gdk_color_state_check_inf_nan (src, dest))
-    return;
-
-  dest[0] = CLAMP (src[0], 0.0f, 1.0f);
-  dest[1] = CLAMP (src[1], 0.0f, 1.0f);
-  dest[2] = CLAMP (src[2], 0.0f, 1.0f);
-  dest[3] = CLAMP (src[3], 0.0f, 1.0f);
-}
-
-static void
-gdk_color_state_clamp_unbounded (GdkColorState *self,
-                                 const float    src[4],
-                                 float          dest[4])
-{
-  if (gdk_color_state_check_inf_nan (src, dest))
-    return;
-
-  dest[0] = src[0];
-  dest[1] = src[1];
-  dest[2] = src[2];
-  dest[3] = CLAMP (src[3], 0.0f, 1.0f);
-}
-
-static void
-gdk_default_color_state_clamp (GdkColorState *color_state,
-                               const float    in[4],
-                               float          out[4])
-{
-  GdkDefaultColorState *self = (GdkDefaultColorState *) color_state;
-
-  self->clamp (color_state, in, out);
-}
-
-/* }}} */
-
-static const
-GdkColorStateClass GDK_DEFAULT_COLOR_STATE_CLASS = {
-  .free = NULL, /* crash here if this ever happens */
-  .equal = gdk_default_color_state_equal,
-  .get_name = gdk_default_color_state_get_name,
-  .get_no_srgb_tf = gdk_default_color_state_get_no_srgb_tf,
-  .get_convert_to = gdk_default_color_state_get_convert_to,
-  .get_convert_from = gdk_default_color_state_get_convert_from,
-  .get_cicp = gdk_default_color_state_get_cicp,
-  .clamp = gdk_default_color_state_clamp,
-};
-
-GdkDefaultColorState gdk_default_color_states[] = {
-  [GDK_COLOR_STATE_ID_SRGB] = {
-    .parent = {
-      .klass = &GDK_DEFAULT_COLOR_STATE_CLASS,
-      .ref_count = 0,
-      .depth = GDK_MEMORY_U8_SRGB,
-      .rendering_color_state = GDK_COLOR_STATE_SRGB,
-      .rendering_color_state_linear = GDK_COLOR_STATE_SRGB_LINEAR,
-    },
-    .name = "srgb",
-    .no_srgb = GDK_COLOR_STATE_SRGB_LINEAR,
-    .convert_to = {
-      [GDK_COLOR_STATE_ID_SRGB_LINEAR] = gdk_default_srgb_to_srgb_linear,
-      [GDK_COLOR_STATE_ID_REC2100_PQ] = gdk_default_srgb_to_rec2100_pq,
-      [GDK_COLOR_STATE_ID_REC2100_LINEAR] = gdk_default_srgb_to_rec2100_linear,
-    },
-    .clamp = gdk_color_state_clamp_0_1,
-    .cicp = { 1, 13, 0, 1 },
-  },
-  [GDK_COLOR_STATE_ID_SRGB_LINEAR] = {
-    .parent = {
-      .klass = &GDK_DEFAULT_COLOR_STATE_CLASS,
-      .ref_count = 0,
-      .depth = GDK_MEMORY_U8,
-      .rendering_color_state = GDK_COLOR_STATE_SRGB_LINEAR,
-      .rendering_color_state_linear = GDK_COLOR_STATE_SRGB_LINEAR,
-    },
-    .name = "srgb-linear",
-    .no_srgb = NULL,
-    .convert_to = {
-      [GDK_COLOR_STATE_ID_SRGB] = gdk_default_srgb_linear_to_srgb,
-      [GDK_COLOR_STATE_ID_REC2100_PQ] = gdk_default_srgb_linear_to_rec2100_pq,
-      [GDK_COLOR_STATE_ID_REC2100_LINEAR] = gdk_default_srgb_linear_to_rec2100_linear,
-    },
-    .clamp = gdk_color_state_clamp_0_1,
-    .cicp = { 1, 8, 0, 1 },
-  },
-  [GDK_COLOR_STATE_ID_REC2100_PQ] = {
-    .parent = {
-      .klass = &GDK_DEFAULT_COLOR_STATE_CLASS,
-      .ref_count = 0,
-      .depth = GDK_MEMORY_FLOAT16,
-      .rendering_color_state = GDK_COLOR_STATE_REC2100_PQ,
-      .rendering_color_state_linear = GDK_COLOR_STATE_REC2100_LINEAR,
-    },
-    .name = "rec2100-pq",
-    .no_srgb = NULL,
-    .convert_to = {
-      [GDK_COLOR_STATE_ID_SRGB] = gdk_default_rec2100_pq_to_srgb,
-      [GDK_COLOR_STATE_ID_SRGB_LINEAR] = gdk_default_rec2100_pq_to_srgb_linear,
-      [GDK_COLOR_STATE_ID_REC2100_LINEAR] = gdk_default_rec2100_pq_to_rec2100_linear,
-    },
-    .clamp = gdk_color_state_clamp_0_1,
-    .cicp = { 9, 16, 0, 1 },
-  },
-  [GDK_COLOR_STATE_ID_REC2100_LINEAR] = {
-    .parent = {
-      .klass = &GDK_DEFAULT_COLOR_STATE_CLASS,
-      .ref_count = 0,
-      .depth = GDK_MEMORY_FLOAT16,
-      .rendering_color_state = GDK_COLOR_STATE_REC2100_LINEAR,
-      .rendering_color_state_linear = GDK_COLOR_STATE_REC2100_LINEAR,
-    },
-    .name = "rec2100-linear",
-    .no_srgb = NULL,
-    .convert_to = {
-      [GDK_COLOR_STATE_ID_SRGB] = gdk_default_rec2100_linear_to_srgb,
-      [GDK_COLOR_STATE_ID_SRGB_LINEAR] = gdk_default_rec2100_linear_to_srgb_linear,
-      [GDK_COLOR_STATE_ID_REC2100_PQ] = gdk_default_rec2100_linear_to_rec2100_pq,
-    },
-    .clamp = gdk_color_state_clamp_unbounded,
-    .cicp = { 9, 8, 0, 1 },
-  },
-};
-
- /* }}} */
-/* {{{ Cicp implementation */
-
-typedef struct _GdkCicpColorState GdkCicpColorState;
-struct _GdkCicpColorState
-{
-  GdkColorState parent;
-
-  GdkColorState *no_srgb;
-
-  char *name;
-
-  GdkTransferFunc eotf;
-  GdkTransferFunc oetf;
-
-  float to_srgb[9];
-  float to_rec2020[9];
-  float from_srgb[9];
-  float from_rec2020[9];
-
-  GdkCicp cicp;
-};
-
-/* {{{ Conversion functions */
-
-#define cicp ((GdkCicpColorState *)self)
-
-TRANSFORM(gdk_cicp_to_srgb,             cicp->eotf,  cicp->to_srgb,      srgb_oetf)
-TRANSFORM(gdk_cicp_to_srgb_linear,      cicp->eotf,  cicp->to_srgb,      NONE)
-TRANSFORM(gdk_cicp_to_rec2100_pq,       cicp->eotf,  cicp->to_rec2020,   pq_oetf)
-TRANSFORM(gdk_cicp_to_rec2100_linear,   cicp->eotf,  cicp->to_rec2020,   NONE)
-TRANSFORM(gdk_cicp_from_srgb,           srgb_eotf,   cicp->from_srgb,    cicp->oetf)
-TRANSFORM(gdk_cicp_from_srgb_linear,    NONE,        cicp->from_srgb,    cicp->oetf)
-TRANSFORM(gdk_cicp_from_rec2100_pq,     pq_eotf,     cicp->from_rec2020, cicp->oetf)
-TRANSFORM(gdk_cicp_from_rec2100_linear, NONE,        cicp->from_rec2020, cicp->oetf)
-
-#undef cicp
-
-/* }}} */
-/* {{{ Vfuncs */
-
-static void
-gdk_cicp_color_state_free (GdkColorState *cs)
-{
-  GdkCicpColorState *self = (GdkCicpColorState *) cs;
-
-  g_free (self->name);
-
-  if (self->no_srgb)
-    gdk_color_state_unref (self->no_srgb);
-
-  g_free (self);
-}
-
-static gboolean
-gdk_cicp_color_state_equal (GdkColorState *self,
-                            GdkColorState *other)
-{
-  GdkCicpColorState *cs1 = (GdkCicpColorState *) self;
-  GdkCicpColorState *cs2 = (GdkCicpColorState *) other;
-
-  return gdk_cicp_equal (&cs1->cicp, &cs2->cicp);
-}
-
-static const char *
-gdk_cicp_color_state_get_name (GdkColorState *self)
-{
-  GdkCicpColorState *cs = (GdkCicpColorState *) self;
-
-  return cs->name;
-}
-
-static GdkColorState *
-gdk_cicp_color_state_get_no_srgb_tf (GdkColorState *self)
-{
-  GdkCicpColorState *cs = (GdkCicpColorState *) self;
-
-  return cs->no_srgb;
-}
-
-static GdkFloatColorConvert
-gdk_cicp_color_state_get_convert_to (GdkColorState *self,
-                                     GdkColorState *target)
-{
-  if (!GDK_IS_DEFAULT_COLOR_STATE (target))
-    return NULL;
-
-  switch (GDK_DEFAULT_COLOR_STATE_ID (target))
-    {
-    case GDK_COLOR_STATE_ID_SRGB:
-      return gdk_cicp_to_srgb;
-    case GDK_COLOR_STATE_ID_SRGB_LINEAR:
-      return gdk_cicp_to_srgb_linear;
-    case GDK_COLOR_STATE_ID_REC2100_PQ:
-      return gdk_cicp_to_rec2100_pq;
-    case GDK_COLOR_STATE_ID_REC2100_LINEAR:
-      return gdk_cicp_to_rec2100_linear;
-
-    case GDK_COLOR_STATE_N_IDS:
-    default:
-      g_assert_not_reached ();
-    }
-
-  return NULL;
-}
-
-static GdkFloatColorConvert
-gdk_cicp_color_state_get_convert_from (GdkColorState *self,
-                                       GdkColorState *source)
-{
-  if (!GDK_IS_DEFAULT_COLOR_STATE (source))
-    return NULL;
-
-  switch (GDK_DEFAULT_COLOR_STATE_ID (source))
-    {
-    case GDK_COLOR_STATE_ID_SRGB:
-      return gdk_cicp_from_srgb;
-    case GDK_COLOR_STATE_ID_SRGB_LINEAR:
-      return gdk_cicp_from_srgb_linear;
-    case GDK_COLOR_STATE_ID_REC2100_PQ:
-      return gdk_cicp_from_rec2100_pq;
-    case GDK_COLOR_STATE_ID_REC2100_LINEAR:
-      return gdk_cicp_from_rec2100_linear;
-
-    case GDK_COLOR_STATE_N_IDS:
-    default:
-      g_assert_not_reached ();
-    }
-
-  return NULL;
-}
-
-static const GdkCicp *
-gdk_cicp_color_state_get_cicp (GdkColorState  *color_state)
-{
-  GdkCicpColorState *self = (GdkCicpColorState *) color_state;
-
-  return &self->cicp;
-}
-
-/* }}} */
-
-static const
-GdkColorStateClass GDK_CICP_COLOR_STATE_CLASS = {
-  .free = gdk_cicp_color_state_free,
-  .equal = gdk_cicp_color_state_equal,
-  .get_name = gdk_cicp_color_state_get_name,
-  .get_no_srgb_tf = gdk_cicp_color_state_get_no_srgb_tf,
-  .get_convert_to = gdk_cicp_color_state_get_convert_to,
-  .get_convert_from = gdk_cicp_color_state_get_convert_from,
-  .get_cicp = gdk_cicp_color_state_get_cicp,
-  .clamp = gdk_color_state_clamp_0_1,
-};
-
-static inline float *
-multiply (float       res[9],
-          const float m1[9],
-          const float m2[9])
-{
-#define IDX(i,j) 3*i+j
-  for (int i = 0; i < 3; i++)
-    for (int j = 0; j < 3; j++)
-      res[IDX(i,j)] =   m1[IDX(i,0)] * m2[IDX(0,j)]
-                      + m1[IDX(i,1)] * m2[IDX(1,j)]
-                      + m1[IDX(i,2)] * m2[IDX(2,j)];
-
-  return res;
-}
-
-GdkColorState *
-gdk_color_state_new_for_cicp (const GdkCicp  *cicp,
-                              GError        **error)
-{
-  GdkCicpColorState *self;
-  GdkTransferFunc eotf;
-  GdkTransferFunc oetf;
-  gconstpointer to_xyz;
-  gconstpointer from_xyz;
-
-  if (cicp->range == GDK_CICP_RANGE_NARROW || cicp->matrix_coefficients != 0)
-    {
-      g_set_error (error,
-                   G_IO_ERROR, G_IO_ERROR_FAILED,
-                   _("cicp: Narrow range or YUV not supported"));
-      return NULL;
-    }
-
-  if (cicp->color_primaries == 2 ||
-      cicp->transfer_function == 2 ||
-      cicp->matrix_coefficients == 2)
-    {
-      g_set_error (error,
-                   G_IO_ERROR, G_IO_ERROR_FAILED,
-                   _("cicp: Unspecified parameters not supported"));
-      return NULL;
-    }
-
-  for (guint i = 0; i < GDK_COLOR_STATE_N_IDS; i++)
-    {
-      if (gdk_cicp_equivalent (cicp, &gdk_default_color_states[i].cicp))
-        return (GdkColorState *) &gdk_default_color_states[i];
-    }
-
-  switch (cicp->transfer_function)
-    {
-    case 1:
-    case 6:
-    case 14:
-    case 15:
-      eotf = bt709_eotf;
-      oetf = bt709_oetf;
-      break;
-    case 4:
-      eotf = gamma22_eotf;
-      oetf = gamma22_oetf;
-      break;
-    case 5:
-      eotf = gamma28_eotf;
-      oetf = gamma28_oetf;
-      break;
-    case 8:
-      eotf = NONE;
-      oetf = NONE;
-      break;
-    case 13:
-      eotf = srgb_eotf;
-      oetf = srgb_oetf;
-      break;
-    case 16:
-      eotf = pq_eotf;
-      oetf = pq_oetf;
-      break;
-    case 18:
-      eotf = hlg_eotf;
-      oetf = hlg_oetf;
-      break;
-    default:
-      g_set_error (error,
-                   G_IO_ERROR, G_IO_ERROR_FAILED,
-                   _("cicp: Transfer function %u not supported"),
-                   cicp->transfer_function);
-      return NULL;
-    }
-
-  switch (cicp->color_primaries)
-    {
-    case 1:
-      to_xyz = srgb_to_xyz;
-      from_xyz = xyz_to_srgb;
-      break;
-    case 5:
-      to_xyz = pal_to_xyz;
-      from_xyz = xyz_to_pal;
-      break;
-    case 6:
-      to_xyz = ntsc_to_xyz;
-      from_xyz = xyz_to_ntsc;
-      break;
-    case 9:
-      to_xyz = rec2020_to_xyz;
-      from_xyz = xyz_to_rec2020;
-      break;
-    case 12:
-      to_xyz = p3_to_xyz;
-      from_xyz = xyz_to_p3;
-      break;
-    default:
-      g_set_error (error,
-                   G_IO_ERROR, G_IO_ERROR_FAILED,
-                   _("cicp: Color primaries %u not supported"),
-                   cicp->color_primaries);
-      return NULL;
-    }
-
-  self = g_new0 (GdkCicpColorState, 1);
-
-  self->parent.klass = &GDK_CICP_COLOR_STATE_CLASS;
-  self->parent.ref_count = 1;
-
-  /* sRGB is special-cased by being a default colorstate */
-  self->parent.rendering_color_state = GDK_COLOR_STATE_REC2100_PQ;
-  self->parent.rendering_color_state_linear = GDK_COLOR_STATE_REC2100_LINEAR;
-
-  self->parent.depth = GDK_MEMORY_FLOAT16;
-
-  memcpy (&self->cicp, cicp, sizeof (GdkCicp));
-
-  self->eotf = eotf;
-  self->oetf = oetf;
-
-  multiply (self->to_srgb, xyz_to_srgb, to_xyz);
-  multiply (self->to_rec2020, xyz_to_rec2020, to_xyz);
-  multiply (self->from_srgb, from_xyz, srgb_to_xyz);
-  multiply (self->from_rec2020, from_xyz, rec2020_to_xyz);
-
-  self->name = g_strdup_printf ("cicp-%u/%u/%u/%u",
-                                cicp->color_primaries,
-                                cicp->transfer_function,
-                                cicp->matrix_coefficients,
-                                cicp->range);
-
-  if (cicp->transfer_function == 13)
-    {
-      self->no_srgb = gdk_color_state_new_for_cicp (&(GdkCicp) {
-                                                      cicp->color_primaries,
-                                                      8,
-                                                      cicp->matrix_coefficients,
-                                                      cicp->range },
-                                                    NULL);
-    }
-
-  return (GdkColorState *) self;
-}
-
-/* }}} */
-/* {{{ Private API */
-
-/*<private>
- * gdk_color_state_get_name:
- * @self: a colorstate
- *
- * Returns the name of @self.
- *
- * This is *not* a translated, user-visible string.
- *
- * Returns: (transfer none): a name for representing the color state
- *     in diagnostic output
- */
-const char *
-gdk_color_state_get_name (GdkColorState *self)
-{
-  return self->klass->get_name (self);
-}
-
-/*<private>
- * gdk_color_state_get_no_srgb_tf:
- * @self: a colorstate
- *
- * This function checks if the colorstate uses an sRGB transfer function
- * as final operation. In that case, it is suitable for use with GL_SRGB
- * (and the Vulkan equivalents).
- *
- * If it is suitable, the colorstate without the transfer function is
- * returned. Otherwise, this function returns NULL.
- *
- * Returns: (transfer none): the colorstate without sRGB transfer function.
- **/
-GdkColorState *
-gdk_color_state_get_no_srgb_tf (GdkColorState *self)
-{
-  if (!GDK_DEBUG_CHECK (LINEAR))
-    return FALSE;
-
-  return self->klass->get_no_srgb_tf (self);
-}
-
-/*< private >
- * gdk_color_state_clamp:
- * @self: a `GdkColorState`
- * @src: the values to clamp
- * @dest: (out): location to store the result, may be identical to
- *   the src argument
- *
- * Clamps the values to be within the allowed ranges for the given
- * color state.
- */
-void
-gdk_color_state_clamp (GdkColorState *self,
-                       const float    src[4],
-                       float          dest[4])
-{
-  self->klass->clamp (self, src, dest);
-}
-
-/* }}} */
-
-/* vim:set foldmethod=marker expandtab: */

gdk/gdkcolorstate.h

@@ -1,62 +0,0 @@
-/* gdkcolorstate.h
- *
- * Copyright 2024 Red Hat, Inc.
- *
- * This library is free software; you can redistribute it and/or
- * modify it under the terms of the GNU Lesser General Public
- * License as published by the Free Software Foundation; either
- * version 2 of the License, or (at your option) any later version.
- *
- * This library is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
- * Lesser General Public License for more details.
- *
- * You should have received a copy of the GNU Lesser General Public
- * License along with this library. If not, see <http://www.gnu.org/licenses/>.
- */
-
-#pragma once
-
-#if !defined (__GDK_H_INSIDE__) && !defined (GTK_COMPILATION)
-#error "Only <gdk/gdk.h> can be included directly."
-#endif
-
-#include <gdk/gdktypes.h>
-
-G_BEGIN_DECLS
-
-#define GDK_TYPE_COLOR_STATE (gdk_color_state_get_type ())
-
-GDK_AVAILABLE_IN_4_16
-GType           gdk_color_state_get_type                (void) G_GNUC_CONST;
-
-GDK_AVAILABLE_IN_4_16
-GdkColorState * gdk_color_state_ref                     (GdkColorState  *self);
-
-GDK_AVAILABLE_IN_4_16
-void            gdk_color_state_unref                   (GdkColorState  *self);
-
-GDK_AVAILABLE_IN_4_16
-GdkColorState * gdk_color_state_get_srgb                (void);
-
-GDK_AVAILABLE_IN_4_16
-GdkColorState * gdk_color_state_get_srgb_linear         (void);
-
-GDK_AVAILABLE_IN_4_16
-GdkColorState * gdk_color_state_get_rec2100_pq          (void);
-
-GDK_AVAILABLE_IN_4_16
-GdkColorState * gdk_color_state_get_rec2100_linear      (void);
-
-GDK_AVAILABLE_IN_4_16
-gboolean        gdk_color_state_equal                   (GdkColorState  *self,
-                                                         GdkColorState  *other);
-
-GDK_AVAILABLE_IN_4_16
-GdkCicpParams  *gdk_color_state_create_cicp_params      (GdkColorState  *self);
-
-
-G_DEFINE_AUTOPTR_CLEANUP_FUNC(GdkColorState, gdk_color_state_unref);
-
-G_END_DECLS

gdk/gdkcolorstateprivate.h

@@ -1,226 +0,0 @@
-#pragma once
-
-#include "gdkcolorstate.h"
-
-#include "gdkcicpparamsprivate.h"
-#include "gdkdebugprivate.h"
-#include "gdkmemoryformatprivate.h"
-#include "gdkrgba.h"
-
-typedef enum
-{
-  GDK_COLOR_STATE_ID_SRGB,
-  GDK_COLOR_STATE_ID_SRGB_LINEAR,
-  GDK_COLOR_STATE_ID_REC2100_PQ,
-  GDK_COLOR_STATE_ID_REC2100_LINEAR,
-
-  GDK_COLOR_STATE_N_IDS
-} GdkColorStateId;
-
-typedef struct _GdkColorStateClass GdkColorStateClass;
-
-struct _GdkColorState
-{
-  const GdkColorStateClass *klass;
-  gatomicrefcount ref_count;
-
-  GdkMemoryDepth depth;
-  GdkColorState *rendering_color_state;
-  GdkColorState *rendering_color_state_linear;
-};
-
-/* Note: self may be the source or the target colorstate */
-typedef void            (* GdkFloatColorConvert)(GdkColorState  *self,
-                                                 float         (*values)[4],
-                                                 gsize           n_values);
-
-struct _GdkColorStateClass
-{
-  void                  (* free)                (GdkColorState  *self);
-  gboolean              (* equal)               (GdkColorState  *self,
-                                                 GdkColorState  *other);
-  const char *          (* get_name)            (GdkColorState  *self);
-  GdkColorState *       (* get_no_srgb_tf)      (GdkColorState  *self);
-  GdkFloatColorConvert  (* get_convert_to)      (GdkColorState  *self,
-                                                 GdkColorState  *target);
-  GdkFloatColorConvert  (* get_convert_from)    (GdkColorState  *self,
-                                                 GdkColorState  *source);
-  const GdkCicp *       (* get_cicp)            (GdkColorState  *self);
-  void                  (* clamp)               (GdkColorState  *self,
-                                                 const float     src[4],
-                                                 float           dest[4]);
-};
-
-typedef struct _GdkDefaultColorState GdkDefaultColorState;
-
-struct _GdkDefaultColorState
-{
-  GdkColorState parent;
-
-  const char *name;
-  GdkColorState *no_srgb;
-  GdkFloatColorConvert convert_to[GDK_COLOR_STATE_N_IDS];
-  void (* clamp) (GdkColorState  *self,
-                  const float     src[4],
-                  float           dest[4]);
-
-  GdkCicp cicp;
-};
-
-extern GdkDefaultColorState gdk_default_color_states[GDK_COLOR_STATE_N_IDS];
-
-#define GDK_COLOR_STATE_SRGB           ((GdkColorState *) &gdk_default_color_states[GDK_COLOR_STATE_ID_SRGB])
-#define GDK_COLOR_STATE_SRGB_LINEAR    ((GdkColorState *) &gdk_default_color_states[GDK_COLOR_STATE_ID_SRGB_LINEAR])
-#define GDK_COLOR_STATE_REC2100_PQ     ((GdkColorState *) &gdk_default_color_states[GDK_COLOR_STATE_ID_REC2100_PQ])
-#define GDK_COLOR_STATE_REC2100_LINEAR ((GdkColorState *) &gdk_default_color_states[GDK_COLOR_STATE_ID_REC2100_LINEAR])
-
-#define GDK_IS_DEFAULT_COLOR_STATE(c) ((GdkDefaultColorState *) (c) >= &gdk_default_color_states[0] && \
-                                       (GdkDefaultColorState *) (c) < &gdk_default_color_states[GDK_COLOR_STATE_N_IDS])
-#define GDK_DEFAULT_COLOR_STATE_ID(c) ((GdkColorStateId) (((GdkDefaultColorState *) c) - gdk_default_color_states))
-
-const char *    gdk_color_state_get_name                (GdkColorState          *color_state);
-GdkColorState * gdk_color_state_get_no_srgb_tf          (GdkColorState          *self);
-
-GdkColorState * gdk_color_state_new_for_cicp            (const GdkCicp          *cicp,
-                                                         GError                **error);
-
-void            gdk_color_state_clamp                   (GdkColorState          *self,
-                                                         const float             src[4],
-                                                         float                   dest[4]);
-
-static inline GdkColorState *
-gdk_color_state_get_rendering_color_state (GdkColorState *self)
-{
-  if (GDK_DEBUG_CHECK (HDR))
-    self = GDK_COLOR_STATE_REC2100_PQ;
-
-  if (!GDK_DEBUG_CHECK (LINEAR))
-    return self->rendering_color_state;
-
-  return self->rendering_color_state_linear;
-}
-
-static inline GdkMemoryDepth
-gdk_color_state_get_depth (GdkColorState *self)
-{
-  if (!GDK_DEBUG_CHECK (LINEAR) && self->depth == GDK_MEMORY_U8_SRGB)
-    return GDK_MEMORY_U8;
-
-  return self->depth;
-}
-
-static inline GdkColorState *
-gdk_color_state_get_by_id (GdkColorStateId id)
-{
-  return (GdkColorState *) &gdk_default_color_states[id];
-}
-
-#define gdk_color_state_ref(self) _gdk_color_state_ref (self)
-static inline GdkColorState *
-_gdk_color_state_ref (GdkColorState *self)
-{
-  if (GDK_IS_DEFAULT_COLOR_STATE (self))
-    return self;
-
-  g_atomic_ref_count_inc (&self->ref_count);
-
-  return self;
-}
-
-#define gdk_color_state_unref(self) _gdk_color_state_unref (self)
-static inline void
-_gdk_color_state_unref (GdkColorState *self)
-{
-  if (GDK_IS_DEFAULT_COLOR_STATE (self))
-    return;
-
-  if (g_atomic_ref_count_dec (&self->ref_count))
-    self->klass->free (self);
-}
-
-#define gdk_color_state_equal(a,b) _gdk_color_state_equal ((a), (b))
-static inline gboolean
-_gdk_color_state_equal (GdkColorState *self,
-                        GdkColorState *other)
-{
-  if (self == other)
-    return TRUE;
-
-  if (self->klass != other->klass)
-    return FALSE;
-
-  return self->klass->equal (self, other);
-}
-
-/* Note: the functions returned from this expect the source
- * color state to be passed as self
- */
-static inline GdkFloatColorConvert
-gdk_color_state_get_convert_to (GdkColorState *self,
-                                GdkColorState *target)
-{
-  return self->klass->get_convert_to (self, target);
-}
-
-/* Note: the functions returned from this expect the target
- * color state to be passed as self
- */
-static inline GdkFloatColorConvert
-gdk_color_state_get_convert_from (GdkColorState *self,
-                                  GdkColorState *source)
-{
-  return self->klass->get_convert_from (self, source);
-}
-
-static inline const GdkCicp *
-gdk_color_state_get_cicp (GdkColorState *self)
-{
-  return self->klass->get_cicp (self);
-}
-
-static inline void
-gdk_color_state_convert_color (GdkColorState *src_cs,
-                               const float    src[4],
-                               GdkColorState *dest_cs,
-                               float          dest[4])
-{
-  GdkFloatColorConvert convert = NULL;
-  GdkFloatColorConvert convert2 = NULL;
-
-  dest[0] = src[0];
-  dest[1] = src[1];
-  dest[2] = src[2];
-  dest[3] = src[3];
-
-  if (gdk_color_state_equal (src_cs, dest_cs))
-    return;
-
-  convert = gdk_color_state_get_convert_to (src_cs, dest_cs);
-
-  if (!convert)
-    convert2 = gdk_color_state_get_convert_from (dest_cs, src_cs);
-
-  if (!convert && !convert2)
-    {
-      GdkColorState *connection = GDK_COLOR_STATE_REC2100_LINEAR;
-      convert = gdk_color_state_get_convert_to (src_cs, connection);
-      convert2 = gdk_color_state_get_convert_from (dest_cs, connection);
-    }
-
-  if (convert)
-    convert (src_cs,  (float(*)[4]) dest, 1);
-
-  if (convert2)
-    convert2 (dest_cs, (float(*)[4]) dest, 1);
-}
-
-static inline void
-gdk_color_state_from_rgba (GdkColorState *self,
-                           const GdkRGBA *rgba,
-                           float          out_color[4])
-{
-  gdk_color_state_convert_color (GDK_COLOR_STATE_SRGB,
-                                 (const float *) rgba,
-                                 self,
-                                 out_color);
-}

gdk/gdkcontentdeserializer.c

@@ -533,13 +533,16 @@ deserialize_not_found (GdkContentDeserializer *deserializer)
  * @type: the GType to deserialize from
  * @io_priority: the I/O priority of the operation
  * @cancellable: (nullable): optional `GCancellable` object
- * @callback: (scope async) (closure user_data): callback to call when the operation is done
- * @user_data: data to pass to the callback function
+ * @callback: (scope async): callback to call when the operation is done
+ * @user_data: (closure): data to pass to the callback function
  *
  * Read content from the given input stream and deserialize it, asynchronously.
  *
  * The default I/O priority is %G_PRIORITY_DEFAULT (i.e. 0), and lower numbers
  * indicate a higher priority.
+ *
+ * When the operation is finished, @callback will be called. You must then
+ * call [func@Gdk.content_deserialize_finish] to get the result of the operation.
  */
 void
 gdk_content_deserialize_async (GInputStream        *stream,

gdk/gdkcontentprovider.c

@@ -169,7 +169,7 @@ gdk_content_provider_class_init (GdkContentProviderClass *class)
   class->get_value = gdk_content_provider_real_get_value;
 
   /**
-   * GdkContentProvider:formats: (getter ref_formats)
+   * GdkContentProvider:formats: (attributes org.gtk.Property.get=gdk_content_provider_ref_formats)
    *
    * The possible formats that the provider can provide its data in.
    */
@@ -181,7 +181,7 @@ gdk_content_provider_class_init (GdkContentProviderClass *class)
                         G_PARAM_EXPLICIT_NOTIFY);
 
   /**
-   * GdkContentProvider:storable-formats: (getter ref_storable_formats)
+   * GdkContentProvider:storable-formats: (attributes org.gtk.Property.get=gdk_content_provider_ref_storable_formats)
    *
    * The subset of formats that clipboard managers should store this provider's data in.
    */
@@ -214,7 +214,7 @@ gdk_content_provider_init (GdkContentProvider *provider)
 }
 
 /**
- * gdk_content_provider_ref_formats: (get-property formats)
+ * gdk_content_provider_ref_formats: (attributes org.gtk.Method.get_property=formats)
  * @provider: a `GdkContentProvider`
  *
  * Gets the formats that the provider can provide its current contents in.
@@ -230,7 +230,7 @@ gdk_content_provider_ref_formats (GdkContentProvider *provider)
 }
 
 /**
- * gdk_content_provider_ref_storable_formats: (get-property storable-formats)
+ * gdk_content_provider_ref_storable_formats: (attributes org.gtk.Method.get_property=storable-formats)
  * @provider: a `GdkContentProvider`
  *
  * Gets the formats that the provider suggests other applications to store
@@ -273,12 +273,16 @@ gdk_content_provider_content_changed (GdkContentProvider *provider)
  * @stream: the `GOutputStream` to write to
  * @io_priority: I/O priority of the request.
  * @cancellable: (nullable): optional `GCancellable` object, %NULL to ignore.
- * @callback: (scope async) (closure user_data): callback to call when the request is satisfied
- * @user_data: the data to pass to callback function
+ * @callback: (scope async): callback to call when the request is satisfied
+ * @user_data: (closure): the data to pass to callback function
  *
  * Asynchronously writes the contents of @provider to @stream in the given
  * @mime_type.
  *
+ * When the operation is finished @callback will be called. You must then call
+ * [method@Gdk.ContentProvider.write_mime_type_finish] to get the result
+ * of the operation.
+ *
  * The given mime type does not need to be listed in the formats returned by
  * [method@Gdk.ContentProvider.ref_formats]. However, if the given `GType` is
  * not supported, `G_IO_ERROR_NOT_SUPPORTED` will be reported.

gdk/gdkcontentserializer.c

@@ -539,13 +539,16 @@ serialize_not_found (GdkContentSerializer *serializer)
  * @value: the content to serialize
  * @io_priority: the I/O priority of the operation
  * @cancellable: (nullable): optional `GCancellable` object
- * @callback: (scope async) (closure): callback to call when the operation is done
- * @user_data: data to pass to the callback function
+ * @callback: (scope async): callback to call when the operation is done
+ * @user_data: (closure): data to pass to the callback function
  *
  * Serialize content and write it to the given output stream, asynchronously.
  *
  * The default I/O priority is %G_PRIORITY_DEFAULT (i.e. 0), and lower numbers
  * indicate a higher priority.
+ *
+ * When the operation is finished, @callback will be called. You must then
+ * call [func@Gdk.content_serialize_finish] to get the result of the operation.
  */
 void
 gdk_content_serialize_async (GOutputStream       *stream,

gdk/gdkcursor.c

@@ -172,7 +172,7 @@ gdk_cursor_class_init (GdkCursorClass *cursor_class)
   object_class->finalize = gdk_cursor_finalize;
 
   /**
-   * GdkCursor:fallback:
+   * GdkCursor:fallback: (attributes org.gtk.Property.get=gdk_cursor_get_fallback)
    *
    * Cursor to fall back to if this cursor cannot be displayed.
    */
@@ -184,7 +184,7 @@ gdk_cursor_class_init (GdkCursorClass *cursor_class)
                                                         G_PARAM_STATIC_STRINGS));
 
   /**
-   * GdkCursor:hotspot-x:
+   * GdkCursor:hotspot-x: (attributes org.gtk.Property.get=gdk_cursor_get_hotspot_x)
    *
    * X position of the cursor hotspot in the cursor image.
    */
@@ -196,7 +196,7 @@ gdk_cursor_class_init (GdkCursorClass *cursor_class)
                                                      G_PARAM_STATIC_STRINGS));
 
   /**
-   * GdkCursor:hotspot-y:
+   * GdkCursor:hotspot-y: (attributes org.gtk.Property.get=gdk_cursor_get_hotspot_y)
    *
    * Y position of the cursor hotspot in the cursor image.
    */
@@ -208,7 +208,7 @@ gdk_cursor_class_init (GdkCursorClass *cursor_class)
                                                      G_PARAM_STATIC_STRINGS));
 
   /**
-   * GdkCursor:name:
+   * GdkCursor:name: (attributes org.gtk.Property.get=gdk_cursor_get_name)
    *
    * Name of this this cursor.
    *
@@ -407,7 +407,7 @@ gdk_cursor_new_from_callback (GdkCursorGetTextureCallback  callback,
 }
 
 /**
- * gdk_cursor_get_fallback:
+ * gdk_cursor_get_fallback: (attributes org.gtk.Method.get_property=fallback)
  * @cursor: a `GdkCursor`
  *
  * Returns the fallback for this @cursor.
@@ -430,7 +430,7 @@ gdk_cursor_get_fallback (GdkCursor *cursor)
 }
 
 /**
- * gdk_cursor_get_name:
+ * gdk_cursor_get_name: (attributes org.gtk.Method.get_property=name)
  * @cursor: a `GdkCursor`
  *
  * Returns the name of the cursor.
@@ -468,7 +468,7 @@ gdk_cursor_get_texture (GdkCursor *cursor)
 }
 
 /**
- * gdk_cursor_get_hotspot_x:
+ * gdk_cursor_get_hotspot_x: (attributes org.gtk.Method.get_property=hotspot-x)
  * @cursor: a `GdkCursor`
  *
  * Returns the horizontal offset of the hotspot.
@@ -490,7 +490,7 @@ gdk_cursor_get_hotspot_x (GdkCursor *cursor)
 }
 
 /**
- * gdk_cursor_get_hotspot_y:
+ * gdk_cursor_get_hotspot_y: (attributes org.gtk.Method.get_property=hotspot-y)
  * @cursor: a `GdkCursor`
  *
  * Returns the vertical offset of the hotspot.