Category : Display Utilities
Archive   : FRCSAV.ZIP
Filename : FSV_READ.ME

 
Output of file : FSV_READ.ME contained in archive : FRCSAV.ZIP

FractalSave Screen Saver, Shareware version 1.0
Copyright (c) 1991 by James H. Price


This file tells you how to use the FractalSave screen saver program. To
print a hard copy of the file, enter the following at a DOS prompt:

TYPE FSV_READ.ME > PRN

NOTE ON SHAREWARE:

This is a shareware program, it is not free or public domain
software. You are encouraged to try it, without charge, for a period of
30 days. If you continue to use it beyond the trial perios, you must
register it. Please be honest about this.

You're encouraged to distribute the program freely as long as it's
not altered in any way, is distributed with this documentation, and if
no charge is made for the program. (Reasonable distribution fees to
cover mailing or diskette costs are perfectly okay with me.)

INTRODUCTION:

FractalSave is a TSR (terminate and stay resident) screen saver
utility based on the popular FractalWeave shareware program. When
loaded in memory, FractalSave monitors the keyboard and mouse and "pops
down" after a predetermined period of no activity. This prevents
possible damage to your video monitor from "burn-in" due to having a
fixed image written to your screen for prolonged periods.

When it pops down, FractalSave displays a colorful, incredibly
intricate, and constantly changing screen image. An unlimited number of
different images can be displayed, depending on the image file selected
when the program is loaded. Custom image files can be generated using
the FractalWeave program (version 2.0 or later), another shareware
product by the same author.

HARDWARE REQUIREMENTS:

FractalSave requires an IBM PC or compatible computer. Monitors of
all types are supported. Displaying FractalWeave image files requires
an EGA or VGA color monitor with at least 256K of video memory. On
other types of monitors a text-based color or monochrome display is
used. The shareware version of FractalSave requires approximately 19k
of memory when loaded in resident mode. A hard disk is recommended, but
not required.

WHAT'S ON THE DISK:

The distribution disk or ZIP file should contain the files listed
below.

FSAVE.EXE The screen saver program itself
DEMO00.WVE Sample EGA image file
DEMO01.WVE ditto
DEMO02.WVE ditto
DEMO03.WVE Sample VGA image file
FSV_READ.ME This document


INSTALLATION:

As a convenience, copy FSAVE and the image (*.WVE) files to a
directory on your PATH statement, otherwise you'll have to specify the
full path when start the program.

If you want to run the program from a floppy diskette, make a backup
copy of the original files and place the backup disk in a safe place.

NOTE TO FLOPPY DISK USERS: When FractalSave pops down, it takes a
snapshot of the current screen and saves it to a temporary file in the
current directory. When you press a key to return to your program,
FractalSave reads the screen information from the disk, then deletes the
file. With a hard disk, the time it takes to save and restore the
information from disk is negligible, particularly if you're using a disk
cache. With a floppy disk, however, you might notice a small delay.

FractalSave can be loaded automatically via your AUTOEXEC.BAT file.
It can also be loaded into "high memory" if your have the appropriate
hardware and software on your system. See your DOS documentation for
details.

RUNNING THE PROGRAM:

There are a number of adjustable parameters which you can set from
the command line to tailor the program to your own preferences. For a
quick summary, type FSAVE /h at a DOS prompt.

To load the program with the default parameters, just type FSAVE at
a DOS prompt. The program will load itself into memory, and pop down
after 5 minutes of no screen activity.

To change the default settings, enter

FSAVE [/option(value)] [/option(value)] ...

Here the "/" tells the program a parameter is coming; "option"
specifies which parameter is being adjusted, and "(value)" is the new
value to set. For example:

FSAVE /d30 /fdemo01.wve

tells the program to set the default delay to 30 seconds, and to use the
image file "demo01.wve". The available parameters and their legal
ranges are discussed below.


COMMAND LINE PARAMETERS:

Remember, you can get a synopsis of the available parameters, their
legal and default values, and the command line syntax by typing FSAVE /h
at the DOS prompt.

Any number of parameters may be used, in any order. In case of a
conflict, the value specified last will be used. You may substitue a
"-" in place of the "/" if you prefer.

/u This unloads the program from memory, or deactivates it if
it can't be safely unloaded.

/n This runs the program without keeping it in memory. It's
useful when you're trying to adjust the program setting, or
simply want to view the FractalWeave images.

