This manual page is for Mac OS X version 10.6.3

If you are running a different version of Mac OS X, view the documentation locally:

  • In Terminal, using the man(1) command

Reading manual pages

Manual pages are intended as a quick reference for people who already understand a technology.

  • For more information about the manual page format, see the manual page for manpages(5).

  • For more information about this technology, look for other documentation in the Apple Reference Library.

  • For general information about writing shell scripts, read Shell Scripting Primer.



DMXAddScreen(3X)                                                                            DMXAddScreen(3X)



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 DMXChangeScreenAt-tributes(3X) DMXChangeScreenAttributes(3X)
       tributes(3X) and DMXGetScreenAttribues(3X) functions.

RETURN VALUE
       DMXAddScreen() will return True if the screen was successfully attached, and False otherwise.   False
       will  be  returned if the -addremovescreens command line option was not specified on the Xdmx(1) com-mand command
       mand line, the input value of screen is out of range, screen is not currently  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(3X) API, this function uses screen for both input and output.

SEE ALSO
       DMXRemoveScreen(3X), DMXChangeScreenAttributes(3X), DMXGetScreenAttributes(3X), DMX(3X), Xdmx(1)



X Version 11                                    libdmx 1.0.2                                DMXAddScreen(3X)

Reporting Problems

The way to report a problem with this manual page depends on the type of problem:

Content errors
Report errors in the content of this documentation with the feedback links below.
Bug reports
Report bugs in the functionality of the described tool or API through Bug Reporter.
Formatting problems
Report formatting mistakes in the online version of these pages with the feedback links below.

Did this document help you? Yes It's good, but... Not helpful...