gsk: Update docs for gtk_snapshot_append_layout

Mention how to get the current theme's foreground color.

rendernode, snapshot: Slightly expand color matrix docs

Based on reverse engineering the color node and contrary to my
expectations, the matrix/offset is expressed in, and applied to,
unpremultiplied colors. The colors are being explicitly
unpremultiplied, transformed according to the matrix/offset, and
premultiplied back (see color_matrix.glsl). The matrix is getting
transposed.

Also, copy the same blurb to the corresponding GtkSnapshot function.

Signed-off-by: Sergey Bugaev <bugaevc@gmail.com>

snapshot: Fix merging color matrix nodes

The code was appliying the matrices in the wrong order: we have to apply
the inner node's matrix first, and the outer one second. Due to the
matrices being implicitly transposed, the matrix multiplication was done
in the right order, yet the wrong matrix was being mutliplied by the
wrong offset vector.

To make the code a little easier to follow, create explicit variables
for the resulting matrix and offset (instead of reusing matrix2 and
offset2), and fix & expand the comment to document how matrix
transposition factors into this.

Signed-off-by: Sergey Bugaev <bugaevc@gmail.com>

introspection: Remove 'caller-allocates' from POD types

The (out caller-allocates) and (out callee-allocates) annotations are
meant for structured or pointer types. Plain old data types are just
regular out parameters and don't need the annotation about who allocates
them.

See glib!2005, gjs#570

meson: Add x11_dep to gtk4-x11 requires

meson: Add wayland-client to gtk4-wayland requires

SignalListItemFactory: small doc grammar+sense fix

* "to to" => "to"
* "a object" => "an object"
* "its new prop is about to be unset" => "its prop is about to be unset"

menubutton: Fix focus on the internal gizmo

Fixes https://gitlab.gnome.org/GNOME/gtk/-/issues/6025

Inspector: Fix ! flash on select widget @ obj tree

Widgets are flashed by the window when it receives Tree::object-selected
- but we were emitting said signal from select_object(), i.e. if we were
made to select by an external caller. We should also emit it if the user
interactively selects an item, so the window receives+flashes the widget

fixes https://gitlab.gnome.org/GNOME/gtk/-/issues/6022

fontdialogbutton: Make activatable

colordialogbutton: Make activatable

text: Track user changes better

Make all the action signal handlers call
begin/end_change(), so we can rely on
change_count being >0 to check later if
an action is user-initiated or programmatic.

Fixes: #6018

gl: Pass swizzle array directly

There's no need to pass pointers to arrays, as arrays are already
pointers.

columnview: Fix refcounting woes

The new code did not deal with the GtkScrollInfo properly.

Related: #6002

gdkcontext: Make has_unpack_subimage() do the version check

Makes the code look simpler when we actually use that function.

treeviewcolumn: Set ascending class for ascending order

The alternative button order confused the code and so the "ascending"
class was set for descending order by default, not when alternate order
is set.

macos: use NSPopUpButton for filter selection in native filechooser

On macOS 14, NSComboBox can't popup the dropdown list of filters. That
makes native filechooser on macOS completed broken. And NSComboBox is
more complex since it is a widget focused on edit capability.
NSPopUpButton is more suitable for plain selectable dropdown list.

Fixes: 4986
Signed-off-by: Qiu Wenbo <qiuwenbo@kylinos.com.cn>

filefilter: fix UTI type conversion on macOS

GContentType on macOS switched to UTI since glib 2.51. We should not assume it as MIME type anymore.

Fixes: #4986
Signed-off-by: Qiu Wenbo <qiuwenbo@kylinos.com.cn>

docs: Add/fix some links; avoid pluralisation

Appending `s` breaks the [type@NS.Object] notation, so fix that in
ListHeader. Add links to ListItem and Overlay, and avoid appending `s`
after `backtick`s just for consistency with the [type@NS.Object] issue.

print: Update printerprivate header location for cpdb backend

This fixes the print-cpdb build option

test-calendar: Update timezone name

Debian no longer provides the MET timezone
but instead provides geographical region and city name

print: Revert "Start sorting apart includes" change for gtkprinteroptionprivate.h

The print backends needs the functions in gtkprinteroptionprivate.h to
be exported.

Fixes #6003.

