Xlockmore95 Readme.txt file.

Version 0.4


Requirements.
-------------

Windows 95 or Windows NT running 256 colors or greater.
Don't know the minimum spec. machine, but I have run it on a 
Pentium 166 (Win95), Pentium Pro 200 (Win NT), and 
Pentium II 233 (Win95).


Installation.
-------------

Place the file "xlockmore.scr" in Windows system directory 
("C:\Windows\System\" on most systems)

Set "xlockmore" to be your screen saver.

You should see an xlockmore mode in the little screen on the 
Display Properties window.


Notes.
------

If you have used an older version than 0.4, it was called 
"xlock.scr". This is not needed anymore and can be deleted from
Windows system directory. Also timings from the older versions are
different than the versions 0.4 and above, so modes will be either 
faster or slower.


When the screen saver is started, it randomly chooses a mode. At this
time, there are only 29 modes. These are:

Blot, Braid, Clock, Coral, Daisy, Deco, Drift, Fadeplot, Flame, 
Forest, Galaxy, Geometry, Grav, Helix, Hop, Lightning, Lisa, Lissie, 
Petal, Qix, Roll, Rotor, Sierpinski, Sphere, Spiral, Spline, Triangle, 
Turtle, Vines


In the X-Windows version it is possible to set variables that affect
how long certain things are done (eg how many vines or blots to be
drawn before clearing the screen). These variables are cycles, size and
batch counts, and every mode is affected by them. The Win95/NT version
currently isn't able to set these variables and therefore they use the
defaults.


About ScrPlus.
--------------

Xlockmore95 uses Lucian Wischik's ScrPlus library. It is freely
available (see Download below) for non-profit use. Xlockmore95 is
built with the release version of ScrPlus.


Future of Xlockmore95.
----------------------

At this stage I have done intermediate releases of Xlockmore95. I
know there are more modes I can add, but as to adding all the modes 
that exist in Xlockmore, I'm not sure it is possible. There are modes 
that use XPM images (X PixMap images), opengl, and there may be 
X11 functions that just won't map easily to win95 functions (I've been
adding them on an as needed basis).

This is a list of what I would like to do (but I'm not promising)...
 . add more modes
 . allowing users to set the cycles and batch count variables, probably
   in the settings window.
 . allowing users to set sepecific options to modes that require it,
   probably in the settings window.

... and ultimately I would like to ...
 . add all modes (even opengl modes, and they would use 3D cards)


Differences with Xlockmore 4.07 (X11) & Bugs.
---------------------------------------------

Clock: when setting line attributes in X11, they only apply to line
drawing functions (not fill functions), but in Win32, line attributes
apply to both line and fill functions. This results in the ugly look
for this mode in Win32.

Galaxy: is getting drawn as a single pixel in the center of the screen,
only when a release build is done. In the debug build, everything is 
fine.

There are small differences in Line Attributes between X11 and WIN32


Change Log.
-----------

version 0.1
. initial release, Vines, Fadeplot, Sierpinski Triangles, Blot

version 0.2 (not a public release)
. added Coral mode

version 0.3
. wasn't initialising some pointer variables, which could cause an 
  error if circumstances allowed. This is now fixed.

. added the ability to redefine the color palette in a mode class.
  This means it is possible to have modes that don't have a palette
  saturation of 1.0 to recalculate the palette to how they require.
  For example Blot mode now has a palette saturation of 0.4

. added Deco & Forest modes

version 0.4
. added code for XDrawArc(), XFillArc() & XFillPolygon()

. changed from using my own base source code to using the source code
  for xlockmore 4.07. I still have to use some of my own code for 
  start-up and initialisation of the screen saver (cannot get around 
  this due to differences between X11 and Win95/NT), and of course all
  the X11 functions and structures. But the rest is xlockmore 4.07 
  code. At some point I will see if David will integrate the Win95
  source code into the official distrubution.

. As a result a lot more modes are now added. These are:
  Braid, Clock, Daisy, Drift, Flame, Galaxy, Geometry, Grav, Helix, 
  Hop, Lightning, Lisa, Lissie, Petal, Qix, Roll, Rotor, Sphere, 
  Spiral, Spline, Triangle, Turtle


Download.
---------

Please don't email David or Lucian about Xlockmore95.

You can get the latest version of xlockmore95 from my web site at
http://www.geocities.com/SiliconValley/Park/4572

You can find the latest information about xlockmore from 
David A. Bagley's site at http://www.tux.org/~bagleyd/xlockmore.html

You can get Lucian Wischik's excellent ScrPlus library to make your
own screen savers from http://classic.physiol.cam.ac.uk/scr/


Copyright.
----------

Copyright (c) 1988-91 by Patrick J. Naughton
Copyright (c) 1993-98 by David A. Bagley
Copyright (c) 1998 by Petey Leinonen (win95/NT version)

Permission to use, copy, modify, and distribute this software and its
documentation for any purpose and without fee is hereby granted,
provided that the above copyright notice appear in all copies and that
both that copyright notice and this permission notice appear in
supporting documentation. 

Please note that I do not provide any warranties, and that you use this
executable and/or source code at your own risk. I will not be held 
responsible for any damage that is incurred by using the executable 
and/or source code.


Petey Leinonen,   25 April 1998
