From Fedora Project Wiki
(add input device properties feature page)
 
m (A few fixes to finish the page)
Line 6: Line 6:


== Owner ==
== Owner ==
* Name: [[whot | Peter Hutterer]]
* Name: [[Peter Hutterer]]


== Current status ==
== Current status ==
* Targeted release: [[Releases/11|  Fedora 11]]  
* Targeted release: [[Releases/11|  Fedora 11]]  
* Last updated: (2009-02-25)
* Last updated: (2009-02-26)
* Percentage of completion: 90%
* Percentage of completion: 100%


== Detailed Description ==
== Detailed Description ==


X server 1.6 (as shipped in F11) provides new protocol requests to list, change and query input device properties.
X server 1.6 (as shipped in F11) provides new X Protocol requests to list, change and query input device properties.
Properties as information exchange mechanism have a long tradition: they are used extensively on windows to provide information exchange between applications (including the window manager). For example, even closing a window is usually performed through setting properties. With the RandR extension, properties became available on output devices, and now, with server 1.6 and the X Input Extension 1.5, such properties are now available on input devices as well.
Properties as information exchange mechanism have a long tradition: they are used extensively on windows to provide information exchange between applications (including the window manager). For example, even closing a window is usually performed through setting properties. With the RandR extension, properties became available on output devices, and now, with server 1.6 and the X Input Extension 1.5, such properties are now available on input devices as well.


Line 38: Line 38:
== User Experience ==
== User Experience ==


This is a low-level interface that has no direct impact on the user. However, some tools are being converted to use input properties instead of custom mechanisms, and a generic tool ('xinput') is available to enable users to change properties in the absence of GUI tools.
This is a low-level interface that has no direct impact on the user. However, some tools are being converted to use input properties instead of custom mechanisms, and a generic tool ('xinput') is available to enable users to change properties in the absence of GUI tools. The drivers xorg-x11-drv-evdev and xorg-x11-drv-synaptics expose configuration settings as properties and can thus be configured at runtime.


== Dependencies ==
== Dependencies ==
Line 44: Line 44:
* xorg-x11-server 1.6 (RCs already in rawhide)
* xorg-x11-server 1.6 (RCs already in rawhide)
* libXi 1.2 (already in rawhide)
* libXi 1.2 (already in rawhide)
For run-time configuration of drivers:
* evdev 2.1 (in F10)
* synaptics 1.0 (already in rawhide)


== Contingency Plan ==
== Contingency Plan ==
Line 56: Line 60:


== Release Notes ==
== Release Notes ==
The new X server 1.6 includes Input Device Properties, a new mechanism to modify input devices at runtime. This new API provides run-time configuration of drivers as well as enabling applications to globally store information on an input device.
The new X server 1.6 includes Input Device Properties, a new mechanism to store information on input devices. This new API allows for run-time configuration of drivers as well as enabling applications to globally store information on an input device.
 
The drivers xorg-x11-drv-evdev and xorg-x11-drv-synaptics already expose configuration settings as properties and can thus be configured at runtime.


----
----


[[Category:FeaturePageIncomplete]]
[[Category:FeaturePageIncomplete]]

Revision as of 23:47, 25 February 2009

Input Device Properties

Summary

With X server 1.6, input devices provide a generic mechanism to change driver settings at runtime. The same mechanism may be used by applications to store information directly on device.

Owner

Current status

  • Targeted release: Fedora 11
  • Last updated: (2009-02-26)
  • Percentage of completion: 100%

Detailed Description

X server 1.6 (as shipped in F11) provides new X Protocol requests to list, change and query input device properties. Properties as information exchange mechanism have a long tradition: they are used extensively on windows to provide information exchange between applications (including the window manager). For example, even closing a window is usually performed through setting properties. With the RandR extension, properties became available on output devices, and now, with server 1.6 and the X Input Extension 1.5, such properties are now available on input devices as well.

Input device properties provide two benefits for applications and users:

  • Properties initialized and recognized by the driver or the server can be used to modify device settings at run-time.
  • Properties initialized by an application can be used to store information globally on a device. This information is available through a generic interface to all other applications and can thus be used to annotate devices.

Run-time manageable device properties reduce the need for configuration in the xorg.conf/HAL's fdi files and supersede custom mechanisms such as synaptics's SHM mechanism.

Benefit to Fedora

Run-time manageable device properties reduce the need for configuration in the xorg.conf/HAL's fdi files and supersede custom mechanisms such as synaptics's SHM areas. They further allow for easily extendable GUI configuration tools and for new ways of exchanging device-related information between applications.

Scope

Requires rebasing to X.Org X11 server 1.6.

Test Plan

No specific test-plan, this feature comes built-in with server 1.6.

User Experience

This is a low-level interface that has no direct impact on the user. However, some tools are being converted to use input properties instead of custom mechanisms, and a generic tool ('xinput') is available to enable users to change properties in the absence of GUI tools. The drivers xorg-x11-drv-evdev and xorg-x11-drv-synaptics expose configuration settings as properties and can thus be configured at runtime.

Dependencies

  • xorg-x11-server 1.6 (RCs already in rawhide)
  • libXi 1.2 (already in rawhide)

For run-time configuration of drivers:

  • evdev 2.1 (in F10)
  • synaptics 1.0 (already in rawhide)

Contingency Plan

  • none, this feature comes built-in with server 1.6

Documentation

Release Notes

The new X server 1.6 includes Input Device Properties, a new mechanism to store information on input devices. This new API allows for run-time configuration of drivers as well as enabling applications to globally store information on an input device.

The drivers xorg-x11-drv-evdev and xorg-x11-drv-synaptics already expose configuration settings as properties and can thus be configured at runtime.