OpenVMS port of Xscreensavser version 2.34           December 1998
==========================================

Xscreensaver distribution can be found in 3 subdirectories:

[.DRIVER]   The Xscreensaver and Xscreensaver-command programs.
[.HACKS]    Graphic demos ,can be run either through the xscreensaver program 
            or standalone.
[.UTILS]    A small libraries of various utilities.

and the optional GL demos (3D demos using OpenGL library):

[.HACKS.GLX]


This port has been tested with  VAX VMS 6.1 (compiled with DEC C 5.0 and
Motif 1.2) and AXP VMS 6.2 (compiled with DEC C 5.2 and Motif 1.2-4). 
The GL demos were built with MESA GL V 2.2 library (available at the DECwidbows
Archive).

Installation:
-------------
Hacks executables are no longer provided due to their size. You can however
relink them with the provided object files found inside AXPOBJS.ZIP and
VAXOBJS.ZIP archives into [.HACKS] directory. Same thing for [.HACKS.GLX]
directory, where you need to customise link*.com scripts according to your Mesa
GL installation.

Xscrensaver and Xscreencommand executables and help files are provided.

Resource file [.DRIVER]XSCREENSAVER.DAT can be copies under SYS$LOGIN or under
SYS$COMMON:[DECW$DEFAULTS.USER] directory. If you want GL demos, you need to
uncomment them into the resource file.

Complete rebuild:
----------------
To rebuild, you need to rebuild [.UTILS] directory first and create the
object library (look at the end of COMPILE*.COM procedure).

You can now build the [.HACKS] directory, the optional [.HACKS.GLX] directory
and the [.DRIVER] directory.

A one-step build is now available via the MAKEVMS.COM script. 

WARNING : before building [.HACKS], you may need to correct some of the
DECwindows bitmap files. Some files are bogus !! (they have a long line of 
null chars  at the end). These files are under 
SYS$COMMON:[DECW$INCLUDE.BITMAPS] directory:

STIPPLE.XBM
HLINES2.XBM
LIGHT_GRAY.XBM
ROOT_WEAVES.XBM
VLINES2.XBM

These files are all used by Greynetic demo.

Nota: link procedure automagically select appropriate X and Motif Libraries
(X11R4/Motif 1.1 - X11R5/Motif 1.2). 

Usage:
-----

The SETUP.COM procedure gives you a definition of all DCL foreign command
symbols needed to run Xscreensaver and all the graphic hacks. You need to
modify this procedure if you install these programs in another directory tree.

You can easily add new graphic demos without recompiling Xscreensaver. You just
need to add them in resource file XSCREENSAVER.DAT. This file (originally
present in [.DRIVER] directory ) can be installed under your SYS$LOGIN 
directory for a per-user customization basis. You can also install it under 
the system-wide user resource directory SYS$COMMON:[DECW$DEFAULT.USER] 
(with (W:RE) protections). The new graphics hack must be run in root-window 
mode to be accepted by Xscreensaver.

A preference file .XSCREENSAVER is created under your SYS$LOGIN directory.

The better way to launch Xscreensaver is:

$ spawn/nowait/input=nl/output=nl xscreensaver

A spash scree gives you access to demo mode or preferences change during a
small amount of time. After, you can control it via xscreencommand command.

To stop the xscreensaver deamon:

$ xscreencommand -exit


Enjoy,
--
Patrick MOREAU  
pmoreau@cena.dgac.fr
moreau_p@decus.decus.fr
http://www2.cenaath.cena.dgac.fr/~pmoreau/
http://www2.cenaath.cena.dgac.fr/ftp/index.html  (DECWindows Archive Home Page)