gtkgridview: return empty area for empty tiles during scroll

section-accessibility: Close tag

Post-release version bump

4.12.0

Merge branch 'matthiasc/for-main' into 'main'

build: Rename docs build options

See merge request GNOME/gtk!6239

README: Some updates

build: Rename docs build options

Rename gtk_doc to documentation and update_screenshots
to screenshots. The old names are still accepted.

Merge branch 'wip/otte/scroll-to' into 'main'

a scroll_to() for list widgets

See merge request GNOME/gtk!6227

inspector: Use scroll_to() in the object tree search

columnview: Implement gtk_column_view_scroll_to()

It's basically the listview version, but with an (optional) column to do
cell-based scrolling/focusing.

Add gtk_grid_view_scroll_to

This does the same as gtk_list_view_scroll_to, just
for a grid view.

gtk-demo: Make arrowing in suggestionentry scroll the dropdown

listview: Implement gtk_list_view_scroll_to()

This adds a flags enum so we can also do select/focus at the same time.

It's implemented in GtkListBase, so adding support forgridview should be
easy.

viewport: Use gtk_viewport_scroll_to() for focus scrolling

viewport: Add gtk_viewport_scroll_to()

First implementation of GtkScrollInfo

gtk: Add GtkScrollInfo

This struct carries information about scrolling a scrollable, so that
individual scrollables can share this struct for their scrolling APIs.

For now, there's not much information here, we're still trying to cook
up an API that works well.

Merge branch 'format' into 'main'

adjustment: Properly use <code> tag

See merge request GNOME/gtk!6238

adjustment: Properly use <code> tag

Update Ukrainian translation

Merge branch 'more-deprecation-cleanup' into 'main'

Drop old style deprecation handling

See merge request GNOME/gtk!6237

examples: More deprecation cleanup

Remove GtkDialog use from bloatpad.

Drop old style deprecation handling

We don't use this anymore.

examples: Deprecation cleanup

Merge branch 'matthiasc/for-main' into 'main'

wayland: Fix gtk-shell protocol handling

See merge request GNOME/gtk!6236

wayland: Fix gtk-shell protocol handling

The protocol spec isn't clear about the relationship
between the capability enum and the uint in the capability
event.

Fix things to use the same relationship as mutter.

Merge branch 'matthiasc/for-main' into 'main'

build: Set the default visibility

See merge request GNOME/gtk!6235

build: Set the default visibility

While working on deprecation cleanups, I noticed
that removing GDK_DEPRECATED_IN... from headers
does not have the effect of making the symbols
disappear, since we were forgetting to set the
default visibility to hidden.

testsuite: Don't rely on default visibility

The builder test was relying on default visiblity
for non-static functions. Make it explicit that we
want to export these functions, so the test keeps
working when we change the default visibility.

Merge branch 'deprecation-cleanups' into 'main'

gtk-demo: Deprecation cleanup

See merge request GNOME/gtk!6233

constraint-editor: Deprecation cleanup

Drop all uses of deprecated API.

print-editor: Deprecation cleanup

Drop all uses of deprecated API.

gtk-demo: Deprecation cleanup

Remove many uses of deprecated api in gtk4-demo.

Remaining uses are demos of wholly deprecated objects
that will just be dropped in GTK5.

Merge branch 'wip/alice/center-layout' into 'main'

centerlayout: Fix child sizing

See merge request GNOME/gtk!6234

centerlayout: Invert :shrink-center-last

Make what it does match its name.

centerlayout: Fix child sizing

For some reason the start/end child size is restricted to
(width - title width) / 2. This is generally unexpected, so stop doing
that.

Update Russian translation

Merge branch 'matthiasc/for-main' into 'main'

gtk-demo: Use GtkBuilderScope more

See merge request GNOME/gtk!6232

Merge branch 'bilelmoussaoui/gi' into 'main'

gtk: Add missing since annotations

See merge request GNOME/gtk!6231

AUTHORS: Some updates

RELEASE-HOWTO: Some updates

gtk-demo: Use GtkBuilderScope more

Under circumstances I haven't fully tracked down,
these demos refuse to run, failing to locate their
callbacks. So use the machinery we have, and set up
a GtkBuilderCScope for each of the problematic cases.

gtk: Add missing since annotations

