Improve a msgid

Instead of gl-context, say "GL Context".

Fixes: #4248

docs: Cosmetics

Do a round of "the the" removal.

docs: Cosmetics

Merge branch 'fix-dnd-coordinates-on-windows' into 'master'

Fix DND coordinates on Windows

See merge request GNOME/gtk!3930

Merge branch 'wip/otte/for-master' into 'master'

glcontext: Reinstate missing "!"

Closes #4349

See merge request GNOME/gtk!4067

gdk: Move GdkMemoryFormat enum to gdktypes.h

It's used in too many places now.

glcontext: Reinstate missing "!"

Replacing the return_if_fail()s in commit f584d4f50025 lost the
inversions.

Fixes #4349

Merge branch 'wip/otte/memoryformat' into 'master'

Refactor various texture machinery

See merge request GNOME/gtk!4057

gl: Use gdk_memory_texture_new_from_texture()

Way less code to prepare the texture in a proper format.

gl: Refactor texture uploading

Don't pass texture + rect, but instead have
  gdk_memory_texture_new_subtexture()
and use it to generate subtextures and pass them.

This has the advantage of downloading the a too large texture only once
instead of N times.

gltexture: Determine format in current thread

Close widget-factory and observe:

Thread 1:
 * acquire main loop
 * handle close button
 * close window
 * dispose video and media stream
 * stop GstPlayer
WAIT on pipeline stopping

Thread 2:
 * prepare next image in pipeline
 * hand image to GtkGstSink
 * create GdkTexture from image
 * gdk_gl_texture_new() determines format
WAIT on acquiring main loop

Sounds like a deadlock?

Indeed, so don't do that.

gl: Move texture uploading to the renderer

It does not belong in GdkGLContext, it's a renderer thing.
It's also the only user of that API.

Introduce gdk_gl_context_check_version() private API to make version
checks simpler.

gl: Fix downloading textures *again*

It turns out glReadPixels() cannot convert pixels and you are only
allowed to pass a single value into the function arguments. You need to
know which ones or things will explode.

GL is great.

png: Refactor png saving

Do all the memory format shenanigans in GTK now and support all the PNG
formats.

Add memory formats used by libpng

Add unpremultiplied high-depth formats. They are used in the real world,
so let's support them.

Update Icelandic translation

(cherry picked from commit 83b3c7d826bea8254357639da58ddd4568d85a30)

Update Brazilian Portuguese translation

(cherry picked from commit 4b9260608a3c20fd049f694e0c9bb587bd6e34bf)

Merge branch 'bilelmoussaoui/gtk-snapshot' into 'master'

gtk: fix Snapshot.push_shadow annotation

See merge request GNOME/gtk!4060

gtk: fix Snapshot.push_shadow annotation

png: Do loader conversions in GDK

Not inside libpng.

We really want to do them in GL, but we don't have a premultiply step
yet.

texture: Refactor downloading

Pass a format do GdkTextureClass::download(). That way we can download
data in any format.

Also replace gdk_texture_download_texture() with
gdk_memory_texture_from_texture() which again takes a format.

The old functionality is still there for code that wants it: Just pass
gdk_texture_get_format (texture) as the format argument.

Merge branch 'wip/otte/for-master' into 'master'

x11: Don't try to move destroyed windows

See merge request GNOME/gtk!4054

x11: Don't try to move destroyed windows

Fixes BadWindow crashes when the resize happen right when tooltips or
other such transient popups were in the process of being destroyed.

Merge branch 'ngl-is-the-new-gl' into 'master'

Rename ngl to gl

Closes #4318

See merge request GNOME/gtk!4037

Merge branch 'docs-window-position' into 'master'

docs: Mention gtk_window_set_position() being gone

See merge request GNOME/gtk!4048

Merge branch 'docs-urlmap' into 'master'

docs: Add GdkPixbuf to the URL map

See merge request GNOME/gtk!4051

[gtkimcontextquartz] Accommodate moving GdkSurface widget to private.

Fixes macOS build.

Merge branch 'wip/otte/gles' into 'master'

Improve GLES

See merge request GNOME/gtk!4050

docs: Add GdkPixbuf to the URL map

Allow cross-linking to the GdkPixbuf reference.

testsuite: Add run for GLES

This is supposed to test the most fallback GL stuff, so we might want to
set even more env vars here.

Also enable the run for the Fedora builder in CI.

gl: Make sure to set a proper alignment

No matter which branch we take, the alignment setting is always the
same.

gl: Check the stride is a multiple of the bpp

gl: Set stride properly in fallback

gl: Fix broken internal format

testsuite: Add a test targeting GL upload code

Previously, all the tests used the icon upload path using
glTexSubImage2D().

This test uses the custom texture path using glTexImage2D().

ngl: Use the right value

It's GL_RGBA, not GL_BGRA, or GLES will complain.

Update Basque translation

