XSetScreenSaver, XForceScreenSaver, XActivateScreenSaver,
       XResetScreenSaver, XGetScreenSaver - manipulate the screen
       saver


SYNTAX

       XSetScreenSaver(display, timeout, interval,
       prefer_blanking, allow_exposures)
             Display *display;
             int timeout, interval;
             int prefer_blanking;
             int allow_exposures;

       XForceScreenSaver(display, mode)
             Display *display;
             int mode;

       XActivateScreenSaver(display)
             Display *display;

       XResetScreenSaver(display)
             Display *display;

       XGetScreenSaver(display, timeout_return, interval_return,
       prefer_blanking_return,
                         allow_exposures_return)
             Display *display;
             int *timeout_return, *interval_return;
             int *prefer_blanking_return;
             int *allow_exposures_return;


ARGUMENTS

       allow_exposures
                 Specifies the screen save control values.  You
                 can pass DontAllowExposures, AllowExposures, or
                 DefaultExposures.

       allow_exposures_return
                 Returns the current screen save control value
                 (DontAllowExposures, AllowExposures, or
                 DefaultExposures).

       display   Specifies the connection to the X server.

       interval  Specifies the interval, in seconds, between
                 screen saver alterations.

       interval_return
                 Returns the interval between screen saver invo-
                 cations.

       mode      Specifies the mode that is to be applied.  You
                 can pass ScreenSaverActive or ScreenSaverReset.

       timeout_return
                 Returns the timeout, in seconds, until the
                 screen saver turns on.


DESCRIPTION

       Timeout and interval are specified in seconds.  A timeout
       of 0 disables the screen saver (but an activated screen
       saver is not deactivated), and a timeout of -1 restores
       the default.  Other negative values generate a BadValue
       error.  If the timeout value is nonzero, XSetScreenSaver
       enables the screen saver.  An interval of 0 disables the
       random-pattern motion.  If no input from devices (key-
       board, mouse, and so on) is generated for the specified
       number of timeout seconds once the screen saver is
       enabled, the screen saver is activated.

       For each screen, if blanking is preferred and the hardware
       supports video blanking, the screen simply goes blank.
       Otherwise, if either exposures are allowed or the screen
       can be regenerated without sending Expose events to
       clients, the screen is tiled with the root window back-
       ground tile randomly re-origined each interval seconds.
       Otherwise, the screens' state do not change, and the
       screen saver is not activated.  The screen saver is deac-
       tivated, and all screen states are restored at the next
       keyboard or pointer input or at the next call to XForce-
       ScreenSaver with mode ScreenSaverReset.

       If the server-dependent screen saver method supports peri-
       odic change, the interval argument serves as a hint about
       how long the change period should be, and zero hints that
       no periodic change should be made.  Examples of ways to
       change the screen include scrambling the colormap periodi-
       cally, moving an icon image around the screen periodi-
       cally, or tiling the screen with the root window back-
       ground tile, randomly re-origined periodically.

       XSetScreenSaver can generate a BadValue error.

       If the specified mode is ScreenSaverActive and the screen
       saver currently is deactivated, XForceScreenSaver acti-
       vates the screen saver even if the screen saver had been
       disabled with a timeout of zero.  If the specified mode is
       ScreenSaverReset and the screen saver currently is
       enabled, XForceScreenSaver deactivates the screen saver if
       it was activated, and the activation timer is reset to its
       initial state (as if device input had been received).

       XForceScreenSaver can generate a BadValue error.

       The XActivateScreenSaver function activates the screen


SEE ALSO

       Xlib - C Language X Interface



X Version 11               Release 6.4                          1