Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
DMXAddScreen(3)		   Library Functions Manual	       DMXAddScreen(3)

NAME
       DMXAddScreen - attach a new back-end screen

SYNOPSIS
       #include	<X11/extensions/dmxext.h>

       Bool DMXAddScreen(Display *dpy,
			 const char *displayName,
			 unsigned int mask,
			 DMXScreenAttributes *attr,
			 int *screen);

DESCRIPTION
       DMXAddScreen()  attaches	 a  back-end  screen to	the Xdmx(1) server, in
       place of	the previously detached	back-end server	specified by screen.

       displayName is the name of the new back-end display, mask specifies the
       field  in  attr	that  are  active,  and	screen returns the new Xdmx(1)
       screen number for the attached screen.

       The information stored in mask  and  attr is identical to that used  by
       the  DMXChangeScreensAttributes(3)  and DMXGetScreenAttributes(3) func-
       tions.

RETURN VALUE
       DMXAddScreen() will return True if  the	screen	was  successfully  at-
       tached, and False otherwise.  False will	be returned if the -addremove-
       screens command line option was not specified on	 the  Xdmx(1)  command
       line,  the  input  value	 of screen is out of range, screen is not cur-
       rently detached,	displayName cannot be opened, has unexpected  visuals,
       or  has	characteristics	 that  do  not	match  the previously detached
       screen.

       DMXAddScreen() can generate BadLength, BadAlloc,	and BadValue errors.

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

       Unlike other functions in the DMX(3) API, this function uses screen for
       both input and output.

SEE ALSO
       DMXRemoveScreen(3),   DMXChangeScreensAttributes(3),    DMXGetScreenAt-
       tributes(3), DMX(3), Xdmx(1)

X Version 11			 libdmx	1.1.3		       DMXAddScreen(3)

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | NOTES | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=DMXAddScreen&sektion=3&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help