mirrors
/
weston
mirror of https://gitlab.freedesktop.org/wayland/weston.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
weston/man/weston-bindings.man

158 lines
2.8 KiB
Groff
Raw Permalink Normal View History

man: Add weston-bindings(7) describing desktop shell shortcuts The desktop-shell-specific bindings were identified from shell_add_bindings in desktop-shell/shell.c. Various general shortcuts (like Ctrl+Alt+F) are provided by files in libweston/ and compositor/ . Also introduce references to the new manual in weston(1) and weston.ini(5). Signed-off-by: Manuel Stoeckl <code@mstoeckl.com>
2019-03-27 04:00:55 +03:00
.\" shorthand for double quote that works everywhere.
.ds q \N'34'
.TH weston-bindings 7 "2019-03-27" "Weston @version@"
.SH NAME
weston-bindings \- a list of keyboard bindings for
.B Weston
\- the reference Wayland
compositor
.SH INTRODUCTION
The Weston desktop shell has a number of keyboard shortcuts. They are listed here.
.SH DESCRIPTION
Almost all keyboard shortcuts for
.B Weston
include a specified modifier
.I mod
which is determined in the file
.BR weston.ini (5).
.\" Begin list
.P
.RE
.B mod + Shift + F
.RS 4
Make active window fullscreen
.P
.RE
.B mod + K
.RS 4
Kill active window
.P
.RE
.B mod + Shift + M
.RS 4
Maximize active window
.P
.RE
desktops-shell: Add tiled orientation support using key-bindings Patch adds KEY_UP/KEY_DOWN for tiled top and bottom positioning, KEY_LEFT/KEY_RIGHT correspondingly, for left and right positioning. It also modifies the man page to include these new bindings, But also with commit 'compositor: Remove desktop zoom' we no longer have zoom effects so removed them. Signed-off-by: Marius Vlad <marius.vlad@collabora.com>
2022-07-16 00:22:00 +03:00
.B mod + Shift + KEY_LEFT
man: Add weston-bindings(7) describing desktop shell shortcuts The desktop-shell-specific bindings were identified from shell_add_bindings in desktop-shell/shell.c. Various general shortcuts (like Ctrl+Alt+F) are provided by files in libweston/ and compositor/ . Also introduce references to the new manual in weston(1) and weston.ini(5). Signed-off-by: Manuel Stoeckl <code@mstoeckl.com>
2019-03-27 04:00:55 +03:00
.RS 4
desktops-shell: Add tiled orientation support using key-bindings Patch adds KEY_UP/KEY_DOWN for tiled top and bottom positioning, KEY_LEFT/KEY_RIGHT correspondingly, for left and right positioning. It also modifies the man page to include these new bindings, But also with commit 'compositor: Remove desktop zoom' we no longer have zoom effects so removed them. Signed-off-by: Marius Vlad <marius.vlad@collabora.com>
2022-07-16 00:22:00 +03:00
Make the active window tiled left.
.P
.RE
.B mod + Shift + KEY_RIGHT
.RS 4
Make the active window tiled right.
.P
.RE
.B mod + Shift + KEY_UP
.RS 4
Make the active window tiled top.
.P
.RE
.B mod + Shift + KEY_DOWN
.RS 4
Make the active window tiled bottom.
man: Add weston-bindings(7) describing desktop shell shortcuts The desktop-shell-specific bindings were identified from shell_add_bindings in desktop-shell/shell.c. Various general shortcuts (like Ctrl+Alt+F) are provided by files in libweston/ and compositor/ . Also introduce references to the new manual in weston(1) and weston.ini(5). Signed-off-by: Manuel Stoeckl <code@mstoeckl.com>
2019-03-27 04:00:55 +03:00
.P
.RE
.B mod + Tab
.RS 4
Switch active window
.P
.RE
.B Ctrl + Alt + Backspace
.RS 4
If supported, terminate Weston. (Note this combination often is used to hard restart Xorg.)
.P
.RE
.B Ctrl + Alt + F
.RS 4
Toggle if Weston is fullscreen; only works when nested under a Wayland compositor
.P
.RE
.B Ctrl + Alt + S
.RS 4
Share output screen, if possible
.P
.RE
.B Ctrl + Alt + F1/F2/F3/F4/F5/F6/F7/F8
.RS 4
Switch virtual terminal, if possible
.P
.RE
.B Super + S
.RS 4
Make a screenshot of the desktop
.P
.RE
.B Super + R
.RS 4
Start or stop recording video of the desktop
.SS "TOUCH / MOUSE BINDINGS"
There are also a number of bindings involving a mouse:
.P
.RE
.B \fI<Touch>\fI, \fI<Left button>\fB, \fI<Right button>\fB
.RS 4
Activate clicked window
.P
.RE
.B Super + Alt + \fI<Vertical Scroll>\fB
.RS 4
Change the opacity of a window
.P
.RE
.B mod + \fI<Left button>\fB
.RS 4
Click and drag to move a window
.P
.RE
.B mod + Shift + \fI<Left button>\fB, mod + \fI<Right button>\fB, mod + \fI<Touch>\fB
.RS 4
Click and drag to resize a window
.P
.RE
.B mod + \fI<Middle button>\fB
.RS 4
Rotate the window (if supported)
.SS DEBUG BINDINGS
The combination \fBmod + Shift + Space\fR begins a debug binding. Debug
bindings are completed by pressing an additional key. For example, pressing
gl-renderer: Make wireframe a debug mode In order to avoid the complexity of handling multiple debug modes at the same time, this commit makes wireframe a proper debug mode. It also uses the new tinting system to make the white wireframe pop over a darkened damaged region. Signed-off-by: Loïc Molinari <loic.molinari@collabora.com>
2024-05-07 16:14:28 +03:00
M may cycle through the GL renderer debug modes. Most debug effects can be
disabled again by repeating the command. Debug bindings are often tied to
specific backends. Below are the debug bindings available.
man: Document available debug bindings. Fixes: #398 Debug bindings were not documented in weston-bindings so document them. Signed-off-by: Veeresh Kadasani <veeresh.kadasani@huawei.com>
2021-01-04 15:16:19 +03:00
.RS
- KEY_D :
.RS 4
Subscribe for flight recorder.
.RE
- KEY_C :
.RS 4
Enable/Disable cursor planes.
.RE
- KEY_V :
.RS 4
Enable/Disable overlay planes.
.RE
- KEY_Q :
.RS 4
Start VAAPI recorder.
.RE
gl-renderer: Set up debug mode infrastructure Set up debug mode initial infrastructure using a dedicated key binding and make shaders debug a debug mode. Signed-off-by: Loïc Molinari <loic.molinari@collabora.com>
2024-05-06 20:17:24 +03:00
- KEY_M :
man: Document available debug bindings. Fixes: #398 Debug bindings were not documented in weston-bindings so document them. Signed-off-by: Veeresh Kadasani <veeresh.kadasani@huawei.com>
2021-01-04 15:16:19 +03:00
.RS 4
gl-renderer: Remove shaders debug mode The shaders debug mode doesn't have much interest now that other more specific debug modes show shaders too. Signed-off-by: Loïc Molinari <loic.molinari@collabora.com>
2024-05-18 20:07:22 +03:00
Cycle through gl-renderer debug modes: none, wireframe, batches, damage, opaque.
man: Document available debug bindings. Fixes: #398 Debug bindings were not documented in weston-bindings so document them. Signed-off-by: Veeresh Kadasani <veeresh.kadasani@huawei.com>
2021-01-04 15:16:19 +03:00
.RE
- KEY_R :
.RS 4
libweston: Remove runtime render switching It is only enabled by a debug key binding, currently not tested at all, and is seems it doesn't really work, so let's remove it. This also removes it from the man page. Signed-off-by: Marius Vlad <marius.vlad@collabora.com>
2022-07-18 23:03:20 +03:00
Enable repaint debugging for Pixman.
man: Document available debug bindings. Fixes: #398 Debug bindings were not documented in weston-bindings so document them. Signed-off-by: Veeresh Kadasani <veeresh.kadasani@huawei.com>
2021-01-04 15:16:19 +03:00
.RE
.RE
man: Add weston-bindings(7) describing desktop shell shortcuts The desktop-shell-specific bindings were identified from shell_add_bindings in desktop-shell/shell.c. Various general shortcuts (like Ctrl+Alt+F) are provided by files in libweston/ and compositor/ . Also introduce references to the new manual in weston(1) and weston.ini(5). Signed-off-by: Manuel Stoeckl <code@mstoeckl.com>
2019-03-27 04:00:55 +03:00
.SH "SEE ALSO"
.BR weston (1),
.BR weston-drm (7),
.BR weston.ini (5),
.BR xkeyboard-config (7)