Xfce Wiki

Sub domains
 

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
xfce:xfce4-settings:mouse [2012/01/24 15:54] – [Cursor] nickxfce:xfce4-settings:mouse [2024/12/13 01:07] (current) kevinbowen
Line 1: Line 1:
-====== Mouse and Touchpad ======+~~NOTOC~~ 
 +{{ :xfce:xfce4-settings.mouse.png?nolink|}} 
 +====== xfce4-settings - Mouse and Touchpad ======
  
-<note warning>The page is work in progress!</note>+  * **[[#Device|Device]]** 
 +      * **[[#Buttons and Feedback|Buttons and Feedback]]** 
 +      * **[[#Touchpad|Touchpad]]** 
 +      * **[[#Tablet|Tablet]]**   
 +  * **[[#Behavior|Behavior]]** 
 +      * **[[#Drag and Drop|Drag and Drop]]** 
 +      * **[[#Double Click|Double Click]]** 
 +  * **[[#Cursor|Cursor]]** 
 +  * **[[#Device Properties|Device Properties]]** 
 + 
 +----
  
 ===== Device ===== ===== Device =====
- 
-<figure "Device Settings"> 
-{{:xfce:xfce4-settings:xfce4-settings-mouse-devices.png?nolink&|}} 
- 
-{{:xfce:xfce4-settings:xfce4-settings-mouse-devices-wacom.png?100|}} {{:xfce:xfce4-settings:xfce4-settings-mouse-devices-synaptics.png?100|}} 
-</figure> 
  
 ? Device ? Device
-! With this combo box you can select the device you want to edit, the settings below will adjust to the selected device. The list shows all connected pointer devices.+! With this dropdown menu you can select the device you want to edit, the settings below will adjust to the selected device. The list shows all connected pointer devices.
 ? Enable this device ? Enable this device
-Uncheck this option to turn a device off. If a device it disabled, it won't send any coordinate updates to the pointer. By default all (new) devices are enabled.+Slide this option left to turn a device off. If a device is disabled, it won't send any coordinate updates to the pointer. By default all (new) devices are enabled.
  
-==== Buttons and Feedback ====+<figure "Mouse Preferences: Devices Settings Tab"> 
 +{{:xfce:xfce4-settings:xfce4-settings-mouse-devices.png|Mouse Preferences: Devices Settings Tab}} 
 +</figure>
  
 +[[|Back To Top]]
 +----
 +===== Buttons and Feedback =====
  
 === Buttons === === Buttons ===
Line 36: Line 47:
 ! The number of pixels the pointer must move in a short time before it starts accelerating. ! The number of pixels the pointer must move in a short time before it starts accelerating.
  
-==== Touchpad ==== +[[|Back To Top]] 
-Currently only touchpads using the Synaptics driver are supported.+---- 
 + 
 +===== Touchpad ====
 + 
 +<figure "Mouse Preferences: Synaptics Touchpad Settings"> 
 +{{:xfce:xfce4-settings:xfce4-settings-mouse-devices-synaptics.png|Mouse Preferences: Synaptics Touchpad Settings Window}} 
 +</figure>
  
 === General === === General ===
Line 46: Line 63:
 ! To click, tap on the touchpad. To double-click, tap twice. To drag an item, double-tap but don't lift your finger after the second tap. Drag the item where you want it, then lift your finger to drop. ! To click, tap on the touchpad. To double-click, tap twice. To drag an item, double-tap but don't lift your finger after the second tap. Drag the item where you want it, then lift your finger to drop.
  
-=== Scrolling === 
  
 ? Scrolling ? Scrolling
Line 58: Line 74:
 ! Allow scrolling horizontal. The way horizontal scrolling works depends on the {gui>Scrolling} type you've selected. ! Allow scrolling horizontal. The way horizontal scrolling works depends on the {gui>Scrolling} type you've selected.
  
-==== Tablet  ====+[[|Back To Top]] 
 +---- 
 + 
 +===== Tablet =====
 Currently only devices using the Wacom driver are supported. Currently only devices using the Wacom driver are supported.
 +
 +<figure "Mouse Preferences: Wacom Tablet Settings">
 +{{:xfce:xfce4-settings:xfce4-settings-mouse-devices-wacom.png|Mouse Preferences: Wacom Tablet Settings Window}} 
 +</figure>
  
 ? Tracking mode ? Tracking mode
Line 75: Line 98:
   ? Counterclockwise   ? Counterclockwise
   ! The tablet is rotated 90 degrees counter-clockwise.   ! The tablet is rotated 90 degrees counter-clockwise.
 +
 +[[|Back To Top]]
 +----
  
 ===== Behavior ===== ===== Behavior =====
  
-<figure "Behavior Settings"> +<figure "Mouse Preferences: Behavior Settings Tab"> 
-{{:xfce:xfce4-settings:xfce4-settings-mouse-behaviour.png?nolink&|}}+{{:xfce:xfce4-settings:xfce4-settings-mouse-behaviour.png|Mouse Preferences: Behavior Settings Tab}}
 </figure> </figure>
  
-==== Drag and Drop ====+=== Drag and Drop ===
  
 ? Threshold ? Threshold
 ! The number of pixels the pointer must move before a drag operation will start. Default value is 8 pixels. ! The number of pixels the pointer must move before a drag operation will start. Default value is 8 pixels.
  
-==== Double Click ====+=== Double Click ===
  
 ? Time ? Time
Line 93: Line 119:
 ? Distance ? Distance
 ! The mouse pointer cannot move farther than this distance between two clicks for them to be considered a double click. Default value is 4 pixels. ! The mouse pointer cannot move farther than this distance between two clicks for them to be considered a double click. Default value is 4 pixels.
 +
 +[[|Back To Top]]
 +----
  
 ===== Cursor ===== ===== Cursor =====
  
-<figure "Cursor Theming"> +<figure "Mouse Preferences: Cursor Theming Tab"> 
-{{:xfce:xfce4-settings:xfce4-settings-mouse-theme.png?nolink&|}}+{{:xfce:xfce4-settings:xfce4-settings-mouse-theme.png|Cursor Theming Tab Window}}
 </figure> </figure>
  
Line 103: Line 132:
  
 You can install new cursor themes by butting them in the ''~/.icons'' directory. Make sure the directory layout looks like ''~/.icons/<theme_name>/cursors''. You can install new cursor themes by butting them in the ''~/.icons'' directory. Make sure the directory layout looks like ''~/.icons/<theme_name>/cursors''.
 +
 +[[|Back To Top]]
 +----
 +
 +===== Device Properties =====
 +
 +The Synaptics and Wacom interface in the dialogs shows only the most important settings, but there are a lot more settings for input devices you can control. Xfsettingsd is capable of setting all sorts of device properties; however, you have to manually set them in the pointers [[xfce:xfconf:|xfconf]] channel which is not always easy.
 +
 +First you need to find the correct device using the ''xinput'' utility. When you run this command it will list the devices on your system.
 +
 +  $ xinput list
 +  Virtual core pointer              id=2    [master pointer  (3)]
 +    Virtual core XTEST pointer      id=4    [slave  pointer  (2)]
 +    SynPS/2 Synaptics TouchPad      id=8    [slave  pointer  (2)]
 +  Virtual core keyboard             id=3    [master keyboard (2)]
 +    Virtual core XTEST keyboard     id=5    [slave  keyboard (3)]
 +    Power Button                    id=6    [slave  keyboard (3)]
 +
 +Now let's assume you want to modify a special property of the touchpad, lets say the coasting speed. If you run the command below it will show a long list with all the different properties.
 +
 +  $ xinput list-props "SynPS/2 Synaptics TouchPad"
 +  Device 'SynPS/2 Synaptics TouchPad':
 +  [...]
 +  Synaptics Coasting Speed (274): 45.000000
 +  Synaptics Scrolling Distance (252): 100, 100 
 +  [...]
 + 
 +Next, it translates the names into a valid [[xfce:xfconf:|Xfconf]] property name. The following characters are allowed: ''A-Z a-z 0-9 - _'' and spaces are replaced with an underscore. So this means ''SynPS/2 Synaptics TouchPad'' will become ''SynPS2_Synaptics_TouchPad''. Same goes for the property name and devices properties are stored under ''/<device-name>/Properties/<prop-name>''.
 +
 +As you can see the value above is stored as a double (45.000), so to disable coasting you have to run the following [[xfce:xfconf:xfconf-query|xfconf-query]] command:
 +
 +  xfconf-query -c pointers -p /SynPS2_Synaptics_TouchPad/Properties/Synaptics_Coasting_Speed -n -t double -s 0
 +
 +Use ''xinput list-props'' to check if the property is applied.
 +
 +In case the device property is an array, it will be show like ''Synaptics Scrolling Distance''; a comma separated list. This value is an integer because the 100 has no precision.
 +
 +  xfconf-query -c pointers -p /SynPS2_Synaptics_TouchPad/Properties/Synaptics_Scrolling_Distance -n -t int -t int -s 50 -s 80
 +
 +
 +[[|Back To Top]]
 +----
 +[[:start|Return to Xfce Main Documentation Page]]
 +
 +[[:xfce:xfce4-settings:start:|Return to xfce4-settings Main Documentation Page]]