(cherry picked from commit 2492729238b90c3b1f28a8776899ea2b11c379a3)

Merge branch 'wip/otte/glcontext' into 'master'

glcontext: Make GLES vs GL configuration clearer

Closes #4221

See merge request GNOME/gtk!4044

docs: Mention gtk_window_set_position() being gone

People search for it in the migration guide much more than other
GdkSurface and GtkWindow methods.

Merge branch 'wip/otte/for-master' into 'master'

Fix GLES fallout from recent NGL updates

See merge request GNOME/gtk!4046

glcontext: Add gdk_gl_context_get_api()

This is mostly for inspector.

Not sure if we also want to deprecate gdk_gl_context_get_use_es() in
favor of this function.

ngl: Fix glTexImage2D() usage on GLES

GLES is very adamant about the format and type matching the internal
format, even if the data is NULL.

gl: Check allowed APIs in realize()

Add gdk_gl_context_is_api_allowed() for backends and make them use it.

Finally, have them return the final API as the return value (or 0 on
error).

And then use that api instead of a use_es boolean flag.

Fixes #4221

glcontext: Deprecate gdk_gl_context_set_use_es()

Make it call gdk_gl_context_set_allowed_apis().

Also port callers to use this function.

glcontext: Add GdkGLContext::allowed-apis

This allows specifying the GL APIs in a more comprehensive way than
gdk_gl_context_set_use_es().

ngl: Compute correct renderformat

We want to round up, not down.

ngl: fbo 0 has no color attachment

Query the backbuffer instead.

gsk: provide an ngl renderer

Provide a minimal renderer implementation that fails
in realize. This avoids reusing the same type, which
might give bindings trouble.

Merge branch 'wip/otte/for-master' into 'master'

css: Render the background-clip area, not the background-origin

Closes #4324

See merge request GNOME/gtk!4043

css: Render the background-clip area, not the background-origin

Testcase included

Fixes #4324

Skip gsk_ngl type funcs

The only type we have with this prefix is the
deprecated duplicate of gsk_gl_renderer_get_type(),
and including it causes some tests to break.
So skip it.

Maintain abi

Keep gsk_ngl_renderer_new and gsk_ngl_renderer_get_type,
since they were part of the abi in 4.2, and in an
installed header.

Fixes: #4318

Rename ngl to gl

We have only one gl renderer now, and it is
a bit odd for it not be called gl.

Merge branch 'wip/cdavis/menu-item-markup' into 'master'

Add support for pango markup in menu items

Closes #4306

See merge request GNOME/gtk!4039

Add support for pango markup in menu items

Before https://gitlab.gnome.org/GNOME/gtk/-/commit/c4a2234a28456fda5034bbaa155a1f8f76a6bebc
menu models could use markup for items and the markup would
be parsed, but this was not intended behavior.

This commit adds official support for using markup
for menu items via the `use-markup` property.

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

Merge branch 'fix-filechooser-portal-crash' into 'master'

filechooserportal: Take a ref on transient-for

Closes #4314

See merge request GNOME/gtk!4038

filechooserportal: Take a ref on transient-for

This may fix a crash that has been reported in
file_chooser_portal_data_free.

Fixes: #4314

Merge branch 'wip/matthiasc/gsk-hdr' into 'master'

texture: Add hdr api

See merge request GNOME/gtk!4036

ngl: Make render_texture high depth aware

Make a deep texture, if the render nodes have
high depth content.

For now, we use 32F here for the deep format,
since using 16F causes small rounding errors
that break the memorytexture roundtrip tests.

ngl: Update framebuffer format for each frame

Look at whether the render nodes are high depth and
if so, request a high depth framebuffer.
Whether we actually get one is up to the backend.

ngl: Determine intermediate formats

Look at the framebuffer and the rendernode to
determine what format to use for intermediate
textures.

Our preference here is to use fp16, if we have it
and it makes sense for the framebuffer we're given.

ngl: Allow specifying texture formats

Allow passing a format when creating textures or render targets.

Update all callers to pass GL_RGBA8, which is the format we
have always used so far.

gsk: Add high depth rendernode api

Add private api to find out if the content
of a render node should be considered 'deep'.

The information is collected at creation time,
so there is no tree-walking involved when we
are using this information in the renderer.

Currently, this comes down to whether there are
any texture nodes with high depth textures in the subtree.
In the future, we may want to allow marking gradient
nodes in this way as well.

texture: Make format a property of GdkTexture

For MemoryTexture, this is a simple change.

For GLTexture, we need to query the format at texture creation. This
sounds like a bad idea and extra work until one realizes that we'd
need to do that anyway when using the texure the first time - either
when downloading, or when trying to use it in a rendernode, where we
will soon need that information to determine if the texture prefers high
depth.

testsuite: Fail more accurately

Don't run the full test and then return "something failed" - instead
just explode when you find the failure.

