text: #ifndef _SWAY_VIEW_H
  #define _SWAY_VIEW_H
  #include <wayland-server-core.h>
  #include <wlr/types/wlr_surface.h>
  #include "config.h"
  #if HAVE_XWAYLAND
  #include <wlr/xwayland.h>
  #endif
  #include "sway/input/input-manager.h"
  #include "sway/input/seat.h"
  
  struct sway_container;
  struct sway_xdg_decoration;
  
  enum sway_view_type {
  	SWAY_VIEW_XDG_SHELL,
  #if HAVE_XWAYLAND
  	SWAY_VIEW_XWAYLAND,
  #endif
  };
  
  enum sway_view_prop {
  	VIEW_PROP_TITLE,
  	VIEW_PROP_APP_ID,
  	VIEW_PROP_CLASS,
  	VIEW_PROP_INSTANCE,
  	VIEW_PROP_WINDOW_TYPE,
  	VIEW_PROP_WINDOW_ROLE,
  #if HAVE_XWAYLAND
  	VIEW_PROP_X11_WINDOW_ID,
  	VIEW_PROP_X11_PARENT_ID,
  #endif
  };
  
  struct sway_view_impl {
  	void (*get_constraints)(struct sway_view *view, double *min_width,
  			double *max_width, double *min_height, double *max_height);
  	const char *(*get_string_prop)(struct sway_view *view,
  			enum sway_view_prop prop);
  	uint32_t (*get_int_prop)(struct sway_view *view, enum sway_view_prop prop);
  	uint32_t (*configure)(struct sway_view *view, double lx, double ly,
  			int width, int height);
  	void (*set_activated)(struct sway_view *view, bool activated);
  	void (*set_tiled)(struct sway_view *view, bool tiled);
  	void (*set_fullscreen)(struct sway_view *view, bool fullscreen);
  	bool (*wants_floating)(struct sway_view *view);
  	void (*for_each_surface)(struct sway_view *view,
  		wlr_surface_iterator_func_t iterator, void *user_data);
  	void (*for_each_popup)(struct sway_view *view,
  		wlr_surface_iterator_func_t iterator, void *user_data);
  	bool (*is_transient_for)(struct sway_view *child,
  			struct sway_view *ancestor);
  	void (*close)(struct sway_view *view);
  	void (*close_popups)(struct sway_view *view);
  	void (*destroy)(struct sway_view *view);
  };
  
  struct sway_view {
  	enum sway_view_type type;
  	const struct sway_view_impl *impl;
  
  	struct sway_container *container; // NULL if unmapped and transactions finished
  	struct wlr_surface *surface; // NULL for unmapped views
  	struct sway_xdg_decoration *xdg_decoration;
  
  	pid_t pid;
  
  	double saved_x, saved_y;
  	int saved_width, saved_height;
  
  	// The size the view would want to be if it weren't tiled.
  	// Used when changing a view from tiled to floating.
  	int natural_width, natural_height;
  
  	char *title_format;
  
  	bool using_csd;
  
  	struct timespec urgent;
  	bool allow_request_urgent;
  	struct wl_event_source *urgent_timer;
  
  	struct wlr_buffer *saved_buffer;
  	int saved_buffer_width, saved_buffer_height;
  
  	// The geometry for whatever the client is committing, regardless of
  	// transaction state. Updated on every commit.
  	struct wlr_box geometry;
  
  	// The "old" geometry during a transaction. Used to damage the old location
  	// when a transaction is applied.
  	struct wlr_box saved_geometry;
  
  	bool destroying;
  
  	list_t *executed_criteria; // struct criteria *
  
  	union {
  		struct wlr_xdg_surface *wlr_xdg_surface;
  #if HAVE_XWAYLAND
  		struct wlr_xwayland_surface *wlr_xwayland_surface;
  #endif
  		struct wlr_wl_shell_surface *wlr_wl_shell_surface;
  	};
  
  	struct {
  		struct wl_signal unmap;
  	} events;
  
  	struct wl_listener surface_new_subsurface;
  };
  
  struct sway_xdg_shell_view {
  	struct sway_view view;
  
  	struct wl_listener commit;
  	struct wl_listener request_move;
  	struct wl_listener request_resize;
  	struct wl_listener request_maximize;
  	struct wl_listener request_fullscreen;
  	struct wl_listener set_title;
  	struct wl_listener set_app_id;
  	struct wl_listener new_popup;
  	struct wl_listener map;
  	struct wl_listener unmap;
  	struct wl_listener destroy;
  };
  #if HAVE_XWAYLAND
  struct sway_xwayland_view {
  	struct sway_view view;
  
  	struct wl_listener commit;
  	struct wl_listener request_move;
  	struct wl_listener request_resize;
  	struct wl_listener request_maximize;
  	struct wl_listener request_configure;
  	struct wl_listener request_fullscreen;
  	struct wl_listener request_activate;
  	struct wl_listener set_title;
  	struct wl_listener set_class;
  	struct wl_listener set_role;
  	struct wl_listener set_window_type;
  	struct wl_listener set_hints;
  	struct wl_listener set_decorations;
  	struct wl_listener map;
  	struct wl_listener unmap;
  	struct wl_listener destroy;
  };
  
  struct sway_xwayland_unmanaged {
  	struct wlr_xwayland_surface *wlr_xwayland_surface;
  	struct wl_list link;
  
  	int lx, ly;
  
  	struct wl_listener request_configure;
  	struct wl_listener request_fullscreen;
  	struct wl_listener commit;
  	struct wl_listener map;
  	struct wl_listener unmap;
  	struct wl_listener destroy;
  };
  #endif
  struct sway_view_child;
  
  struct sway_view_child_impl {
  	void (*get_root_coords)(struct sway_view_child *child, int *sx, int *sy);
  	void (*destroy)(struct sway_view_child *child);
  };
  
  /**
   * A view child is a surface in the view tree, such as a subsurface or a popup.
   */
  struct sway_view_child {
  	const struct sway_view_child_impl *impl;
  	struct wl_list link;
  
  	struct sway_view *view;
  	struct sway_view_child *parent;
  	struct wl_list children; // sway_view_child::link
  	struct wlr_surface *surface;
  	bool mapped;
  
  	struct wl_listener surface_commit;
  	struct wl_listener surface_new_subsurface;
  	struct wl_listener surface_map;
  	struct wl_listener surface_unmap;
  	struct wl_listener surface_destroy;
  	struct wl_listener view_unmap;
  };
  
  struct sway_subsurface {
  	struct sway_view_child child;
  
  	struct wl_listener destroy;
  };
  
  struct sway_xdg_popup {
  	struct sway_view_child child;
  
  	struct wlr_xdg_surface *wlr_xdg_surface;
  
  	struct wl_listener new_popup;
  	struct wl_listener destroy;
  };
  
  const char *view_get_title(struct sway_view *view);
  
  const char *view_get_app_id(struct sway_view *view);
  
  const char *view_get_class(struct sway_view *view);
  
  const char *view_get_instance(struct sway_view *view);
  
  uint32_t view_get_x11_window_id(struct sway_view *view);
  
  uint32_t view_get_x11_parent_id(struct sway_view *view);
  
  const char *view_get_window_role(struct sway_view *view);
  
  uint32_t view_get_window_type(struct sway_view *view);
  
  const char *view_get_shell(struct sway_view *view);
  
  void view_get_constraints(struct sway_view *view, double *min_width,
  		double *max_width, double *min_height, double *max_height);
  
  uint32_t view_configure(struct sway_view *view, double lx, double ly, int width,
  	int height);
  
  /**
   * Whether or not the view is the only visible view in its tree. If the view
   * is tiling, there may be floating views. If the view is floating, there may
   * be tiling views or views in a different floating container.
   */
  bool view_is_only_visible(struct sway_view *view);
  
  /**
   * Configure the view's position and size based on the container's position and
   * size, taking borders into consideration.
   */
  void view_autoconfigure(struct sway_view *view);
  
  void view_set_activated(struct sway_view *view, bool activated);
  
  /**
   * Called when the view requests to be focused.
   */
  void view_request_activate(struct sway_view *view);
  
  /**
   * If possible, instructs the client to change their decoration mode.
   */
  void view_set_csd_from_server(struct sway_view *view, bool enabled);
  
  /**
   * Updates the view's border setting when the client unexpectedly changes their
   * decoration mode.
   */
  void view_update_csd_from_client(struct sway_view *view, bool enabled);
  
  void view_set_tiled(struct sway_view *view, bool tiled);
  
  void view_close(struct sway_view *view);
  
  void view_close_popups(struct sway_view *view);
  
  void view_damage_from(struct sway_view *view);
  
  /**
   * Iterate all surfaces of a view (toplevels + popups).
   */
  void view_for_each_surface(struct sway_view *view,
  	wlr_surface_iterator_func_t iterator, void *user_data);
  
  /**
   * Iterate all popups recursively.
   */
  void view_for_each_popup(struct sway_view *view,
  	wlr_surface_iterator_func_t iterator, void *user_data);
  
  // view implementation
  
  void view_init(struct sway_view *view, enum sway_view_type type,
  	const struct sway_view_impl *impl);
  
  void view_destroy(struct sway_view *view);
  
  void view_begin_destroy(struct sway_view *view);
  
  void view_map(struct sway_view *view, struct wlr_surface *wlr_surface,
  	bool fullscreen, struct wlr_output *fullscreen_output, bool decoration);
  
  void view_unmap(struct sway_view *view);
  
  void view_update_size(struct sway_view *view, int width, int height);
  
  void view_child_init(struct sway_view_child *child,
  	const struct sway_view_child_impl *impl, struct sway_view *view,
  	struct wlr_surface *surface);
  
  void view_child_destroy(struct sway_view_child *child);
  
  
  struct sway_view *view_from_wlr_xdg_surface(
  	struct wlr_xdg_surface *xdg_surface);
  #if HAVE_XWAYLAND
  struct sway_view *view_from_wlr_xwayland_surface(
  	struct wlr_xwayland_surface *xsurface);
  #endif
  struct sway_view *view_from_wlr_surface(struct wlr_surface *surface);
  
  /**
   * Re-read the view's title property and update any relevant title bars.
   * The force argument makes it recreate the title bars even if the title hasn't
   * changed.
   */
  void view_update_title(struct sway_view *view, bool force);
  
  /**
   * Run any criteria that match the view and haven't been run on this view
   * before.
   */
  void view_execute_criteria(struct sway_view *view);
  
  /**
   * Returns true if there's a possibility the view may be rendered on screen.
   * Intended for damage tracking.
   */
  bool view_is_visible(struct sway_view *view);
  
  void view_set_urgent(struct sway_view *view, bool enable);
  
  bool view_is_urgent(struct sway_view *view);
  
  void view_remove_saved_buffer(struct sway_view *view);
  
  void view_save_buffer(struct sway_view *view);
  
  bool view_is_transient_for(struct sway_view *child, struct sway_view *ancestor);
  
  #endif
  