AuroraMiddleware/gtk
1
0
Fork 1
mirror of https://gitlab.gnome.org/GNOME/gtk.git synced 2024-11-09 18:30:08 +00:00
Code Issues Projects Releases Wiki Activity
b05408f854
gtk/gdk/gdksurfaceprivate.h

331 lines
13 KiB
C
Raw Normal View History

gdk: Add a private header This is in preparation for getting rid of GdkSurfaceImpl.
2019-04-21 18:42:31 +00:00
/* GDK - The GIMP Drawing Kit
* Copyright (C) 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 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/>.
*/
/* Uninstalled header defining types and functions internal to GDK */
#ifndef __GDK_SURFACE_PRIVATE_H__
#define __GDK_SURFACE_PRIVATE_H__
#include <gdk-pixbuf/gdk-pixbuf.h>
#include "gdkenumtypes.h"
#include "gdksurface.h"
G_BEGIN_DECLS
gdk: Drop surface-type We have interfaces for surface subtypes now.
2020-03-09 15:22:55 +00:00
typedef enum
{
GDK_SURFACE_TOPLEVEL,
GDK_SURFACE_TEMP,
GDK_SURFACE_POPUP
} GdkSurfaceType;
gdk: Add a private header This is in preparation for getting rid of GdkSurfaceImpl.
2019-04-21 18:42:31 +00:00
struct _GdkSurface
{
GObject parent_instance;
GdkDisplay *display;
surface: Store popup parent Store popup parents separately from transient-for parents, since these are separate concepts with different behaviors. And we need the parent in the frontend, so we can use it in the fallback move-to-rect implementation.
2019-04-22 14:21:17 +00:00
GdkSurface *transient_for; /* for toplevels */
GdkSurface *parent; /* for popups */
gdk: Maintain popup tree in the frontend We will need this information here, and we can share the child lists between various backends.
2019-05-22 22:04:45 +00:00
GList *children; /* popups */
gdk: Add a private header This is in preparation for getting rid of GdkSurfaceImpl.
2019-04-21 18:42:31 +00:00
gpointer widget;
gint x;
gint y;
guint8 resize_count;
GdkGLContext *gl_paint_context;
cairo_region_t *update_area;
guint update_freeze_count;
gdk/frameclock: Make surfaces inhibit freeze To make a frame clock tick as long as any of the associated surfaces expect to receive ticks, make the surfaces inhibit freezing the clock, instead of directly tell the frame clock to freeze itself. This makes it so that as long as any surface using a certain frame clock is not frozen (e.g. just received a frame event from the display server), the frame clock will not be frozen. With this, the frame clock is initiated as frozen, and won't be thawed until any surface inhibits freeze. It will be frozen again, when every surface has that previously inhibited freeze uninhibited freeze.
2019-06-28 16:45:44 +00:00
gboolean pending_schedule_update;
gdk: Add a private header This is in preparation for getting rid of GdkSurfaceImpl.
2019-04-21 18:42:31 +00:00
/* This is the update_area that was in effect when the current expose
started. It may be smaller than the expose area if we'e painting
more than we have to, but it represents the "true" damage. */
cairo_region_t *active_update_area;
GdkSurfaceState old_state;
GdkSurfaceState state;
guint8 alpha;
guint8 fullscreen_mode;
guint modal_hint : 1;
guint destroyed : 2;
guint accept_focus : 1;
guint focus_on_map : 1;
guint support_multidevice : 1;
guint viewable : 1; /* mapped and all parents mapped */
guint in_update : 1;
guint frame_clock_events_paused : 1;
surface: Add an autohide property This api is meant to mimic xdg-popover.grab - we show the surface, and dismiss it when we get events on other surfaces. For foreign surfaces, the compositor handles that for us; for our own, we check outselves before delivering events to GTK.
2019-04-22 21:31:33 +00:00
guint autohide : 1;
gdk: Add a private header This is in preparation for getting rid of GdkSurfaceImpl.
2019-04-21 18:42:31 +00:00
gdk/surface: Replace move_to_rect() with GdkPopupLayout based API Replace the gdk_surface_move_to_rect() API with a new GdkSurface method called gdk_surface_present_popup() taking a new GdkPopupLayout object describing how they should be laid out on screen. The layout properties provided are the same as the ones used with gdk_surface_move_to_rect(), except they are now set up using GdkPopupLayout. Calling gdk_surface_present_popup() will either show the popup at the position described using the popup layout object and a new unconstrained size, or reposition it accordingly. In some situations, such as when a popup is set to autohide, presenting may immediately fail, in case the grab was not granted by the display server. After a successful present, the result of the layout can be queried using the following methods: * gdk_surface_get_position() - to get the position relative to its parent * gdk_surface_get_width() - to get the current width * gdk_surface_get_height() - to get the current height * gdk_surface_get_rect_anchor() - to get the anchor point on the anchor rectangle the popup was effectively positioned against given constraints defined by the environment and the layout rules provided via GdkPopupLayout. * gdk_surface_get_surface_anchor() - the same as the one above but for the surface anchor. A new signal replaces the old "moved-to-rect" one - "popup-layout-changed". However, it is only intended to be emitted when the layout changes implicitly by the windowing system, for example if the monitor resolution changed, or the parent window moved.
2020-02-16 11:59:24 +00:00
struct {
GdkGravity surface_anchor;
GdkGravity rect_anchor;
} popup;
gdk: Add a private header This is in preparation for getting rid of GdkSurfaceImpl.
2019-04-21 18:42:31 +00:00
guint update_and_descendants_freeze_count;
gint width, height;
gint shadow_top;
gint shadow_left;
gint shadow_right;
gint shadow_bottom;
GdkCursor *cursor;
GHashTable *device_cursor;
surface: Rename gdk_surface_input_shape_combine_region There is no shape combining going on anymore, so call this just gdk_surface_set_input_region, and remove the offset arguments too. All callers pass 0 anyway. Update all callers and implementations.
2020-03-01 19:29:06 +00:00
cairo_region_t *input_region;
gdk: Add a private header This is in preparation for getting rid of GdkSurfaceImpl.
2019-04-21 18:42:31 +00:00
GList *devices_inside;
GdkFrameClock *frame_clock; /* NULL to use from parent or default */
GSList *draw_contexts;
GdkDrawContext *paint_context;
cairo_region_t *opaque_region;
};
struct _GdkSurfaceClass
{
Get rid of GdkSurfaceImpl We don't need the complicated wrapper system anymore, since client-side windows are gone. This commit moves all the vfuncs to GtkSurfaceClass, and changes the backends to just derive their surface implementation from GdkSurface.
2019-04-22 01:14:46 +00:00
GObjectClass parent_class;
cairo_surface_t *
(* ref_cairo_surface) (GdkSurface *surface);
void (* show) (GdkSurface *surface,
gboolean already_mapped);
void (* hide) (GdkSurface *surface);
void (* withdraw) (GdkSurface *surface);
void (* raise) (GdkSurface *surface);
void (* lower) (GdkSurface *surface);
void (* restack_toplevel) (GdkSurface *surface,
GdkSurface *sibling,
gboolean above);
gdk/surface: Add toplevel_resize vfunc To separate how toplevels and popups are configured, a first step is to introduce a resize-only vfunc for backends to implement. It's meant to only configure toplevel windows, i.e. popups. Currently it's used for both types, but introducing the resize-only API is a first step.
2019-07-15 08:54:44 +00:00
void (* toplevel_resize) (GdkSurface *surface,
gint width,
gint height);
gdk/surface: Replace move_to_rect() with GdkPopupLayout based API Replace the gdk_surface_move_to_rect() API with a new GdkSurface method called gdk_surface_present_popup() taking a new GdkPopupLayout object describing how they should be laid out on screen. The layout properties provided are the same as the ones used with gdk_surface_move_to_rect(), except they are now set up using GdkPopupLayout. Calling gdk_surface_present_popup() will either show the popup at the position described using the popup layout object and a new unconstrained size, or reposition it accordingly. In some situations, such as when a popup is set to autohide, presenting may immediately fail, in case the grab was not granted by the display server. After a successful present, the result of the layout can be queried using the following methods: * gdk_surface_get_position() - to get the position relative to its parent * gdk_surface_get_width() - to get the current width * gdk_surface_get_height() - to get the current height * gdk_surface_get_rect_anchor() - to get the anchor point on the anchor rectangle the popup was effectively positioned against given constraints defined by the environment and the layout rules provided via GdkPopupLayout. * gdk_surface_get_surface_anchor() - the same as the one above but for the surface anchor. A new signal replaces the old "moved-to-rect" one - "popup-layout-changed". However, it is only intended to be emitted when the layout changes implicitly by the windowing system, for example if the monitor resolution changed, or the parent window moved.
2020-02-16 11:59:24 +00:00
gboolean (* present_popup) (GdkSurface *surface,
int width,
int height,
GdkPopupLayout *layout);
Get rid of GdkSurfaceImpl We don't need the complicated wrapper system anymore, since client-side windows are gone. This commit moves all the vfuncs to GtkSurfaceClass, and changes the backends to just derive their surface implementation from GdkSurface.
2019-04-22 01:14:46 +00:00
void (* get_geometry) (GdkSurface *surface,
gint *x,
gint *y,
gint *width,
gint *height);
void (* get_root_coords) (GdkSurface *surface,
gint x,
gint y,
gint *root_x,
gint *root_y);
gboolean (* get_device_state) (GdkSurface *surface,
GdkDevice *device,
gdouble *x,
gdouble *y,
GdkModifierType *mask);
surface: Rename gdk_surface_input_shape_combine_region There is no shape combining going on anymore, so call this just gdk_surface_set_input_region, and remove the offset arguments too. All callers pass 0 anyway. Update all callers and implementations.
2020-03-01 19:29:06 +00:00
void (* set_input_region) (GdkSurface *surface,
cairo_region_t *shape_region);
Get rid of GdkSurfaceImpl We don't need the complicated wrapper system anymore, since client-side windows are gone. This commit moves all the vfuncs to GtkSurfaceClass, and changes the backends to just derive their surface implementation from GdkSurface.
2019-04-22 01:14:46 +00:00
/* Called to do the windowing system specific part of gdk_surface_destroy(),
*
* surface: The window being destroyed
* foreign_destroy: If TRUE, the surface or a parent was destroyed by some
* external agency. The surface has already been destroyed and no
* windowing system calls should be made. (This may never happen
* for some windowing systems.)
*/
void (* destroy) (GdkSurface *surface,
gboolean foreign_destroy);
/* optional */
gboolean (* beep) (GdkSurface *surface);
void (* focus) (GdkSurface *surface,
guint32 timestamp);
void (* set_type_hint) (GdkSurface *surface,
GdkSurfaceTypeHint hint);
GdkSurfaceTypeHint (* get_type_hint) (GdkSurface *surface);
void (* set_modal_hint) (GdkSurface *surface,
gboolean modal);
void (* set_geometry_hints) (GdkSurface *surface,
const GdkGeometry *geometry,
GdkSurfaceHints geom_mask);
void (* set_title) (GdkSurface *surface,
const gchar *title);
void (* set_startup_id) (GdkSurface *surface,
const gchar *startup_id);
void (* set_transient_for) (GdkSurface *surface,
GdkSurface *parent);
void (* get_frame_extents) (GdkSurface *surface,
GdkRectangle *rect);
void (* set_accept_focus) (GdkSurface *surface,
gboolean accept_focus);
void (* set_focus_on_map) (GdkSurface *surface,
gboolean focus_on_map);
void (* set_icon_list) (GdkSurface *surface,
GList *pixbufs);
void (* set_icon_name) (GdkSurface *surface,
const gchar *name);
Rename "iconify" to "minimize" The "iconified" state is mostly an X11-ism; every other platform calls this state "minimized" because it may not involve turning a window into an icon at all.
2019-11-16 19:50:57 +00:00
void (* minimize) (GdkSurface *surface);
void (* unminimize) (GdkSurface *surface);
Get rid of GdkSurfaceImpl We don't need the complicated wrapper system anymore, since client-side windows are gone. This commit moves all the vfuncs to GtkSurfaceClass, and changes the backends to just derive their surface implementation from GdkSurface.
2019-04-22 01:14:46 +00:00
void (* stick) (GdkSurface *surface);
void (* unstick) (GdkSurface *surface);
void (* maximize) (GdkSurface *surface);
void (* unmaximize) (GdkSurface *surface);
void (* fullscreen) (GdkSurface *surface);
void (* fullscreen_on_monitor) (GdkSurface *surface,
GdkMonitor *monitor);
void (* apply_fullscreen_mode) (GdkSurface *surface);
void (* unfullscreen) (GdkSurface *surface);
void (* set_keep_above) (GdkSurface *surface,
gboolean setting);
void (* set_keep_below) (GdkSurface *surface,
gboolean setting);
void (* set_decorations) (GdkSurface *surface,
GdkWMDecoration decorations);
gboolean (* get_decorations) (GdkSurface *surface,
GdkWMDecoration *decorations);
void (* set_functions) (GdkSurface *surface,
GdkWMFunction functions);
void (* begin_resize_drag) (GdkSurface *surface,
GdkSurfaceEdge edge,
GdkDevice *device,
gint button,
gint root_x,
gint root_y,
guint32 timestamp);
void (* begin_move_drag) (GdkSurface *surface,
GdkDevice *device,
gint button,
gint root_x,
gint root_y,
guint32 timestamp);
void (* set_opacity) (GdkSurface *surface,
gdouble opacity);
void (* destroy_notify) (GdkSurface *surface);
GdkDrag * (*drag_begin) (GdkSurface *surface,
GdkDevice *device,
GdkContentProvider*content,
GdkDragAction actions,
gint dx,
gint dy);
gint (* get_scale_factor) (GdkSurface *surface);
void (* get_unscaled_size) (GdkSurface *surface,
int *unscaled_width,
int *unscaled_height);
void (* set_opaque_region) (GdkSurface *surface,
cairo_region_t *region);
void (* set_shadow_width) (GdkSurface *surface,
gint left,
gint right,
gint top,
gint bottom);
gboolean (* show_window_menu) (GdkSurface *surface,
GdkEvent *event);
GdkGLContext *(*create_gl_context) (GdkSurface *surface,
gboolean attached,
GdkGLContext *share,
GError **error);
gboolean (* supports_edge_constraints)(GdkSurface *surface);
gdk: Add a private header This is in preparation for getting rid of GdkSurfaceImpl.
2019-04-21 18:42:31 +00:00
};
void gdk_surface_set_state (GdkSurface *surface,
GdkSurfaceState new_state);
gdk/surface: Replace move_to_rect() with GdkPopupLayout based API Replace the gdk_surface_move_to_rect() API with a new GdkSurface method called gdk_surface_present_popup() taking a new GdkPopupLayout object describing how they should be laid out on screen. The layout properties provided are the same as the ones used with gdk_surface_move_to_rect(), except they are now set up using GdkPopupLayout. Calling gdk_surface_present_popup() will either show the popup at the position described using the popup layout object and a new unconstrained size, or reposition it accordingly. In some situations, such as when a popup is set to autohide, presenting may immediately fail, in case the grab was not granted by the display server. After a successful present, the result of the layout can be queried using the following methods: * gdk_surface_get_position() - to get the position relative to its parent * gdk_surface_get_width() - to get the current width * gdk_surface_get_height() - to get the current height * gdk_surface_get_rect_anchor() - to get the anchor point on the anchor rectangle the popup was effectively positioned against given constraints defined by the environment and the layout rules provided via GdkPopupLayout. * gdk_surface_get_surface_anchor() - the same as the one above but for the surface anchor. A new signal replaces the old "moved-to-rect" one - "popup-layout-changed". However, it is only intended to be emitted when the layout changes implicitly by the windowing system, for example if the monitor resolution changed, or the parent window moved.
2020-02-16 11:59:24 +00:00
void gdk_surface_layout_popup_helper (GdkSurface *surface,
int width,
int height,
GdkPopupLayout *layout,
GdkRectangle *out_final_rect);
static inline GdkGravity
gdk_gravity_flip_horizontally (GdkGravity anchor)
{
switch (anchor)
{
default:
case GDK_GRAVITY_STATIC:
case GDK_GRAVITY_NORTH_WEST:
return GDK_GRAVITY_NORTH_EAST;
case GDK_GRAVITY_NORTH:
return GDK_GRAVITY_NORTH;
case GDK_GRAVITY_NORTH_EAST:
return GDK_GRAVITY_NORTH_WEST;
case GDK_GRAVITY_WEST:
return GDK_GRAVITY_EAST;
case GDK_GRAVITY_CENTER:
return GDK_GRAVITY_CENTER;
case GDK_GRAVITY_EAST:
return GDK_GRAVITY_WEST;
case GDK_GRAVITY_SOUTH_WEST:
return GDK_GRAVITY_SOUTH_EAST;
case GDK_GRAVITY_SOUTH:
return GDK_GRAVITY_SOUTH;
case GDK_GRAVITY_SOUTH_EAST:
return GDK_GRAVITY_SOUTH_WEST;
}
g_assert_not_reached ();
}
static inline GdkGravity
gdk_gravity_flip_vertically (GdkGravity anchor)
{
switch (anchor)
{
default:
case GDK_GRAVITY_STATIC:
case GDK_GRAVITY_NORTH_WEST:
return GDK_GRAVITY_SOUTH_WEST;
case GDK_GRAVITY_NORTH:
return GDK_GRAVITY_SOUTH;
case GDK_GRAVITY_NORTH_EAST:
return GDK_GRAVITY_SOUTH_EAST;
case GDK_GRAVITY_WEST:
return GDK_GRAVITY_WEST;
case GDK_GRAVITY_CENTER:
return GDK_GRAVITY_CENTER;
case GDK_GRAVITY_EAST:
return GDK_GRAVITY_EAST;
case GDK_GRAVITY_SOUTH_WEST:
return GDK_GRAVITY_NORTH_WEST;
case GDK_GRAVITY_SOUTH:
return GDK_GRAVITY_NORTH;
case GDK_GRAVITY_SOUTH_EAST:
return GDK_GRAVITY_NORTH_EAST;
}
g_assert_not_reached ();
}
gdk: Make backends implement move_to_rect() The generic layer still does the heavy lifting, leaving the backends more or less just act as thin wrappers, dealing a bit with global coordinate transformations. The end goal is to remove explicit surface moving from the generic gdk layer.
2019-07-15 09:35:24 +00:00
gdk: Add a private header This is in preparation for getting rid of GdkSurfaceImpl.
2019-04-21 18:42:31 +00:00
G_END_DECLS
#endif /* __GDK_SURFACE_PRIVATE_H__ */
Reference in New Issue Copy Permalink