cairo: Use GdkTexture for converting from pixbuf

gdk: hdr => high depth

The term "hdr" is so overloaded, we shouldn't use them anywhere, except
from maybe describing all of this work in blog posts and other marketing
materials.

So do renames:
* hdr => high_depth
* request_hdr => prefers_high_depth

This more accurately describes what is going on.

memoryformat: Add gdk_memory_format_prefers_high_depth()

This is unused so far, but is part of preparations for high depth
support in renderers.

gl: Move memory <=> GL format mapping

Put it into gdkmemoryformat.c, where all the mapping goes.

memorytexture: Split out GdkMemoryFormat handling

Also, now make gdk_memory_convert() the only conversion functions
and allow conversions between any 2 formats by going via a float[4].

This could be optimized via fast-paths, but so far it isn't.

Merge branch 'wip/chergert/dropdown-show-arrow' into 'master'

dropdown: add GtkDropDown:show-arrow property

See merge request GNOME/gtk!4033

dropdown: fix extraneous * in documentation

dropdown: add GtkDropDown:show-arrow property

This allows hiding the arrow on the dropdown which cannot otherwise be
controlled via CSS.

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

gdk: Fix an oversight

See merge request GNOME/gtk!4035

gdk: Fix an oversight

The intention here was obviously to return
the hdr config.

Merge branch 'wip/otte/gl-hdr' into 'master'

Rework GL for HDR support

See merge request GNOME/gtk!4032

egl: Implement HDR support

If EGL supports:
* no-config contexts
* >8bits pixel formats
* (optionally) floating point pixel formats

Then select such a profile as the HDR format and use it when HDR is
requested.

gdk: Add GDK_DEBUG=hdr

Forces request_hdr = TRUE for all requests.

Backends should also use this when choosing whether to honor HDR
requests for low quality compositors - as long as the compositor
pretends to support HDR, shovel HDR at it.

gdk: Add a request_hdr argument to begin_frame()

It's not used by anyone, it's just there.

gdk_draw_context_begin_frame_full() has been added so renderers can
make use of it.

egl: Support EGL_KHR_no_config_context

If the extension is supported, we create configless contexts.

This will come in handy real soon now, we use different configs for HDR
and SDR.

glcontext: Handle failure of eglBindAPI()

We don't want to be sure if we have GL or GLES.

egl: Unify contexts

Unify the X11 and Wayland EGL contexts.

This is a bit ugly to implement, because I don't want to create an
interface and I can't make them inherit from the same object, because
one needs to inherit from X11GLContext and the other from
WaylandGLContext.

So we have to put the code in GdkGLContext and make sure non-EGL
contexts can't accidentally run it. This is rather easy because we can
just check for priv->egl_context != NULL.

glcontext: Remove unused functionality

The recent changes made and unused function removals make these features
unused.

gdk: Remove unused gdk_gl_texture_quads() function

That function carried a lot of baggage.

cairo-gl: Don't leak framebuffers

The framebufffer was cached, but never deleted. And because this
function is deprecated and nobody should ever use it: Don't bother with
caching now.

wayland: Remove initial GL API bind

This is leftover from before the addition of GLES support.

GTK works fine without OpenGL and just OpenGLES.

egl: Move extension checks to GdkDisplay

We check the same extensions anyway, so no need to duplicate the code.

egl: Move EGLSurface handling to GdkSurface

Calling gdk_surface_set_egl_native_window() enables this.

display: Get carried away by extension checker

I wanted to make it easy to check for multiple extensions and then got
carried away by trying to generate beautiful error messages.

surface: Add a private struct

Adding a random member to it resulted in a lot of header surgery as a
side effect.

glcontext: The content cannot be the current context

The current context owns a reference to the context, so it cannot be
disposed.

x11: Port to shared EGL code

egl: Move initialization code and port Wayland

Moves the EGL initialization code to gdk/ so it can be shared between
backends.

Also port the Wayland backend to this code, so I know that it works.

build: Add a HAVE_EGL define to config.h

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

inspector: Export gtk_inspector_init

See merge request GNOME/gtk!4034

inspector: Export gtk_inspector_init

Quietly export this function mainly for the benefit
of libadwaita, which can can use this to install its
implementation of the gtk-inspector-page extension
point.

surface: Use g_clear_thing()

widget-factory: Name the images pages

gdk: Make GDK_DEBUG GL backend selection global

We have a global GdkGLBackendType now, just set it.

This way, using the variable forces the backend type, and we don't need
special code handling the env vars in the backends.

It also means setting the env var will now "work" on GDK backends that
don't even support that GL backend and simualte another GDK backend
having registered that GL backend already. So you can run
  GDK_DEBUG=gl-wgl gtk4-demo
on test what Wayland will do when WGL is in use.

pathbar: Use correct marshaler

Recent changes to types didn't update the marshaler. Oops.