DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH PRINT BOOK
 

DMXGetInputAttributes(3)





NAME

       DMXGetInputAttributes - determine input device attributes


SYNOPSIS

       #include <X11/extensions/dmxext.h>

       Bool DMXGetInputAttributes(Display *dpy,
                                  int id,
                                  DMXInputAttributes *attr);


DESCRIPTION

       DMXGetInputAttributes()  returns  information  about  the  input device
       specified with id.   This  information  cannot  be  obtained  from  the
       XListInputDeivices(3X)  call.   id  is  the  same  as  that used by the
       XListInputDevices(3X) call, and must be in the range 0 to one less than
       the value returned by DMXGetInputCount(3X), inclusive.

       The DMXInputAttributes structure is:

       typedef struct {
           DMXInputEnum inputType;
           int          physicalScreen;
           int          physicalId;
           Bool         isCore;
           Bool         sendsCore;
           const char   *name;
           Bool         detached;
       } DMXInputAttributes;

       The  value  of inputType will always be valid, and will have one of the
       following values, depending on the type of input:  DMXLocalInputType  ,
       DMXConsoleInputType , or DMXBackendInputType .

       For local devices, all other fields returned, except isCore  and  send-
       sCore , are invalid.

       For console devices, physicalScreen  and  physicalID will  be  invalid,
       and name will return the name of the X server on which the console win-
       dow is displayed.

       For back-end devices, physicalScreen will identify the back-end display
       and  can be used as an argument to DMXGetScreenAttributes(3X) to obtain
       more information; physicalId will be the XInput device id on the  back-
       end  X  server; and name will be invalid (since it does not provide any
       additional information that cannot  be  obtained  with  DMXGetScreenAt-
       tributes(3X)).

       If  isCore  is  True,  then  this device is active as a true core input
       device and will send core events.  If  sendsCore  is  True,  then  this
       device  is an XInput extension device, but sends core events instead of
       extension events.  This behavior is different from that of  XFree86  or
       Xorg, where XInput extension devices may send both extension events and
       core events.

       If detached is True, then this device  has  been  detached  and  is  no
       longer producing input events.  The device may be reattached using DMX-
       AddInput(3X).


RETURN VALUE

       DMXGetInputAttributes() returns True unless there is a protocol error.

       DMXGetInputAttributes() can generate BadValue (if the value  of  id  is
       out of range).


SEE ALSO

       DMXGetInputCount(3X),       XListInputDevices(3X),      DMXGetScreenAt-
       tributes(3X), DMXAddInput(3X), DMX(3X), Xdmx(1)

X Version 11                     libdmx 1.0.2        DMXGetInputAttributes(3X)

Man(1) output converted with man2html