/* * Copyright © 2019 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.1 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 . * * Authors: Matthias Clasen */ #include "config.h" #include "gtknativeprivate.h" #include "gtkwidgetprivate.h" #include "gdk/gdk-private.h" #include "gtkprivate.h" #include "gtkintl.h" #include "gtkcssnodeprivate.h" typedef struct _GtkNativePrivate { gulong update_handler_id; gulong layout_handler_id; } GtkNativePrivate; static GQuark quark_gtk_native_private; /** * SECTION:gtknative * @Title: GtkNative * @Short_description: Interface for widgets having surfaces * @See_also: #GtkRoot * * #GtkNative is the interface implemented by all widgets that can provide * a GdkSurface for widgets to render on. * * The obvious example of a #GtkNative is #GtkWindow. */ G_DEFINE_INTERFACE (GtkNative, gtk_native, GTK_TYPE_WIDGET) static GskRenderer * gtk_native_default_get_renderer (GtkNative *self) { return NULL; } static void gtk_native_default_get_surface_transform (GtkNative *self, double *x, double *y) { *x = 0; *y = 0; } static void gtk_native_default_layout (GtkNative *self, int width, int height) { } static void gtk_native_default_init (GtkNativeInterface *iface) { iface->get_renderer = gtk_native_default_get_renderer; iface->get_surface_transform = gtk_native_default_get_surface_transform; iface->layout = gtk_native_default_layout; quark_gtk_native_private = g_quark_from_static_string ("gtk-native-private"); } static void frame_clock_update_cb (GdkFrameClock *clock, GtkNative *native) { if (GTK_IS_ROOT (native)) gtk_css_node_validate (gtk_widget_get_css_node (GTK_WIDGET (native))); } static void gtk_native_layout (GtkNative *self, int width, int height) { return GTK_NATIVE_GET_IFACE (self)->layout (self, width, height); } static void surface_layout_cb (GdkSurface *surface, int width, int height, GtkNative *native) { gtk_native_layout (native, width, height); if (gtk_widget_needs_allocate (GTK_WIDGET (native))) gtk_native_queue_relayout (native); } static void verify_priv_unrealized (gpointer user_data) { GtkNativePrivate *priv = user_data; g_warn_if_fail (priv->update_handler_id == 0); g_warn_if_fail (priv->layout_handler_id == 0); g_free (priv); } /** * gtk_native_realize: * @self: a #GtkNative * * Realizes a #GtkNative. */ void gtk_native_realize (GtkNative *self) { GdkSurface *surface; GdkFrameClock *clock; GtkNativePrivate *priv; g_return_if_fail (g_object_get_qdata (G_OBJECT (self), quark_gtk_native_private) == NULL); surface = gtk_native_get_surface (self); clock = gdk_surface_get_frame_clock (surface); g_return_if_fail (clock != NULL); priv = g_new0 (GtkNativePrivate, 1); priv->update_handler_id = g_signal_connect_after (clock, "update", G_CALLBACK (frame_clock_update_cb), self); priv->layout_handler_id = g_signal_connect (surface, "layout", G_CALLBACK (surface_layout_cb), self); g_object_set_qdata_full (G_OBJECT (self), quark_gtk_native_private, priv, verify_priv_unrealized); } /** * gtk_native_unrealize: * @self: a #GtkNative * * Unrealizes a #GtkNative. */ void gtk_native_unrealize (GtkNative *self) { GtkNativePrivate *priv; GdkSurface *surface; GdkFrameClock *clock; priv = g_object_get_qdata (G_OBJECT (self), quark_gtk_native_private); g_return_if_fail (priv != NULL); surface = gtk_native_get_surface (self); clock = gdk_surface_get_frame_clock (surface); g_return_if_fail (clock != NULL); g_clear_signal_handler (&priv->update_handler_id, clock); g_clear_signal_handler (&priv->layout_handler_id, surface); g_object_set_qdata (G_OBJECT (self), quark_gtk_native_private, NULL); } /** * gtk_native_get_surface: * @self: a #GtkNative * * Returns the surface of this #GtkNative. * * Returns: (transfer none): the surface of @self */ GdkSurface * gtk_native_get_surface (GtkNative *self) { g_return_val_if_fail (GTK_IS_NATIVE (self), NULL); return GTK_NATIVE_GET_IFACE (self)->get_surface (self); } /** * gtk_native_get_renderer: * @self: a #GtkNative * * Returns the renderer that is used for this #GtkNative. * * Returns: (transfer none): the renderer for @self */ GskRenderer * gtk_native_get_renderer (GtkNative *self) { g_return_val_if_fail (GTK_IS_NATIVE (self), NULL); return GTK_NATIVE_GET_IFACE (self)->get_renderer (self); } /** * gtk_native_get_surface_transform: * @self: a @GtkNative * @x: (out): return location for the x coordinate * @y: (out): return location for the y coordinate * * Retrieves the surface transform of @self. This is the translation * from @self's surface coordinates into @self's widget coordinates. */ void gtk_native_get_surface_transform (GtkNative *self, double *x, double *y) { g_return_if_fail (GTK_IS_NATIVE (self)); g_return_if_fail (x != NULL); g_return_if_fail (y != NULL); return GTK_NATIVE_GET_IFACE (self)->get_surface_transform (self, x, y); } /** * gtk_native_get_for_surface: * @surface: a #GdkSurface * * Finds the GtkNative associated with the surface. * * Returns: (transfer none): the #GtkNative that is associated with @surface */ GtkNative * gtk_native_get_for_surface (GdkSurface *surface) { GtkWidget *widget; widget = (GtkWidget *)gdk_surface_get_widget (surface); if (widget && GTK_IS_NATIVE (widget)) return GTK_NATIVE (widget); return NULL; } void gtk_native_queue_relayout (GtkNative *self) { GtkWidget *widget = GTK_WIDGET (self); GdkSurface *surface; GdkFrameClock *clock; surface = gtk_widget_get_surface (widget); clock = gtk_widget_get_frame_clock (widget); if (clock == NULL) return; gdk_frame_clock_request_phase (clock, GDK_FRAME_CLOCK_PHASE_UPDATE); gdk_surface_request_layout (surface); }