GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  DMXADDSCREEN (3)

NAME

DMXAddScreen - attach a new back-end screen

CONTENTS

Synopsis
Description
Notes

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) 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) command 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(3) API, this function uses screen for both input and output.

SEE ALSO

DMXRemoveScreen(3), DMXChangeScreensAttributes(3), DMXGetScreenAttributes(3), DMX(3), Xdmx(1)
Search for    or go to Top of page |  Section 3 |  Main Index


X Version 11 DMXADDSCREEN (3) libdmx 1.1.3

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.