DMXAddInput(3)

NAME

   DMXAddInput,  DMXAddBackendInput,  DMXAddConsoleInput  -  attach  a new
   input

SYNOPSIS

   #include <X11/extensions/dmxext.h>

   Bool DMXAddInput(Display *dpy,
                    unsigned int mask,
                    DMXInputAttributes *attr,
                    int *id);
   Bool DMXAddBackendInput(Display *dpy,
                           int screen,
                           int sendsCore,
                           int *newId);
   Bool DMXAddConsoleInput(Display *dpy,
                           const char *name,
                           int sendsCore,
                           int *newId);

DESCRIPTION

   DMXAddInput() is used to attach a new input (or a  previously  detached
   input)  to  the Xdmx(1) server.  mask specifies the fields in attr that
   are active, and id returns the device if of the  first  device  in  the
   series that is added.

   The value of mask is computed from the following values:

   DMXInputType
   DMXInputPhysicalScreen
   DMXInputSendsCore

   The DMXInputAttributes structure is:

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

   inputType     may    have    the    value    DMXConsoleInputType     or
   DMXBackendInputType .

   For console devices, name will specify the display to be used.

   For back-end devices, physicalScreen will specify  the  Xdmx(1)  screen
   number.

   If  sendsCore  is  True,  the  new  device will be added as a true core
   device.

   If a device was removed with DMXRemoveInput(3) an attempt will be  made
   to reconnect the previous devices (sendsCore is ignored in this case).

   DMXAddBackendInput()  is  a  helper  function that is used to add input
   from a back-end server.  With this function, screen refers to the back-
   end  screen, sendsCore is True if the new input should send core events
   (and it ignored if the input has been detached), and  newId  will  hold
   the device id of the first device in the series added.

   DMXAddConsoleInput()  is  a  helper  function that is used to add input
   from a console.  With this function, name is the name  of  the  console
   display,  sendsCore  is  True  if the new input should send core events
   (and it ignored if the input has been detached), and  newId  will  hold
   the device id of the first device in the series added.

RETURN VALUE

   DMXAddInput() returns True on success and False otherwise.

   DMXAddInput()  can  generate  BadValue  (if  inputType  is  invalid  or
   physicalScreen is out of range), BadAccess (if the  input  has  already
   been attached or if the backend screen is currently detached).

NOTES

   Local devices cannot be attached or detached.

   Attributes  that are not specified will default to 0.  This may lead to
   unintended results.

SEE ALSO

   DMXRemoveInput(3), DMX(3), Xdmx(1)

---

Free and Open Source Software