squash
This commit is contained in:
233
bar/services/wlr/protocol/windows.py
Normal file
233
bar/services/wlr/protocol/windows.py
Normal file
@@ -0,0 +1,233 @@
|
||||
#!/usr/bin/env python3
|
||||
|
||||
import sys
|
||||
from typing import Dict, List, Optional
|
||||
|
||||
import pywayland
|
||||
from pywayland.client import Display
|
||||
from pywayland.protocol.wayland import WlOutput, WlSeat
|
||||
|
||||
# Import the protocol interfaces from your files
|
||||
from wlr_foreign_toplevel_management_unstable_v1.zwlr_foreign_toplevel_manager_v1 import (
|
||||
ZwlrForeignToplevelManagerV1,
|
||||
)
|
||||
from wlr_foreign_toplevel_management_unstable_v1.zwlr_foreign_toplevel_handle_v1 import (
|
||||
ZwlrForeignToplevelHandleV1,
|
||||
)
|
||||
|
||||
|
||||
class Window:
|
||||
"""Represents a toplevel window in the compositor."""
|
||||
|
||||
def __init__(self, handle: ZwlrForeignToplevelHandleV1):
|
||||
self.handle = handle
|
||||
self.title: str = "Unknown"
|
||||
self.app_id: str = "Unknown"
|
||||
self.states: List[str] = []
|
||||
self.outputs: List[WlOutput] = []
|
||||
self.parent: Optional["Window"] = None
|
||||
self.closed = False
|
||||
|
||||
def __str__(self) -> str:
|
||||
state_str = (
|
||||
", ".join([ZwlrForeignToplevelHandleV1.state(s).name for s in self.states])
|
||||
if self.states
|
||||
else "normal"
|
||||
)
|
||||
return (
|
||||
f"Window(title='{self.title}', app_id='{self.app_id}', state={state_str})"
|
||||
)
|
||||
|
||||
|
||||
class WaylandWindowManager:
|
||||
"""Manages Wayland windows using the foreign toplevel protocol."""
|
||||
|
||||
def __init__(self):
|
||||
self.display = Display()
|
||||
self.windows: Dict[ZwlrForeignToplevelHandleV1, Window] = {}
|
||||
self.manager = None
|
||||
self.running = False
|
||||
|
||||
def connect(self) -> bool:
|
||||
"""Connect to the Wayland display and bind to the toplevel manager."""
|
||||
try:
|
||||
self.display.connect()
|
||||
print("Connected to Wayland display")
|
||||
|
||||
# Get the registry to find the foreign toplevel manager
|
||||
registry = self.display.get_registry()
|
||||
registry.dispatcher["global"] = self._registry_global_handler
|
||||
|
||||
# Roundtrip to process registry events
|
||||
self.display.roundtrip()
|
||||
|
||||
if not self.manager:
|
||||
print(
|
||||
"Foreign toplevel manager not found. Is wlr-foreign-toplevel-management protocol supported?"
|
||||
)
|
||||
return False
|
||||
|
||||
return True
|
||||
|
||||
except Exception as e:
|
||||
print(f"Failed to connect: {e}")
|
||||
return False
|
||||
|
||||
def _registry_global_handler(self, registry, id, interface, version):
|
||||
"""Handle registry global objects."""
|
||||
if interface == ZwlrForeignToplevelManagerV1.name:
|
||||
print(f"Found foreign toplevel manager (id={id}, version={version})")
|
||||
self.manager = registry.bind(
|
||||
id, ZwlrForeignToplevelManagerV1, min(version, 3)
|
||||
)
|
||||
self.manager.dispatcher["toplevel"] = self._handle_toplevel
|
||||
self.manager.dispatcher["finished"] = self._handle_manager_finished
|
||||
|
||||
def _handle_toplevel(self, manager, toplevel):
|
||||
"""Handle a new toplevel window."""
|
||||
window = Window(toplevel)
|
||||
self.windows[toplevel] = window
|
||||
print(window)
|
||||
|
||||
# Setup event dispatchers for the toplevel
|
||||
toplevel.dispatcher["title"] = self._handle_title
|
||||
toplevel.dispatcher["app_id"] = self._handle_app_id
|
||||
toplevel.dispatcher["state"] = self._handle_state
|
||||
toplevel.dispatcher["done"] = self._handle_done
|
||||
toplevel.dispatcher["closed"] = self._handle_closed
|
||||
toplevel.dispatcher["output_enter"] = self._handle_output_enter
|
||||
toplevel.dispatcher["output_leave"] = self._handle_output_leave
|
||||
|
||||
def _handle_title(self, toplevel, title):
|
||||
"""Handle toplevel title changes."""
|
||||
window = self.windows.get(toplevel)
|
||||
if window:
|
||||
window.title = title
|
||||
|
||||
def _handle_app_id(self, toplevel, app_id):
|
||||
"""Handle toplevel app_id changes."""
|
||||
window = self.windows.get(toplevel)
|
||||
if window:
|
||||
window.app_id = app_id
|
||||
|
||||
def _handle_state(self, toplevel, states):
|
||||
"""Handle toplevel state changes."""
|
||||
window = self.windows.get(toplevel)
|
||||
if window:
|
||||
window.states = states
|
||||
|
||||
def _handle_done(self, toplevel):
|
||||
"""Handle toplevel done event."""
|
||||
window = self.windows.get(toplevel)
|
||||
if window and not window.closed:
|
||||
print(f"Window updated: {window}")
|
||||
|
||||
def _handle_closed(self, toplevel):
|
||||
"""Handle toplevel closed event."""
|
||||
window = self.windows.get(toplevel)
|
||||
if window:
|
||||
window.closed = True
|
||||
print(f"Window closed: {window}")
|
||||
# Clean up the toplevel object
|
||||
toplevel.destroy()
|
||||
# Remove from our dictionary
|
||||
del self.windows[toplevel]
|
||||
|
||||
def _handle_output_enter(self, toplevel, output):
|
||||
"""Handle toplevel entering an output."""
|
||||
window = self.windows.get(toplevel)
|
||||
if window and output not in window.outputs:
|
||||
window.outputs.append(output)
|
||||
|
||||
def _handle_output_leave(self, toplevel, output):
|
||||
"""Handle toplevel leaving an output."""
|
||||
window = self.windows.get(toplevel)
|
||||
if window and output in window.outputs:
|
||||
window.outputs.remove(output)
|
||||
|
||||
def _handle_parent(self, toplevel, parent):
|
||||
"""Handle toplevel parent changes."""
|
||||
window = self.windows.get(toplevel)
|
||||
if window:
|
||||
if parent is None:
|
||||
window.parent = None
|
||||
else:
|
||||
parent_window = self.windows.get(parent)
|
||||
if parent_window:
|
||||
window.parent = parent_window
|
||||
|
||||
def _handle_manager_finished(self, manager):
|
||||
"""Handle manager finished event."""
|
||||
print("Foreign toplevel manager finished")
|
||||
self.running = False
|
||||
|
||||
def get_windows(self) -> List[Window]:
|
||||
"""Get all currently active windows."""
|
||||
# Filter out closed windows
|
||||
active_windows = [
|
||||
window for window in self.windows.values() if not window.closed
|
||||
]
|
||||
return active_windows
|
||||
|
||||
def run(self):
|
||||
"""Run the event loop to receive window updates."""
|
||||
self.running = True
|
||||
print("Listening for window events (press Ctrl+C to exit)...")
|
||||
|
||||
try:
|
||||
while self.running:
|
||||
self.display.dispatch(block=True)
|
||||
except KeyboardInterrupt:
|
||||
print("\nExiting...")
|
||||
finally:
|
||||
self.cleanup()
|
||||
|
||||
def cleanup(self):
|
||||
"""Clean up resources."""
|
||||
print("cleanup")
|
||||
if self.manager:
|
||||
self.manager.stop()
|
||||
|
||||
# Destroy all toplevel handles
|
||||
for toplevel, window in list(self.windows.items()):
|
||||
if not window.closed:
|
||||
toplevel.destroy()
|
||||
|
||||
# Disconnect from display
|
||||
if self.display:
|
||||
self.display.disconnect()
|
||||
|
||||
self.running = False
|
||||
|
||||
|
||||
def main():
|
||||
"""Main entry point."""
|
||||
manager = WaylandWindowManager()
|
||||
|
||||
if not manager.connect():
|
||||
return 1
|
||||
|
||||
# # Run for a short time to collect initial windows
|
||||
for _ in range(1):
|
||||
manager.display.dispatch(block=True)
|
||||
|
||||
# Print all windows
|
||||
windows = manager.get_windows()
|
||||
print("\nActive windows:")
|
||||
if windows:
|
||||
for i, window in enumerate(windows, 1):
|
||||
print(f"{i}. {window}")
|
||||
else:
|
||||
print("No windows found")
|
||||
|
||||
# # Option to keep monitoring window events
|
||||
# if len(sys.argv) > 1 and sys.argv[1] == "--monitor":
|
||||
# manager.run()
|
||||
# else:
|
||||
manager.cleanup()
|
||||
|
||||
return 0
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
sys.exit(main())
|
||||
@@ -0,0 +1,270 @@
|
||||
<?xml version="1.0" encoding="UTF-8"?>
|
||||
<protocol name="wlr_foreign_toplevel_management_unstable_v1">
|
||||
<copyright>
|
||||
Copyright © 2018 Ilia Bozhinov
|
||||
|
||||
Permission to use, copy, modify, distribute, and sell this
|
||||
software and its documentation for any purpose is hereby granted
|
||||
without fee, provided that the above copyright notice appear in
|
||||
all copies and that both that copyright notice and this permission
|
||||
notice appear in supporting documentation, and that the name of
|
||||
the copyright holders not be used in advertising or publicity
|
||||
pertaining to distribution of the software without specific,
|
||||
written prior permission. The copyright holders make no
|
||||
representations about the suitability of this software for any
|
||||
purpose. It is provided "as is" without express or implied
|
||||
warranty.
|
||||
|
||||
THE COPYRIGHT HOLDERS DISCLAIM ALL WARRANTIES WITH REGARD TO THIS
|
||||
SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND
|
||||
FITNESS, IN NO EVENT SHALL THE COPYRIGHT HOLDERS BE LIABLE FOR ANY
|
||||
SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
|
||||
WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN
|
||||
AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION,
|
||||
ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF
|
||||
THIS SOFTWARE.
|
||||
</copyright>
|
||||
|
||||
<interface name="zwlr_foreign_toplevel_manager_v1" version="3">
|
||||
<description summary="list and control opened apps">
|
||||
The purpose of this protocol is to enable the creation of taskbars
|
||||
and docks by providing them with a list of opened applications and
|
||||
letting them request certain actions on them, like maximizing, etc.
|
||||
|
||||
After a client binds the zwlr_foreign_toplevel_manager_v1, each opened
|
||||
toplevel window will be sent via the toplevel event
|
||||
</description>
|
||||
|
||||
<event name="toplevel">
|
||||
<description summary="a toplevel has been created">
|
||||
This event is emitted whenever a new toplevel window is created. It
|
||||
is emitted for all toplevels, regardless of the app that has created
|
||||
them.
|
||||
|
||||
All initial details of the toplevel(title, app_id, states, etc.) will
|
||||
be sent immediately after this event via the corresponding events in
|
||||
zwlr_foreign_toplevel_handle_v1.
|
||||
</description>
|
||||
<arg name="toplevel" type="new_id" interface="zwlr_foreign_toplevel_handle_v1"/>
|
||||
</event>
|
||||
|
||||
<request name="stop">
|
||||
<description summary="stop sending events">
|
||||
Indicates the client no longer wishes to receive events for new toplevels.
|
||||
However the compositor may emit further toplevel_created events, until
|
||||
the finished event is emitted.
|
||||
|
||||
The client must not send any more requests after this one.
|
||||
</description>
|
||||
</request>
|
||||
|
||||
<event name="finished" type="destructor">
|
||||
<description summary="the compositor has finished with the toplevel manager">
|
||||
This event indicates that the compositor is done sending events to the
|
||||
zwlr_foreign_toplevel_manager_v1. The server will destroy the object
|
||||
immediately after sending this request, so it will become invalid and
|
||||
the client should free any resources associated with it.
|
||||
</description>
|
||||
</event>
|
||||
</interface>
|
||||
|
||||
<interface name="zwlr_foreign_toplevel_handle_v1" version="3">
|
||||
<description summary="an opened toplevel">
|
||||
A zwlr_foreign_toplevel_handle_v1 object represents an opened toplevel
|
||||
window. Each app may have multiple opened toplevels.
|
||||
|
||||
Each toplevel has a list of outputs it is visible on, conveyed to the
|
||||
client with the output_enter and output_leave events.
|
||||
</description>
|
||||
|
||||
<event name="title">
|
||||
<description summary="title change">
|
||||
This event is emitted whenever the title of the toplevel changes.
|
||||
</description>
|
||||
<arg name="title" type="string"/>
|
||||
</event>
|
||||
|
||||
<event name="app_id">
|
||||
<description summary="app-id change">
|
||||
This event is emitted whenever the app-id of the toplevel changes.
|
||||
</description>
|
||||
<arg name="app_id" type="string"/>
|
||||
</event>
|
||||
|
||||
<event name="output_enter">
|
||||
<description summary="toplevel entered an output">
|
||||
This event is emitted whenever the toplevel becomes visible on
|
||||
the given output. A toplevel may be visible on multiple outputs.
|
||||
</description>
|
||||
<arg name="output" type="object" interface="wl_output"/>
|
||||
</event>
|
||||
|
||||
<event name="output_leave">
|
||||
<description summary="toplevel left an output">
|
||||
This event is emitted whenever the toplevel stops being visible on
|
||||
the given output. It is guaranteed that an entered-output event
|
||||
with the same output has been emitted before this event.
|
||||
</description>
|
||||
<arg name="output" type="object" interface="wl_output"/>
|
||||
</event>
|
||||
|
||||
<request name="set_maximized">
|
||||
<description summary="requests that the toplevel be maximized">
|
||||
Requests that the toplevel be maximized. If the maximized state actually
|
||||
changes, this will be indicated by the state event.
|
||||
</description>
|
||||
</request>
|
||||
|
||||
<request name="unset_maximized">
|
||||
<description summary="requests that the toplevel be unmaximized">
|
||||
Requests that the toplevel be unmaximized. If the maximized state actually
|
||||
changes, this will be indicated by the state event.
|
||||
</description>
|
||||
</request>
|
||||
|
||||
<request name="set_minimized">
|
||||
<description summary="requests that the toplevel be minimized">
|
||||
Requests that the toplevel be minimized. If the minimized state actually
|
||||
changes, this will be indicated by the state event.
|
||||
</description>
|
||||
</request>
|
||||
|
||||
<request name="unset_minimized">
|
||||
<description summary="requests that the toplevel be unminimized">
|
||||
Requests that the toplevel be unminimized. If the minimized state actually
|
||||
changes, this will be indicated by the state event.
|
||||
</description>
|
||||
</request>
|
||||
|
||||
<request name="activate">
|
||||
<description summary="activate the toplevel">
|
||||
Request that this toplevel be activated on the given seat.
|
||||
There is no guarantee the toplevel will be actually activated.
|
||||
</description>
|
||||
<arg name="seat" type="object" interface="wl_seat"/>
|
||||
</request>
|
||||
|
||||
<enum name="state">
|
||||
<description summary="types of states on the toplevel">
|
||||
The different states that a toplevel can have. These have the same meaning
|
||||
as the states with the same names defined in xdg-toplevel
|
||||
</description>
|
||||
|
||||
<entry name="maximized" value="0" summary="the toplevel is maximized"/>
|
||||
<entry name="minimized" value="1" summary="the toplevel is minimized"/>
|
||||
<entry name="activated" value="2" summary="the toplevel is active"/>
|
||||
<entry name="fullscreen" value="3" summary="the toplevel is fullscreen" since="2"/>
|
||||
</enum>
|
||||
|
||||
<event name="state">
|
||||
<description summary="the toplevel state changed">
|
||||
This event is emitted immediately after the zlw_foreign_toplevel_handle_v1
|
||||
is created and each time the toplevel state changes, either because of a
|
||||
compositor action or because of a request in this protocol.
|
||||
</description>
|
||||
|
||||
<arg name="state" type="array"/>
|
||||
</event>
|
||||
|
||||
<event name="done">
|
||||
<description summary="all information about the toplevel has been sent">
|
||||
This event is sent after all changes in the toplevel state have been
|
||||
sent.
|
||||
|
||||
This allows changes to the zwlr_foreign_toplevel_handle_v1 properties
|
||||
to be seen as atomic, even if they happen via multiple events.
|
||||
</description>
|
||||
</event>
|
||||
|
||||
<request name="close">
|
||||
<description summary="request that the toplevel be closed">
|
||||
Send a request to the toplevel to close itself. The compositor would
|
||||
typically use a shell-specific method to carry out this request, for
|
||||
example by sending the xdg_toplevel.close event. However, this gives
|
||||
no guarantees the toplevel will actually be destroyed. If and when
|
||||
this happens, the zwlr_foreign_toplevel_handle_v1.closed event will
|
||||
be emitted.
|
||||
</description>
|
||||
</request>
|
||||
|
||||
<request name="set_rectangle">
|
||||
<description summary="the rectangle which represents the toplevel">
|
||||
The rectangle of the surface specified in this request corresponds to
|
||||
the place where the app using this protocol represents the given toplevel.
|
||||
It can be used by the compositor as a hint for some operations, e.g
|
||||
minimizing. The client is however not required to set this, in which
|
||||
case the compositor is free to decide some default value.
|
||||
|
||||
If the client specifies more than one rectangle, only the last one is
|
||||
considered.
|
||||
|
||||
The dimensions are given in surface-local coordinates.
|
||||
Setting width=height=0 removes the already-set rectangle.
|
||||
</description>
|
||||
|
||||
<arg name="surface" type="object" interface="wl_surface"/>
|
||||
<arg name="x" type="int"/>
|
||||
<arg name="y" type="int"/>
|
||||
<arg name="width" type="int"/>
|
||||
<arg name="height" type="int"/>
|
||||
</request>
|
||||
|
||||
<enum name="error">
|
||||
<entry name="invalid_rectangle" value="0"
|
||||
summary="the provided rectangle is invalid"/>
|
||||
</enum>
|
||||
|
||||
<event name="closed">
|
||||
<description summary="this toplevel has been destroyed">
|
||||
This event means the toplevel has been destroyed. It is guaranteed there
|
||||
won't be any more events for this zwlr_foreign_toplevel_handle_v1. The
|
||||
toplevel itself becomes inert so any requests will be ignored except the
|
||||
destroy request.
|
||||
</description>
|
||||
</event>
|
||||
|
||||
<request name="destroy" type="destructor">
|
||||
<description summary="destroy the zwlr_foreign_toplevel_handle_v1 object">
|
||||
Destroys the zwlr_foreign_toplevel_handle_v1 object.
|
||||
|
||||
This request should be called either when the client does not want to
|
||||
use the toplevel anymore or after the closed event to finalize the
|
||||
destruction of the object.
|
||||
</description>
|
||||
</request>
|
||||
|
||||
<!-- Version 2 additions -->
|
||||
|
||||
<request name="set_fullscreen" since="2">
|
||||
<description summary="request that the toplevel be fullscreened">
|
||||
Requests that the toplevel be fullscreened on the given output. If the
|
||||
fullscreen state and/or the outputs the toplevel is visible on actually
|
||||
change, this will be indicated by the state and output_enter/leave
|
||||
events.
|
||||
|
||||
The output parameter is only a hint to the compositor. Also, if output
|
||||
is NULL, the compositor should decide which output the toplevel will be
|
||||
fullscreened on, if at all.
|
||||
</description>
|
||||
<arg name="output" type="object" interface="wl_output" allow-null="true"/>
|
||||
</request>
|
||||
|
||||
<request name="unset_fullscreen" since="2">
|
||||
<description summary="request that the toplevel be unfullscreened">
|
||||
Requests that the toplevel be unfullscreened. If the fullscreen state
|
||||
actually changes, this will be indicated by the state event.
|
||||
</description>
|
||||
</request>
|
||||
|
||||
<!-- Version 3 additions -->
|
||||
|
||||
<event name="parent" since="3">
|
||||
<description summary="parent change">
|
||||
This event is emitted whenever the parent of the toplevel changes.
|
||||
|
||||
No event is emitted when the parent handle is destroyed by the client.
|
||||
</description>
|
||||
<arg name="parent" type="object" interface="zwlr_foreign_toplevel_handle_v1" allow-null="true"/>
|
||||
</event>
|
||||
</interface>
|
||||
</protocol>
|
||||
@@ -0,0 +1,27 @@
|
||||
# This file has been autogenerated by the pywayland scanner
|
||||
|
||||
# Copyright © 2018 Ilia Bozhinov
|
||||
#
|
||||
# Permission to use, copy, modify, distribute, and sell this
|
||||
# software and its documentation for any purpose is hereby granted
|
||||
# without fee, provided that the above copyright notice appear in
|
||||
# all copies and that both that copyright notice and this permission
|
||||
# notice appear in supporting documentation, and that the name of
|
||||
# the copyright holders not be used in advertising or publicity
|
||||
# pertaining to distribution of the software without specific,
|
||||
# written prior permission. The copyright holders make no
|
||||
# representations about the suitability of this software for any
|
||||
# purpose. It is provided "as is" without express or implied
|
||||
# warranty.
|
||||
#
|
||||
# THE COPYRIGHT HOLDERS DISCLAIM ALL WARRANTIES WITH REGARD TO THIS
|
||||
# SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND
|
||||
# FITNESS, IN NO EVENT SHALL THE COPYRIGHT HOLDERS BE LIABLE FOR ANY
|
||||
# SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
|
||||
# WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN
|
||||
# AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION,
|
||||
# ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF
|
||||
# THIS SOFTWARE.
|
||||
|
||||
from .zwlr_foreign_toplevel_handle_v1 import ZwlrForeignToplevelHandleV1 # noqa: F401
|
||||
from .zwlr_foreign_toplevel_manager_v1 import ZwlrForeignToplevelManagerV1 # noqa: F401
|
||||
@@ -0,0 +1,352 @@
|
||||
# This file has been autogenerated by the pywayland scanner
|
||||
|
||||
# Copyright © 2018 Ilia Bozhinov
|
||||
#
|
||||
# Permission to use, copy, modify, distribute, and sell this
|
||||
# software and its documentation for any purpose is hereby granted
|
||||
# without fee, provided that the above copyright notice appear in
|
||||
# all copies and that both that copyright notice and this permission
|
||||
# notice appear in supporting documentation, and that the name of
|
||||
# the copyright holders not be used in advertising or publicity
|
||||
# pertaining to distribution of the software without specific,
|
||||
# written prior permission. The copyright holders make no
|
||||
# representations about the suitability of this software for any
|
||||
# purpose. It is provided "as is" without express or implied
|
||||
# warranty.
|
||||
#
|
||||
# THE COPYRIGHT HOLDERS DISCLAIM ALL WARRANTIES WITH REGARD TO THIS
|
||||
# SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND
|
||||
# FITNESS, IN NO EVENT SHALL THE COPYRIGHT HOLDERS BE LIABLE FOR ANY
|
||||
# SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
|
||||
# WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN
|
||||
# AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION,
|
||||
# ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF
|
||||
# THIS SOFTWARE.
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
import enum
|
||||
|
||||
from pywayland.protocol_core import (
|
||||
Argument,
|
||||
ArgumentType,
|
||||
Global,
|
||||
Interface,
|
||||
Proxy,
|
||||
Resource,
|
||||
)
|
||||
|
||||
from pywayland.protocol.wayland import WlOutput
|
||||
from pywayland.protocol.wayland import WlSeat
|
||||
from pywayland.protocol.wayland import WlSurface
|
||||
|
||||
|
||||
class ZwlrForeignToplevelHandleV1(Interface):
|
||||
"""An opened toplevel
|
||||
|
||||
A :class:`ZwlrForeignToplevelHandleV1` object represents an opened toplevel
|
||||
window. Each app may have multiple opened toplevels.
|
||||
|
||||
Each toplevel has a list of outputs it is visible on, conveyed to the
|
||||
client with the output_enter and output_leave events.
|
||||
"""
|
||||
|
||||
name = "zwlr_foreign_toplevel_handle_v1"
|
||||
version = 3
|
||||
|
||||
class state(enum.IntEnum):
|
||||
maximized = 0
|
||||
minimized = 1
|
||||
activated = 2
|
||||
fullscreen = 3
|
||||
|
||||
class error(enum.IntEnum):
|
||||
invalid_rectangle = 0
|
||||
|
||||
|
||||
class ZwlrForeignToplevelHandleV1Proxy(Proxy[ZwlrForeignToplevelHandleV1]):
|
||||
interface = ZwlrForeignToplevelHandleV1
|
||||
|
||||
@ZwlrForeignToplevelHandleV1.request()
|
||||
def set_maximized(self) -> None:
|
||||
"""Requests that the toplevel be maximized
|
||||
|
||||
Requests that the toplevel be maximized. If the maximized state
|
||||
actually changes, this will be indicated by the state event.
|
||||
"""
|
||||
self._marshal(0)
|
||||
|
||||
@ZwlrForeignToplevelHandleV1.request()
|
||||
def unset_maximized(self) -> None:
|
||||
"""Requests that the toplevel be unmaximized
|
||||
|
||||
Requests that the toplevel be unmaximized. If the maximized state
|
||||
actually changes, this will be indicated by the state event.
|
||||
"""
|
||||
self._marshal(1)
|
||||
|
||||
@ZwlrForeignToplevelHandleV1.request()
|
||||
def set_minimized(self) -> None:
|
||||
"""Requests that the toplevel be minimized
|
||||
|
||||
Requests that the toplevel be minimized. If the minimized state
|
||||
actually changes, this will be indicated by the state event.
|
||||
"""
|
||||
self._marshal(2)
|
||||
|
||||
@ZwlrForeignToplevelHandleV1.request()
|
||||
def unset_minimized(self) -> None:
|
||||
"""Requests that the toplevel be unminimized
|
||||
|
||||
Requests that the toplevel be unminimized. If the minimized state
|
||||
actually changes, this will be indicated by the state event.
|
||||
"""
|
||||
self._marshal(3)
|
||||
|
||||
@ZwlrForeignToplevelHandleV1.request(
|
||||
Argument(ArgumentType.Object, interface=WlSeat),
|
||||
)
|
||||
def activate(self, seat: WlSeat) -> None:
|
||||
"""Activate the toplevel
|
||||
|
||||
Request that this toplevel be activated on the given seat. There is no
|
||||
guarantee the toplevel will be actually activated.
|
||||
|
||||
:param seat:
|
||||
:type seat:
|
||||
:class:`~pywayland.protocol.wayland.WlSeat`
|
||||
"""
|
||||
self._marshal(4, seat)
|
||||
|
||||
@ZwlrForeignToplevelHandleV1.request()
|
||||
def close(self) -> None:
|
||||
"""Request that the toplevel be closed
|
||||
|
||||
Send a request to the toplevel to close itself. The compositor would
|
||||
typically use a shell-specific method to carry out this request, for
|
||||
example by sending the xdg_toplevel.close event. However, this gives no
|
||||
guarantees the toplevel will actually be destroyed. If and when this
|
||||
happens, the :func:`ZwlrForeignToplevelHandleV1.closed()` event will be
|
||||
emitted.
|
||||
"""
|
||||
self._marshal(5)
|
||||
|
||||
@ZwlrForeignToplevelHandleV1.request(
|
||||
Argument(ArgumentType.Object, interface=WlSurface),
|
||||
Argument(ArgumentType.Int),
|
||||
Argument(ArgumentType.Int),
|
||||
Argument(ArgumentType.Int),
|
||||
Argument(ArgumentType.Int),
|
||||
)
|
||||
def set_rectangle(
|
||||
self, surface: WlSurface, x: int, y: int, width: int, height: int
|
||||
) -> None:
|
||||
"""The rectangle which represents the toplevel
|
||||
|
||||
The rectangle of the surface specified in this request corresponds to
|
||||
the place where the app using this protocol represents the given
|
||||
toplevel. It can be used by the compositor as a hint for some
|
||||
operations, e.g minimizing. The client is however not required to set
|
||||
this, in which case the compositor is free to decide some default
|
||||
value.
|
||||
|
||||
If the client specifies more than one rectangle, only the last one is
|
||||
considered.
|
||||
|
||||
The dimensions are given in surface-local coordinates. Setting
|
||||
width=height=0 removes the already-set rectangle.
|
||||
|
||||
:param surface:
|
||||
:type surface:
|
||||
:class:`~pywayland.protocol.wayland.WlSurface`
|
||||
:param x:
|
||||
:type x:
|
||||
`ArgumentType.Int`
|
||||
:param y:
|
||||
:type y:
|
||||
`ArgumentType.Int`
|
||||
:param width:
|
||||
:type width:
|
||||
`ArgumentType.Int`
|
||||
:param height:
|
||||
:type height:
|
||||
`ArgumentType.Int`
|
||||
"""
|
||||
self._marshal(6, surface, x, y, width, height)
|
||||
|
||||
@ZwlrForeignToplevelHandleV1.request()
|
||||
def destroy(self) -> None:
|
||||
"""Destroy the :class:`ZwlrForeignToplevelHandleV1` object
|
||||
|
||||
Destroys the :class:`ZwlrForeignToplevelHandleV1` object.
|
||||
|
||||
This request should be called either when the client does not want to
|
||||
use the toplevel anymore or after the closed event to finalize the
|
||||
destruction of the object.
|
||||
"""
|
||||
self._marshal(7)
|
||||
self._destroy()
|
||||
|
||||
@ZwlrForeignToplevelHandleV1.request(
|
||||
Argument(ArgumentType.Object, interface=WlOutput, nullable=True),
|
||||
version=2,
|
||||
)
|
||||
def set_fullscreen(self, output: WlOutput | None) -> None:
|
||||
"""Request that the toplevel be fullscreened
|
||||
|
||||
Requests that the toplevel be fullscreened on the given output. If the
|
||||
fullscreen state and/or the outputs the toplevel is visible on actually
|
||||
change, this will be indicated by the state and output_enter/leave
|
||||
events.
|
||||
|
||||
The output parameter is only a hint to the compositor. Also, if output
|
||||
is NULL, the compositor should decide which output the toplevel will be
|
||||
fullscreened on, if at all.
|
||||
|
||||
:param output:
|
||||
:type output:
|
||||
:class:`~pywayland.protocol.wayland.WlOutput` or `None`
|
||||
"""
|
||||
self._marshal(8, output)
|
||||
|
||||
@ZwlrForeignToplevelHandleV1.request(version=2)
|
||||
def unset_fullscreen(self) -> None:
|
||||
"""Request that the toplevel be unfullscreened
|
||||
|
||||
Requests that the toplevel be unfullscreened. If the fullscreen state
|
||||
actually changes, this will be indicated by the state event.
|
||||
"""
|
||||
self._marshal(9)
|
||||
|
||||
|
||||
class ZwlrForeignToplevelHandleV1Resource(Resource):
|
||||
interface = ZwlrForeignToplevelHandleV1
|
||||
|
||||
@ZwlrForeignToplevelHandleV1.event(
|
||||
Argument(ArgumentType.String),
|
||||
)
|
||||
def title(self, title: str) -> None:
|
||||
"""Title change
|
||||
|
||||
This event is emitted whenever the title of the toplevel changes.
|
||||
|
||||
:param title:
|
||||
:type title:
|
||||
`ArgumentType.String`
|
||||
"""
|
||||
self._post_event(0, title)
|
||||
|
||||
@ZwlrForeignToplevelHandleV1.event(
|
||||
Argument(ArgumentType.String),
|
||||
)
|
||||
def app_id(self, app_id: str) -> None:
|
||||
"""App-id change
|
||||
|
||||
This event is emitted whenever the app-id of the toplevel changes.
|
||||
|
||||
:param app_id:
|
||||
:type app_id:
|
||||
`ArgumentType.String`
|
||||
"""
|
||||
self._post_event(1, app_id)
|
||||
|
||||
@ZwlrForeignToplevelHandleV1.event(
|
||||
Argument(ArgumentType.Object, interface=WlOutput),
|
||||
)
|
||||
def output_enter(self, output: WlOutput) -> None:
|
||||
"""Toplevel entered an output
|
||||
|
||||
This event is emitted whenever the toplevel becomes visible on the
|
||||
given output. A toplevel may be visible on multiple outputs.
|
||||
|
||||
:param output:
|
||||
:type output:
|
||||
:class:`~pywayland.protocol.wayland.WlOutput`
|
||||
"""
|
||||
self._post_event(2, output)
|
||||
|
||||
@ZwlrForeignToplevelHandleV1.event(
|
||||
Argument(ArgumentType.Object, interface=WlOutput),
|
||||
)
|
||||
def output_leave(self, output: WlOutput) -> None:
|
||||
"""Toplevel left an output
|
||||
|
||||
This event is emitted whenever the toplevel stops being visible on the
|
||||
given output. It is guaranteed that an entered-output event with the
|
||||
same output has been emitted before this event.
|
||||
|
||||
:param output:
|
||||
:type output:
|
||||
:class:`~pywayland.protocol.wayland.WlOutput`
|
||||
"""
|
||||
self._post_event(3, output)
|
||||
|
||||
@ZwlrForeignToplevelHandleV1.event(
|
||||
Argument(ArgumentType.Array),
|
||||
)
|
||||
def state(self, state: list) -> None:
|
||||
"""The toplevel state changed
|
||||
|
||||
This event is emitted immediately after the
|
||||
zlw_foreign_toplevel_handle_v1 is created and each time the toplevel
|
||||
state changes, either because of a compositor action or because of a
|
||||
request in this protocol.
|
||||
|
||||
:param state:
|
||||
:type state:
|
||||
`ArgumentType.Array`
|
||||
"""
|
||||
self._post_event(4, state)
|
||||
|
||||
@ZwlrForeignToplevelHandleV1.event()
|
||||
def done(self) -> None:
|
||||
"""All information about the toplevel has been sent
|
||||
|
||||
This event is sent after all changes in the toplevel state have been
|
||||
sent.
|
||||
|
||||
This allows changes to the :class:`ZwlrForeignToplevelHandleV1`
|
||||
properties to be seen as atomic, even if they happen via multiple
|
||||
events.
|
||||
"""
|
||||
self._post_event(5)
|
||||
|
||||
@ZwlrForeignToplevelHandleV1.event()
|
||||
def closed(self) -> None:
|
||||
"""This toplevel has been destroyed
|
||||
|
||||
This event means the toplevel has been destroyed. It is guaranteed
|
||||
there won't be any more events for this
|
||||
:class:`ZwlrForeignToplevelHandleV1`. The toplevel itself becomes inert
|
||||
so any requests will be ignored except the destroy request.
|
||||
"""
|
||||
self._post_event(6)
|
||||
|
||||
@ZwlrForeignToplevelHandleV1.event(
|
||||
Argument(
|
||||
ArgumentType.Object, interface=ZwlrForeignToplevelHandleV1, nullable=True
|
||||
),
|
||||
version=3,
|
||||
)
|
||||
def parent(self, parent: ZwlrForeignToplevelHandleV1 | None) -> None:
|
||||
"""Parent change
|
||||
|
||||
This event is emitted whenever the parent of the toplevel changes.
|
||||
|
||||
No event is emitted when the parent handle is destroyed by the client.
|
||||
|
||||
:param parent:
|
||||
:type parent:
|
||||
:class:`ZwlrForeignToplevelHandleV1` or `None`
|
||||
"""
|
||||
self._post_event(7, parent)
|
||||
|
||||
|
||||
class ZwlrForeignToplevelHandleV1Global(Global):
|
||||
interface = ZwlrForeignToplevelHandleV1
|
||||
|
||||
|
||||
ZwlrForeignToplevelHandleV1._gen_c()
|
||||
ZwlrForeignToplevelHandleV1.proxy_class = ZwlrForeignToplevelHandleV1Proxy
|
||||
ZwlrForeignToplevelHandleV1.resource_class = ZwlrForeignToplevelHandleV1Resource
|
||||
ZwlrForeignToplevelHandleV1.global_class = ZwlrForeignToplevelHandleV1Global
|
||||
@@ -0,0 +1,112 @@
|
||||
# This file has been autogenerated by the pywayland scanner
|
||||
|
||||
# Copyright © 2018 Ilia Bozhinov
|
||||
#
|
||||
# Permission to use, copy, modify, distribute, and sell this
|
||||
# software and its documentation for any purpose is hereby granted
|
||||
# without fee, provided that the above copyright notice appear in
|
||||
# all copies and that both that copyright notice and this permission
|
||||
# notice appear in supporting documentation, and that the name of
|
||||
# the copyright holders not be used in advertising or publicity
|
||||
# pertaining to distribution of the software without specific,
|
||||
# written prior permission. The copyright holders make no
|
||||
# representations about the suitability of this software for any
|
||||
# purpose. It is provided "as is" without express or implied
|
||||
# warranty.
|
||||
#
|
||||
# THE COPYRIGHT HOLDERS DISCLAIM ALL WARRANTIES WITH REGARD TO THIS
|
||||
# SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND
|
||||
# FITNESS, IN NO EVENT SHALL THE COPYRIGHT HOLDERS BE LIABLE FOR ANY
|
||||
# SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
|
||||
# WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN
|
||||
# AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION,
|
||||
# ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF
|
||||
# THIS SOFTWARE.
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
from pywayland.protocol_core import (
|
||||
Argument,
|
||||
ArgumentType,
|
||||
Global,
|
||||
Interface,
|
||||
Proxy,
|
||||
Resource,
|
||||
)
|
||||
|
||||
from .zwlr_foreign_toplevel_handle_v1 import ZwlrForeignToplevelHandleV1
|
||||
|
||||
|
||||
class ZwlrForeignToplevelManagerV1(Interface):
|
||||
"""List and control opened apps
|
||||
|
||||
The purpose of this protocol is to enable the creation of taskbars and
|
||||
docks by providing them with a list of opened applications and letting them
|
||||
request certain actions on them, like maximizing, etc.
|
||||
|
||||
After a client binds the :class:`ZwlrForeignToplevelManagerV1`, each opened
|
||||
toplevel window will be sent via the toplevel event
|
||||
"""
|
||||
|
||||
name = "zwlr_foreign_toplevel_manager_v1"
|
||||
version = 3
|
||||
|
||||
|
||||
class ZwlrForeignToplevelManagerV1Proxy(Proxy[ZwlrForeignToplevelManagerV1]):
|
||||
interface = ZwlrForeignToplevelManagerV1
|
||||
|
||||
@ZwlrForeignToplevelManagerV1.request()
|
||||
def stop(self) -> None:
|
||||
"""Stop sending events
|
||||
|
||||
Indicates the client no longer wishes to receive events for new
|
||||
toplevels. However the compositor may emit further toplevel_created
|
||||
events, until the finished event is emitted.
|
||||
|
||||
The client must not send any more requests after this one.
|
||||
"""
|
||||
self._marshal(0)
|
||||
|
||||
|
||||
class ZwlrForeignToplevelManagerV1Resource(Resource):
|
||||
interface = ZwlrForeignToplevelManagerV1
|
||||
|
||||
@ZwlrForeignToplevelManagerV1.event(
|
||||
Argument(ArgumentType.NewId, interface=ZwlrForeignToplevelHandleV1),
|
||||
)
|
||||
def toplevel(self, toplevel: ZwlrForeignToplevelHandleV1) -> None:
|
||||
"""A toplevel has been created
|
||||
|
||||
This event is emitted whenever a new toplevel window is created. It is
|
||||
emitted for all toplevels, regardless of the app that has created them.
|
||||
|
||||
All initial details of the toplevel(title, app_id, states, etc.) will
|
||||
be sent immediately after this event via the corresponding events in
|
||||
:class:`~pywayland.protocol.wlr_foreign_toplevel_management_unstable_v1.ZwlrForeignToplevelHandleV1`.
|
||||
|
||||
:param toplevel:
|
||||
:type toplevel:
|
||||
:class:`~pywayland.protocol.wlr_foreign_toplevel_management_unstable_v1.ZwlrForeignToplevelHandleV1`
|
||||
"""
|
||||
self._post_event(0, toplevel)
|
||||
|
||||
@ZwlrForeignToplevelManagerV1.event()
|
||||
def finished(self) -> None:
|
||||
"""The compositor has finished with the toplevel manager
|
||||
|
||||
This event indicates that the compositor is done sending events to the
|
||||
:class:`ZwlrForeignToplevelManagerV1`. The server will destroy the
|
||||
object immediately after sending this request, so it will become
|
||||
invalid and the client should free any resources associated with it.
|
||||
"""
|
||||
self._post_event(1)
|
||||
|
||||
|
||||
class ZwlrForeignToplevelManagerV1Global(Global):
|
||||
interface = ZwlrForeignToplevelManagerV1
|
||||
|
||||
|
||||
ZwlrForeignToplevelManagerV1._gen_c()
|
||||
ZwlrForeignToplevelManagerV1.proxy_class = ZwlrForeignToplevelManagerV1Proxy
|
||||
ZwlrForeignToplevelManagerV1.resource_class = ZwlrForeignToplevelManagerV1Resource
|
||||
ZwlrForeignToplevelManagerV1.global_class = ZwlrForeignToplevelManagerV1Global
|
||||
Reference in New Issue
Block a user