XPSEUDOROOT(1)                       BSD                        XPSEUDOROOT(1)



NAME
     xpseudoroot - create a pseudo root window

SYNOPSIS
     xpseudoroot [-options ...] property_name

DESCRIPTION
     The xpseudoroot program allows you to create pseudo root windows as
     outlined in the Inter-Client Communications Conventions Manual.  By
     default it just makes a copy of the normal root window, but command line
     options may be used to alter much of the screen-related information.

     The command line argument property_name specifies the name of a property
     on the screen's real root window in which to store the pseudo root
     information.  Applications can be run within the pseudo root window by
     appending .property_name to the displaynumber.screennumber part of the
     display name; for example: expo:0.0.property_name

     WARNING: This is experimental code for implementing pseudo root windows
     as specified by the Inter-Client Communications Conventions Manual.  The
     interfaces that it provides should be considered private to the MIT
     implementation of Xlib and WILL CHANGE IN THE NEXT RELEASE.  The
     interfaces that it provides should not be incorporated into any toolkits
     or applications.  No effort will be made to provide backward
     compatibility.

OPTIONS
     -display displayname
             This option specifies the name of the X server to contact.

     -geometry geom
             This option specifies size and location of the pseudo root
             window.

     -visuals visualid ...
             This option specifies a list of visuals to support on the pseudo
             root window.  Any number of numeric visual identifiers (in hex,
             octal, or decimal) may be given per -visuals.

     -colormap colormapid
             This option specifies the numeric colormap identifier to be
             associated with the pseudo root window.

     -Colormap visualid
             This option specifies a numeric visual identifier to be used in
             creating a new colormap for the pseudo root window.  If this
             option is given, xpseudoroot will create a new colormap from the
             given visual and set the black and white pixel fields to the
             desired colors.

     -white pixel
             This option specifies the numeric pixel value to use for
             WhitePixel when creating a new colormap with -Colormap.  The
             default is to copy the real screen's WhitePixel.

     -White colorname
             This option specifies the color to use when setting WhitePixel in
             newly created colormaps.  It may be used with -white to create
             arbitrary WhitePixels.

     -black pixel

             This option specifies the numeric pixel value to use for
             BlackPixel when creating a new colormap with -Colormap.  The
             default is to copy the real screen's BlackPixel.

     -Black colorname
             This option specifies the color to use when setting BlackPixel in
             newly created colormaps.  It may be used with -black to create
             arbitrary BlackPixels.

     -empty  This option indicates that any colormaps created with -Colormap
             should not have BlackPixel and WhitePixel preallocated (although
             the values may still be set with -black and -white).  This leaves
             as much room as possible for running applications that would
             otherwise not find enough colors.  This is not for general use as
             it guarantees that an application will be displayed in incorrect
             colors.

     -max number
             This option specifies the maximum number of installed colormaps
             that will be allowed on this screen.  The default is to use the
             real screen's value.

     -min number
             This option specifies the minimum number of installed colormaps
             that will be allowed on this screen.  The default is to use the
             real screen's value.

     -backingstore when
             This option specifies when backing store window attributes will
             be honored and takes one of the following arguments:  NotUseful,
             WhenMapped, or Always.  The default is to use the real screen's
             value.

     -saveunders boolean
             This option specifies whether or not this screen supports save-
             unders and takes one of the following arguments:  yes or no.

     -name string
             This option specifies the name to be used for the pseudo root
             window.

SEE ALSO
     X(1), xdpyinfo(1), xwininfo(1), xprop(1), Inter-Client Communications
     Conventions Manual

BUGS
     This is a sample program that is primarily intended as a testbed for
     ICCCM pseudo roots.  It should not be incorporated into any toolkit or
     application.  Both the command line arguments and internal interfaces are
     guaranteed to change in the next release.

COPYRIGHT
     Copyright 1988, Massachusetts Institute of Technology.
     See X(1) for a full statement of rights and permissions.

AUTHOR
     Jim Fulton, MIT X Consortium