man XF86Misc (Fonctions bibliothèques) - Extension library for the XFree86-Misc X extension.

NAME

XF86MiscQueryExtension, XF86MiscQueryVersion, XF86MiscGetMouseSettings, XF86MiscSetMouseSettings, XF86MiscGetKbdSettings, XF86MiscSetKbdSettings - Extension library for the XFree86-Misc X extension.

SYNTAX

#include <X11/extensions/xf86misc.h>

Bool XF86MiscQueryExtension(
    Display *display,
    int *event_base_return,
    int *error_base_return);

Bool XF86MiscQueryVersion(
    Display *display,
    int *major_version_return,
    int *minor_version_return);

Status XF86MiscGetSaver(
    Display *display,
    int screen,
    int *suspend_time_return,
    int *off_time_return);

Status XF86MiscSetSaver(
    Display *display,
    int screen,
    int suspend_time,
    int off_time);

Status XF86MiscGetMouseSettings(
    Display *display,
    XF86MiscMouseSettings *mseinfo);

Status XF86MiscSetMouseSettings(
    Display *display,
    XF86MiscMouseSettings *mseinfo);

Status XF86MiscGetKbdSettings(
    Display *display,
    XF86MiscKbdSettings *kbdinfo);

Status XF86MiscSetKbdSettings(
    Display *display,
    XF86MiscKbdSettings *kbdinfo);

ARGUMENTS

display
Specifies the connection to the X server.
screen
Specifies which screen number the setting apply to.
event_base_return
Returns the base event number for the extension.
error_base_return
Returns the base error number for the extension.
major_version_return
Returns the major version number of the extension.
minor_version_return
Returns the minor version number of the extension.
suspend_time_return
Returns the number of seconds of idle time the server will wait before activating the monitor's suspend mode.
off_time_return
Returns the number of seconds of idle time the server will wait before causing the monitor to powerdown.
suspend_time
Specifies the number of seconds of idle time the server should wait before activating the monitor's suspend mode.
off_time
Specifies the number of seconds of idle time the server should wait before causing the monitor to powerdown.
mseinfo
Specifies a structure which contains the mouse parameters.
kbdinfo
Specifies a structure which contains the keyboard parameters.

STRUCTURES

Mouse:
typedef struct {
    char *device; 	/ returned path to device */
    int type;	/ mouse protocol */
    int baudrate;	/ 1200, 2400, 4800, or 9600 */
    int samplerate;	/ samples per second */
    int resolution;	/ resolution, count per inch */
    int buttons;	/ number of buttons */
    Bool emulate3buttons;	/ Button1+Button3 -> Button2 ? */
    int emulate3timeout;	/ in milliseconds */
    Bool chordmiddle;	/ Button1+Button3 == Button2 ? */
    int flags;	/ Device open flags */
} XF86MiscMouseSettings;

Keyboard:
typedef struct {
    int type;	/ of keyboard: 84-key, 101-key, Xqueue  */
    int rate;	/ repeat rate */
    int delay;	/ delay until repeat starts */
    Bool servnumlock;	/ Server handles NumLock ? */
} XF86MiscKbdSettings;

DESCRIPTION

These functions provide an interface to the XFree86-Misc extension which allows various server settings to be queried and changed dynamically. Applications that use these functions must be linked with

POWER-SAVER FUNCTIONS

The and functions have been removed. This functionality is now provided by the DPMS extension.

MOUSE FUNCTIONS

Mouse parameters can be queried using the function The structure pointed to by its second argument is filled in with the current mouse settings.

Not all fields are valid in all cases. For example, when the protocol indicates a bus mouse (i.e. the type field has value as defined in then the value in the field should be ignored as it does not apply to bus mice.

The field contains the resolution in lines per inch when using the Hitachi tablet protocol.

The device field of the structure points to dynamically allocated storage which should be freed by the caller.

Any of the fields of the structure can be altered and then passed to the function to change their value in the server, with the following restrictions:

1)
The device can not be changed
2)
The protocol can not be changed to or from Xqueue or OsMouse
3)
The buttons field can not be changed
4)
Invalid combinations of parameters are not allowed

The server will generate an error if any of the above is attempted, except the first - the contents of the device field are simply ignored.

A change of the protocol causes the device to be closed and reopened. Changes to the baud rate, sample rate, resolution or flags, when applicable to the selected protocol, also cause a reopen of the device. A reopen can be forced by using the MF_REOPEN flag, except in the case of the OsMouse and Xqueue protocols which ignore all attempts to reopen the device.

KEYBOARD FUNCTIONS

The function allows you to retrieve the current keyboard-related settings from the server.

Using the function, the keyboard autorepeat delay and rate can be set. Requests to change the and fields are ignored (except for checking for an invalid keyboard type). This is expected to change in a future release.

OTHER FUNCTIONS

Two functions, and are provided which allow the client to query some information regarding the extension itself.

PREDEFINED VALUES

The header file contains definitions for

MTYPE_*
Mouse protocols
KTYPE_*
Keyboard types
MF_*
Mouse flags

SEE ALSO

xset(1), xorg.conf(5)

AUTHORS

Joe Moss and David Dawes, The XFree86 Project, Inc.