/s This adjusts the speed at which the "fractal ball" moves
around the screen. Larger numbers gives slower speeds. The
default value is zero; you might want to increase it if you
have a fast machine, or prefer a leisurely display.

The /s parameter also affects the text mode display; in this
case by slowing down the rate at which the colored boxes are
written to the screen. The default value for text is 16.

/t This parameter affects the rate at which the palette is
changed in the graphics display. It has no effect on the
text display. Valid range is 0 - 60. Zero specifies NO
change, while values from 1 - 60 specify a value in seconds.
The default value is 4.

/f Specifies which FractalWeave image file to load. The
default is "demo00.wve". If a path is not specified, the
program searches the PATH specified in your AUTOEXEC.BAT
file. If the file is still not found, the program aborts
and returns the message "Couldn't open image file." Example:
" FSAVE /fc:\util\mywve.wve ".

If you wish, you can use the /f switch with no filename to
force the text display. You might wish to do this if you
use a program which writes to multiple text pages (see
below).


QUIRKS and INCOMPATIBILITIES:

1) FractalSave will not pop down when a graphics program is running
in the foreground.

This is by design. Swapping a graphics screen to disk is very
slow; furthermore, (and primarily) a majority of graphics
programs (including Windows 3.0) exhibit the behavior discussed
in (3) below.

2) FractalSave should be run in text mode when used with a program
that writes to multiple text pages.

FractalSave saves and restores only the foreground screen. If
the foreground program writes to more than one page of text, the
information on subsequent pages is lost when FractalSave enters
a graphics mode. In such a case, use the "/f" switch by itself
to force text mode. (I don't know of any programs which
actually do this; if you do, please let me know. It's an easy
modification for the next version.)

3) FractalSave (along with other TSRs) is incompatible with programs
which intercept the system timer or keyboard interrupts and
don't pass them along.

In the first case, FractalWeave never finds out that it's time
to pop down, and doesn't.

In the second case, FractalWeave pops down, and then waits
patiently for a keystroke which gets intercepted and never
arrives. This gives the appearance of "hanging".

To the credit of programmers everywhere, I don't know of any
text-based program which exhibits such pathological behavior.

********
LATE NEWS: I spoke too soon. The new text editor included with DOS 5.0
is not fully compatible with FractalSave, apparently due to keyboard
conflicts similar to those just discussed. Use them together with
caution, if at all.
********

ABOUT THE PROGRAM:

FractalSave is based on the very popular FractalWeave shareware
program by the same author. Many users of FractalWeave requested a
screen saver version of that program. FractalSave was written to
accomodate that demand.

Version 2.0 of FractalWeave generates image files which are fully
compatible with FractalSave. The demo image files included with
FractalSave only hint at the wide variety of images which can be
generated. FractalWeave gives you full control over the image. You
can use it to create an unlimited number of custom images for use
with FractalSave.

*************************************************************************

REGISTERING FRACTALSAVE:

FractalSave is a shareware program, not free or public domain
software. A lot of time and effort went into developing it; if you
use it, you should register it. Please be honest and fair about
this.

To register FractalSave, send $15.00 to

James H. Price
1253 E. Calaveras St
Altadena, CA 91001

WHAT A DEAL:

As an added inducement to register, I'll also send the latest
version of FractalWeave at no extra cost.

*************************************************************************

OBTAINING THE RETAIL VERSION:

The shareware version of FractalSave is written primarily in C, with
video and graphics routines in assembly language. It requires
approximately 19k of memory when resident. The retail version of
FractalSave is written entirely in assembly language, and requires a
mere 4.5k of memory when resident.

The retail version is being made available to registered owners of
FractalWeave and FractalSave for a modest $10.00 upgrade fee. If
you haven't registered either of these products, you can take
advantage of the upgrade offer now. Send $25.00 (instead of $15.00)
to the address above, and I'll send you the retail version of
FractalSave, and (what the heck) the latest version FractalWeave at
no extra cost.


CONTACTING THE AUTHOR:

If you have any questions or difficulties with the program, feel
free to contact me at the above address. I can also be reached via
CompuServe E-mail at 76264,3534.

FINE PRINT:

This program is distributed as-is. There is no warranty of any
kind. By using the program, you agree to this.



I hope you enjoy the program.


Jim Price