MirBSD manpage: DMXAddScreen(3)


DMXAddScreen(3X)    UNIX Programmer's Manual     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 DMXChangeScreenAttributes(3X) and
     DMXGetScreenAttribues(3X) functions.

RETURN VALUE

     DMXAddScreen() will return True if the screen was success-
     fully attached, and False otherwise. False will be returned
     if the -addremovescreens command line option was not speci-
     fied on the Xdmx(1) command line, the input value of screen
     is out of range, screen is not currently detached, display-
     Name cannot be opened, has unexpected visuals, or has
     characteristics that do not match the previously detached
     screen.

     DMXAddScreen() can generate BadLength, BadAlloc, and Bad-
     Value 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)

XFree86                   Version 4.5.0                         1

Generated on 2021-12-07 11:07:08 by $MirOS: src/scripts/roff2htm,v 1.103 2021/01/23 20:24:35 tg Exp $ — This product includes material provided by mirabilos.

These manual pages and other documentation are copyrighted by their respective writers; their sources are available at the project’s CVSweb, AnonCVS and other mirrors. The rest is Copyright © 2002–2021 MirBSD.

This manual page’s HTML representation is supposed to be valid XHTML/1.1; if not, please send a bug report — diffs preferred.