Class

PhocView

Description [src]

class Phoc.View : GObject.Object {
  parent_instance: GObject,
  desktop: PhocDesktop*,
  link: wl_list,
  parent_link: wl_list,
  box: wlr_box,
  saved: wlr_box,
  pending_centering: _Bool,
  parent: PhocView*,
  stack: wl_list,
  wlr_surface: wlr_surface*
}

A PhocView represents a toplevel like an xdg-toplevel or a xwayland window.

Ancestors

Functions

phoc_view_from_wlr_surface

Given a wlr_surface return the corresponding PhocView.

Instance methods

phoc_view_activate

Performs the necessary steps to make the view itself appear activated and send out the corresponding view related protocol events. Note that this is not enough to actually focus the view for the user See phoc_seat_set_focus_view().

phoc_view_add_bling

By adding a PhocBling to a view you ensure that it gets rendered just before the view if both the view and the bling are mapped.

phoc_view_appear_activated
No description available.

phoc_view_close
No description available.

phoc_view_damage_whole

Add the damage of all surfaces belonging to a PhocView to the damaged screen area that needs repaint. This damages the whole view (possibly including server side window decorations) ignoring any buffer damage.

phoc_view_flush_activation_token

Notifies that the compositor handled processing the activation token and clears it.

phoc_view_for_each_surface
No description available.

phoc_view_get_activation_token

Get the current activation token.

phoc_view_get_alpha

Get the surface’s transparency.

phoc_view_get_app_id
No description available.

phoc_view_get_blings

Gets the view’s current list of blings.

phoc_view_get_fullscreen_output

Gets the output a view is fullscreen on. Returns NULL if the view isn’t currently fullscreen.

phoc_view_get_geometry
No description available.

phoc_view_get_maximized_box

Gets the “visible bounds” that a view will use on a given output when maximized.

phoc_view_get_output

If a view spans multiple output it returns the output that the center of the view is on.

phoc_view_get_pid
No description available.

phoc_view_get_scale

Get the surface’s scale.

phoc_view_get_scale_to_fit
No description available.

phoc_view_get_tile_direction
No description available.

phoc_view_get_tiled_box

Gets the “visible bounds” a view will use on a given output when tiled.

phoc_view_get_wlr_surface_at
No description available.

phoc_view_is_decorated
No description available.

phoc_view_is_mapped

Check if a view is currently mapped.

phoc_view_maximize
No description available.

phoc_view_move
No description available.

phoc_view_move_resize
No description available.

phoc_view_remove_bling

Removes the given bling from the view.

phoc_view_set_activation_token

Sets the activation token that will be used when activate the view once mapped. It will be cleared once the view got activated.

phoc_view_set_app_id
No description available.

phoc_view_set_decoration

Sets whether the window is decorated. If TRUE also specifies the decoration.

phoc_view_set_fullscreen

If fullscreen is true. fullscreens a view on the given output or (if output is NULL) on the view’s current output. Unfullscreens the view if fullscreens is false.

phoc_view_set_scale_to_fit

Turn auto scaling if oversized for this surface on (TRUE) or off (FALSE)

phoc_view_want_auto_maximize
No description available.

Methods inherited from GObject (43)

Please see GObject for a full list of methods.

Properties

Phoc.View:activation-token

If not NULL this token will be used to activate the view once mapped.

Phoc.View:alpha

The view’s transparency.

Phoc.View:is-mapped

Whether the view is currently mapped.

Phoc.View:scale-to-fit

If TRUE if surface will be scaled down to fit the screen.

Signals

Phoc.View::surface-destroy
No description available.

Signals inherited from GObject (1)
GObject::notify

The notify signal is emitted on an object when one of its properties has its value set through g_object_set_property(), g_object_set(), et al.

Class structure

struct PhocViewClass {
  GObjectClass parent_class;
  void (* move) (
    PhocView* self,
    double x,
    double y
  );
  void (* resize) (
    PhocView* self,
    uint32_t width,
    uint32_t height
  );
  void (* move_resize) (
    PhocView* self,
    double x,
    double y,
    uint32_t width,
    uint32_t height
  );
  _Bool (* want_scaling) (
    PhocView* self
  );
  _Bool (* want_auto_maximize) (
    PhocView* self
  );
  void (* set_active) (
    PhocView* self,
    _Bool active
  );
  void (* set_fullscreen) (
    PhocView* self,
    _Bool fullscreen
  );
  void (* set_maximized) (
    PhocView* self,
    _Bool maximized
  );
  void (* set_tiled) (
    PhocView* self,
    _Bool tiled
  );
  void (* close) (
    PhocView* self
  );
  void (* for_each_surface) (
    PhocView* self,
    wlr_surface_iterator_func_t iterator,
    void* user_data
  );
  void (* get_geometry) (
    PhocView* self,
    wlr_box* box
  );
  wlr_surface* (* get_wlr_surface_at) (
    PhocView* self,
    double sx,
    double sy,
    double* sub_x,
    double* sub_y
  );
  pid_t (* get_pid) (
    PhocView* self
  );
  
}
No description available.
Class members
parent_class: GObjectClass

The object class structure needs to be the first element in the widget class structure in order for the class mechanism to work correctly. This allows a PhocViewClass pointer to be cast to a GObjectClass pointer.

move: void (* move) ( PhocView* self, double x, double y )
No description available.
resize: void (* resize) ( PhocView* self, uint32_t width, uint32_t height )
No description available.
move_resize: void (* move_resize) ( PhocView* self, double x, double y, uint32_t width, uint32_t height )
No description available.
want_scaling: _Bool (* want_scaling) ( PhocView* self )
No description available.
want_auto_maximize: _Bool (* want_auto_maximize) ( PhocView* self )
No description available.
set_active: void (* set_active) ( PhocView* self, _Bool active )
No description available.
set_fullscreen: void (* set_fullscreen) ( PhocView* self, _Bool fullscreen )
No description available.
set_maximized: void (* set_maximized) ( PhocView* self, _Bool maximized )
No description available.
set_tiled: void (* set_tiled) ( PhocView* self, _Bool tiled )
No description available.
close: void (* close) ( PhocView* self )
No description available.
for_each_surface: void (* for_each_surface) ( PhocView* self, wlr_surface_iterator_func_t iterator, void* user_data )
No description available.
get_geometry: void (* get_geometry) ( PhocView* self, wlr_box* box )
No description available.
get_wlr_surface_at: wlr_surface* (* get_wlr_surface_at) ( PhocView* self, double sx, double sy, double* sub_x, double* sub_y )
No description available.
get_pid: pid_t (* get_pid) ( PhocView* self )
No description available.

Virtual methods

Phoc.ViewClass.close
No description available.

Phoc.ViewClass.for_each_surface
No description available.

Phoc.ViewClass.get_geometry
No description available.

Phoc.ViewClass.get_pid
No description available.

Phoc.ViewClass.get_wlr_surface_at
No description available.

Phoc.ViewClass.move
No description available.

Phoc.ViewClass.move_resize
No description available.

Phoc.ViewClass.resize
No description available.

Phoc.ViewClass.set_active
No description available.

Phoc.ViewClass.set_fullscreen
No description available.

Phoc.ViewClass.set_maximized
No description available.

Phoc.ViewClass.set_tiled
No description available.

Phoc.ViewClass.want_auto_maximize
No description available.

Phoc.ViewClass.want_scaling
No description available.