Mirrored_Repos/LookingGlass
1
0
Fork 0
mirror of https://github.com/gnif/LookingGlass.git synced 2026-11-09 21:37:20 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity

[doc] input: Touchup

Browse Source
This commit is contained in:
Jonathan Rubenstein
2026-11-05 14:56:50 +02:00
committed by Geoffrey McRae
parent acb95cfa23
commit 238c1620fc
1 changed files with 17 additions and 7 deletions
Download Patch File Download Diff File Expand all files Collapse all files

24
doc/input.rst
View File

@@ -7,28 +7,32 @@ The current IDD provides keyboard and mouse input directly over LGMP. It uses
absolute positioning for normal desktop use and relative movement in capture absolute positioning for normal desktop use and relative movement in capture
mode. SPICE remains available as a fallback when direct input is unavailable. mode. SPICE remains available as a fallback when direct input is unavailable.
The client changes input provider automatically. If the displayed video has The client changes input provider automatically. If the displayed video falls
fallen back to SPICE, the client also uses SPICE input so that the picture and back to SPICE, the client also uses SPICE input.
pointer always refer to the same guest.
Only one LGMP client controls direct input at a time. Starting another client Only one LGMP client controls direct input at a time. Starting another client
does not give both clients simultaneous control. Disconnecting or restarting does not give both clients simultaneous control. Disconnecting or restarting
the IDD releases held keys and buttons before ownership changes. the IDD releases held keys and buttons before ownership changes.
.. _client_input_normal:
Normal input Normal input
------------ ------------
Move the pointer into the guest view to use absolute desktop input. This keeps Move the pointer into the guest view to use absolute desktop input. This keeps
the guest pointer aligned without requiring capture. the guest pointer aligned without requiring capture.
Direct IDD input supports the keyboard, media keys and up to 32 mouse buttons. Direct IDD input supports keyboard input, media keys, and up to 32 mouse
SPICE fallback uses relative mouse input and supports fewer extra buttons. buttons. SPICE fallback uses relative mouse input and supports fewer extra
buttons.
.. _client_capture_mode:
Capture mode Capture mode
------------ ------------
Press the escape key, :kbd:`ScrLk` by default, to capture the mouse. Capture Press the escape key (:kbd:`ScrLk` by default) to capture the mouse. Capture
mode confines the pointer and sends relative motion, which is appropriate for mode confines the pointer and uses relative movement, which is appropriate for
games and applications that lock the cursor. Press the escape key again to games and applications that lock the cursor. Press the escape key again to
leave capture mode. leave capture mode.
@@ -53,6 +57,8 @@ Common capture options are:
``input:hideCursor`` ``input:hideCursor``
Hide the host cursor while Looking Glass renders the guest cursor. Hide the host cursor while Looking Glass renders the guest cursor.
.. _client_autocapture:
Automatic keyboard capture Automatic keyboard capture
-------------------------- --------------------------
@@ -74,6 +80,8 @@ mouse input.
guest view is active. ``input:grabKeyboard`` controls whether full capture guest view is active. ``input:grabKeyboard`` controls whether full capture
mode grabs the keyboard. mode grabs the keyboard.
.. _client_input_spice:
SPICE fallback SPICE fallback
-------------- --------------
@@ -91,6 +99,8 @@ To disable all SPICE input while keeping SPICE audio or clipboard services:
If direct input is also unavailable, the client will display video without If direct input is also unavailable, the client will display video without
being able to control the guest. being able to control the guest.
.. _client_input_evdev:
Evdev capture Evdev capture
------------- -------------