org.plasmazones.CompositorBridge

Compositor-agnostic bridge protocol. Compositor bridges register here and receive window manipulation commands via signals.

Well-known name	org.plasmazones.CompositorBridge
Source XML	org.plasmazones.CompositorBridge.xml
Methods	2
Signals	8
Properties	0

Methods

<tt>registerBridge()</tt>

Register a compositor bridge. Returns session info.

Arg	Direction	Type	Description
compositorName	in	s *(string)*	Compositor name (e.g. kwin, hyprland, sway).
version	in	s *(string)*	Compositor version string.
capabilities	in	as *(array<string>)*	Supported capabilities: borderless, maximize, animation, borders, modifiers.
result	out	(sss) *(struct(string,string,string))*	Struct: (apiVersion, bridgeName, sessionId).

<tt>reportModifierState()</tt>

Report keyboard modifier and mouse button state from compositor.

Arg	Direction	Type	Description
modifiers	in	i *(int32)*	Qt::KeyboardModifiers bitmask.
mouseButtons	in	i *(int32)*	Qt::MouseButtons bitmask.

Signals

<tt>applyWindowGeometry</tt>

Apply geometry to a single window.

Arg	Direction	Type	Description
windowId	out	s *(string)*
x	out	i *(int32)*
y	out	i *(int32)*
width	out	i *(int32)*
height	out	i *(int32)*
zoneId	out	s *(string)*
skipAnimation	out	b *(bool)*

<tt>applyWindowGeometriesBatch</tt>

Apply geometry to a batch of windows.

Arg	Direction	Type	Description
geometries	out	a(siiii) *(array<struct(string,int32,int32,int32,int32)>)*	Array of (windowId, x, y, width, height).
action	out	s *(string)*	Operation type: rotate, resnap, snap_all.

<tt>activateWindow</tt>

Activate (focus) a window.

Arg	Direction	Type	Description
windowId	out	s *(string)*

<tt>raiseWindows</tt>

Raise windows in order (bottom-to-top).

Arg	Direction	Type	Description
windowIds	out	as *(array<string>)*

<tt>setWindowBorderless</tt>

Set window borderless state (hide/show title bar).

Arg	Direction	Type	Description
windowId	out	s *(string)*
borderless	out	b *(bool)*

<tt>maximizeWindow</tt>

Maximize or restore a window.

Arg	Direction	Type	Description
windowId	out	s *(string)*
mode	out	i *(int32)*	0=restore, 3=full maximize.

<tt>bridgeRegistered</tt>

A compositor bridge registered.

Arg	Direction	Type	Description
compositorName	out	s *(string)*
version	out	s *(string)*
capabilities	out	as *(array<string>)*

<tt>modifierStateChanged</tt>

Modifier state reported by compositor.

Arg	Direction	Type	Description
modifiers	out	i *(int32)*
mouseButtons	out	i *(int32)*