Follow up of https://gitlab.gnome.org/GNOME/gtk/-/commit/7f946eff0163e84e34a1880f068f7f5efb354add

Merge branch 'gdk-win32-cleanup' into 'main'

GdkWin32 cleanup

See merge request GNOME/gtk!6230

Merge branch 'cetner-layout-compute-expand' into 'main'

Fix computing expand in GtkCenterLayout

See merge request GNOME/gtk!6229

GdkWin32: Remove unused members from GdkWin32Surface

GdkWin32: No need to set the active keyboard layout

It's already done as part of GdkWin32Keymap initialization
(in update_keymap ())

GdkWin32: Remove gdk_synchronize

Merge branch 'ebassi/hint-font-lodpi' into 'main'

Enable subpixel positioning for text only on high scaling factors

See merge request GNOME/gtk!6190

centerlayout: Fix computing expand

It was calling get_hexpand () / get_vexpand (), which only get whether
the expand properties are set on the widget itself. Use
compute_expand (), which properly walks the widget tree and finds
whether exapnd is set on the widget or any of its descendants.

Signed-off-by: Sergey Bugaev <bugaevc@gmail.com>

reftests: Fix one reftest

The xalign property of GtkLabel defaults to 0.5,
meaning that the contents will be centered, which
is not what GtkInscription does.

label: Another tweak to wrapping handling

This fixes a few reftests that were failing after
the previous change because they ended up with x == -1.

Merge branch 'radioactiveman-main-patch-77429' into 'main'

docs: Fix typo

See merge request GNOME/gtk!6226

docs: Fix typo

Merge branch 'wip/sophie-h/ask' into 'main'

filelauncher: Add 'ask' property

Closes #5942

See merge request GNOME/gtk!6225

filelauncher: Add 'always-ask' property

The 'ask' property is part of the portal. It forces always asking
the user with which app to open a file.

Closes #5942

Update Persian translation

Update Georgian translation

Merge branch 'wip/otte/vulkan-for-main' into 'main'

inspector: Make the measure map buttons work again

Closes #5992

See merge request GNOME/gtk!6223

inspector: Make the measure map buttons work again

The show/hide => set_visible() cleanups had broken things.

Fixes #5992

Merge branch 'wip/otte/vulkan-for-main' into 'main'

vulkan: Remove unused variable

See merge request GNOME/gtk!6222

vulkan: Clear Cairo surfaces on upload

The memory isn't guaranteed to be all zeroes and we don't want glitches.

vulkan: Fix a memleak

vulkan: Plug a memleak

Yay, we no longer leak swapchain images

rendernode-tool: Add another magic format

Make .svg use the Cairo renderer to save to an SVG file.

It's useful when comparing rendering behavior and times with
web browsers (as long as one is aware that browsers build a full
DOM tree out of those SVGs).

rendernode-tool: Move code

No functional changes yet.

vulkancontext: Do proper refcounting

- fix a memleak
- call unref() instead of new()
- remove idle handler on dispose

What was I doing when I wrote the pipeline cache code?

vulkan: Plug a memleak

memorytexture: Add a check

Sophie Herold was running into this problem while coding, so let's help
people by catching it early.

vulkan: Remove unused variable

It's only used when printing debug stuff. Debug stuff is not that
important.

docs: Update for recent rendernode-tool changes

Update Persian translation

Update Hungarian translation

Merge branch 'gtk-wip/inactive-state' into 'main'

gtk: Add suspended window state

See merge request GNOME/gtk!6221

Add a single test runner

Running the whole test suite is not fun, and the magic incantations for
running a specific backend are too complicated to remember.

label: Let Pango align the layout

Just like GtkInscription does since commit 883011f2. The layout offsets
are maintained as floats, and only converted to integers when exposing
them to callers.

Fix indentation in GtkInscription

build: Don't require bleeding-edge wayland-protocols

The 1.32 wayland-protocols release is not in distribution
builds yet, so a hard dependency on it is not helpful.

gtk: Add suspended window state

This is implemented using a new xdg_toplevel `suspended` state, and is
meant for allowing applications to know when they can stop doing
unnecessary work and thus save power.

In the other backends, the `suspended` state is set at the same time as
`minimized` as it's the closest there is to traditional windowing
systems.