LGUG2Z
d781028a2a
komorebi-for-kde/docs/ -> docs/linux/ komorebi-for-mac/docs/ -> docs/macos/ The Windows docs stay where they are (docs/). Renames only, so links and include paths that named the old directories are broken at this revision; they are fixed in the revision that fixes the paths of the whole layout move.
4.3 KiB
Floating windows
A floating window is one of a workspace's windows that is not in its layout: komorebi gives it no tile and does not move it, and it stays where it is put by hand.
komorebic toggle-float takes the window that has the focus out of the
layout, and the other windows of the workspace share the work area. The same command on a
floating window puts it back in the layout, at the place of the focused window.
komorebic toggle-float
A floated window keeps its size and position by default. The floating windows of a workspace are
in the daemon's state as floating_windows, next to its containers.
Windows that open floating
With the float override on, every window that opens floats instead of getting a tile.
komorebic toggle-float-override turns it on and off for every
workspace, and
komorebic toggle-workspace-float-override for the
focused workspace only: the first time it takes the opposite of what every workspace has, and from
then on it follows its own setting.
komorebic toggle-float-override
komorebic toggle-workspace-float-override
The override is in the daemon's state, as float_override for every workspace and in each
workspace that has one of its own.
In komorebi.json it is float_override, for every workspace and in the entry of a workspace.
float_override_placement says what is done to the window the override floats: None leaves it
where KWin put it, Center centers it in the work area and CenterAndResize also makes it half
as tall as the work area, with the aspect ratio floating_window_aspect_ratio names. A window is
centered only on a workspace that tiles.
The two layers
A workspace is on one of two layers: its tiles, or its floating windows. Which one decides what
komorebic focus, cycle-focus,
move and resize-edge act on. Floating a window puts
the workspace on its floating layer, and giving the focus to a tiled window, with the pointer or a
command, puts it back on its tiling layer. A window that opens and is tiled does the same, and so
does putting a floating window back in the layout.
komorebic toggle-workspace-layer switches the layer by hand.
The windows of the layer it goes to are raised in front of the others, and one of them is given the
focus: the focused floating window, or the focused container's window. Going to the tiles hides the
floating windows, and going back to the floating layer shows them.
komorebic toggle-workspace-layer
On the floating layer:
focus left,right,upanddowngive the focus to the nearest floating window on that side, by where KWin has them. When no floating window is on that side the focus goes to the monitor on that side, as it does for tiles, and the command fails where there is none: the daemon logs "there is no container or monitor in this direction".cycle-focus nextandpreviousgo round the floating windows in the order they were floated, and wrap around.movemoves the focused floating window by the resize delta, 50 pixels unless it was set, and not out of the work area.resize-edgeandresize-axischange the frame of the focused floating window:increaseon the left or the upper side moves it that way, and on the right or the lower side makes it wider or taller by twice the delta;decreasedoes the opposite.preselect-directiondoes nothing.
komorebic toggle-maximize maximizes the focused floating window
there, and when it is restored it is a tile, not a floating window.
The layer is layer in the state of each workspace, Tiling or Floating.
What a window that opens while a workspace is on its floating layer gets is
floating_layer_behaviour in komorebi.json: Tile, the default, gives it a tile, and Float
floats it, centered in the work area as floating_layer_placement says (Center by default; the
values are those of float_override_placement). The entry of a monitor and the entry of a
workspace can have a floating_layer_behaviour of their own: the workspace's comes before the
monitor's, which comes before the one for every monitor.