Eyecandy: Turn your computer into an expensive lava lamp.

Razzle Dazzle

Initial Release Date
September 3, 1990 (v4.0)
Color Palette
8/24b
Max Resolution
320x400
License Status
Public Domain (to v4.0) / Shareware © Worldwide MicroTronics, Inc.
Codebase
C
Platform(s)
MS-DOS
Author(s)
James R. Shiflett

Description

Razzle Dazzle, initially known as just Dazzle, generated a variety of hypnotizing imagery in high resolution Mode X VGA modes (i.e. 320x400) and later in SVGA modes (i.e. 640x480) using ~30 different image generation algorithms.

Unlike most MS-DOS eyecandy, Razzle Dazzle was a $15 commercial product (beyond version 4.0, which was public domain). Versions here are the public/shareware versions. The commercial version implemented a TSR to automatically launch the program on inactive PCs, supported SVGA 640x480 modes, as well as having expanded visualization modes.

Razzle Dazzle later became a Windows screen-saver known as Razzle Dazzle, described in an extended appendix of the 5.1a version's documentation. It's too long to fully quote here, but I like the phrase...

Behold the beauty of math in all it's glorious colors.

Razzle Dazzle was used to generate a 45 minute music video by Jonn Serrie, which can be viewed today thanks to The Internet Archive. Unfortunately, Worldwide Microtronics Inc. forfeited existence as of 2005. It's unclear if there is any way to get the commercial versions of Dazzle or Razzle Dazzle today.

Dazzle also didn't seem to promote the drug use often associated with eyecandy software. Instead it took a more spiritual approach, reminding the user post each run...

Our creator evidenced by our creativity

...from version 4.2 on. The comment is more throughly explained in the "Programmers Comments" section of the documentation, quoting various Christian scriptures.

Video

Screen Shots

ScreenshotScreenshotScreenshotScreenshotScreenshotScreenshotScreenshotScreenshotScreenshot

Download

Documentation

Dazzle 4.0
DAZZLE :             Documentation for Revision 4.0
                            4 September 1990


       A randomized color pattern generator for MsDOS/PCDOS computers
with EGA or VGA compatible color displays and adapters.  Performance art
for the eyes!

       A source of beauty, sometimes subtle, sometimes vibrant, always
changing.  The image engine has over 30 primary drawing algorithms, most
of which have at least two styles of presentation, many of which have
multiple internal drawing variations.  There are also an assortment of
"fades", including split screens and pans, used by the imaging system
for greater diversity of presentation.  The entire color range of the
detected video system is utilized for maximum variety and visual
stimulation.  The primary algorithms are mixed randomly on the screen,
typically from 3 to 8 are overlaid at a time producing a very large
assortment of possible displays.  Each display remains for a while to be
appreciated, then the screen is cleared via one of the fade algorithms
and another set of patterns is presented.  Mathematically speaking, an
exact pattern match might not occur for many days of continuous
operation.  Of course human perception is far less exacting and will
discern repetition well ahead of these extremes, but the general effect
is still impressive.  Note that the starting patterns of the program
will be different each time it is executed, if it seems predictable then
exit it and start it over again.

       The July 1990 issue of "PsL News" (713-524-6394) described this
program as:
               ...the best kaleidoscope program we've seen yet.
               The beautiful use of colors, enhanced even
               further by the use of fading in and out, is, for
               want of a better word, awesome.

       Dazzle can be used in a variety of ways.  At the office it keeps
the screen from being burned by constant display of an unchanging
prompt.  Simply activate the program when leaving your desk or answering
the phone or otherwise diverted.  One option is to activate Dazzle from
a keyboard-locking program so that unauthorized access is prevented on
your un-attended computer until you return.  In reception areas, at
trade shows, and other events where the desire is to attract attention,
use one of the faster cycling modes of Dazzle to peak curiosity and draw
visitors to your area.  DAZZLE can be invoked from within your own
presentation software for an extra touch of piazzas.

       Dazzle can be used to aid relaxation.  In its slower cycling VGA
modes it is often soothing and helps one to shift conscious attention
from the cares of the day.  When overwhelmed with problems or pressures,
it is often true that shifting one's focus from an immediate concern
provides the objectivity needed to enhance decision making and settle
the nerves.  Used in conjunction with your favorite music, Dazzle can be
highly entertaining and regenerating.


DAZZLE Revision 4.0                    page 1 of 6
Program, including source, and all related documentation Copyright

       DAZZLE is a performing art tool for the eyes.  The MIDI control
and full manual image control options have not yet been implemented, but
even in its current random play mode it is great 'living' mobile art.
Capture stills, record it on your VCR, or play it live with your band.
Applications are boundless.


Usage: DAZZLE [- options] [/ options]
       -c = COMPATIBLE mode, use BIOS for better portability.
       -2 = 2 part palette update to fix flickering screens (slower).
       -n = NO retract of hard disk heads.
       -x = XT compatible mode, inferior but works.
       -s = SHOW mode, quick single image.
       -e = EGA operation mode forced.
       -v = VGA operation mode forced.
       -t = TALL video aspect ratio mode.
       -f = FIXED colors instead of randomized.
       -a = ALTERNATE (faster) color cycling speed.
       -m = MAD (fastest) color cycling speed.
       -b = Bashful, no closing credits.
 During the display the '+' and '-' keys can be used to control color
cycling speed!  The TAB key will FREEZE the display till the next key!


       The DAZZLE program accepts any combination of options on the
initial command line that affect it's mode of operation.  The options
can be preceded with either the "/" character or the "-" character. At
least one space must exist between the DAZZLE command and the first
option.  For example: "DAZZLE -FN" instructs DAZZLE to execute with
Fixed colors and No retract of the hard disk drive heads.  The options
are not case sensitive (upper and lower case letters are treated
identically). The options can be concatenated into a single string
(like: -FN), or can be entered separately (like: -F -N), the effect is
the same.  To get a list of legal options use either the "-?" option
(DAZZLE -?) or the question mark alone (DAZZLE ?).  The effects of each
option are detailed below.

       Six of the options for DAZZLE are specifically related to
increasing portability of the program to various computers and displays.
The "c", "2", "n", "x", "e", and "v" options default to the most
desirable modes, but can be controlled by the user.  VGA users should
also refer to the "t" option for details.

/C = COMPATIBLE mode, use BIOS for better portability.
       Normally DAZZLE bypasses the video adapters BIOS code for maximum
speed in color palette cycling.  However, some adapters can have
problems with this mode of operation.  To cause DAZZLE to use the
provided BIOS the "C" option can be used.  If your display flickers,
distorts, or the color fails to cycle smoothly during the display then
try this option to determine if it corrects the problem.  As of Rev.
3.9g this option also impacts the EGA operational mode, this was needed
by some VGA adapters when DAZZLE was operated in the forced EGA mode.
This option reduces program performance speed and should not be used if

DAZZLE Revision 4.0                    page 2 of 6
Program, including source, and all related documentation Copyright

not needed.

/2 = 2 part palette update to fix flickering screens (slower).
       Normally the entire color palette is updated at one time for each
tick of the color cycling clock.  If the CPU clock speed or the VGA
palette register update rate are too slow, the upper part, or perhaps
all of the display, will flicker badly during the display.  To determine
if this is due to palette updates, press and hold the "-" key during the
running display until it beeps (this is the slowest cycling clock rate).
If the display only flickers when the color changes, then palette update
speed is a problem.  Using the "2" option splits the VGA palette update
request into two almost equal groups that are handled sequentially. This
should remove, or at least significantly reduce, cycling induced
flicker.  This option should not be used if not needed as it slows the
entire display generation process.  This option only affects operation
with VGA adapters since they allow longer 256 color palettes.  Short 16
color palettes for EGA's are never divided into two separate updates.

/N = NO retract of hard disk heads.
       Since the DAZZLE display is often allowed to run for hours, the
hard disk heads are normally parked into a safe power-down position as a
precaution in case electrical power is lost, or the computer powered-
down while DAZZLE is active.  This process has no effect on the image
generation performance of DAZZLE, but if your drive controller is highly
non-standard it might cause DAZZLE to fail to start.  The user can issue
this option to prevent any attempt to park the hard disk heads.

/X = XT compatible mode, inferior but works.
       This option should allow DAZZLE to execute on 8088 or 8086 based
XT type computers with EGA or VGA adaptors.  This option will be
automatically initiated if the 808x style CPU is detected at program
startup, but specifying the command line option avoids the warning
message.  The EGA performance on XT computers seems acceptable, but the
VGA mode may be noticeably inferior to the performance of an 80x86 based
computer.  The faster the CPU clock the better the overall performance
and fluidity of DAZZLE.


       The remainder of the DAZZLE options adjust the image generating
algorithms used by the program.  They are largely artistic in nature but
allow customizing the presentation to various environments and
requirements.

/S = SHOW mode, quick single image.
       This option gives a quick single panel of images and then
terminates automatically.  This is most useful when DAZZLE is to be
executed from other programs or batch files.  As of rev 4.0 the image
displayed is NOT the same one each time, this now allows normal
randomization of the program.

/E = EGA operation mode forced.
       Normally DAZZLE will automatically detect the video adapter
hardware attached and adjust itself to utilize the maximum resources

DAZZLE Revision 4.0                    page 3 of 6
Program, including source, and all related documentation Copyright

available.  If a VGA style adapter is detected then the display uses all
256 color palette registers for a far more subtle and interesting series
of displays.  This /E option allows VGA users to select and view the EGA
mode of operation.  NOTE: If VGA users wish to use an 'image capture'
type of program to extract the display into a file you must use either
the /E option or the /T option since these modes use standard BIOS
supported video modes.  The default VGA mode of DAZZLE uses a specially
enhanced 320x400x256 mode that has yet to be successfully captured by
any commercial product.  As of rev 4.0 this option, like the new /V
option, will prevent DAZZLE from aborting if it thinks that it has
detected an unacceptable video controller/monitor combination, though it
will still give it's usual error messages during startup.

/V = VGA operation mode forced.
       Normally DAZZLE will automatically detect the video adapter
hardware attached and adjust itself to utilize the maximum resources
available.  This option generally SHOULD NOT BE NECESSARY, NOR USED.  It
should be unable to cause any damage, but is intended for rare
compatibility conflicts where the startup code in DAZZLE falsely rejects
the video controller/monitor combination as unacceptable.  This option,
like the /E option, will allow the error messages to be reported (so
that you can write us of the problem), but will prevent the program from
aborting itself.  If the controller/monitor is really VGA compatible, or
really EGA compatible if using the /E option, then normal image
generation should be observed.  Unlike the /E option, this option has no
"artistic" usage or impact.

/T = TALL video aspect ratio mode.
       Normally the EGA mode of DAZZLE uses a 16 color 640x350
resolution display with a modified aspect ratio (screen is mapped as if
it had 640x700 resolution).   The default VGA mode uses 256 color
320x400 resolution.  The /T option causes the program to use the
standard BIOS supported screen resolution and aspect ratio in generating
all images.  The effect is slightly faster image generation, but with a
noticeably tall aspect ratio.  As of rev 4.0 this option is functional
with the VGA display mode.  This allows VGA images to be captured, or
converted to NTSC television video images for recording on video tape.
Note that due to VGA hardware limitations that using this option will
prevent the display of "dual page" effects (where a screen composed of a
different image than the one being displayed is 'panned' or 'scrolled'
onto the visible display area).

/F = FIXED colors instead of randomized.
       Normally DAZZLE will randomize the color palette registers
between each screen erase before starting the next image generation.
This allows all the possible colors (up to a quarter million on VGA) to
be used by the program.  This option forces the palette to an identical
state at all times.

 /A = ALTERNATE (faster) color cycling speed.
       The default color cycling mode is the slowest, with the most
subtle shadings and transitions.  This option increases the cycling rate
used in shaping the palette contents.  This effect is distinct from, but

DAZZLE Revision 4.0                    page 4 of 6
Program, including source, and all related documentation Copyright

can complement, the "+" and "-" keys that can be used while the program
is active.

/M = MAD (fastest) color cycling speed.
       This option not only greatly accelerates the color palette
contents rotation, but it also increases the number of image primitives
that can be displayed at one time before the screen is erased.  The
effect is a far busier screen, a more intense visual experience.  This
is particularly suited to attention getting in show-rooms and other
public displays, whereas the default mode is more practical for personal
meditation and relaxation.

/B = Bashful, no closing credits.
       DAZZLE will identify itself, including its revision level, when
the program is first initiated.  In most display modes this opening
identification will remain on the screen with a "Press any key" prompt
until the user makes some key entry (or about 30 seconds passes).  The
BASHFUL option will allow DAZZLE to start without requiring an extra
keystroke after only a 2 second delay.  This mode will also prevent
closing credits when the program terminates (similar to the SHOW
option), and additionally prevents DAZZLE from clearing the type-ahead
keyboard buffer when it exits.  This allows usage of DAZZLE in a more
classical 'Screen Saver' mode since whatever key is pressed to exit is
not lost.  This mode disables ALL key interpretation of DAZZLE, even the
"+" and the "-" keys will cause DAZZLE to terminate.  DAZZLE does not
(yet) initiate itself in a 'Screen Saver' fashion, but by using this
option it can be called from such a utility.


       While DAZZLE is actively displaying it's images (if not in
BASHFUL mode) the "+" and "-" keys can be used to adjust the color
palette cycling clock.  The console will 'beep' when either the maximum
or the minimum extreme is reached.  The TAB key can be used to FREEZE
any display pending another key press.  This is helpful for those that
wish to capture, photograph, or ponder the current image.  Note that the
TAB key has two possible effects.  When TAB is first pressed, all screen
activity is frozen, including color cycling.  At this point if any key
other than another TAB is pressed then DAZZLE beeps and resumes fully
normal activity.  If however, a second TAB is pressed, then color
cycling is resumed, but the image generation engine is still frozen.  In
this condition any key press, even another TAB, will simply beep and
resume fully normal activity.

       Most any other keypress during the display will terminate the
program.  There are some keys that have some harmless undocumented
effects on the display for various development testing (for example:
pressing the "H" key will HOLD the current display from fading until the
"N" key is pressed to start the NEXT display).  The use of either the
"Enter" or the "Escape" key will guarantee normal program termination.

       All reasonable effort has been made to assure that the use of
this program on any compatible computer system can have no detrimental
side effects.  In addition to extensive Quality Assurance testing, the

DAZZLE Revision 4.0                    page 5 of 6
Program, including source, and all related documentation Copyright

program contains an internal integrity check.  If some ill-willed person
attempts to attach any virus or other code modifications to this program
it probably will be detected and the program refuse to execute.  Any
such persons will be aggressively pursued and prosecuted.  Anyone
receiving this program and being unable to execute it should contact us
directly and provide information about where the defective copy was
acquired.  As of rev 4.0 the anti-viral system uses CRC checking instead
of the previous checksum algorithm.


       Programmers comments: DAZZLE is mostly written in Turbo C 2.0
(copyright Borland).  Recent attempts to use Turbo C++ 1.0 have seemed
successful, but quality assurance testing will not be quickly completed
due to the variations that need to be confirmed.  Assembler code was
used mostly due to two characteristic of DAZZLE; all image generation is
done a single pixel at a time, thus video write mode 2 was needed for
EGA speed, secondly the VGA mode uses the not-so-standard but highly
portable 320x400 mode instead of the normal BIOS supported 320x200 mode.
DAZZLE contains a few added tricks as well that reside both in C and
assembler.

       If you are a C programmer with interest in DAZZLE then please
write to us.  Not only is it possible to purchase source code, but we
are currently offering financial incentives for contributing authors.
We will be glad to provide full details if you send a Self Addressed
Stamped Envelope, or note your interest when you pay your registration
fee.


This program may be distributed AT NO CHARGE (excluding reasonable
distribution cost) as is.  All commercial rights retained by the author,
this program is released in executable form to the Public Domain.  This
program must not be altered in any way, and is offered without warranty,
as is, the only assurance to the user is that all reasonable effort has
been made to confirm that this program as released will produce no
undesirable or damaging effects on the executing computer.

Comments and inquires about updates, other versions, and other products
are welcome. Source can be purchased for some products. $10.00
registration payable to MicroTronics earns a free update and puts you on
our mailing list (be sure to mention the revision level of the copy of
DAZZLE that you have currently!).

Mailing address (1990) :
J.R.Shiflett's Midnight Visions Workshop
c/o MicroTronics
503 Shenandoah Drive
Spring, Tx USA 77381

DAZZLE Revision 4.0                    page 6 of 6
Program, including source, and all related documentation Copyright

Dazzle 4.2













                                DAZZLE



                             Users Manual









                    Documentation for Revision 4.2

                           15 November 1991





























                             MicroTronics

                             P.O.Box 8759

                       Spring, Tx USA 77387-8759





Please take the time to print and review this whole document as soon as

possible in your use of DAZZLE. The program is far more configurable and

flexible than it initially appears, and the great majority of questions

that arise are addressed herein.



James Russell Shiflett







1.     DAZZLE Overview  ...................................            1

2.     INTRODUCTION  ......................................            2

3.     SHAREWARE  .........................................            4

3.1     Usage Limitation  .................................            4

3.2     Revision Control  .................................            5

3.3     Current registration fee and discounts  ...........            5

3.4     Site Licenses  ....................................            6

3.5     OEM/VAR Licenses  .................................            6

3.6     Future Products  ..................................            6

3.7     Royalties  ........................................            6

3.8     Disclaimer   ......................................            6

3.9     Distribution Limitation  ..........................            7

4.     COMMAND LINE OPTIONS  ..............................            7

4.1     Main Options Menu  ................................            7

4.2     Additional Options Menu  ..........................            8

4.3     Specifying Options  ...............................            8

4.4     Compatibility Options  ............................            8

4.4.1    /2 = 2 part palette update.  .....................            8

4.4.2    /C = COMPATIBLE mode, use BIOS.  .................            9

4.4.3    /E = EGA operation mode forced.  .................            9

4.4.4    /K = Keyboard typematic unchanged.  ..............            9

4.4.5    /N = NO retract of hard disk heads.  .............           10

4.4.6    /V = VGA operation mode forced.  .................           10

4.4.7    /X = XT compatible mode, inferior but works.  ....           11

4.5     Artistic Options  .................................           11

4.5.1    /4 = Restrict the EGA mode to 4 colors.  .........           11

4.5.2    /A = ALTERNATE (faster) color cycling speed.  ....           11

4.5.3    /F = FIXED colors instead of randomized.  ........           11

4.5.4    /H = Hide EGA border.  ...........................           11

4.5.5    /M = MAD (fastest) color cycling speed.  .........           11

4.5.6    /S = SHOW mode, quick single image.  .............           12

4.5.7    /T = TALL video aspect ratio mode.  ..............           12

4.6     Other Options  ....................................           12

4.6.1    /B = Bashful, no closing credits.  ...............           12

4.6.2    /D = DEBUG mode, for use with debugger.  .........           12

4.6.3    /I = Insecure, no antiviral checking.  ...........           12

4.6.4    /Q = Quiet, no tones (no effect on beeps).  ......           13

4.6.5    /W = Window environment, changes defaults.  ......           13

4.6.6    /Z = Create DAZZLE.DOC file  .....................           13

4.7     Specifying the INPUTFILE  .........................           13

5.     ON-LINE HELP  ......................................           14

5.1     Cursor Keys within HELP  ..........................           14

5.2     Exiting HELP  .....................................           14

6.     LED Indications during DAZZLE  .....................           14

6.1     Scroll Lock LED  ..................................           14

6.2     Num Lock LED  .....................................           15

6.3     Cap Lock LED  .....................................           15

7.     PRIMARY DAZZLE MODES  ..............................           15

7.1     Selecting Modes  ..................................           15













Programs and all related documentation Copyright MicroTronics  page ii







8.     KEYS ACTIVE IN ALL MODES  ..........................           15

8.1     ESCAPE : Program Termination  .....................           16

8.2     TAB : Freeze Image  ...............................           16

8.3     "+" and "-" : Color Cycling Clock Adjustment  .....           16

8.4     Shf-F10 : Reinitialize the Color Palette  .........           16

8.5     The Fade Control keys  ............................           17

8.5.1    W : Wipe (curtain) fade  .........................           17

8.5.2    L : Linewipe fade  ...............................           17

8.5.3    X : heXagon fade  ................................           17

8.5.4    S : Starburst fade  ..............................           17

8.5.5    R : Rectangles fade  .............................           17

8.5.6    E : Exclusive-OR fade  ...........................           17

8.6     Special Fade Control keys  ........................           18

8.6.1    P : Pan/Scroll fade  .............................           18

8.6.2    H : Hold current display  ........................           18

8.6.3    N : Next display now  ............................           19

8.7     Mouse Clicks  .....................................           19

9.     KEYS ACTIVE IN "SEMI-AUTO" MODE  ...................           19

9.1     F8 : Toggle continuous drawing mode  ..............           19

9.2     F9 : Select Random Image  .........................           19

9.3     F10 : Draw Current Image  .........................           19

9.4     Alt-F10 : Reinitialize Current Algorithm  .........           20

9.5     Specific Image Selection Keys  ....................           20

10.    CONFIGURATION  .....................................           20

10.1    Cursor Keys within CONFIGURE  .....................           20

10.2    Exiting CONFIGURE  ................................           20

10.3    Image Size Control  ...............................           21

10.4    Fade Enable Control  ..............................           21

10.5    Auto Mode Display Customization  ..................           21

10.6    File Access Menu  .................................           22

10.6.1   Select Mode  .....................................           22

10.6.2   File Name  .......................................           22

10.6.3   Path  ............................................           22

10.6.4   F3 : View Disk Directory  ........................           23

10.6.5   F4 : Execute Save/Load  ..........................           23

11.    USAGE WITHIN WINDOWS  ..............................           23

12.    CONFIGURATION FILE FORMAT  .........................           24

12.1    Shift Key Tokens  .................................           24

12.2    Special Token  ....................................           24

12.3    Key ID  ...........................................           24

12.4    Configuration Value  ..............................           24

12.5    Comment Lines  ....................................           25

12.6    Version Flag  .....................................           25

13.    PROGRAM INTEGRITY  .................................           25

14.    PROGRAMMERS COMMENTS  ..............................           25

15.    THE MEANING OF LIFE  ...............................           26

16.    DAZZLE Distribution Authorization  .................           28

17.    EPILOGUE  ..........................................           29















Programs and all related documentation Copyright MicroTronics  page iii







1.                         DAZZLE Overview 

      version number: 4.2        document date: 15 November 1991



Requirements :

       Any PC/XT/AT computer, color EGA or VGA, MSDOS 2.x or higher,

Windows2.x and Windows3.x acceptable, no experience necessary.



       DAZZLE uses about 275KB of memory. DAZE uses about 80KB.



 Purpose:

       Graphics Display and Interactive Image Generation.



 Features:

       An award winning interactive color kaleidoscopic program that

provides many hours of changing visual viewscapes.  Performance art for

the eyes using over 30 drawing algorithms and an assortment of "fades"

and special effects to exercise a wide range of available display

techniques. Providing an entertaining excursion through the capabilities

of PC graphics technology. The non-interactive self generating mode is

an effective attention getter with a variety of uses; in trade shows, in

showrooms, in schools, ad infinitum.



Enhancements:



       R4.2 adds a new fade and image algorithm. New configuration menu

sets number of images in Auto mode.  Adds "/W" command line option for

easier use with Windows (not yet a windows application). Keyboard LED's

are used to indicate program state and progress. The "/Z" option creates

a DAZZLE.DOC file for the user, so it can't be lost!



       R4.1 introduced interactive control and configuration of the Auto

mode of operation, an on-line help system, and user toggle between self

generating "Auto" mode and interactive "Semi-Auto" mode. New color

palettes can be invoked for any image at any time. Antiviral check

bypass for faster program invocation. Compressed executable file size

using less disk space. Enhanced documentation.



       R4.1a added the "/K" command line option as part of a bug fix for

keyboard handling. R4.1b improved stability with SMARTDRV.SYS. R4.1c

improved MATHERR handler to prevent program aborts. R4.1f corrected for

use with QEMM and Windows3.0, and added the F8 key for continuous play

in Semi-Automatic mode.



























Programs and all related documentation Copyright MicroTronics  page 1







2.     INTRODUCTION 



       DAZZLE and DAZE are award winning self directing color pattern

generators for DOS computers with EGA or VGA compatible color displays

and adapters. Performance art for the eyes, and DAZZLE now supports

optional interactive control!



       A source of beauty; sometimes subtle, sometimes vibrant, always

changing. The image engine has over 30 primary image drawing algorithms,

most of which have at least two styles of presentation, many of which

have multiple internal drawing variations. There is also an assortment

of "fades", including split screens and pans, used by the imaging system

for greater diversity of presentation. The entire color range of the

detected video system is utilized for maximum variety and visual

stimulation.



       When the "Semi-Automatic" mode of DAZZLE is active, the user can

play the program from the keyboard. Specifically selecting each pattern

to draw, or letting the program select the pattern randomly. The

selected pattern is generated for as long as the user holds the draw

key. There are no limits on the mixing of image patterns. The user can

then invoke a specific fade effect, or let the program select an effect

randomly. The types of displays that can be generated in this fashion

are far more varied, and personal, than anything that "Auto" mode ever

produces.



       There is a configuration menu that allows the customization of

DAZZLE image generation. It also allows the selective disabling of

various fades. This configuration information can be written to an

editable text file, and either loaded again from the menu or loaded

automatically at program invocation by specifying the file name on the

DAZZLE command line.



       An on-line HELP text window system is included in DAZZLE.



       In the self generating "Auto" mode (the only mode supported by

DAZE), the primary image algorithms are mixed randomly on the screen.

Typically from 3 to 9 are overlaid at a time, producing a very large

assortment of possible displays. As of Rev. 4.2 this number of overlaid

images in Auto mode can be customized in the configuration menu. Each

display remains for a while to be appreciated, then the screen is

cleared via a fade algorithm, and another set of patterns is presented.

Mathematically speaking, an exact pattern match might not occur for many

days of continuous operation. Of course, human perception is far less

exacting and will discern repetition well ahead of these extremes, but

the general effect is still impressive. Note that the starting patterns

of the program will be different each time it is executed. If the

program seems predictable, exit it and start it over again.















Programs and all related documentation Copyright MicroTronics  page 2







       "PsL News" (713-524-6394) described DAZZLE as:



               ...the best kaleidoscope program we've seen yet.

               The beautiful use of colors, enhanced even

               further by the use of fading in and out, is, for

               want of a better word, awesome.



       DAZZLE has received many other good press reviews, and has been

awarded "Best New Graphics Program for 1990" (December 90 PsL News).

There have since been complimentary reports too numerous to repeat here,

my thanks to all who have been so supportive.



       Dazzle can be used in a variety of ways. At the office it keeps

the screen from being burned by constant display of an unchanging

prompt. Simply start the program when leaving your desk or answering the

phone or otherwise diverted. One option is to start Dazzle from a

keyboard locking program so that unauthorized access is prevented on

your unattended computer until you return. A program called DAZZLE.SYS

is under development for future release to registered users that

provides self-starting DOS Screen Saver mode (with Windows3.0

compatibility) and optional password protection.



       In reception areas, at trade shows, in showrooms, in waiting

rooms, in schools, in display windows, and other events where the desire

is to attract attention; use a faster cycling mode of Dazzle to peak

curiosity and draw visitors to your area. A program called DAZLOGO has

been released for customers that want their logo or other custom images

integrated into DAZZLE for regular presentation. DAZZLE also can be

invoked from within your presentation software (see the "/S" and "/B"

command line options) for an extra touch of pizzazz.



       Dazzle can be used to aid relaxation. In its slower cycling VGA

modes (where this program REALLY shines) it is often soothing and helps

one to shift conscious attention from the cares of the day. Various

university and medical studies conducted on volunteers watching DAZZLE

document a reduction of blood-pressure, general relaxation, and

heightened alpha states in the brain. When overwhelmed with problems or

pressures, it is often true that shifting one's focus from an immediate

concern allows the objectivity needed to enhance decision making and

settle the nerves.



       DAZZLE is a performing art tool for the eyes. Used with your

favorite music Dazzle can be highly entertaining and regenerating. The

MIDI control and full manual image control options are still under

development (we plan to offer these to Registered Users only), but even

in its current random play mode it is great "living" mobile art. An

internal test version of DAZZLE that plays music files via the Sound

Blaster card (Creative Labs, Inc.) suggest new avenues of application

for both business and pleasure. Capture stills, record it on your VCR,

use the images as backgrounds for your slide presentations, or play it

live with your band. Applications are boundless.



       DAZE is a REDUCED size and functionality derivative of DAZZLE





Programs and all related documentation Copyright MicroTronics  page 3







that is intended for use as a window task, or a pattern generator that

can be called from programs with insufficient memory to load the full

DAZZLE program.



3.     SHAREWARE 



       Shareware is a brave concept in software marketing that allows

you to "try before you buy." Shareware authors retain all rights under

their copyright, but allow free distribution of their programs.

Distributors of shareware--including online BBS and catalog outlets-

-usually do not charge for the shareware software itself. The

distributors are charging for their own services in providing access to

their resources. Registration payment directly to the author entitles

the user to additional services, information, and newer products. It is

a great deal for users, authors, and distributors alike. Please support

this honor system marketing technique so that more great programs of

increasingly professional quality can reasonably be provided via this

system.



       Copyright laws apply to both shareware and commercial software,

and the copyright holder retains all rights, with a few specific

exceptions clearly stated by the author. Shareware authors are

accomplished programmers, just like commercial authors, and the programs

are of comparable quality--in both cases there are good programs and bad

ones! The main difference is in the method of distribution. The

shareware author specifically grants the right to copy and distribute

the software to all, except that MicroTronics requires that written

permission be acquired before a commercial disk vendor may copy or

distribute our products.



       Shareware is a distribution method, not a type of software. You

should find software that suits your needs and pocketbook, whether it's

commercial or shareware. The shareware system makes fitting your needs

easier, because you can try before you buy. And because the overhead is

low, prices are low also. Shareware has the ultimate money-back

guarantee--if you don't use the product, you don't pay for it.



       You are encouraged to pass a copy of DAZZLE along to your friends

for evaluation, but please do not give it away altered or as part of

another system. Please encourage them to register their copy if they

find that they can use it.



3.1     Usage Limitation 



       Please note that this program is NOT FREE. You are entitled to

use it for evaluation over a short time (no more than 30 days) to

determine if it functions adequately for your needs, after which time a

registration fee paid directly to MicroTronics is required by copyright

law, and greatly appreciated by all of us. Any distribution or online

fee paid by you to copy DAZZLE is (usually) not forwarded to

MicroTronics by the distributor, and therefore would not constitute

payment of a registration fee.







Programs and all related documentation Copyright MicroTronics  page 4







3.2     Revision Control 



       MicroTronics is NOT responsible for revision control of DAZZLE

through any source other than direct mailings from our office. If you

request a copy from any other source please be certain of the revision

level that you are acquiring, and that it contains all related files and

documentation.



       Your registration fee for DAZZLE or DAZE entitles you to 1 free

disk copy update of DAZZLE from us within the first year--at your

option. It is assumed that all payments are registrations of existing

copies, so disk are not automatically mailed unless the request for

"order" or "update disk" is clearly identified in the letter. Many users

prefer to retain their update option until the next newer release is

available. PLEASE specify your floppy disk format when writing. Once you

have received your free disk when you exercise your update option,

additional disk updates are available at a reduced fee. Names on our

PRIVATE mailing list are never shared with others, and will be

maintained for at least 1 year from last contact unless materials are

returned without forwarding address.



3.3     Current registration fee and discounts 



       The registration fee for this version of DAZZLE is $15 ($20US for

customers outside the continental U.S.A. please). For those that wish to

buy multiple registrations of the unmodified shareware product the

following discounts are currently allowed:



Copies 1 through 3

       Registration cost $15 each ($20US foreign)



Copies 4 through 8

       Additional cost $12 each ($17US foreign)



Copies 9 or more

       Additional cost $7 each ($12US foreign)



Thus 12 copies would cost $133.00 (3x$15 + 5x$12 + 4x$7). Discounts may

be discontinued without prior notice. Multiple registrations make for a

great gift idea to your computer using friends, and are wonderful around

the office. This pricing is for independent registrations of multiple

program copies. MicroTronics will provide a disk and documentation for

each copy thus registered, and put the recipient of each copy on our

mailing list.



       A single registration fee will license one copy for use on any

one computer at any one time.  You must treat this software just like a

book.  An example is that this software may be used by any number of

people and may be freely moved from one computer location to another, so

long as there is no possibility of it being used at one location while

it's being used at another. Just as a book cannot be read by two

different persons at the same time.







Programs and all related documentation Copyright MicroTronics  page 5







3.4     Site Licenses 



       Also available are SITE LICENSES.  The licensee receives one

"master" copy of the program and all related documentation, additional

master copies of disk and/or documentation available for an extra

charge. These may be copied by the licensee for multiple users at the

designated location (site) up to the number of licensed copies. The

current offer is that $15 is paid for the master copy supplied from us,

and you pay $5 for each additional copy that you make (subject to the

terms of the Site License agreement). The number of authorized copies

can be automatically extended by simply submitting the additional funds

with a note referencing the original site license.



3.5     OEM/VAR Licenses 



       Multi-copy OEM/VAR licenses are available at a reduced cost for

developers that wish to incorporate DAZZLE into their own product for

resale. There is also an open-ended license that allows unlimited copies

to be distributed for a single one-time fee. These licenses include

priority telephone support and free extended period product upgrades for

the licensee. 



3.6     Future Products 



       A new derivative non-shareware product called DAZLOGO allows

commercial clients to incorporate their own logo or other artwork for

regular presentation by the DAZZLE display for trade shows, waiting

rooms, promotional gifts, and other uses. Write us for details.



       Another derivative product soon to be released is DAZTUTOR. This

allows users to experience a revolutionary Psycho-Ergonomic(tm) stress-

less computer aided memorization technique. Commit information to memory

during a high-alpha state of relaxation without the duress and

distraction associated with other memorization environments.



       The rapid success of DAZZLE as shareware has prompted us to

expand our resources and dedication to this marketplace. We have a

number of interesting projects in the works to reward registered users

for their faithfulness. 



3.7     Royalties 



       All commercial rights to this program are retained by the author,

but revenue derived from the images captured or photographed or in any

way derived from DAZZLE or DAZE are free from any royalty, fee, or other

claims by the author AS LONG AS credit for, and address of, MicroTronics

is prominently displayed in the distributed work and/or documentation.



3.8     Disclaimer  



       Users of DAZZLE and related products must accept this disclaimer

of warranty: "DAZZLE and DAZE are supplied for non-exclusive usage as

is.  The author disclaims all warranties, expressed or implied,





Programs and all related documentation Copyright MicroTronics  page 6







including, without limitation, the warranties of merchantability and of

fitness for any purpose. The author assumes no liability for damages,

direct or consequential, which may result from the use of these

programs."



3.9     Distribution Limitation 



       Anyone distributing DAZZLE for any kind of remuneration must

first contact MicroTronics for authorization, use of the Distribution

Authorization form below is recommended. This authorization will be

automatically granted to distributors recognized by the (ASP) as

adhering to its guidelines for shareware distributors, and such

distributors may begin offering DAZZLE immediately (however MicroTronics

must still be advised).



4.     COMMAND LINE OPTIONS 



       A number of options that control the action of the DAZZLE family

of programs can be specified on the command line when the program is

invoked, or can be encoded into a batch file for easy activation.



4.1     Main Options Menu 



       When you enter the command "DAZZLE -?" at the DOS prompt you will

be presented with the following display. Most of these commands are also

available with the DAZE program.



Usage: DAZZLE -options /options inputfile

       -~ = show more command line options.

       -2 = 2 part palette update to fix flickering screens (slower).

       -a = ALTERNATE (faster) color cycling speed.

       -b = Bashful, no closing credits.

       -c = COMPATIBLE mode, use BIOS for better portability.

       -i = Insecure, no antiviral checking.

       -m = MAD (fastest) color cycling speed.

       -n = NO retract of hard disk heads.

       -q = Quiet, no tones (no effect on beeps).

       -s = SHOW mode, quick single image.

       -w = Window environment, changes some defaults.

       -x = XT compatible, inferior but works.

       -z = Create DAZZLE.DOC file on current disk path!



During the display the "+" and "-" keys can be used to control color

cycling speed. The TAB key will FREEZE the display till SPACE is

pressed. F1 activates on-line help during the program. F2 provides a

configuration menu. ESCAPE terminates the program.



       If you are using the DAZE or DAZLOGO programs this display will

have subtle but significant differences.













Programs and all related documentation Copyright MicroTronics  page 7







4.2     Additional Options Menu 



       When you enter the command "DAZZLE -~" at the DOS prompt you will

be presented with the following display. Most of these commands are also

available with the DAZE program.



Usage: DAZZLE -options /options inputfile



       -e = EGA operation mode forced.

       -h = Hide EGA border.

       -k = Keyboard typematic unchanged.

       -t = TALL video aspect ratio mode.

       -v = VGA operation mode forced.



=-=-=-= limited use command line options =-=-=-=



       -4 = Restrict the EGA mode to 4 colors.

       -d = DEBUG mode, for use with debugger.

       -f = FIXED colors instead of randomized.



Additional information (cv, r1, r2) will be presented in this display by

the DAZZLE program only.



4.3     Specifying Options 



       The DAZZLE program accepts any combination of options on the

initial command line that affect its mode of operation. The options can

be preceded with either the "/" (slash) character or the "-" (minus)

character. At least one space must exist between the DAZZLE command and

the first option. For example: "DAZZLE -FN" instructs DAZZLE to execute

with Fixed colors and No retract of the hard disk drive heads. The

options are not case sensitive--upper and lower case letters are treated

identically. The options can be concatenated into a single string (like:

-FN), or can be entered separately (like: -F -N), the effect is the

same. The optional inputfile can be specified anywhere on the command

line. For example: "DAZZLE -I DAZZLE.DZL" has the same effect as "DAZZLE

DAZZLE.DZL -I", which is to tell DAZZLE to startup in the insecure mode,

and to load configuration file DAZZLE.DZL prior to starting the image

generation process. The effects of each option are detailed below.



4.4     Compatibility Options 



       Seven of the options for DAZZLE are specifically related to

increasing portability of the program to various computers and displays.

The "2", "c", "e", "k", "n", "v", and "x" options default to the most

desirable modes, but can be controlled by the user. VGA users also

should refer to the "t" option for details.



4.4.1    /2 = 2 part palette update. 

       Normally the entire color palette is updated at one time for each

tick of the color cycling clock. If the CPU clock speed or the VGA

palette register update rate is too slow, the upper part, or perhaps all

of the display, will flicker badly during the display. To determine if





Programs and all related documentation Copyright MicroTronics  page 8







this is due to palette updates, press and hold the "-" (minus) key

during the running graphics display until it beeps (this is the slowest

cycling clock rate). If the display flickers only when the color

changes, then palette update speed is a problem. Using the "2" option

splits the VGA palette update request into two almost equal groups that

are handled sequentially. This should remove, or at least significantly

reduce, cycling induced flicker. This option should not be used if not

needed, as it slows the entire display generation process. This option

affects operation with VGA adapters only, since they allow longer 256

color palettes. Short 16 color palettes for EGA's are never divided into

two separate updates.



4.4.2    /C = COMPATIBLE mode, use BIOS. 

       Normally DAZZLE bypasses the video adapters BIOS code for maximum

speed in color palette cycling. However, some adapters can have problems

with this mode of operation. To cause DAZZLE to use the provided BIOS

the "C" option can be used. If your display flickers or distorts, or the

color fails to cycle smoothly during the display, then try this option

to determine if it corrects the problem. As of Rev. 3.9g this option

also affects the EGA operational mode. This was needed by some VGA

adapters when DAZZLE was operated in the forced EGA mode. This option

reduces program performance speed and should not be used if not needed.



4.4.3    /E = EGA operation mode forced. 

       Normally DAZZLE will automatically detect the video adapter

hardware attached and adjust itself to use either the EGA or the VGA

mode. This "/E" option allows VGA users to select and view the EGA mode

of operation, which is 640x350x16 in format. As of revision 4.0 this

option, like the "/V" option, will prevent DAZZLE from aborting if it

thinks that it has detected an unacceptable video controller/monitor

combination, though it will still give its usual error messages during

startup. Refer to the "/V" option below for more information.



4.4.4    /K = Keyboard typematic unchanged. 

       Revision 4.1a contains enhancements to make the program largely

immune to some "keyboard acceleration" utilities that exist. These

utilities cause the self-repeating "typematic" function of the keyboard

to function far more rapidly. They come in two flavors:

* Those that tell the keyboard to send keys more often.

* Those that trick DOS into thinking that more keys arrive than actually

are sent by the keyboard.



       The latter of these types proved to be able to trash the keyboard

interfacing of prior versions of DAZZLE because of their "slight of

hand" tactics. This revision is now more able to withstand this attack.



       The former of these types is less of a problem, but is capable of

drastically reducing the performance of DAZZLE on computers with slower

CPU clocks.



       Without specifying this command line option, DAZZLE will set the

"typematic" rate of the keyboard to it's minimum value for best program

performance. When DAZZLE terminates it puts the "typematic" speed back





Programs and all related documentation Copyright MicroTronics  page 9







to a value typical of most DOS defaults, unfortunately I am not aware of

a way to test the setting before changing it. Those that use a keyboard

speed-up utility that stops having an effect after DAZZLE has been

executed have the first type of such a utility, which I believe is the

better of the two. If you want the keys back to their quicker speed you

can re-execute your speed-up command. If you find this unacceptable then

use this command line option to force DAZZLE to keep from changing the

"typematic" rate of the keyboard, if you must. The "/S" , "/W", and the

"/B" options automatically disable changing of the typematic rate.



       It is possible that some utilities that expand the size of the

typeahead buffer might cause some problems for DAZZLE, but there have

been no problems reported as of this writing.



4.4.5    /N = NO retract of hard disk heads. 

       Since the DAZZLE display is often allowed to run for hours, the

hard disk heads are normally parked into a safe power-down position (as

determined by the BIOS in your specific computer) as a precaution in

case electrical power is lost, or the computer powered down while DAZZLE

is active. This process has no effect on the image generation

performance of DAZZLE, but if your drive controller is highly

nonstandard it might cause DAZZLE to fail to start. Some disk drives

make a really nasty sound when they are next accessed after they have

been parked. While this is not an error, nor technically a cause for

concern, it sure can upset someone not sure of what is happening. The

user can issue this option to prevent any attempt to park the hard disk

heads. If you have any reason to doubt the safety of using the head

parking feature with your computer/drive combination then please always

use this command line option.



4.4.6    /V = VGA operation mode forced. 

       Normally DAZZLE will automatically detect the video adapter

hardware attached and adjust itself to use either the EGA or the VGA

mode. This option generally SHOULD NOT BE NECESSARY, OR USED. It should

be unable to cause any damage, but is intended for rare compatibility

conflicts where the startup code in DAZZLE falsely rejects the video

controller/monitor combination as unacceptable. This option, like the

"/E" option, will allow the error messages to be reported (so that you

can write us of the problem), but will prevent the program from aborting

itself. If the controller/monitor is really VGA compatible, or really

EGA compatible if using the "/E" option, then normal image generation

should be observed. Unlike the "/E" option, this option lacks artistic

usage or impact. The VGA mode uses all 256 color palette registers for a

far more subtle and interesting series of displays. NOTE: If VGA users

wish to use an image capture type program to extract the display into a

file, you should use either the "/E" option or the "/T" option, since

these modes use standard BIOS supported video modes. The default VGA

mode of DAZZLE uses a specially enhanced 320x400x256 mode that is not

properly captured by most commercial products. Both VGA modes require no

more than 256kB of video memory.











Programs and all related documentation Copyright MicroTronics  page 10







4.4.7    /X = XT compatible mode, inferior but works. 

       This option should allow DAZZLE to execute on 8088 or 8086 based

PC/XT type computers with EGA or VGA adaptors and color displays. This

option will be automatically initiated if the 808x style CPU is detected

at program startup, but specifying the command line option avoids the

warning message. The EGA performance on XT computers seems acceptable,

but the VGA mode may be noticeably inferior to the performance of an

80x86 based computer. The faster the CPU clock the better the overall

performance and fluidity of DAZZLE.



4.5     Artistic Options 



       These options adjust the image generating algorithms used by the

program. They are largely artistic in nature but allow customizing the

presentation to various environments and requirements.



4.5.1    /4 = Restrict the EGA mode to 4 colors. 

       The default EGA mode will use the full complement of available

colors for the display. Using this option restricts the display to only

4 simultaneous colors at one time. This is used when the output from

DAZZLE will be directed to another system that does not support more

than 4 colors (like automated weaving or embossing machines).



4.5.2    /A = ALTERNATE (faster) color cycling speed. 

       The default color cycling mode is the slowest, with the most

subtle shadings and transitions. This option increases the cycling rate

used in shaping the palette contents. This effect is distinct from, but

can complement, the "+" and "-" keys that can be used while the program

is active.



4.5.3    /F = FIXED colors instead of randomized. 

       Normally DAZZLE will randomize the color palette registers

between each screen erase before starting the next image generation.

This allows all the possible colors (up to a quarter million on VGA) to

be used by the program. This option forces the palette to an identical

state at all times.



4.5.4    /H = Hide EGA border. 

       Some folks find the colored border on the EGA display

distracting, and some displays do not perform retrace masking properly.

This option will cause the border color in EGA modes to be forced to

black at all times.



4.5.5    /M = MAD (fastest) color cycling speed. 

       This option not only greatly accelerates the color palette

contents rotation, but it also increases the number of image primitives

that can be displayed in "Auto" mode at one time before the screen is

erased. The effect is a far busier screen, a more intense visual

experience. This is particularly suited to attention-getting in

showrooms and other public displays, whereas the default mode is more

practical for personal meditation and relaxation.









Programs and all related documentation Copyright MicroTronics  page 11







4.5.6    /S = SHOW mode, quick single image. 

       This option gives a single panel of images and then terminates

automatically. This is most useful when DAZZLE is to be executed from

within other programs or batch files. As of revision 4.0 the image

displayed is different each time.



4.5.7    /T = TALL video aspect ratio mode. 

       Normally the EGA mode of DAZZLE uses a 16 color 640x350

resolution display with a modified aspect ratio (screen is mapped as if

it had 640x700 resolution). The default VGA mode uses 256 color 320x400

resolution. The "/T" option causes the program to use the standard BIOS

supported screen resolution and aspect ratio in generating all images.

The effect is somewhat faster image generation, but with a noticeably

tall aspect ratio. As of revision 4.0 this option is functional with the

VGA display mode, and causes it to use the BIOS supported 320x200 video

mode. This allows VGA images to be captured, or converted to NTSC

television video images for recording on video tape. Note that due to

VGA hardware limitations, using this option will prevent the display of

"dual page" effects (where a screen composed of a different image than

the one being displayed is "panned" or "scrolled" onto the visible

display area).



4.6     Other Options 



4.6.1    /B = Bashful, no closing credits. 

       DAZZLE will identify itself, including its revision level, when

the program is started. The BASHFUL option will prevent closing credits

when the program terminates (similar to the SHOW option), and

additionally prevents DAZZLE from clearing the typeahead keyboard buffer

when it exits. This allows usage of DAZZLE in a more classical "Screen

Saver" mode, since whatever key is pressed to exit is not lost. This

mode disables ALL key interpretation of DAZZLE. Even the "+" and the "-"

keys will cause DAZZLE to terminate. DAZZLE does not (yet) initiate

itself in a "Screen Saver" fashion under DOS, but by using this option

it can be called from such a utility. This mode blocks the use of the

keyboard LED's to indicate the state condition of the executing DAZZLE

program. DAZZLE has been successfully used within MS/Windows (copyright

Microsoft), but use of this option will prevent window selection

keystrokes. Use of the command line option "/W" was added in R4.2 for

the windows environment as detailed below.



4.6.2    /D = DEBUG mode, for use with debugger. 

       This has no value for the general user. It is used for

development purposes. It changes the operation of the program

significantly and should not be used.



4.6.3    /I = Insecure, no antiviral checking. 

       Before starting the image display process DAZZLE will normally

perform a test on the disk copy of itself in an attempt to assure that

no unauthorized modifications ("hacks") have been made to the program

after it was distributed from MicroTronics. This is a safety feature

added for YOUR protection! Please note that this is not a system wide

scan for virus infection--only the current disk copy of the DAZZLE.EXE





Programs and all related documentation Copyright MicroTronics  page 12







file is checked. Once you have used your copy of DAZZLE, after it has

passed its antiviral test and you no longer wish to endure the delay at

every invocation for this testing, you can use this command line option

to bypass this safety feature. IF YOUR COPY OF DAZZLE FAILS THIS TEST,

PLEASE NEVER USE THIS OPTION! INSTEAD WRITE TO US, AND TO THE SUPPLIER

THAT GAVE YOU THE BAD COPY, AND LET US KNOW! A clean copy can be in your

hands in a very short time, and might save your entire software

investment (NOTE: MicroTronics only supplies disk to registered users).



4.6.4    /Q = Quiet, no tones (no effect on beeps). 

       This option will block the tones that DAZZLE emits at various

points in its operations. But warning beeps are generally not

restricted. As of revision 4.1, DAZZLE uses programmed tones for most

alerts and signals that it issues. These tones are of short duration,

and change pitch depending on the condition being signaled. With the

increase in operational options these tones are very helpful in

determining the state the program is in. The one place where these tones

are superfluous is the tiny tune in the closing credits, but this tune

can be aborted with any keypress.



4.6.5    /W = Window environment, changes defaults. 

       This option was added to simplify use of DAZZLE within MS/Windows

environments. It prevents the startup antiviral check (please see the

"/I" option for a discussion of the risk involved), disk head parking,

and all startup messages. This mode blocks the use of the keyboard LED's

to indicate the state condition of the executing DAZZLE program. It

allows normal "switch" key commands to Windows for task switching.

DAZZLE will still show the closing credits graphic image, but not the

closing text messages. A true Windows3.0 version of DAZZLE may be in the

works for the not-too-distant future.



4.6.6    /Z = Create DAZZLE.DOC file 

       A number of users have complained about losing the DAZZLE.DOC

documentation of the Users Manual, or never having received it from the

distributor or BBS.  As of R4.2 DAZZLE now keeps the entire Users Manual

within itself in an efficient manner that has minimal impact on total

usage of the program. By specifying this option DAZZLE will create a new

DAZZLE.DOC Users Manual file on your current default disk directory,

which you can then print or otherwise review.



4.7     Specifying the INPUTFILE 



       As of revision 4.1, DAZZLE can accept the optional specification

of an input file on the command line. This file must contain a text

script that is consistent with the program's language specification. The

specification of a path as well as a filename is acceptable. If the file

cannot be found DAZZLE will abort. Be sure to separate the file name

from options with at least one space.















Programs and all related documentation Copyright MicroTronics  page 13







5.     ON-LINE HELP 



       As of revision 4.1, DAZZLE now supports an on-line help menu

system. You may press the "F1" function key to activate the help

subsystem. This system is intentionally limited in size and scope to

keep the program from growing too large, but it offers useful summaries

of the newest and most pertinent features of DAZZLE. At this time the

graphics screen that was being displayed when help is activated is

erased when help is exited.



5.1     Cursor Keys within HELP 



       When within the help subsystem DAZZLE recognizes the various

standard cursor keys. The "HOME" key jumps to the first page of help

text. The "END" key jumps to the last page of help text. The "PgDn" key

advances to the next page of help text, the "PgUp" returns to the

previous page. The arrow keys also can be used. Note that the bottom

right of the text window shows what page movement keys are valid at that

point.



5.2     Exiting HELP 



       The text menu subsystems, including the help system, can be

exited by pressing the same key that invokes that subsystem. Thus to

exit help press the "F1" key again.



6.     LED Indications during DAZZLE 



       As of R4.2 the DAZZLE family of programs control the lighting of

the Num Lock, Cap Lock, and Scroll Lock LED's (Light Emitting Diodes) on

the keyboard to indicate to the user the state of the program as it

moves through the various conditions or "states" in normal operation.

These LED's (or lights) can be on, off, or blink; each represents a

different condition as detailed below. Note that use of the "/W" or the

"/B" command line options prevent the DAZZLE program from changing the

keyboard LED indicators.



6.1     Scroll Lock LED 



       This light indicates 1 of 3 possible conditions for the program. 

1) When off, the program is not in any pause state, something is

actively being computed or displayed.  



2) When blinking, the program is in an active countdown of a normal

pause delay. When the delay expires the program will proceed to the next

action without any need for user intervention.



3) When on, the program is halted in a pause state, and will not proceed

until the user takes some action.  This can be induced by pressing

either the "TAB" key or the "H" fade key.  Refer to the details

elsewhere for these specific keys to understand how to release the

program from this state. This condition also occurs when any text menu







Programs and all related documentation Copyright MicroTronics  page 14







is on the display, use the specified menu exit command to restore normal

program execution.



6.2     Num Lock LED 



       This light indicates that the program is either computing or

displaying a "Pan/Scroll Fade" process.  If no activity is visible on

the screen then the program is building a new image on the "hidden"

display so that it can be moved onto the active or "visible" display

area.  Refer to the "P" fade key for additional details.



6.3     Cap Lock LED 



       This light indicates that the program is computing a new VGA

color palette to use on the active display. The duration of this period

is directly dependent on the math speed of your computer. This

indication was added to inform users when their program seems halted

that valid computations are progressing unseen within the system. Refer

to the "Shift-F10" key description for additional details.



7.     PRIMARY DAZZLE MODES 



       As of revision 4.1, DAZZLE now has two primary modes of

operation. The original "Automatic" (a.k.a. "Auto") mode, which is fully

self generating; and a new "Semi-Automatic" (a.k.a. "Semi-Auto") mode,

which allows interactive control of the image generation process. Some

keys are only effective in the "Semi-Automatic" mode, others are active

at all times.



7.1     Selecting Modes 



       Selection between these two modes is done by pressing the "ALT"

(Alternate) key and the "F9" function key. This combination is referred

to as "Alt-F9" for short. At program startup DAZZLE is always in "Auto"

mode.



       To enter "Semi-Auto" mode press "Alt-F9". There is a short high

pitched tone. The display is cleared. The palette is reinitialized to a

new setting (this may take a few seconds on a slow VGA machine). Then a

short multi-tone chirp is emitted to indicate that "Semi-Auto" is ready

for image drawing commands.



       To return to "Auto" mode press "Alt-F9". There is a short lower

pitched tone. The display is cleared. The palette is reinitialized to a

new setting. Then the self generating engine begins creating random

image displays.



8.     KEYS ACTIVE IN ALL MODES 



       Some key commands that DAZZLE recognizes are active regardless of

the current display mode. The meaning of some keys change slightly

depending on the current display mode.







Programs and all related documentation Copyright MicroTronics  page 15







8.1     ESCAPE : Program Termination 



       There is an old adage, "The first and most important thing to

learn about any program is how to get out of it." This key will do the

job for you regardless of where you are in the program, just keep

banging it till you get back to the DOS prompt. Note that when not in

the various text menu screens, that "ENTER" also will terminate the

program.



8.2     TAB : Freeze Image 



       The "TAB" key can be pressed at any time when not in a text menu

to "freeze" the current graphics image display. Once pressed, DAZZLE

will remain in "freeze" mode until the "SPACE" key is pressed (the "n"

key will also work since R4.1b). While in "freeze" mode, the "TAB" can

be repeatedly pressed to toggle between color-cycling and color-static

modes. The "Shift-F10" key can be used to change the palette of an image

in "freeze" mode. This is most useful in stabilizing a specific display

for image capture programs or screen photography. Even an image in the

midst of a fade or pan can be put into "freeze" mode. This key is also

active in the "Semi-Automatic" mode, though here its usefulness is

limited to halting a fade in mid-execution.



       As of R4.2 the Scroll Lock LED on the keyboard will be

continuously lighted to indicate that "freeze" is active. Refer to the

section on Scroll Lock LED above for more details.



8.3     "+" and "-" : Color Cycling Clock Adjustment 



       The fluid changing of DAZZLE images is largely the result of a

clock driven rotation of the display's color palette. The user can

adjust the rate of this clock at any time by using the "-" (minus) key

or the "+" (plus) key. Pressing "-" reduces the clock rate, pressing "+"

increases the clock rate. Note that DAZZLE defaults to maximum speed in

VGA modes, and almost maximum rate in EGA modes. When either the maximum

or the minimum clock rate is reached the console emits a short tone.

This process is distinct from, yet can complement, the palette control

command line options (see descriptions for "/A" and "/M" options above).



8.4     Shf-F10 : Reinitialize the Color Palette 



       Pressing the "SHIFT" key and also the "F10" function key

simultaneously, called "Shf-F10" for short, causes the current color

palette of the display to be reinitialized to a new random condition.

There is a short tone at the start of the request, and another tone when

the process is completed. In EGA modes the process is almost

instantaneous. In VGA modes it can take up to a few seconds, and the Cap

Lock LED will light while the new palette is being computed. Refer to

the Cap Lock LED description for further details.













Programs and all related documentation Copyright MicroTronics  page 16







8.5     The Fade Control keys 



       DAZZLE allows the user to select which fades will be used. The

actions of these keys vary slightly depending on the current mode. In

"Auto" mode, pressing one of the fade keys sets which fade will be used

next but allows the normal image generation process to continue. In the

"Semi-Automatic" mode the fade keys induce the selected fade

immediately.



       The following entries show which key (without the "Alt", "Ctrl",

or "Shift" keys being used) can be pressed to select a specific fade

algorithm, and a description of the fade induced.



8.5.1    W : Wipe (curtain) fade 



       Vertical or horizontal curtain wipe. Sometimes in color,

sometimes to black.



8.5.2    L : Linewipe fade 



       This selects a straight line drawing algorithm that uses random

deltas on the X and Y coordinates to produce some really interesting and

convoluted weavings of lines. This pattern can come up in unsymmetric

mode--a single row of lines moving around--or in four sided or eight

sided symmetry. Like many fades, it can be in solid color mode, or may

come up in exclusive-OR mode. This latter mode moves a "ghost" of the

image through the display, and creates complex mosaic texturing. The

modes that will be used at any time are randomly selected.



8.5.3    X : heXagon fade 



       This one is a basic six sided shape that burst from the center of

the screen. Some of its sides are transparent, some are solid. This fade

can use the exclusive-OR mode, which can be really pleasing.



8.5.4    S : Starburst fade 



       This one was a direct result of watching "Star Trek" and "Star

Trek: The Next Generation" (copyright Paramount) one too many times. The

stars in the burst can have long or short tails. This fade will

sometimes be invoked by the Hexagon fade, just because they seem to look

nice together.



8.5.5    R : Rectangles fade 



       This selects a series of rectangles that are rotated on an axis

in the center of the screen. The rectangles grow as they spin.



8.5.6    E : Exclusive-OR fade 



       While some other fades, and most image generating algorithms, can

use the exclusive-OR technique (a computer term for a mathematical

process, don't fret if it's greek to you) to produce "ghost" or mosaic





Programs and all related documentation Copyright MicroTronics  page 17







images, this fade does this every time. It just builds a rectangle

around the virtual screen in memory and moves it into the center of the

screen. Note that many shapes within the effected area have the

direction of their color motion reversed when this effect passes over

them.



8.6     Special Fade Control keys 



       The following behave a little differently, so they have been set

aside for special discussion.



8.6.1    P : Pan/Scroll fade 



       Unlike the previous fade keys, this one has to be pressed at a

certain time to have any effect in the "Automatic" mode. When DAZZLE is

drawing in "Auto" mode it is in the "Auto Daze" state (no LED's are lit,

see details above about LED usage). Once the last image has been drawn

it switches to the "Fade Out" state (the Scroll Lock LED is lit). The

first thing this latter state usually does is just pause for a while so

that you can appreciate the incredible beauty of the display. The "P"

key is only recognized in "Auto" mode if pressed while still in the

"Auto Daze" state (before Scroll Lock lights). Once the last image has

been drawn and the pause delay starts this key will simply be ignored.



       If a Pan/Scroll is in progress as indicated by the lighting of

the Num Lock LED, then pressing the "P" key will assure that both a pan

and also a scroll are presented.



       In the "Semi-Automatic" mode this key will not induce a

Pan/Scroll. Since that effect is not supported in the "Semi-Auto" mode,

pressing "P" causes one of the other fades to be randomly selected and

executed immediately.



8.6.2    H : Hold current display 



       This is distinct from, yet similar to, the "freeze" command that

is called with the "TAB" key. This key is simply ignored in the "Semi-

Auto" mode. In the "Auto" mode it lets the "Auto Daze" state (refer to

Pan/Scroll description above) continue to normal completion, and will

even let a Pan/Scroll proceed normally if one happens to have been

selected by the "Fade Out" state. But it causes the "Fade Out" state to

jam in the pause delay mode forever. Here the program will wait until

you manually select a fade. Note that the fade that you select will

commence immediately. The Scroll Lock LED will light solidly, indicating

that user intervention is required to allow the program to proceed

normally. Refer to the Scroll Lock LED description above for more

details.



       If you press "H" as soon at DAZZLE enters the pause delay mode,

then any fade select key, the delay is effectively canceled--allowing

you to immediately induce any fade you wish.









Programs and all related documentation Copyright MicroTronics  page 18







8.6.3    N : Next display now 



       This key has been made immediately effective in all modes. It

stops any current image generation or fade, and begins a screen clear

process. This is the fastest way to blank the screen.



8.7     Mouse Clicks 



       As of revision 4.0c DAZZLE will test for the presence of a

Microsoft compatible Mouse driver. If any mouse button is pressed (or if

the screen is contacted when using a Touch Screen system that is

Microsoft Mouse compatible) DAZZLE will usually interpret that action as

being the same as pressing the "ENTER" key. Note that in the text menu

subsystem of this current version a mouse click aborts the program.



9.     KEYS ACTIVE IN "SEMI-AUTO" MODE 



       As of revision 4.1, DAZZLE supports a whole set of commands to

allow the user to control the image generation process of the program.

Refer to "Selecting Modes" above for details on accessing the "Semi-

Automatic" mode. Note that configuration options that disable a fade

cause that fade to be unavailable in the "Semi-Auto" mode also. In

addition to the keys described in the "KEYS ACTIVE IN ALL MODES" section

above, the following keys can be used while in the "Semi-Auto" mode.



9.1     F8 : Toggle continuous drawing mode 



       This key is similar to the F10 Draw Current Image key, except

that "F8" will draw the selected image continuously until the next press

of the "F8" key. All other keys maintain their normal function even

while the continuous drawing mode is active. This mode is switched off

when you exit 'Semi-Automatic' operation, but remains active through a

fade or menu access. Review the section below with the F10 key

description for more details.



9.2     F9 : Select Random Image 



       If the user wishes to let DAZZLE randomly select the next image

generating algorithm to be drawn then press the "F9" function key. It

selects another image each time it is pressed. Note that specific images

can be selected as detailed below.



9.3     F10 : Draw Current Image 



       Once an image algorithm has been selected by whatever means, the

"F10" key is pressed to draw that image. The image will be drawn for as

long as you hold down this key. You may release the key, and when you

press it again it will simply resume where it left off if you have not

pressed another key. It is suggested that you start an image with just a

tap of this key, note what it is doing, and then decide how long you

wish to hold it. Since there are no limits on image generation time with

this key, you can let a really interesting pattern grow continuously,

producing visual effects that "Auto" mode will never duplicate. This key





Programs and all related documentation Copyright MicroTronics  page 19







will remember the image being played even if you perform a "fade". So if

a great image gets too busy, you can "fade" it and press "F10" again and

pick up where you left off.



       Due to the behavior of the "typematic" key repeat built into the

keyboard controller, it is possible for DAZZLE to get confused about

when you release the "F10" key. If this happens then the selected image

will continue drawing after you release this key. Just a quick tap of

this key again will bring it to a halt.



9.4     Alt-F10 : Reinitialize Current Algorithm 



       This key allows the continued use of the same currently selected

image algorithm. But it causes the image algorithm to be reinitialized

to new random settings. This is most useful for changing between various

modes of the same algorithm. Some images support use of exclusive-OR for

"ghosting" or mosaic texturing, some can change shape, most will change

color and screen location when this is pressed.



9.5     Specific Image Selection Keys 



       It is possible to specify exactly which image algorithm you wish

DAZZLE to use by pressing one of the Alt-keys 0 through 9, or A through

Z. Press the "Alt" key, and a letter key or number key (use the numbers

along the top of the keyboard, not the ones over on the side calculator

pad). Each represents a specific image selection. The "Image Size"

display in the "Configuration" menu list the name of each algorithm, and

the Alt-key that can be used to select that image.



10.    CONFIGURATION 



       As of revision 4.1, DAZZLE allows the user to customize some of

the characteristics of the image generation and fade actions. At any

time you may press the "F2" function key to activate the configuration

menu subsystem. This system is currently a bit limited in its range, but

it offers useful enhancements and controls.



10.1    Cursor Keys within CONFIGURE 



       When within the configure subsystem DAZZLE recognizes the various

standard cursor keys. The "HOME" key jumps to the first entry field of

the current screen. The "END" key jumps to the last entry field of the

current screen. The "PgDn" key advances to the next screen, the "PgUp"

returns to the previous screen. The arrow keys also can be used. Note

that the bottom right of the text window shows what page movement keys

are valid at that point.



10.2    Exiting CONFIGURE 



       The text menu subsystems, including the configure system, can be

exited by pressing the same key that invokes that subsystem. Thus to

exit configure press the "F2" key again.







Programs and all related documentation Copyright MicroTronics  page 20







10.3    Image Size Control 



       This screen allows the user to customize the images generated in

the "Auto" mode of DAZZLE. When an image is called, it is allowed to

draw on the display for a variable amount of time, the duration of which

centers around the number entered in this menu. This number is

multiplied by an internal value that reflects the size of the display

and the resolution of the current active video mode. Therefore these

numbers are relative and not absolute in their impact. Since the screen

resolution varies from EGA to VGA, it is also true that the maximum

value that can be entered changes between video modes. You may enter any

large number, DAZZLE will reduce your input to the legal range for the

current mode. As of R4.2 the minimum value is 0, thus allowing the

complete disabling of images that you do not desire. At least one image

must have a non-zero value, a configuration file that fails this

criteria will cause DAZZLE to abort during startup.



       As this number is increased the selected image is allowed to draw

longer, producing either larger patterns, more patterns, and/or a

greater variety of pattern variations.



       The "KEY" field shows which Alt-key (refer to "Specific Image

Selection Keys" above) will select that specific image drawing

algorithm. The "NAME" field shows the internal name of that image. The

"SIZE" field shows the current relative size limit for that image.



10.4    Fade Enable Control 



       This screen allows the user to selectively enable or disable

specific fades. If disabled, the fade will be unavailable in either

"Auto" or "Semi-Automatic" modes. If the user presses a fade command key

(refer to "The Fade Control Keys" above) for a fade that has been

disabled then DAZZLE will randomly select an enabled fade to execute.



       The "KEY" field shows which key (without the "Alt", "Ctrl", or

"Shift" keys being used) will select that specific fade algorithm. The

"FADE" field shows the internal name of that fade. The "ENABLE" field

shows the current state for that fade.



10.5    Auto Mode Display Customization 



       This menu shows 2 numbers; "Minimum images per display" and

"Maximum images per display".  These values control the number of images

that will be overlaid on a single screen during the Auto Mode of

operation. When set to small numbers only a few images will be mixed

together on one display prior to the next fade. This reduces how busy

the screen becomes. When set to large numbers many images will be mixed

together on a display prior to the next fade. This creates a much more

complex display.



       The bottom of this menu states, "These numbers will be increased

if in Alternate or Mad mode."  What specifically happens is that if the

program is operating in the Alternate (faster color cycling) mode then





Programs and all related documentation Copyright MicroTronics  page 21







the number of overlaid images is increased by up to the number you

entered as a minimum count (i.e., #images = (min + random(1+max-min) +

random(min))). If the program is operating in the Mad (fastest color

cycling) mode then the number of overlaid images is increased by up to

the number you entered as a maximum count (i.e., #images = (min +

random(1+max-min) + random(max))).



10.6    File Access Menu 



       This screen allows the user to save or load a DAZZLE

configuration file. There are three entry fields on this screen. Two

additional function keys are also recognized only when viewing this

screen.



10.6.1   Select Mode 



       At this entry the user can select either to "Save" the current

configuration information, or to "Load" an existing file. Press either

the "S" key or the "L" key, then "ENTER".



10.6.2   File Name 



       At this entry the user can specify the file to be saved or

loaded. Note that a default name is provided if one was not used at

program invocation. To replace the name simply begin typing it in, and

press "ENTER" when completed. It is suggested that a file extension (the

last three characters in the name, on the right of the period) of ".DZL"

be used. The following extensions are illegal : .BAT, .COM, .EXE.



       Beneath this field is an unmarked "File Status" field. If you

attempt to load a nonexistent file this will show "NOT FOUND". If you

try to save over an existing file this will show "EXIST", unless the

file is protected from overwriting, in which case it will show "READ

ONLY".



       If you specify a wildcard character ("*" or "?") within this

entry, then DAZZLE will automatically invoke a directory list to aid in

your selection process.



10.6.3   Path 



       The current disk and directory path is displayed in this field.

You may specify any variation of disk and path information that DOS

would normally support. Each of the following are legal:



       ..           (changes to previous directory)

       C:           (changes to C drive)

       \MT          (to MT directory on current disk)

       D:\          (to root directory on D drive)













Programs and all related documentation Copyright MicroTronics  page 22







10.6.4   F3 : View Disk Directory 



       Pressing the "F3" function key invokes the disk directory

display. Note that if you have begun an entry in any of the menu's

fields you must press "ENTER" before this key can take effect.



       Once a disk directory is displayed you may use the various cursor

keys to move around. Arrow keys work, and the "HOME" key jumps to the

top of the display, the "END" key jumps to the bottom. The "PgUp" and

"PgDn" keys can be used to move about more quickly. Press "ENTER" to

select a specific file, or "F3" again to exit this display.



       If you select a field that ends with a "\" (backslash) character,

you are selecting a directory, and the display will be updated to

reflect the contents of this new default path. The path field in the

File Access Menu also will be updated to this new path.



       File names displayed in lower case letters are "Read Only".



10.6.5   F4 : Execute Save/Load 



       Once the desired file has been specified, the "F4" function key

can be pressed to execute the specified command. Upon successful

completion the File Access Menu will be exited. If the "F4" key is

ignored, then you may still have a pending input entry; simply press

"ENTER" then try the "F4" key again.



11.    USAGE WITHIN WINDOWS 



       DAZZLE has been tested with both Windows2.0 and Windows3.0, both

with excellent results. While a true Windows Application Interface is

still future, it is currently very usable as is. DAZZLE can be left

inactive in the background, and brought up on the screen where it was

last interrupted with a simple Alt-TAB (or equivalent) key press. In

Extended 386/486 system the DAZZLE image will start intact from an

interruption, otherwise the image may be corrupted when DAZZLE is first

resumed but it will correct itself once the next fade operation is

completed.



       As a basic starting point try these DAZZLE.PIF entries:



       Program Parameters : /W

       Memory Required: 275KB, Memory Desired 275KB

       Display Usage: Full Screen

       Close Window on Exit

       Video Memory: High Graphics

       Retain Video Memory



All other options should be disabled. Especially avoid any video monitor

selections. If you are not using a 386/486 computer you may not be asked

to set each of these options.









Programs and all related documentation Copyright MicroTronics  page 23







12.    CONFIGURATION FILE FORMAT 



       The file that is used by DAZZLE is an editable text file that

follows a simple format. Each entry in the file must be on a separate

line, and consist of a "Key ID" and a "Configuration Value". It is

suggested that the user invoke DAZZLE in it's default mode, use the File

Access Menu to "Save" a copy of the program's configuration. That file

should then be printed. With DAZZLE in the Configuration Menu mode, a

printout of the configuration file, and a copy of this document in hand,

the whole process should prove to be very clear.



12.1    Shift Key Tokens 



       A token in DAZZLE is a character that represents a condition. In

order to represent within the configuration file the condition of the

three shift keys--Alternate, Control, Shift--a group of tokens have been

assigned as follows:



       Alternate = ~           (Tilde character)

       Control   = ^           (Caret character)

       Shift     = `           (grave or backwards-quote character)



       Thus to specify the Alt-A key, the file entry would be "~A". To

specify the Shift-F key, the file entry would be "`F". Note that this

version of DAZZLE only uses the Alt-key in this file, the other shift

keys listed are for future expansion and enhancements.



12.2    Special Token 



       This file also contains a special token to allow the

specification of menu configuration entries that do not match any shift

key function.  The "$" (dollar) token is used to mark such a field.  As

of R4.2 the values for Auto Mode Display Customization are contained in

this file as:



$I : the mInimum number of images on one display

$X : the maXimum number of images on one display



12.3    Key ID 



       A "Key ID" entry in the file consist of the key to be designated,

with an optional shift key token prefix. Refer to Shift Key Tokens above

for examples.



12.4    Configuration Value 



       The value to be specified must be surrounded in square brackets;

"[" and "]". 



       If the value is for an Image Size entry, then the use of an

unsigned integer value is required. Unsigned meaning no "+" or "-"

values. Integer meaning no fractions, decimal points, or exponents.

Therefore legal values are: "[25]" or "[0001]" or "[ 99 ]". Illegal





Programs and all related documentation Copyright MicroTronics  page 24







values would include: "[-1]" or " 25]" or "[14.5]".



       If the value is for a fade entry, then the use of either a "Y" or

an "N" character is required: "[Y]" or "[N]".



12.5    Comment Lines 



       While reading (parsing) any line of text in the file, when a ";"

(semicolon) is encountered DAZZLE stops reading that line. This allows

the liberal insertion of various comments within the file. DAZZLE is

very casual about parsing this file. It tolerates extra space and tab

characters, so you can generally make the file look any way you like.



12.6    Version Flag 



       The first non-comment line in the file should be the version

flag. It consists of a "#" (hash) character followed by an unsigned

integer of the DAZZLE version of the creating program. This is intended

for future compatibility between upgrades and should not be changed.



13.    PROGRAM INTEGRITY 



       All reasonable effort has been made to assure that the use of

this program on any compatible computer system can have no detrimental

side effects. In addition to extensive Quality Assurance testing, the

DAZZLE program contains an internal integrity check (read the section on

the "/I" command line option above). If someone makes any code

modifications to this program, it probably will be detected and the

program will refuse to execute. Any persons making unauthorized

modifications will be aggressively pursued and prosecuted. As of

revision 4.0 the antiviral system uses CRC checking instead of the

previous checksum algorithm.



14.    PROGRAMMERS COMMENTS 



       DAZZLE is written mostly in Borland C 2.0 (copyright Borland).

Assembler code for direct video control was used mostly due to two

characteristics of DAZZLE: all image generation is done a single pixel

at a time, thus video write mode 2 was needed for EGA speed; secondly,

the VGA mode uses the not-so-standard but highly portable 320x400 mode

instead of the normal BIOS supported 320x200 mode.



       Talented and accomplished people are always an asset. If you

might be interested in contributing to a MicroTronics project, then

please write, and if possible include a sample of your work.



       Some of you have questioned me about the "Our Creator, evidenced

by our creativity" message on the program credits artwork screen. The

next section is perhaps the best way to answer all the questions. I hope

you will receive it in the same spirit in which it is offered.











Programs and all related documentation Copyright MicroTronics  page 25







15.                      THE MEANING OF LIFE 



HIDDEN TRUTH                         Luke 4:18,19 The Spirit of the

                                     Lord is on me, because he has

Why was I born? Is this all          anointed me to preach good news

there is to my life, nothing         to the poor. He has sent me to

more? What's the point of my         proclaim freedom for the

existence? Have I no purpose, no     prisoners and recovery of sight

reason for being? Does someone       for the blind, to release the

possess a hidden "Secret" to         oppressed, to proclaim the year

fulfillment, or am I blinded to      of the Lord's favor.

the open answer?                     

                                     THERE IS A PURPOSE FOR YOUR LIFE

Are you willing to think about       

it honestly, or will you dismiss     Many are the plans in a man's

truths without ever questioning      heart, but it is the Lord's

what motivates your prejudice.       purpose that prevails (Prov

If you have never asked yourself     19:21). And we know that in all

these or similar questions, or       things God works for the good of

are not ready to face the            those who love him, who have

answers, then don't read on.         been called according to his

                                     purpose (Rom 8:28). In him we

2 Cor 4:3,4  Even if the truth       were also chosen, having been

is veiled, it is veiled to those     predestined according to the

who are perishing. The false god     plan of him who works out

of this age has blinded the          everything in conformity with

minds of unbelievers, so that        the purpose of his will (Eph

they cannot see the light of the     1:11), for it is God who works

good news of the glory of the        in you to will and to act

anointed one, who is the image       according to his good purpose

of God.                              (Phil 2:13).

                                     

REVEALED IN SUPERNATURAL POWER       Col 2:2-4    My purpose is that

                                     they may be encouraged in heart

The truth of the good news about     and united in love, so that they

Jesus the Christ is that he is       may have the full riches of

the Son of God (Mark 1:1) who        complete understanding, in order

will save us and call us to a        that they may know the mystery

holy life--not because of            of God, namely, Christ, in whom

anything we have done but            are hidden all the treasures of

because of his own purpose and       wisdom and knowledge. I tell you

grace (2 Tim 1:9).                   this so that no one may deceive

                                     you by fine-sounding arguments

Do not be afraid or ashamed of       [and New Age deceptions]. 

this truth, because it is the        

power of your creator God for        SALVATION MUST PRECEDE PURPOSE

the salvation of everyone who        

believes (Rom 1:16). This truth      The Lord will be the sure

is evidenced with works of           foundation for your times, a

supernatural power when used         rich store of salvation and

rightly and in love as commanded     wisdom and knowledge; the

(Mark 16:15-18).                     reverence of the Lord is the key

                                     to this treasure (Isa 33:6).





Programs and all related documentation Copyright MicroTronics  page 26







"Maintain justice and do what is     Titus 3:4-7  When the kindness

right, for my salvation is close     and love of God our Savior

at hand and my righteousness         appeared, he saved us, not

will soon be revealed" (Isa          because of righteous things we

56:1). Bear in mind that our         had done, but because of his

Lord's patience means salvation      mercy. He saved us through the

(2 Pet 3:15), though you have        washing of rebirth and renewal

not yet seen him, you can love       by the Holy Spirit, whom he

him; and even though you do not      poured out on us generously

see him now, you can believe in      through Jesus Christ our Savior,

him and be filled with an            so that, having been justified

inexpressible and glorious joy,      by his grace, we might become

for you will be receiving the        heirs having the hope of eternal

goal of your faith, the              life.

salvation of your soul (1 Pet        

1:8,9). We must pay more careful     Titus 2:11-14   For the grace of

attention to what we have heard,     God that brings salvation has

so that we do not drift away.        appeared to all men. It teaches

How shall we escape if we ignore     us to say "No" to ungodliness

such a great salvation (Heb          and worldly passions, and to

2:1-3)?                              live self-controlled, upright

                                     and godly lives in this present

Isa 12:2,3   Surely God is my        age, while we wait for the

salvation; I will trust and not      blessed hope--the glorious

be afraid. The Lord is my            appearing of our great God and

strength and my song; he has         Savior, Jesus Christ, who gave

become my salvation. With joy        himself for us to redeem us from

you will draw water from the         all wickedness and to purify for

wells of salvation.                  himself a people that are his

                                     very own, eager to do what is

OUR ETERNAL HOPE                     good. 

                                     

He alone is our rock and our         CHALLENGE

salvation; he is our fortress,       

we will never be shaken (Psa         Read this section again from the

62:2). We do not hide his            beginning with the viewpoint of

righteousness in our heart; we       "What if this just happens to be

speak of his faithfulness and        true?" What do you risk to

salvation. We do not conceal his     simply give it a try? When you

love and his truth from the          are ready for the true answers

masses (Psa 40:10). The              to life's hardest questions

salvation of the righteous comes     remember the source of all

from the Lord; he is our             wisdom, Jesus (Yeshua) of the

stronghold in times of trouble       Holy Bible.

(Psa 37:39). Therefore, prepare      

your mind for action in his          CREDITS

purpose; be self-controlled; set     

your hope fully on the grace to      Scriptures liberally taken from

be given you in Jesus Christ         the New International Version,

(1 Pet 1:13), as guaranteed in       copyright International Bible

his resurrection from the dead       Society.

(1 Pet 1:3).







Programs and all related documentation Copyright MicroTronics  page 27







16.    DAZZLE Distribution Authorization 



       This statement of agreement is valid only for those persons

distributing for a fee files from MicroTronics. Possession and use of

executable copies of our Shareware programs does not require the signing

of this agreement.



       The enclosed DAZZLE program is hereby offered for your non-

exclusive use and distribution as a Shareware product. Anyone wishing to

charge people a fee for giving them a copy of DAZZLE must sign and

return this form to MicroTronics, or will be in violation of copyright

restrictions. If you wish to receive automatic upgrade releases then

submit $15 payable to MicroTronics. Distributors recognized by the

Association of Shareware Professionals will normally be approved without

question, and are exempt from the $15 fee. A complementary copy of your

catalog would be greatly appreciated.



Name of Organization : _________________________________________________

Your Name : ____________________________________________________________

Address  :  ____________________________________________________________

            ____________________________________________________________

            ____________________________________________________________



TERMS OF DISTRIBUTION OF DAZZLE: 

1.     The fee charged may not exceed $7, including postage, mailer and

any other charges.



2.     Your library's catalog or listing must state that this program is

not free, but is copyrighted software that is provided to allow the user

to evaluate it before paying.



3.     The offering and sale of DAZZLE will be stopped at any time the

author so requests.



4.     Duplicates must be made from the copy of DAZZLE sent to you

directly from MicroTronics. The program and its documentation files must

be supplied in their entirety, without modification, truncation, or

omission.



5.     Problems or complaints will be reported to the author for

resolution.



In return for the right to charge a fee for the distribution of the

program DAZZLE, I agree to comply with the above terms of distribution.





Signed,





___________________________________________  _________________________

 your signature                Date            Title









Programs and all related documentation Copyright MicroTronics  page 28







17.    EPILOGUE 



This program may be distributed complete, and as is, AT NO CHARGE

(excluding reasonable duplication cost). All commercial rights retained

by the author. This program must not be altered in any way, and is

offered as is without warranty. The only assurance to the user is that

all reasonable effort has been made to confirm that this program as

released will produce no undesirable or damaging effects on the

executing computer.



This product consists of 2 files: DAZZLE.EXE DAZZLE.DOC

The DAZZLE.DOC file of the Users Manual can be created by entering

"DAZZLE -Z" at the DOS prompt.

The file DAZE.EXE may optionally be included.



Comments and inquires about updates and other products are welcome at

our mailing address.  $15.00 ($20US overseas) registration payable to

MicroTronics makes you eligible for a free update disk and puts you on

our PRIVATE mailing list. Be sure to mention this programs revision

level and your floppy disk format when you write.

       A production of J.R.Shiflett's Midnight Visions Workshop.



Mailing address (1991):                        CompuServe [76236,1573]

 MicroTronics

 P.O.Box 8759

 Spring, Tx USA 77387-8759



























































Programs and all related documentation Copyright MicroTronics  page 29


Dazzle 5.0h




                                D A Z Z L E

                   The Ultimate Graphics Image Generator


                                 Shareware
                              Usage Agreement
                                    and
                               User's Manual




                      Documentation for Revision 5.0h
                                8 Oct 1992





                       Worldwide MicroTronics, Inc.
                               P.O.Box 8759
                         Spring, TX USA 77387-8759



BY USING THIS SOFTWARE YOU ARE AGREEING TO ALL THE TERMS, LIMITATIONS, AND
CONDITIONS CONTAINED HEREIN.

Please take the time to review this whole document as soon as possible in
your use of DAZZLE. The program is far more configurable and flexible than
it initially appears, and the great majority of questions that arise are
addressed herein. The size of this document lends itself to being printed
for easier review and reference.

Information in this document is subject to change without notice and does
not represent a commitment on the part of Worldwide MicroTronics, Inc.. The
software described in this document is furnished under a license agreement.
The software may be used or copied only in accordance with the terms of the
agreement.

Programs and documentation Copyright 1992 WMT (Worldwide MicroTronics,Inc.)


1. DAZZLE Overview................................................1
2. INTRODUCTION...................................................1
3. SHAREWARE......................................................3
     3.1. Usage Limitation........................................3
     3.2. Revision Control........................................3
     3.3. Current registration fee and discounts..................4
     3.4. Site Licenses...........................................4
     3.5. Future Products.........................................5
     3.6. Royalties...............................................5
     3.7. Disclaimer..............................................5
     3.8. Distribution Limitation.................................5
     3.9. Ombudsman...............................................6
4. COMMAND LINE OPTIONS...........................................6
     4.1. Main Options Menu.......................................6
     4.2. Additional Options Menu.................................6
     4.3. Specifying Options......................................7
     4.4. Compatibility Options...................................7
          /2 = 2 part palette update..............................7
          /C = COMPATIBLE mode, use BIOS..........................8
          /D = Delay, slow down drawing for faster PC's...........8
          /E = EGA operation mode forced..........................8
          /K = Keyboard typematic unchanged.......................8
          /V = VGA operation mode forced..........................9
          /X = XT compatible mode, inferior but works.............9
     4.5. Artistic Options........................................9
          /4 = Restrict the EGA mode to 4 colors..................9
          /A = ALTERNATE (faster) color cycling speed.............9
          /F = FIXED colors instead of randomized.................9
          /H = Hide EGA border....................................10
          /M = MAD (fastest) color cycling speed..................10
          /S = SHOW mode, quick single image......................10
          /T = TALL video aspect ratio mode.......................10
     4.6. Other Options...........................................10
          /$ = Display order information..........................10
          /B = Bashful, no closing credits........................11
          /I = Insecure, no antiviral checking....................11
          /Q = Quiet, no tones (no effect on beeps)...............11
          /W = Window environment, changes defaults...............11
          /Z = Create DAZZLE.DOC file.............................12
          /+ = Ignore TARGA+64, and empty keyboard buffer on exit.12
          /! = Monitor Screen Saver driver interface..............12
     4.7. Specifying the INPUTFILE................................12
5. ON-LINE HELP...................................................12
     5.1. Cursor Keys within HELP.................................12
     5.2. Exiting HELP............................................12
6. LED Indications during DAZZLE..................................12
     6.1. Scroll Lock LED.........................................13
     6.2. Num Lock LED............................................13
     6.3. Cap Lock LED............................................13
7. PRIMARY DAZZLE MODES...........................................13
     7.1. Selecting Modes.........................................13
8. KEYS ACTIVE IN ALL MODES.......................................14
     8.1. ESCAPE : Program Termination............................14
     8.2. TAB : Freeze Image......................................14
     8.3. F5 : Dump Screen Image to Disk File.....................14
     8.4. "." : Toggle Quite Mode.................................14
     8.5. "+" and "-" : Color Cycling Clock Adjustment............14


DAZ50h-921008 Programs & documentation (c)1992 WMT                   i


     8.6. "PgUp" and "PgDn" VGA Color Cycling Step Adjustment.....15
     8.7. Shf-F10 : Reinitialize the Color Palette................15
     8.8. CTL-F10 : Select New Background Color...................15
     8.9. The Fade Control keys...................................15
     8.10. Special Fade Control keys..............................15
          P : Pan/Scroll fade.....................................15
          H : Hold current display................................16
          N : Next display now....................................16
     8.11. Mouse Clicks...........................................16
9. KEYS ACTIVE IN "SEMI-AUTO" MODE................................16
     9.1. F8 : Toggle continuous drawing mode.....................16
     9.2. F9 : Select Random Image................................16
     9.3. F10 : Draw Current Image................................17
     9.4. Alt-F10 : Reinitialize Current Algorithm................17
     9.5. Specific Image Selection Keys...........................17
10. CONFIGURATION.................................................17
     10.1. Cursor Keys within CONFIGURE...........................17
     10.2. Exiting CONFIGURE......................................18
     10.3. Image Size Control.....................................18
     10.4. Fade Enable Control....................................18
     10.5. Auto Mode Display Customization........................18
     10.6. File Access Menu.......................................19
          Select Mode.............................................19
          File Name...............................................19
          Path....................................................19
          F3 : View Disk Directory................................19
          F4 : Execute Save/Load..................................20
11. USAGE WITHIN WINDOWS..........................................20
12. CONFIGURATION FILE FORMAT.....................................20
     12.1. Shift Key Tokens.......................................20
     12.2. Special Token..........................................21
     12.3. Key ID.................................................21
     12.4. Configuration Value....................................21
     12.5. Comment Lines..........................................21
     12.6. Version Flag...........................................21
13. PROGRAM INTEGRITY.............................................21
14. PROGRAMMERS COMMENTS..........................................22
15. DAZZLE Distribution Authorization.............................24





















DAZ50h-921008 Programs & documentation (c)1992 WMT                  ii


1. DAZZLE Overview
version number: 5.0h

The only Screen Saver so stunning that it has been made into a Long Form
Music Video!

Transform your color VGA or EGA-equipped PC into a stunning source of
computer-generated beauty. DAZZLE is a hypnotizing graphics screen saver
acclaimed in computer magazines as the best self-directing art program
available. It fills the computer monitor with continually evolving displays
that protect the screen from image burn. A popular diversion for waiting
rooms, reception areas, and family rooms at home. Used in conjunction with
your favorite music, there is no form of entertainment quite like it.

DAZZLE constructs breath-taking geometric images that can be used to
complement desktop publishing materials, 35mm-slide and overhead design, or
to create dynamic background animation for video production.

*    Award winning interactive color kaleidoscopic program that provides
     hours of changing visual viewscapes.
*    Performance art for the eyes featuring a rich selection of drawing
     algorithms, fades, and special effects.
*    Includes a self-directing mode which is an effective and entertaining
     attention getter.

System Requirements
*    Personal computer using the 8088, 186, 286, 386, or higher processor.
*    EGA, VGA, 8514/A graphics card, or compatible video graphics adapter
     and monitor.
*    MS-DOS or PC-DOS operating system version 3.1 or higher.

Enhancements:

     R5.0 is the most significant "face lift" the program has ever
received. The number of fades and drawing algorithms have been greatly
expanded. A truly fresh interpretation of the DAZZLE vision.

     Configuration menu sets number of images and pause time in Auto mode.
"/W" command line option for easier use with Windows (a windows driver is a
separate product). Keyboard LED's indicate program state and progress. The
"/Z" option creates DAZZLE.DOC User's Manual. Enhanced interactive control.

2. INTRODUCTION
     DAZZLE is an award winning self directing color image generator for
DOS and Windows computers with EGA or VGA compatible color displays and
adapters. Performance art for the eyes.

     A source of beauty; sometimes subtle, sometimes vibrant, always
changing. The image engine has numerous primary image drawing algorithms,
most of which have at least two styles of presentation, many of which have
multiple internal drawing variations. There is an assortment of fades,
including split screens and pans, used by the imaging system for greater
diversity of presentation. The entire color range of the detected video
system is utilized for maximum variety and visual stimulation.

     When the "Semi-Automatic" mode of DAZZLE is active, the user can play
the program from the keyboard. Specifically selecting each pattern to draw,


DAZ50h-921008 Programs & documentation (c)1992 WMT                   1


or letting the program select the pattern randomly. The selected pattern is
generated for as long as the user holds the draw key. There are no limits
on the mixing of image patterns. The user can then invoke a specific fade
effect, or let the program select an effect randomly. The types of displays
that can be generated in this fashion are far more varied, and personal,
than anything that "Auto" mode ever produces.

     There is a configuration menu that allows the customization of DAZZLE
image generation. It also allows the selective disabling of various fades.
This configuration information can be written to an editable text file, and
either loaded again from the menu or loaded automatically at program
invocation by specifying the file name on the DAZZLE command line.

     An on-line HELP text window system is included in DAZZLE.

     In the self generating "Auto" mode the primary image algorithms are
mixed randomly on the screen. An adjustable number of images are overlaid
at a time, producing a very large assortment of possible displays. Each
display remains for a while to be appreciated, then the screen is cleared
via a fade algorithm, and another set of patterns is presented.
Mathematically speaking, an exact pattern match might not occur for many
weeks of continuous operation. Human perception is far less exacting and
will discern repetition well ahead of these extremes, but the general
effect is impressive and frequently surprising. Note that the starting
patterns of the program will be different each time it is executed. If the
program seems predictable, exit it and start it over again.

     "PsL News" (713-524-6394) described DAZZLE as:
     ...the best kaleidoscope program we've seen yet. The beautiful use of
colors, enhanced even further by the use of fading in and out, is, for want
of a better word, awesome.

     DAZZLE has received many other good press reviews, and has been
awarded "Best New Graphics Program for 1990" (December 90 PsL News). There
have since been complimentary reports too numerous to repeat here, my
thanks to all who have been so supportive.

     DAZZLE can be used in a variety of ways. At the office it keeps the
screen from being burned by constant display of an unchanging prompt.
Simply start the program when leaving your desk or answering the phone or
otherwise diverted. One option is to start DAZZLE from a keyboard locking
program so that unauthorized access is prevented on your unattended
computer until you return. Additional programs are available from Worldwide
MicroTronics, Inc. that provide self-starting DOS and Windows Screen Saver
capability, and optional password protection.

     DAZZLE can be used to aid relaxation. In its slower cycling VGA modes
(where this program REALLY shines) it is often soothing and helps one to
shift conscious attention from the cares of the day. Various university and
medical studies conducted on volunteers watching DAZZLE document a
reduction of blood-pressure, general relaxation, and heightened alpha
states in the brain. When overwhelmed with problems or pressures, it is
often true that shifting one's focus from an immediate concern allows the
objectivity needed to enhance decision making and settle the nerves.

     DAZZLE is a performing art realization on a computer platform. Used
with your favorite music DAZZLE can be highly entertaining and


DAZ50h-921008 Programs & documentation (c)1992 WMT                   2


regenerating. In its self-directing play mode it is great "living" mobile
art.

3. SHAREWARE
     Shareware is a brave concept in software marketing that allows you to
"try before you buy." Shareware authors retain all rights under their
copyright, but allow free distribution of their programs. Distributors of
shareware -- including on-line BBS and catalog outlets -- usually do not
charge for the shareware software itself. The distributors are charging for
their own services in providing access to their resources. Registration
payment directly to the author entitles the user to additional services,
information, and newer products. It is a great deal for users, authors, and
distributors alike. Please support this honor system marketing technique so
that more great programs of increasingly professional quality can
reasonably be provided via this system.

     Copyright laws apply to both shareware and commercial software, and
the copyright holder retains all rights, with a few specific exceptions
clearly stated by the author. Shareware authors are accomplished
programmers, just like commercial authors, and the programs are of
comparable quality -- in both cases there are good programs and bad ones!
The main difference is in the method of distribution. The shareware author
specifically grants the right to copy and distribute the software to all,
except that Worldwide MicroTronics, Inc. requires that written permission
be acquired before a commercial disk vendor may copy or distribute our
products.

     Shareware is a distribution method, not a type of software. You should
find software that suits your needs and budget, whether it's commercial or
shareware. The shareware system makes fitting your needs easier, because
you can try before you buy. And because the overhead is low, prices are low
also. Shareware has the ultimate money-back guarantee -- if you don't use
the product, you don't pay for it.

     You are encouraged to pass a copy of DAZZLE along to your friends for
evaluation, BUT PLEASE DO NOT GIVE IT AWAY ALTERED OR AS PART OF ANOTHER
SYSTEM. Please encourage them to register their copy if they find that they
can use it. Businesses, BBS's, and catalog operations please note:
distribution of Worldwide MicroTronics, Inc. shareware products, even free
of charge, without clearly explaining to the recipient their legal
requirement to register the program is strictly forbidden, and a violation
of copyright law.

3.1. Usage Limitation
     Please note that this program is NOT FREE. You are entitled to use it
for evaluation over a short time (not more than 10 days) to determine if it
functions adequately for your needs, after which time a registration fee
paid directly to Worldwide MicroTronics, Inc. is required by copyright law,
and greatly appreciated by all of us. Any distribution or on-line fee paid
by you to copy DAZZLE is (usually) not forwarded to Worldwide MicroTronics,
Inc. by the distributor, and therefore would not constitute payment of a
registration fee. The images generated by this program are protected under
copyright law.

3.2. Revision Control
     Worldwide MicroTronics, Inc. is NOT responsible for revision control
of DAZZLE through any source other than direct mailings from our office. If


DAZ50h-921008 Programs & documentation (c)1992 WMT                   3


you request a copy from any other source please be certain of the revision
level that you are acquiring, and that it contains all related files and
documentation.

     Your registration fee for DAZZLE entitles you to one disk copy update
of DAZZLE from us within the first year -- at your option. It is assumed
that all payments are registrations of existing copies, so disk are not
automatically mailed unless the request for "order" or "update disk" is
clearly identified in the letter. Many users prefer to retain their update
option until the next newer release is available. PLEASE specify your
floppy disk format when writing. Once you have received your update disk,
additional disk updates are available at a reduced fee. Names on our
mailing list will be maintained for at least 1 year from last contact
unless materials are returned without forwarding address.

3.3. Current registration fee and discounts
     The registration fee for this version of DAZZLE is $15 ($20US for
customers outside the continental U.S.A. please). For those that wish to
buy multiple registrations of the unmodified shareware product the
following discounts are currently allowed:

Copies 1 through 3
     Registration cost $15 each ($20US foreign)

Copies 4 through 8
     Additional cost $12 each ($17US foreign)

Copies 9 or more
     Additional cost $7 each ($12US foreign)

Thus 12 copies would cost $133.00 (3x$15 + 5x$12 + 4x$7). Discounts may be
discontinued without prior notice. Multiple registrations make for a great
gift idea to your computer using friends, and are wonderful around the
office. This pricing is for independent registrations of multiple program
copies. Worldwide MicroTronics, Inc. will provide a disk and documentation
for each copy thus registered, and put the recipient of each copy on our
mailing list.

     A single registration fee will license one copy for use on any one
computer at any one time. You must treat this software just like a book. An
example is that this software may be used by any number of people and may
be freely moved from one computer location to another, so long as there is
no possibility of it being used at one location while it's being used at
another. Just as a book cannot be read by two different persons at the same
time.

3.4. Site Licenses
     Also available are MULTI-COPY or SITE LICENSES. The licensee receives
one "master" copy of the program and all related documentation, additional
master copies of disk and/or documentation available for an extra charge.
These may be copied by the licensee for multiple users at the designated
location (site) up to the number of licensed copies. The current offer is
that $15 is paid for the master copy supplied from us, and you pay $5 for
each additional copy that you make (subject to the terms of the Site
License agreement). The number of authorized copies can be automatically
extended by simply submitting the additional funds with a letter
referencing the original site license.


DAZ50h-921008 Programs & documentation (c)1992 WMT                   4



3.5. Future Products
     Self activating DOS and Windows Screen Saver Razzle-Dazzle is
available at better computer software retail stores.

     A full computer security version of MT-DAZE is available from
Worldwide MicroTronics, Inc.

     A derivative limited availability retail product called DAZLOGO allows
commercial clients to incorporate their own logo or other artwork for
regular presentation by the Razzle-Dazzle screen saver display for trade
shows, waiting rooms, promotional gifts, and other uses. Write us for
details.

     Another derivative product for potential future release is DAZTUTOR.
This allows users to experience a revolutionary Psycho-Ergonomic(TM)
stress-less computer aided memorization technique. Commit information to
memory during a high-alpha state of relaxation without the duress and
distraction associated with other memorization environments.

     Worldwide MicroTronics, Inc. is making available DAZZLE merchandise of
a broad variety, including: Music Videos, Shirts, Mugs, Cards, Prints,
Stick'EMs, and such.

3.6. Royalties
     ALL COMMERCIAL RIGHTS TO THIS PROGRAM ARE RETAINED BY THE AUTHOR. The
images generated by this program are intended for viewing on a computer
executing a registered copy of this software, and may be extracted,
projected, or otherwise translated onto other media only for personal
enjoyment or non-commercial use within companies which have registered this
software. Public display of DAZZLE images is permitted without royalty for
registered copies that are used for trade shows, point of sales, and
offices, where such usage is for entertainment or demonstration purposes,
if no admission is charged, and the display is incidental to the business
being conducted.

3.7. Disclaimer
     Users of DAZZLE and related products must accept this disclaimer of
warranty: "DAZZLE is supplied for non-exclusive usage as is. The author
disclaims all warranties, expressed or implied, including, without
limitation, the warranties of merchantability and of fitness for any
purpose. The author assumes no liability for damages, direct or
consequential, which may result from the use of these programs."

3.8. Distribution Limitation
     Anyone distributing DAZZLE for any kind of remuneration must first
contact Worldwide MicroTronics, Inc. for authorization, use of the
Distribution Authorization form below is recommended. This authorization
will be automatically granted to distributors recognized by the (ASP) as
adhering to its guidelines for shareware distributors, and such
distributors may begin offering DAZZLE immediately (however Worldwide
MicroTronics, Inc. must still be advised). Distribution of Worldwide
MicroTronics, Inc. shareware products, even free of charge, without clearly
explaining to the recipient their legal requirement to register the program
is strictly forbidden, and a violation of copyright law.




DAZ50h-921008 Programs & documentation (c)1992 WMT                   5


3.9. Ombudsman
     Worldwide MicroTronics, Inc. (formerly, MicroTronics) is an associate
member of the Association of Shareware Professionals (ASP). ASP wants to
make sure that the shareware principle works for you. If you are unable to
resolve a shareware-related problem with an ASP member by contacting the
member directly, ASP may be able to help. The ASP Ombudsman can help you
resolve a dispute or problem with an ASP member, but does not provide
technical support for members' products. Please write to the ASP Ombudsman
at 545 Grover Road, Muskegon, MI 49442 or send a CompuServe message via
CompuServe Mail to ASP Ombudsman 70007,3536.

4. COMMAND LINE OPTIONS
     A number of options that control the action of the DAZZLE family of
programs can be specified on the command line when the program is invoked,
or can be encoded into a batch file for easy activation.

4.1. Main Options Menu
     When you enter the command "DAZZLE -?" at the DOS prompt you will be
presented with the following display.

The following options can be specified on the command line and are used to
customize and control the action of "Dazzle". These options can also be
specified in a batch (.BAT) file for automatic activation.

       -$  Display order information.
       -2  2-part palette, fixes flickering screens but slows drawing.
       -a  Alternate Speed - uses faster color cycling speed.
       -b  Bashful - no closing credits & pressing any key quits the program.
       -c  Compatible mode - use the PC's BIOS for better compatibility.
       -d  Delay - slows the drawing speed for faster PC's.
           "-d=xxxx" delays drawing speed by the specified value.
       -i  Insecure - CRC checking is not performed when program starts.
       -m  Mad - uses fastest color cycling speed...a real attention getter!
       -q  Quiet - no tones (this option has no effect on warning beeps).
       -s  Show - displays a single image then quits.
           "-s=xxxx" shows for the specified number of seconds then quits.
       -w  Window - changes defaults for use with Windows.
       -x  XT compatible - for use on 8088/8086 PC's with EGA or VGA.
       -Z  Create DAZZLE.DOC file
For example - if you want to start "Dazzle" so that no tones are heard,
no CRC checking is performed, and no closing credits are seen when you
quit the program, type the following command:
                       DAZZLE -q -i -b

Press any key to continue

4.2. Additional Options Menu
     When you press a key at the "Press Any Key" prompt you will be
presented with the following display.

While "Dazzle" is running, the [Tab] key will freeze the display until
the [Space] bar is pressed.
The [F1] key activates on-line help during the program. The [F2] key provides
a menu of configuration options. The [Esc] key terminates the program.

 ** Refer to the Dazzle User's Manual for far more details **



DAZ50h-921008 Programs & documentation (c)1992 WMT                   6


 Additional command line options:
       -e  EGA - forces EGA display mode.
       -h  Hide EGA border - forces a black border in EGA mode.
       -k  Keyboard Typematic - keeps program from changing the typematic rate.
       -t  Tall Video - forces the program to use standard BIOS aspect ratios.
***** limited use command line options *****
       -+  Ignore TARGA+64, and empty keyboard buffer on exit.
       -!  Monitor Screen Saver driver interface.
       -4  Restrict the EGA mode to only 4 random colors.
       -f  Fixed colors instead of randomized.
       -v  VGA operation mode forced.

4.3. Specifying Options
     The Dazzle program accepts any combination of options on the initial
command line that affect its mode of operation. The options may be preceded
with either the "/" (slash) character or the "-" (minus) character. If you
use the SwitchChar feature of MS-DOS, the "/" (slash) option marker
character can be changed to any other key. At least one space must exist
between the Dazzle command and the first option. For example, "DAZZLE -FC"
instructs Dazzle to execute with Fixed colors and in Compatible mode. The
options are not case-sensitive -- uppercase and lowercase letters are
treated identically. The options may either be concatenated into a single
string or entered separately (-FC is treated the same as -F -C). The
optional input file may be specified anywhere on the command line. For
example, "DAZZLE  -I MTDAZZLE.DZL" has the same effect as
"DAZZLE MTDAZZZLE.DZL  -I". Both commands instruct Dazzle to start up in
Insecure mode and to load the configuration file MTDAZZLE.DZL before
starting the image generation process. Note that Dazzle will automatically
attempt to locate and load a configuration file named MTDAZZLE.DZL unless
explicitly instructed otherwise with the "*" (asterisk) or "-*" (minus
asterisk) command line options. The effects of each option are detailed
below.

4.4. Compatibility Options
     Some of the options for DAZZLE are specifically related to increasing
portability of the program to various computers and displays. The "2", "c",
"d", "e", "k", "v", and "x" options default to the most desirable modes,
but can be controlled by the user. VGA users also should refer to the "t"
option for details.

     /2 = 2 part palette update.
     Normally the entire color palette is updated at one time for each tick
of the color cycling clock. If the CPU clock speed or the VGA palette
register update rate is too slow, the upper part, or perhaps all of the
display, will flicker badly during the display. To determine if this is due
to palette updates, press and hold the "-" (minus) key during the running
graphics display until it beeps (this is the slowest cycling clock rate).
If the display flickers only when the color changes, then palette update
speed is a problem. Using the "2" option splits the VGA palette update
request into two almost equal groups that are handled sequentially. This
should remove, or at least significantly reduce, cycling induced flicker.
This option should not be used if not needed, as it slows the entire
display generation process. This option affects operation with VGA adapters
only, since they allow longer 256 color palettes. Short 16 color palettes
for EGA's are never divided into two separate updates.




DAZ50h-921008 Programs & documentation (c)1992 WMT                   7


     /C = COMPATIBLE mode, use BIOS.
     Normally DAZZLE bypasses the video adapters BIOS code for maximum
speed in color palette cycling. However, some rare adapters may have
problems with this mode of operation. To cause DAZZLE to use the provided
BIOS the "C" option can be used. If your display flickers or distorts, or
the color fails to cycle smoothly during the display, then try this option
to determine if it corrects the problem. This option reduces program
performance speed and should not be used if not needed.

     /D = Delay, slow down drawing for faster PC's.
      "-d=xxxx" delay xxxx units.
     This option serves both artistic and compatibility purposes. On faster
computers the DAZZLE drawing algorithms can be too fast to appreciate as an
evolving image. If the computer is too fast, or if you simply desire to
induce a slower drawing speed for purely aesthetic reasons, this option can
be used to delay the drawing process. If used simply as "/D", without
specifying any delay units, the program will use a default delay amount. To
adjust the amount of delay a specific value can be provided after the "="
(equal) character. There is no exact relationship of the delay unit value
and the impact on the drawing speed, it must be experimentally determined
on each computer. The larger the number, the slower the drawing (TARGA+64
users note: this option works in reverse on this system, larger unit
numbers produce faster drawing).

     The delay unit value ranges from 1 (minimum) to 8191(maximum), and can
be entered without leading zero's. There must be no spaces or tabs between
the "D", the "=", and the numbers for the delay units. This option can be
concatenated with other non-numeric options. Thus "/AD=250W" is a legal
command option string.

     /E = EGA operation mode forced.
     Normally DAZZLE will automatically detect the video adapter hardware
attached and adjust itself to use either the EGA or the VGA mode. This "/E"
option allows VGA users to select and view the EGA mode of operation, which
is 640x350x16 in format. As of revision 4.0 this option, like the "/V"
option, will prevent DAZZLE from aborting if it thinks that it has detected
an unacceptable video controller/monitor combination, though it will still
give its usual error messages during startup. Refer to the "/V" option
below for more information.

     /K = Keyboard typematic unchanged.
     Revision 4.1a contains enhancements to make the program largely immune
to some "keyboard acceleration" utilities that exist. These utilities cause
the self-repeating "typematic" function of the keyboard to function far
more rapidly. They come in two flavors:

*    Those that tell the keyboard to send keys more often.
*    Those that trick DOS into thinking that more keys arrive than actually
are sent by the keyboard.

     Without specifying this command line option, DAZZLE will set the
"typematic" rate of the keyboard to it's minimum value for best program
performance. When DAZZLE terminates it puts the "typematic" speed back to a
value typical of most DOS defaults, unfortunately I am not aware of a way
to test the setting before changing it. Those that use a keyboard speed-up
utility that stops having an effect after DAZZLE has been executed have the
first type of such a utility. If you want the keys back to their quicker


DAZ50h-921008 Programs & documentation (c)1992 WMT                   8


speed you can re-execute your speed-up command. If you find this
unacceptable then use this command line option to force DAZZLE to keep from
changing the "typematic" rate of the keyboard. The "/S" , "/W", and the
"/B" options automatically disable changing of the typematic rate.

     /V = VGA operation mode forced.
     Normally DAZZLE will automatically detect the video adapter hardware
attached and adjust itself to use either the EGA or the VGA mode. This
option generally SHOULD NOT BE NECESSARY, OR USED. It should be unable to
cause any damage, but is intended for rare compatibility conflicts where
the startup code in DAZZLE falsely rejects the video controller/monitor
combination as unacceptable. This option, like the "/E" option, will allow
the error messages to be reported (so that you can write us of the
problem), but will prevent the program from aborting itself. If the
controller/monitor is really VGA compatible, or really EGA compatible if
using the "/E" option, then normal image generation should be observed.
Unlike the "/E" option, this option lacks artistic usage or impact. The VGA
mode uses all 256 color palette registers for a far more subtle and
interesting series of displays. The default VGA mode of DAZZLE uses a
specially enhanced 320x400x256 mode that is not properly captured by many
commercial products. The VGA modes require no more than 256kB of video
memory.

     /X = XT compatible mode, inferior but works.
     This option allows DAZZLE to execute on 8088 or 8086 based PC/XT type
computers with EGA or VGA adapters and color displays. This option will be
automatically initiated if the 808x style CPU is detected at program
startup, but specifying the command line option avoids the warning message.
The EGA performance on XT computers seems acceptable, but the VGA mode may
be noticeably inferior to the performance of an 80x86 based computer. The
faster the CPU clock the better the overall performance and fluidity of
DAZZLE.

4.5. Artistic Options
     These options adjust the image generating algorithms used by the
program. They are largely artistic in nature but allow customizing the
presentation to various environments and requirements.

     /4 = Restrict the EGA mode to 4 colors.
     The default EGA mode will use the full complement of available colors
for the display. Using this option restricts the display to only 4
simultaneous colors at one time. This is used when the output from DAZZLE
will be directed to another system that does not support more than 4
colors.

     /A = ALTERNATE (faster) color cycling speed.
     The default color cycling mode is the slowest, with the most subtle
shadings and transitions. This option increases the cycling rate used in
shaping the palette contents. This effect is distinct from, but can
complement, the "+" and "-" keys that can be used while the program is
active.

     /F = FIXED colors instead of randomized.
     Normally DAZZLE will randomize the color palette registers between
each screen erase before starting the next image generation. This allows
all the possible colors (up to a quarter million on VGA) to be used by the
program. This option forces the palette to an identical state at all times.


DAZ50h-921008 Programs & documentation (c)1992 WMT                   9



     /H = Hide EGA border.
     Some folks find the colored border on the EGA display distracting, and
some displays do not perform retrace masking properly. This option will
cause the border color in EGA modes to be forced to black at all times.

     /M = MAD (fastest) color cycling speed.
     This option not only greatly accelerates the color palette contents
rotation, but it also increases the number of image primitives that can be
displayed in "Auto" mode at one time before the screen is erased. The
effect is a far busier screen, a more intense visual experience. This is
particularly suited to attention-getting in showrooms and other public
displays, whereas the default mode is more practical for personal
meditation and relaxation.

     /S = SHOW mode, quick single image.
      "-s=xxxx" Show mode, duration xxxx seconds.
     The "/S" option gives a single panel of images and then terminates
automatically. This is most useful when DAZZLE is to be executed from
within other programs or batch files. The image displayed is different each
time.

     The "/S=xxxx" option allows DAZZLE to execute for a specified length
of time, after which it will terminate at the end of the next fade.

     The duration value ranges from 1 (minimum) to 3600(maximum), and can
be entered without leading zero's. There must be no spaces or tabs between
the "S", the "=", and the numbers for the duration. This option can be
concatenated with other non-numeric options. Thus "/AS=250W" is a legal
command option string.

     /T = TALL video aspect ratio mode.
     Normally the EGA mode of DAZZLE uses a 16 color 640x350 resolution
display with a modified aspect ratio (screen is mapped as if it had 640x700
resolution). The default VGA mode uses 256 color 320x400 resolution. The
"/T" option causes the program to use the standard BIOS supported screen
resolution and aspect ratio in generating all images. The effect is
somewhat faster image generation, but with a noticeably tall aspect ratio.
As of revision 4.0 this option is functional with the VGA display mode, and
causes it to use the BIOS supported 320x200 video mode. Note that due to
VGA hardware limitations, using this option will prevent the display of
"dual page" effects (where a screen composed of a different image than the
one being displayed is "panned" or "scrolled" onto the visible display
area).

4.6. Other Options

     /$ = Display order information.
     Issuing this option when invoking DAZZLE will cause the program to
output a convenient order form that can be quickly completed and sent to
Worldwide MicroTronics, Inc. for product orders, information request, and
shareware registration. To send this form directly to a printer use the
MSDOS output redirection character ">" (greater-than) to specify the
destination. For example, if you have a printer that can accept standard
ASCII text on your computer port PRN:, then the command to use would be:
     DAZZLE -$ > PRN:



DAZ50h-921008 Programs & documentation (c)1992 WMT                  10


     Complete the form and mail it to the indicated address. Enclose any
indicated funds in U.S.Dollar instruments, payable to Worldwide
MicroTronics, Inc. .

     /B = Bashful, no closing credits.
     DAZZLE will identify itself, including its revision level, when the
program is started. The BASHFUL option will prevent closing credits when
the program terminates (similar to the SHOW option), and additionally
prevents DAZZLE from clearing the type ahead keyboard buffer when it exits.
This allows usage of DAZZLE in a more classical "Screen Saver" mode, since
whatever key is pressed to exit is not lost. This mode disables ALL key
interpretation of DAZZLE. Even the "+" and the "-" keys will cause DAZZLE
to terminate. The shareware version of DAZZLE does not initiate itself in a
"Screen Saver" fashion under DOS or Windows, this flag is used by the
retail Screen Saver drivers from Worldwide MicroTronics, Inc. . This mode
blocks the use of the keyboard LED's to indicate the state condition of the
executing DAZZLE program. DAZZLE has been successfully used within
MS/Windows (copyright Microsoft), but use of this option will prevent
window selection keystrokes. Use of the command line option "/W" was added
in R4.2 for the windows environment as detailed below.

     /I = Insecure, no antiviral checking.
     Before starting the image display process DAZZLE will normally perform
a test on the disk copy of itself in an attempt to assure that no
unauthorized modifications ("hacks") have been made to the program after it
was distributed from Worldwide MicroTronics, Inc. . This is a safety
feature added for YOUR protection! Please note that this is not a system
wide scan for virus infection-only the current disk copy of the DAZZLE.EXE
file is checked, nor is the self-check completely exhaustive. Once you have
used your copy of DAZZLE, after it has passed its antiviral test and you no
longer wish to endure the delay at every invocation for this testing, you
can use this command line option to bypass this safety feature. IF YOUR
COPY OF DAZZLE FAILS THIS TEST, PLEASE NEVER USE THIS OPTION! INSTEAD WRITE
TO US, AND TO THE SUPPLIER THAT GAVE YOU THE BAD COPY, AND LET US KNOW! A
clean copy can be in your hands in a very short time, and might save your
entire software investment (NOTE: Worldwide MicroTronics, Inc. only
supplies disk to registered users).

     /Q = Quiet, no tones (no effect on beeps).
     This option will block the tones that DAZZLE emits at various points
in its operations. But warning beeps are generally not restricted. As of
revision 4.1, DAZZLE uses programmed tones for most alerts and signals that
it issues. These tones are of short duration, and change pitch depending on
the condition being signaled. With the increase in operational options
these tones are very helpful in determining the state the program is in.
The one place where these tones are superfluous is the tiny tune in the
closing credits, but this tune can be aborted with any keypress.

     /W = Window environment, changes defaults.
     This option was added to simplify use of DAZZLE within MS/Windows
environments. It prevents the startup antiviral check (please see the "/I"
option for a discussion of the risk involved), disk head parking, and all
startup messages. This mode blocks the use of the keyboard LED's to
indicate the state condition of the executing DAZZLE program. It allows
normal "switch" key commands to Windows for task switching. DAZZLE will
still show the closing credits graphic image, but not the closing text
messages.


DAZ50h-921008 Programs & documentation (c)1992 WMT                  11



     /Z = Create DAZZLE.DOC file
     DAZZLE keeps the entire Users Manual within itself in an efficient
manner that has minimal impact on total usage of the program. By specifying
this option DAZZLE will create a new DAZZLE.DOC Users Manual file on your
current default disk directory, which you can then print. Note that this
file is formatted for generic text printers.

     /+ = Ignore TARGA+64, and empty keyboard buffer on exit.
     This TARGA portion of this option is designed for use on the retail
versions of these programs, and has essentially no effect on this shareware
version of the program. This option also forces the program to clear the
keyboard buffer when exiting back to DOS, even if using the "/B" option.

     /! = Monitor Screen Saver driver interface.
     The retail versions of Razzle-Dazzle and related products allow
execution as a self activating Screen Saver under both DOS and Windows3.x.
This option allows the retail version of the program to monitor the Screen
Saver driver interface so that it performs normally in that environment,
which is the default mode invoked by DAZTSR.

4.7. Specifying the INPUTFILE
     DAZZLE can accept the optional specification of an input file on the
command line. This file must contain a text script that is consistent with
the program's language specification. The specification of a path as well
as a filename is acceptable. Be sure to separate the file name from options
with at least one space.

     As of R5.0, DAZZLE will automatically attempt to locate and load a
configuration file named MTDAZZLE.DZL unless explicitly instructed
otherwise with the "*" or "-*" command line options.

5. ON-LINE HELP
     DAZZLE supports an on-line help menu system. You may press the "F1"
function key to activate the help subsystem. This system is intentionally
limited in size and scope to keep the program from growing too large, but
it offers useful summaries of the newest and most pertinent features of
DAZZLE. The graphics screen that was being displayed when help is activated
is erased when help is exited.

5.1. Cursor Keys within HELP
     When within the help subsystem DAZZLE recognizes the various standard
cursor keys. The "HOME" key jumps to the first page of help text. The "END"
key jumps to the last page of help text. The "PgDn" key advances to the
next page of help text, the "PgUp" returns to the previous page. The arrow
keys also can be used. Note that the bottom right of the text window shows
what page movement keys are valid at that point.

5.2. Exiting HELP
     The text menu subsystems, including the help system, can be exited by
pressing the same key that invokes that subsystem. Thus to exit help press
the "F1" key again.

6. LED Indications during DAZZLE
     DAZZLE family of programs control the lighting of the Num Lock, Cap
Lock, and Scroll Lock LED's (Light Emitting Diodes) on the keyboard to
indicate to the user the state of the program as it moves through the


DAZ50h-921008 Programs & documentation (c)1992 WMT                  12


various conditions or "states" in normal operation. These LED's (or lights)
can be on, off, or blink; each represents a different condition as detailed
below. Note that use of the "/W" or the "/B" command line options prevent
the DAZZLE program from changing the keyboard LED indicators.

6.1. Scroll Lock LED
     This light indicates 1 of 3 possible conditions for the program.

1) When off, the program is not in any pause state, something is actively
being computed or displayed.

2) When blinking, the program is in an active countdown of a normal pause
delay. When the delay expires the program will proceed to the next action
without any need for user intervention.

3) When on, the program is halted in a pause state, and will not proceed
until the user takes some action. This can be induced by pressing either
the "TAB" key or the "H" fade key. Refer to the details elsewhere for these
specific keys to understand how to release the program from this state.
This condition also occurs when any text menu is on the display, use the
specified menu exit command to restore normal program execution.

6.2. Num Lock LED
     This light indicates that the program is either computing or
displaying a "Pan/Scroll Fade" process. If no activity is visible on the
screen then the program is building a new image on the "hidden" display so
that it can be moved onto the active or "visible" display area. Refer to
the "P" fade key for additional details.

6.3. Cap Lock LED
     This light indicates that the program is computing a new VGA color
palette to use on the active display. The duration of this period is
directly dependent on the math speed of your computer. This indication was
added to inform users when their program seems halted that valid
computations are progressing unseen within the system. Refer to the
"Shift-F10" key description for additional details.

7. PRIMARY DAZZLE MODES
     DAZZLE has two primary modes of operation. The original "Automatic"
(a.k.a. "Auto") mode, which is fully self generating; and a new
"Semi-Automatic" (a.k.a. "Semi-Auto") mode, which allows interactive
control of the image generation process. Some keys are only effective in
the "Semi-Automatic" mode, others are active at all times.

7.1. Selecting Modes
     Selection between these two modes is done by pressing the "ALT"
(Alternate) key and the "F9" function key. This combination is referred to
as "Alt-F9". At program startup DAZZLE is always in "Auto" mode.

     To enter "Semi-Auto" mode press "Alt-F9". There is a short high
pitched tone. The display is cleared. The palette is reinitialized to a new
setting (this may take a few seconds on a slow VGA machine). Then a short
multi-tone chirp is emitted to indicate that "Semi-Auto" is ready for image
drawing commands.

     To return to "Auto" mode press "Alt-F9". There is a short lower
pitched tone. The display is cleared. The palette is reinitialized to a new


DAZ50h-921008 Programs & documentation (c)1992 WMT                  13


setting. Then the self generating engine begins creating random image
displays.

8. KEYS ACTIVE IN ALL MODES
     Some key commands that DAZZLE recognizes are active regardless of the
current display mode. The meaning of some keys change slightly depending on
the current display mode.

8.1. ESCAPE : Program Termination
     "The first and most important thing to learn about any program is how
to get out of it." This key will do the job for you regardless of where you
are in the program, just keep banging it till you get back to the DOS
prompt. Note that when not in the various text menu screens, that "ENTER"
also will terminate the program.

8.2. TAB : Freeze Image
     The "TAB" key can be pressed at any time when not in a text menu to
"freeze" the current graphics image display. Once pressed, DAZZLE will
remain in "freeze" mode until the "SPACE" key is pressed (the "n" key will
also work). While in "freeze" mode, the "TAB" can be repeatedly pressed to
toggle between color-cycling and color-static modes. The "Shift-F10" key
can be used to change the palette of an image in "freeze" mode. This is
most useful in stabilizing a specific display for image capture. Even an
image in the midst of a fade or pan can be put into "freeze" mode. This key
is also active in the "Semi-Automatic" mode, though here its usefulness is
limited to halting a fade in mid-execution.

     The Scroll Lock LED on the keyboard will be continuously lighted to
indicate that "freeze" is active. Refer to the section on Scroll Lock LED
above for more details.

8.3. F5 : Dump Screen Image to Disk File
     Pressing the "F5" function key converts the display memory into an
industry standard PCX disk image file. The program will name the file
"DAZ_xxxx.PCX", where xxxx is replaced with a number from 0000 to 9999,
depending on what filenames already exist on the current disk path. The
image format will match the current video mode of the program. The program
will resume normal display after the file is completely written. If a
"Pan/Scroll" fade is in effect when "F5" is pressed the "current" display
will assume full screen position for the duration of the file creation,
then the fade will return to normal action.

8.4. "." : Toggle Quite Mode
     Pressing the "." (period) key while the program is drawing will toggle
the Quite mode (refer to "/Q" command line option) on and off. This allows
muting of the program sounds without having to terminate execution.

8.5. "+" and "-" : Color Cycling Clock Adjustment
     The fluid changing of DAZZLE images is largely the result of a clock
driven rotation of the display's color palette. The user can adjust the
rate of this clock at any time by using the "-" (minus) key or the "+"
(plus) key. Pressing "-" reduces the clock rate, pressing "+" increases the
clock rate. Note that DAZZLE defaults to maximum speed in VGA modes, and
almost maximum rate in EGA modes. When either the maximum or the minimum
clock rate is reached the console emits a short tone. This process is
distinct from, yet can complement, the palette control command line options
(see descriptions for "/A" and "/M" options above).


DAZ50h-921008 Programs & documentation (c)1992 WMT                  14



8.6. "PgUp" and "PgDn" VGA Color Cycling Step Adjustment
     The degree of color change that occurs at each event of the color
clock can be adjusted on VGA displays using the "Page Up" (PgUp) and "Page
Down" (PgDn) keys. The program starts in the minimum step condition when
loaded. This effect is distinct from, yet strongly complements, the "+" and
"-" key functions described above.

8.7. Shf-F10 : Reinitialize the Color Palette
     Pressing the "SHIFT" key and also the "F10" function key
simultaneously (Shf-F10) causes the current color palette of the display to
be reinitialized to a new random condition. There is a short tone at the
start of the request, and another tone when the process is completed. In
EGA modes the process is almost instantaneous. In VGA modes it can take up
to a few seconds, and the Cap Lock LED will light while the new palette is
being computed. Refer to the Cap Lock LED description for further details.

8.8. CTL-F10 : Select New Background Color
     Pressing the "CONTROL" key and also the "F10" function key
simultaneously (CTL-F10) causes the background color of the current display
to be changed to a new random value.

8.9. The Fade Control keys
     DAZZLE allows the user to select which fades will be used. The actions
of these keys vary slightly depending on the current mode. In "Auto" mode,
pressing one of the fade keys sets which fade will be used next but allows
the normal image generation process to continue. In the "Semi-Automatic"
mode the fade keys induce the selected fade immediately.

     The "Fade Enable Control" screen in the "Configuration" menu shows
which key (without the "Alt", "Ctl", or "Shf" keys being used) can be
pressed to select a specific fade algorithm.

8.10. Special Fade Control keys
     The following behave a little differently, so they have been set aside
for special discussion.

     P : Pan/Scroll fade
     Unlike the previous fade keys, this one has to be pressed at a certain
time to have any effect in the "Automatic" mode. When DAZZLE is drawing in
"Auto" mode it is in the "Auto-DAZE" state (no LED's are lit, see details
above about LED usage). Once the last image has been drawn it switches to
the "Fade-Out" state (the Scroll Lock LED is lit). The first thing this
latter state usually does is just pause for a while so that you can
appreciate the incredible beauty of the display. The "P" key is only
recognized in "Auto" mode if pressed while still in the "Auto-DAZE" state
(before Scroll Lock lights). Once the last image has been drawn and the
pause delay starts this key will simply be ignored.

     If a Pan/Scroll is in progress as indicated by the lighting of the Num
Lock LED, then pressing the "P" key will assure that both a pan and also a
scroll are presented.

     In the "Semi-Automatic" mode this key will not induce a Pan/Scroll.
Since that effect is not supported in the "Semi-Auto" mode, pressing "P"
causes one of the other fades to be randomly selected and executed
immediately.


DAZ50h-921008 Programs & documentation (c)1992 WMT                  15



     H : Hold current display
     This is distinct from, yet similar to, the "freeze" command that is
called with the "TAB" key. This key is simply ignored in the "Semi-Auto"
mode. In the "Auto" mode it lets the "Auto-DAZE" state (refer to Pan/Scroll
description above) continue to normal completion, and will even let a
Pan/Scroll proceed normally if one happens to have been selected by the
"Fade-Out" state. But it causes the "Fade-Out" state to jam in the pause
delay mode forever. Here the program will wait until you manually select a
fade. Note that the fade that you select will commence immediately. The
Scroll Lock LED will light solidly, indicating that user intervention is
required to allow the program to proceed normally. Refer to the Scroll Lock
LED description above for more details.

     If you press "H" as soon at DAZZLE enters the pause delay mode, then
any fade select key, the delay is effectively canceled -- allowing you to
immediately induce any fade you wish.

     N : Next display now
     This key has been made immediately effective in all modes. It stops
any current image generation or fade, and begins a screen clear process.
This is the fastest way to blank the screen.

8.11. Mouse Clicks
     DAZZLE will test for the presence of a Microsoft compatible Mouse
driver. If any mouse button is pressed (or if the screen is contacted when
using a Touch Screen system that is Microsoft Mouse compatible) DAZZLE will
usually interpret that action as being the same as pressing the "ENTER"
key. Note that in the text menu subsystem of this current version a mouse
click aborts the program.

9. KEYS ACTIVE IN "SEMI-AUTO" MODE
     DAZZLE supports a whole set of commands to allow the user to control
the image generation process of the program. Refer to "Selecting Modes"
above for details on accessing the "Semi-Automatic" mode. Note that
configuration options that disable a fade cause that fade to be unavailable
in the "Semi-Auto" mode also. In addition to the keys described in the
"KEYS ACTIVE IN ALL MODES" section above, the following keys can be used
while in the "Semi-Auto" mode.

9.1. F8 : Toggle continuous drawing mode
     This key is similar to the F10 Draw Current Image key, except that
"F8" will draw the selected image continuously until the next press of the
"F8" key. All other keys maintain their normal function even while the
continuous drawing mode is active. This mode is switched off when you exit
'Semi-Automatic' operation, but remains active through a fade or menu
access. Review the section below with the F10 key description for more
details.

9.2. F9 : Select Random Image
     If the user wishes to let DAZZLE randomly select the next image
generating algorithm to be drawn then press the "F9" function key. It
selects another image each time it is pressed. Note that specific images
can be selected as detailed below.





DAZ50h-921008 Programs & documentation (c)1992 WMT                  16


9.3. F10 : Draw Current Image
     Once an image algorithm has been selected by whatever means, the "F10"
key is pressed to draw that image. The image will be drawn for as long as
you hold down this key. You may release the key, and when you press it
again it will simply resume where it left off if you have not pressed
another key. It is suggested that you start an image with just a tap of
this key, note what it is doing, and then decide how long you wish to hold
it. Since there are no limits on image generation time with this key, you
can let a really interesting pattern grow continuously, producing visual
effects that "Auto" mode will never duplicate. This key will remember the
image being played even if you perform a "fade". So if a great image gets
too busy, you can "fade" it and press "F10" again and pick up where you
left off.

     Due to the behavior of the "typematic" key repeat built into the
keyboard controller, it is possible for DAZZLE to get confused about when
you release the "F10" key. If this happens then the selected image will
continue drawing after you release this key. Just a quick tap of this key
again will bring it to a halt.

9.4. Alt-F10 : Reinitialize Current Algorithm
     This key allows the continued use of the same currently selected image
algorithm. But it causes the image algorithm to be reinitialized to new
random settings. This is most useful for changing between various modes of
the same algorithm. Some images support use of exclusive-OR for "ghosting"
or mosaic texturing, some can change shape, most will change color and
screen location when this is pressed.

9.5. Specific Image Selection Keys
     It is possible to specify exactly which image algorithm you wish
DAZZLE to use by pressing one of the Alt-keys 0 through 9, or A through Z.
Press the "Alt" key, and a letter key or number key (use the numbers along
the top of the keyboard, not the ones over on the side calculator pad).
Each represents a specific image selection. The "Image Size" display in the
"Configuration" menu list the name of each algorithm, and the Alt-key that
can be used to select that image.

     In addition to the Alt-keys pattern selection, Ctl-keys A through Z
can be used to select images that are detailed in the second "Image Size"
display in the "Configuration" menu list of algorithms.

10. CONFIGURATION
     DAZZLE allows the user to customize many of the characteristics of the
image generation and fade actions. At any time you may press the "F2"
function key to activate the configuration menu subsystem. This system
offers useful enhancements and controls.

10.1. Cursor Keys within CONFIGURE
     When within the configure subsystem DAZZLE recognizes the various
standard cursor keys. The "HOME" key jumps to the first entry field of the
current screen. The "END" key jumps to the last entry field of the current
screen. The "PgDn" key advances to the next screen, the "PgUp" returns to
the previous screen. The arrow keys also can be used. Note that the bottom
right of the text window shows what page movement keys are valid at that
point.




DAZ50h-921008 Programs & documentation (c)1992 WMT                  17


10.2. Exiting CONFIGURE
     The text menu subsystems, including the configure system, can be
exited by pressing the same key that invokes that subsystem. Thus to exit
configure press the "F2" key again.

10.3. Image Size Control
     These two screens allow the user to customize the images generated in
the "Auto" mode of DAZZLE. When an image is called, it is allowed to draw
on the display for a variable amount of time, the duration of which centers
around the number entered in this menu. This number is multiplied by an
internal value that reflects the size of the display and the resolution of
the current active video mode. Therefore these numbers are relative and not
absolute in their impact. Since the screen resolution varies from EGA to
VGA, it is also true that the maximum value that can be entered changes
between video modes. You may enter any large number, DAZZLE will reduce
your input to the legal range for the current mode. The minimum value is 0,
thus allowing the complete disabling of images as you desire. At least one
image must have a non-zero value, a configuration file that fails this
criteria may cause DAZZLE to abort during startup.

     As the "Image Size" number is increased the selected image is allowed
to draw longer, producing either larger patterns, more patterns, and/or a
greater variety of pattern variations.

     The "KEY" field shows which Alt-key or Ctl-key (refer to "Specific
Image Selection Keys" above) will select that specific image drawing
algorithm. The "NAME" field shows the internal name of that image. The
"SIZE" field shows the current relative size limit for that image. Note
that the first Image Size screen is for use with Alt-key images, and the
second Image Size screen is for use with Ctl-key images.

10.4. Fade Enable Control
     This screen allows the user to selectively enable or disable specific
fades. If disabled, the fade will be unavailable in either "Auto" or "Semi-
Automatic" modes. If the user presses a fade command key (refer to "The
Fade Control Keys" above) for a fade that has been disabled then DAZZLE
will randomly select an enabled fade to execute. Note that in addition to
the listed fades, DAZZLE uses a "fade to black" process to clear the screen
at the end of each fade.

     The "KEY" field shows which key (without the "Alt", "Ctl", or "Shf"
keys being used) will select that specific fade algorithm. The "FADE" field
shows the internal name of that fade. The "ENABLE" field shows the current
state for that fade.

10.5. Auto Mode Display Customization
     This menu shows two numbers; "Minimum images per display" and "Maximum
images per display". These values control the number of images that will be
overlaid on a single screen during the Auto Mode of operation. When set to
small numbers only a few images will be mixed together on one display prior
to the next fade. This reduces how busy the screen becomes. When set to
large numbers many images will be mixed together on a display prior to the
next fade. This creates a much more complex display.

     This menu also allows you to control how long the program pauses in an
idle state before initiating a fade. This time is provided to allow a
screen to be appreciated before it is removed.


DAZ50h-921008 Programs & documentation (c)1992 WMT                  18



     The bottom of this menu states, "These numbers will be increased if in
Alternate or Mad mode..." What specifically happens is that if the program
is operating in the Alternate (faster color cycling) mode then the number
of overlaid images is increased by up to the number you entered as a
minimum count. If the program is operating in the Mad (fastest color
cycling) mode then the number of overlaid images is increased by up to the
number you entered as a maximum count.

10.6. File Access Menu
     This screen allows the user to save or load a DAZZLE configuration
file. There are three entry fields on this screen. Two additional function
keys are also recognized only when viewing this screen.

     Select Mode
     At this entry the user can select either to "Save" the current
configuration information, or to "Load" an existing file. Press either the
"S" key or the "L" key, then "ENTER".

     File Name
     At this entry the user can specify the file to be saved or loaded.
Note that a default name is provided if one was not used at program
invocation. To replace the name simply begin typing it in, and press
"ENTER" when completed. It is suggested that a file extension (the last
three characters in the name, on the right of the period) of ".DZL" be
used. The following extensions are illegal : .BAT, .COM, .EXE.

     Beneath this field is an unmarked "File Status" field. If you attempt
to load a nonexistent file this will show "NOT FOUND". If you try to save
over an existing file this will show "EXIST", unless the file is protected
from overwriting, in which case it will show "READ ONLY".

     If you specify a wildcard character ("*" or "?") within this entry,
then DAZZLE will automatically invoke a directory list to aid in your
selection process.

     Path
     The current disk and directory path is displayed in this field. You
may specify any variation of disk and path information that DOS would
normally support. Each of the following are legal:

     ..        (changes to previous directory)
     C:        (changes to C drive)
     \MT       (to MT directory on current disk)
     D:\       (to root directory on D drive)

     F3 : View Disk Directory
     Pressing the "F3" function key invokes the disk directory display.
Note that if you have begun an entry in any of the menu's fields you must
press "ENTER" before this key can take effect.

     Once a disk directory is displayed you may use the various cursor keys
to move around. Arrow keys work, and the "HOME" key jumps to the top of the
display, the "END" key jumps to the bottom. The "PgUp" and "PgDn" keys can
be used to move about more quickly. Press "ENTER" to select a specific
file, or "F3" again to exit this display.



DAZ50h-921008 Programs & documentation (c)1992 WMT                  19


     If you select a field that ends with a "\" (backslash) character, you
are selecting a directory, and the display will be updated to reflect the
contents of this new default path. The path field in the File Access Menu
also will be updated to this new path.

     File names displayed in lower case letters are "Read Only".

     F4 : Execute Save/Load
     Once the desired file has been specified, the "F4" function key can be
pressed to execute the specified command. If the "F4" key is ignored, then
you may still have a pending input entry; simply press "ENTER" then try the
"F4" key again.

11. USAGE WITHIN WINDOWS
     DAZZLE has been tested with both Windows2.0 and Windows3.x, both with
excellent results. While a true Windows Application Interface is available
from Worldwide MicroTronics, Inc. , this version is very usable as is.
DAZZLE can be left inactive in the background, and brought up on the screen
where it was last interrupted with a simple Alt-TAB (or equivalent) key
press. In Extended 386/486 system the DAZZLE image will start intact from
an interruption, otherwise the image may be corrupted when DAZZLE is first
resumed but it will correct itself once the next fade operation is
completed.

     As a basic starting point create DAZZLE.PIF with these entries:

     Program Parameters : /W
     Memory Required: 350KB, Memory Desired 350KB
     Display Usage: Full Screen
     Close Window on Exit
     Allow Close on Exit

All other options should be disabled. Especially avoid any video monitor
selections. If you are not using a 386/486 computer you may not be asked to
set each of these options.

12. CONFIGURATION FILE FORMAT
     The file that is used by DAZZLE is an editable text file that follows
a simple format. Each entry in the file must be on a separate line, and
consist of a "Key ID" and a "Configuration Value". It is suggested that the
user invoke DAZZLE in it's default mode, use the File Access Menu to "Save"
a copy of the program's configuration. That file should then be printed.
With DAZZLE in the Configuration Menu mode, a printout of the configuration
file, and a copy of this document in hand, the whole process should prove
to be very clear.

12.1. Shift Key Tokens
     A token in DAZZLE is a character that represents a condition. In order
to represent within the configuration file the condition of the three shift
keys-Alternate, Control, Shift-a group of tokens have been assigned as
follows:

     Alternate = ~       (Tilde character)
     Control = ^         (Caret character)
     Shift  = `          (grave or backwards-quote character)




DAZ50h-921008 Programs & documentation (c)1992 WMT                  20


     Thus to specify the Alt-A key, the file entry would be "~A". To
specify the Ctl-F key, the file entry would be "^F".

12.2. Special Token
     This file also contains a special token to allow the specification of
menu configuration entries that do not match any shift key function. The
"$" (dollar) token is used to mark such a field. The values for Auto Mode
Display Customization are contained in this file as:

$I : the mInimum number of images on one display
$X : the maXimum number of images on one display
$F : Fade delay time in Auto mode

12.3. Key ID
     A "Key ID" entry in the file consist of the key to be designated, with
an optional shift key token prefix. Refer to Shift Key Tokens above for
examples.

12.4. Configuration Value
     The value to be specified must be surrounded in square brackets; "["
and "]".

     If the value is for an Image Size or configuration entry, then the use
of an unsigned integer value is required. Unsigned meaning no "+" or "-"
values. Integer meaning no fractions, decimal points, or exponents.
Therefore legal values are: "[25]" or "[0001]" or "[ 99 ]". Illegal values
would include: "[-1]" or " 25]" or "[14.5]".

     If the value is for a fade entry, then the use of either a "Y" or an
"N" character is required: "[Y]" or "[N]".

12.5. Comment Lines
     While reading (parsing) any line of text in the file, when a ";"
(semicolon) is encountered DAZZLE stops reading that line. This allows the
liberal insertion of various comments within the file. DAZZLE is very
casual about parsing this file. It tolerates extra space and tab
characters, so you can generally make the file look any way you like.

12.6. Version Flag
     The first non-comment line in the file should be the version flag. It
consists of a "#" (hash) character followed by an unsigned integer of the
DAZZLE version of the creating program. This is intended for future
compatibility between upgrades and should not be changed.

13. PROGRAM INTEGRITY
     All reasonable effort has been made to assure that the use of this
program on any compatible computer system can have no detrimental side
effects. In addition to extensive Quality Assurance testing, the DAZZLE
program contains an internal integrity check (read the section on the "/I"
command line option above). If someone makes any code modifications to this
program, it probably will be detected and the program will refuse to
execute. Any persons making unauthorized modifications will be aggressively
pursued and prosecuted. As of revision 5.0 the antiviral system uses a
faster and better CRC checking algorithm.





DAZ50h-921008 Programs & documentation (c)1992 WMT                  21


14. PROGRAMMERS COMMENTS
     DAZZLE is written mostly in Borland C 3.1 (copyright Borland).
Assembler code for direct video control.

     Talented and accomplished people are always an asset. If you might be
interested in contributing to a Worldwide MicroTronics, Inc. project, then
please write, and if possible include a NON-CONFIDENTIAL sample of your
work.

     Some of you have questioned me about the "Our Creator, evidenced by
our creativity" message on the program credits artwork screen. This section
is perhaps the best way to answer all the questions. I hope you will
receive it in the same friendly spirit in which it is offered.

HIDDEN TRUTH
Are you willing to think about it honestly, or will you dismiss truths
without ever questioning what motivates your prejudice? If you have never
asked yourself these or similar questions, or are not ready to face the
answers, then skip this section.

2 Cor 4:3,4    Even if the truth is veiled, it is veiled to those who are
perishing. The false god of this age has blinded the minds of unbelievers,
so that they cannot see the light of the good news of the glory of the
anointed one, who is the image of God.

REVEALED IN SUPERNATURAL POWER
The truth of the good news about Jesus the Christ is that he is the Son of
God (Mark 1:1) who will save us and call us to a holy life - not because of
anything we have done but because of his own purpose and grace (2 Tim 1:9).

Do not be afraid or ashamed of this truth, because it is the power of your
creator God for the salvation of everyone who believes (Rom 1:16)

Luke 4:18,19   The Spirit of the Lord is on me, because he has anointed me
to preach good news to the poor. He has sent me to proclaim freedom for the
prisoners and recovery of sight for the blind, to release the oppressed, to
proclaim the year of the Lord's favor.

THERE IS A PURPOSE FOR YOUR LIFE
Col 2:2-4      My purpose is that they may be encouraged in heart and
united in love, so that they may have the full riches of complete
understanding, in order that they may know the mystery of God, namely,
Christ, in whom are hidden all the treasures of wisdom and knowledge. I
tell you this so that no one may deceive you by fine-sounding arguments
[and New Age deceptions].

SALVATION MUST PRECEDE PURPOSE
Isa 12:2,3     Surely God is my salvation; I will trust and not be afraid.
The Lord is my strength and my song; he has become my salvation. With joy I
will draw water from the wells of salvation.

OUR ETERNAL HOPE
Titus 3:4-7    When the kindness and love of God our Savior appeared, he
saved us, not because of righteous things we had done, but because of his
mercy. He saved us through the washing of rebirth and renewal by the Holy
Spirit, whom he poured out on us generously through Jesus Christ our



DAZ50h-921008 Programs & documentation (c)1992 WMT                  22


Savior, so that, having been justified by his grace, we might become heirs
having the hope of eternal life.

CHALLENGE
Read this section again from the beginning with the viewpoint of "What if
this just happens to be true?" What do you risk to simply give it a try?
When you are ready for the true answers to life's hardest questions
remember the source of all wisdom, Jesus (Yeshua) of the Holy Bible.

CREDITS
Scriptures liberally taken from the New International Version, copyright
International Bible Society.















































DAZ50h-921008 Programs & documentation (c)1992 WMT                  23


15. DAZZLE Distribution Authorization

     This statement of agreement is valid only for those persons and
organizations distributing for a fee shareware files from Worldwide
MicroTronics, Inc. Possession and use of registered executable copies of
our Shareware programs does not require the signing of this agreement.
Distribution of Worldwide MicroTronics, Inc. shareware products, even free
of charge, without clearly explaining to the recipient their legal
requirement to register the program is strictly forbidden, and a violation
of copyright law.

     The enclosed DAZZLE program is hereby offered for your non-exclusive
use and distribution as a Shareware product. Anyone wishing to charge
people a fee for giving them a copy of any Worldwide MicroTronics, Inc.
programs MUST sign and return this form to Worldwide MicroTronics, Inc., or
will be in violation of copyright restrictions. Distributors recognized by
the Association of Shareware Professionals will normally be approved
without question. A complementary copy of your catalog would be greatly
appreciated.

Name of Organization :____________________________________________________
Your Name :          ____________________________________________________
Address :            ____________________________________________________
                     ____________________________________________________
                     ____________________________________________________

TERMS OF DISTRIBUTION OF DAZZLE:
1.   The fee charged may not exceed $7, including postage, mailer and any
other charges.

2.   Your library's catalog or listing must state that this program is not
free, but is copyrighted software that is provided to allow the user to
evaluate it before paying.

3.   The offering and sale of DAZZLE will be stopped at any time the author
so requests.

4.   Duplicates must be made from the copy of DAZZLE sent to you directly
from Worldwide MicroTronics, Inc. . The program and its documentation files
must be supplied in their entirety, without modification, truncation, or
omission.

5.   Problems or complaints will be reported to the author for resolution.

In return for the right to charge a fee for the distribution of the program
DAZZLE, I agree to comply with the above terms of distribution.


_________________________________________ _________________________
Your signature                Date           Title

Member, Association of Shareware Professionals







DAZ50h-921008 Programs & documentation (c)1992 WMT                  24
Dazzle 5.1a
 
 
 
 
 
                                 D A Z Z L E
 
                    The Ultimate Graphics Image Generator
 
 
                                  Shareware
                               Usage Agreement
                                     and
                                User's Manual
 
 
 
 
                        Documentation for Revision 5.1
                                17 March, 1994
 
 
 
 
 
                         Worldwide MicroTronics, Inc.
                                 P.O.Box 8759
                          Spring, TX USA 77387-8759
                           (713) 298-1698 voice/fax
 
 
 
BY USING THIS SOFTWARE YOU ARE AGREEING TO ALL THE TERMS, LIMITATIONS, AND
CONDITIONS CONTAINED HEREIN. This software is NOT FREE, see the SHAREWARE
section for details. Payment of shareware registration does NOT entitle user
to any other products, especially not any retail products.
 
Please take the time to review this whole document as soon as possible in your
use of DAZZLE. The program is far more configurable and flexible than it
initially appears, and the great majority of questions that arise are
addressed herein. The size of this document lends itself to being printed for
easier review and reference.
 
Information in this document is subject to change without notice and does not
represent a commitment on the part of Worldwide MicroTronics, Inc.(WMT). The
software described in this document is furnished under a license agreement.
The software may be used or copied only in accordance with the terms of the
agreement.
 
Programs & documentation Copyright(c)1989-94 Worldwide MicroTronics,Inc.(WMT)
 
 
 
1. DAZZLE OVERVIEW...........................................................1
 
 
2. INTRODUCTION..............................................................1
 
 
3. SHAREWARE.................................................................3
 
3.1. USAGE LIMITATION........................................................3
3.2. REVISION CONTROL........................................................4
3.3. CURRENT REGISTRATION FEE, DISCOUNTS, AND CREDIT CARDS...................4
3.4. SITE LICENSES...........................................................6
3.5. FUTURE PRODUCTS.........................................................6
3.6. ROYALTIES...............................................................6
3.7. DISCLAIMER..............................................................7
3.8. DISTRIBUTION LIMITATION.................................................7
3.9. OMBUDSMAN...............................................................7
 
4. COMMAND LINE OPTIONS......................................................7
 
4.1. MAIN OPTIONS MENU.......................................................8
4.2. ADDITIONAL OPTIONS MENU.................................................8
4.3. SPECIFYING OPTIONS......................................................8
4.4. COMPATIBILITY OPTIONS...................................................9
4.5. ARTISTIC OPTIONS.......................................................11
4.6. OTHER OPTIONS..........................................................12
4.7. SPECIFYING THE INPUTFILE...............................................14
 
5. ON-LINE HELP.............................................................15
 
5.1. CURSOR KEYS WITHIN HELP................................................15
5.2. EXITING HELP...........................................................15
 
6. LED INDICATIONS DURING DAZZLE............................................15
 
6.1. SCROLL LOCK LED........................................................15
6.2. NUM LOCK LED...........................................................15
6.3. CAP LOCK LED...........................................................16
 
7. PRIMARY DAZZLE MODES.....................................................16
 
7.1. SELECTING MODES........................................................16
 
8. KEYS ACTIVE IN ALL MODES.................................................16
 
   ESCAPE : PROGRAM TERMINATION ............................................16
   TAB : FREEZE IMAGE ......................................................16
   F5 : DUMP SCREEN PCX IMAGE TO DISK FILE .................................17
   F6 : DUMP SCREEN BMP IMAGE TO DISK FILE .................................17
   "." : TOGGLE QUIET MODE .................................................17
   "+" AND "-" : COLOR CYCLING CLOCK ADJUSTMENT ............................17
   "PGUP" AND "PGDN" VGA COLOR CYCLING STEP ADJUSTMENT .....................17
   SHF-F10 : REINITIALIZE THE COLOR PALETTE ................................18
   CTL-F10 : SELECT NEW BACKGROUND COLOR ...................................18
   THE FADE CONTROL KEYS ...................................................18
   SPECIAL FADE CONTROL KEYS ...............................................18
 
 
DAZ5.1 17-Mar-94 Programs & documentation (c)1994 WMT                i
 
 
   MOUSE CLICKS ............................................................19
 
9. KEYS ACTIVE IN "SEMI-AUTO" MODE..........................................19
 
   F8 : TOGGLE CONTINUOUS DRAWING MODE .....................................19
   F9 : SELECT RANDOM IMAGE ................................................19
   F10 : DRAW CURRENT IMAGE ................................................20
   ALT-F10 : REINITIALIZE CURRENT ALGORITHM ................................20
   SPECIFIC IMAGE SELECTION KEYS ...........................................20
 
10. CONFIGURATION...........................................................20
 
10.1. CURSOR KEYS WITHIN CONFIGURE..........................................20
10.2. EXITING CONFIGURE.....................................................21
10.3. CONFIG VERSUS IMAGE CONTROL...........................................21
10.4. IMAGE SIZE CONTROL....................................................21
10.5. FADE ENABLE CONTROL...................................................21
10.6. AUTO MODE DISPLAY CUSTOMIZATION.......................................22
10.7. FILE ACCESS MENU......................................................22
 
11. USAGE WITHIN WINDOWS....................................................23
 
 
12. CONFIGURATION FILE FORMAT...............................................23
 
12.1. SHIFT KEY TOKENS......................................................24
12.2. SPECIAL TOKEN.........................................................24
12.3. KEY ID................................................................24
12.4. CONFIGURATION VALUE...................................................24
12.5. COMMENT LINES.........................................................24
12.6. VERSION FLAG..........................................................24
 
13. PROGRAM INTEGRITY.......................................................24
 
 
14. PROGRAMMERS COMMENTS....................................................25
 
 
15. DAZZLE DISTRIBUTION AUTHORIZATION.......................................27
 
 
APPENDIX A -- RETAIL RAZZLE DAZZLE 3D DESCRIPTION...........................28
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
DAZ5.1 17-Mar-94 Programs & documentation (c)1994 WMT               ii
 
 
1. DAZZLE Overview
version number: 5.1
 
         The only Screen Saver so stunning that it has been made into a
                             Long Form Music Video!
 
Transform your color VGA or EGA-equipped PC into a stunning source of
computer-generated beauty. DAZZLE is a hypnotizing graphics image generator
acclaimed in computer magazines as the best self-directing art program
available. It fills the computer monitor with continually evolving displays
that protect the screen from image burn. A popular diversion for waiting
rooms, reception areas, and family rooms at home. Used in conjunction with
your favorite music, there is no form of entertainment quite like it.
 
*    Award winning interactive color kaleidoscopic program that provides
     endless changing visual viewscapes.
 
*    Performance art for the eyes featuring a rich selection of drawing
     algorithms, fades, and special effects.
 
*    Includes a self-directing mode which is an effective and entertaining
     attention getter.
 
 
System Requirements
 
*    Personal computer using the 8088, 186, 286, 386, or higher processor.
 
*    EGA, VGA, 8514/A graphics card, or compatible video graphics adapter and
     color monitor.
 
*    MS-DOS or PC-DOS operating system version 3.1 or higher.
 
 
 
2. INTRODUCTION
      DAZZLE is an award winning self directing color image generator for DOS
and Windows computers with EGA or VGA compatible color displays and adapters.
Performance art for the eyes.
 
      A source of beauty; sometimes subtle, sometimes vibrant, always
changing. The image engine has numerous primary image drawing algorithms, most
of which have at least two styles of presentation, many of which have multiple
internal drawing variations. There is an assortment of fades, including split
screens and pans, used by the imaging system for greater diversity of
presentation. The entire color range of the detected video system is utilized
for maximum variety and visual stimulation.
 
      When the "Semi-Automatic" mode of DAZZLE is active, the user can play
the program from the keyboard. Specifically selecting each pattern to draw, or
letting the program select the pattern randomly. The selected pattern is
generated for as long as the user holds the draw key. There are no limits on
the mixing of image patterns. The user can then invoke a specific fade effect,
or let the program select an effect randomly. The types of displays that can
be generated in this fashion are far more varied, and personal, than anything
that "Auto" mode ever produces.
 
 
 
DAZ5.1 17-Mar-94 Programs & documentation (c)1994 WMT                1
 
 
      There is a configuration menu that allows the customization of DAZZLE
image generation. It also allows the selective disabling of various fades.
This configuration information can be written to an editable text file, and
either loaded again from the menu or loaded automatically at program
invocation by specifying the file name on the DAZZLE command line.
 
      An on-line HELP text window system is included in DAZZLE.
 
      In the self generating "Auto" mode the primary image algorithms are
mixed randomly on the screen. An adjustable number of images are overlaid at a
time, producing a very large assortment of possible displays. Each display
remains for a while to be appreciated, then the screen is cleared via a fade
algorithm, and another set of patterns is presented. Mathematically speaking,
an exact pattern match might not occur for many weeks of continuous operation.
Human perception is far less exacting and will discern repetition well ahead
of these extremes, but the general effect is impressive and frequently
surprising. Note that the starting patterns of the program will be different
each time it is executed. If the program seems predictable, exit it and start
it over again.
 
     ...the best kaleidoscope program we've seen yet. The
     beautiful use of colors, enhanced even further by the use of
     fading in and out, is, for want of a better word, awesome.
 
      DAZZLE has received many other good press reviews, and has been awarded
"Best New Graphics Program." There have since been complimentary reports too
numerous to repeat here, our thanks to all who have been so supportive.
 
      DAZZLE can be used in a variety of ways. At the office it keeps the
screen from being burned by constant display of an unchanging prompt. Simply
start the program when leaving your desk or answering the phone or otherwise
diverted. One option is to start DAZZLE from a keyboard locking program so
that unauthorized access is prevented on your unattended computer until you
return (see note below in section "3.5. Future Products" about HARCOM Security
product). Additional programs are available from Worldwide MicroTronics, Inc.
that provide self-starting DOS and Windows Screen Saver capability, and
optional password protection. This shareware version is NOT a self activating
memory resident screen saver. The retail RAZZLE DAZZLE 3D program provides
full screen saver capability (Payment of DAZZLE shareware registration does
NOT entitle user to a copy of RAZZLE DAZZLE. Retail products must be purchased
separately). Section "3.5. Future Products" below features information about
these and other programs.
 
      DAZZLE can be used to aid relaxation. In its slower cycling VGA modes
(where this program REALLY shines) it is often soothing and helps one to shift
conscious attention from the cares of the day. Watching DAZZLE causes a
reduction of blood-pressure, general relaxation, and heightened alpha states
in the brain. When overwhelmed with problems or pressures, it is often true
that shifting one's focus from an immediate concern allows the objectivity
needed to enhance decision making and settle the nerves.
 
      DAZZLE is a performing art realization on a computer platform. Used with
your favorite music DAZZLE can be highly entertaining and regenerating. In its
self-directing play mode it is great "living" mobile art.
 
 
 
 
 
DAZ5.1 17-Mar-94 Programs & documentation (c)1994 WMT                2
 
 
3. SHAREWARE
      Shareware is a brave concept in software marketing that allows you to
"try before you buy." Shareware authors retain all rights under their
copyright, but allow free distribution of their programs within specified
limits. Distributors of shareware -- including on-line BBS and catalog
outlets -- usually do not charge for the shareware software itself. The
distributors are charging for their own services in providing access to their
resources. Registration payment directly to the author entitles the user to
additional services, information, and newer products. It is a great deal for
users, authors, and distributors alike. Please support this honor system
marketing technique so that more great programs of increasingly professional
quality can reasonably be provided via this system.
 
      Copyright laws apply to both shareware and commercial software, and the
copyright holder retains all rights, with a few specific exceptions clearly
stated by the author. Shareware authors are accomplished programmers, just
like commercial authors, and the programs are of comparable quality -- in both
cases there are good programs and bad ones! The main difference is in the
method of distribution. The shareware author specifically grants the right to
copy and distribute the software to all.
 
      Shareware is a distribution method, not a type of software. You should
find software that suits your needs and budget, whether it's commercial or
shareware. The shareware system makes fitting your needs easier, because you
can try before you buy. And because the overhead is low, prices are low also.
Shareware has the ultimate money-back guarantee -- if you don't use the
product, you don't pay for it.
 
      You are encouraged to pass a copy of DAZZLE along to your friends for
evaluation, BUT PLEASE DO NOT GIVE IT AWAY ALTERED OR AS PART OF ANOTHER
SYSTEM (unless you have an OEM license from WMT). Please encourage them to
register their copy if they find that they can use it. Businesses, BBS's, and
catalog operations please note: distribution of Worldwide MicroTronics, Inc.
(WMT) shareware products, even free of charge, without clearly explaining to
the recipient their legal requirement to register the program is strictly
forbidden, and a violation of USA copyright law and International Treaty
Provisions.
 
3.1. Usage Limitation
      Please note that this program is NOT FREE. You are entitled to use it
for evaluation over a short time (not more than 15 days) to determine if it
functions adequately for your needs, after which time a registration fee paid
directly to Worldwide MicroTronics, Inc. is required by copyright law, and
greatly appreciated by all of us. Any distribution or on-line fee paid by you
to copy DAZZLE is (usually) not forwarded to Worldwide MicroTronics, Inc. by
the distributor, and therefore would not constitute payment of a registration
fee. The purchase price you paid for a book or a magazine authorized to
distribute this software, or another program that contained an OEM version of
this program, does NOT constitute payment of the mandatory registration fee
due directly to Worldwide MicroTronics, Inc. (WMT).
 
The images generated by this program are protected under copyright law (see
section "3.6. Royalties" below).
 
Businesses and government agencies MUST register every copy of this program in
use anywhere within their operations, facilities, or place of business. Use of
this software without proof of registration payment is strictly forbidden.
 
 
DAZ5.1 17-Mar-94 Programs & documentation (c)1994 WMT                3
 
 
 
3.2. Revision Control
      Worldwide MicroTronics, Inc. is NOT responsible for revision control of
DAZZLE through any source other than direct mailings from our office. If you
request a copy from any other source please be certain of the revision level
that you are acquiring, and that it contains all related files and
documentation.
 
      Your registration fee for DAZZLE entitles you to legally use the copy of
DAZZLE in your possession beyond the 15 day evaluation period. We also offer
one disk copy of DAZZLE from us within the first year -- at your option. It is
assumed that all payments are registrations of existing copies, so disk are
not automatically mailed unless the request for "order" or "update disk" is
clearly identified in the letter. Many users prefer to retain their disk
option until the next newer release is available. PLEASE specify your floppy
disk size (3 or 5 inch) when writing (we ship High Density disk). Once you
have received your disk, additional disk updates are available at a reduced
fee. Names on our mailing list will be maintained for at least 1 year from
last contact unless materials are returned without forwarding address.
Registration of this shareware product does NOT entitle the user to any of our
other products, not even the RAZZLE DAZZLE 3D program (which can be purchased
separately, details in Appendix A -- retail RAZZLE DAZZLE 3D description
below).
 
3.3. Current registration fee, discounts, and credit cards
      The registration fee for this version of DAZZLE is $15 ($20US for
customers outside the continental U.S.A. please). You may enter the command
"DAZZLE /$" to display a convenient order form. The output is standard English
ASCII text. If you have a dot-matrix printer, or a LaserJet, or other device
that can print normal ASCII text attached to your computer, you can use this
command to print the form: "DAZZLE  /$  >  PRN:  " (don't include the quotes).
If you have a postscript printer, or other device that will not accept normal
ASCII text, use whatever tools are provided to print standard DOS type text
files. If you must print from a file, you can use this command:
"DAZZLE  /$  >  ORDRFORM.TXT  " (don't include the quotes). Basically,
whatever commands you used to print this manual should also work for the order
form.
 
If you have access to Compuserve and would like to register online you may do
so. The registration cost will be added to your next Compuserve billing
statement. We treat Compuserve orders like mail orders, thus we send a coupon
(for a free update disk) instead of a disk, unless you specifically instruct
us otherwise. Please note that as of this writing Compuserve charges a flat
US$20 per online registration, for either domestic or international
registrations. So this offering may be most attractive to our international
customers. To register the program within Compuserve, type GO SWREG, and
select program #150, program name DAZZLE.
 
 
 
 
 
 
 
 
 
 
 
 
DAZ5.1 17-Mar-94 Programs & documentation (c)1994 WMT                4
 
 
   ------------------------------------------------------------------------
 
                         ! CREDIT CARD ORDERS ONLY !
 
You can order with MC, Visa, Amex, or Discover from Public (software) Library
by calling 800-2424-PsL or 713-524-6394 or by FAX to 713-524-6398 or by CIS
Email to 71355,470. You can also mail credit card orders to PsL at P.O.Box
35705, Houston, TX USA 77235-5705.  Ask for PRODUCT NUMBER 11205, name DAZZLE.
 
                    THE ABOVE NUMBERS ARE FOR ORDERS ONLY.
 
Orders placed with PsL are currently US$15 per disk, shipping to USA and
Canada is free, shipping anywhere else is US$5 extra.
 
Any questions about the status of the shipment of the order, refunds,
registration options, product details, technical support, volume discounts,
dealer pricing, site licenses, etc., must be directed to Worldwide
MicroTronics, Inc..
 
To insure that you get the latest version, PsL will notify us the day of your
order and we will ship the product directly to you shortly thereafter.
 
  -------------------------------------------------------------------------
 
For those that wish to buy multiple registrations of the unmodified shareware
product the following discounts are currently allowed if ordered directly from
Worldwide MicroTronics, Inc.:
 
Copies 1 through 3
      Registration cost $15 each ($20US foreign)
 
Copies 4 through 8
      Additional cost $12 each ($17US foreign)
 
Copies 9 or more
      Additional cost $7 each ($12US foreign)
 
Thus 12 copies would cost $133.00 (3x$15 + 5x$12 + 4x$7). Discounts may be
discontinued without prior notice. Multiple registrations make for a great
gift idea to your computer using friends, and are wonderful around the office.
This pricing is for independent registrations of multiple program copies.
Worldwide MicroTronics, Inc. will provide a disk and documentation for each
copy thus registered, and put the recipient of each copy on our mailing list.
 
      A single registration fee will license one copy for use on any one
computer at any one time. You must treat this software just like a book. An
example is that this software may be used by any number of people and may be
freely moved from one computer location to another, so long as there is no
possibility of it being used at one location while it's being used at another.
Just as a book cannot be read by two different persons at the same time.
 
Additional registration offices are being considered to service customers
outside of the continental U.S.A. As we receive additional registrations from
international customers we will be able to improve the level and accessibility
of support, and produce multilingual programs.
 
 
 
 
DAZ5.1 17-Mar-94 Programs & documentation (c)1994 WMT                5
 
 
3.4. Site Licenses
      Also available are MULTI-COPY or SITE LICENSES -- minimum quantity 10
copies. The licensee receives one "master" copy of the program and all related
documentation, additional master copies of disk and/or documentation are
available for an extra charge. These may be copied by the licensee for
multiple users at the designated location (site) up to the number of licensed
copies. The current offer is that $15 is paid for the master copy supplied
from us, and you pay $5 for each additional copy that you make (subject to the
terms of the Site License agreement). The number of authorized copies can be
automatically extended by simply submitting the additional funds with a letter
referencing the original site license. SITE LICENSES AND MULTICOPY LICENSES
MUST BE PAID DIRECTLY TO WORLDWIDE MICROTRONICS, INC.. NOT TO ANY OTHER
REPRESENTATIVE, OUTLET, AGENT, OR OTHER ENTITY.
 
      PLEASE DO NOT ASSUME THAT ANY SITE, OFFICE, COMPANY, OR GOVERNMENT
OPERATION HAS AN UNLIMITED LICENSE TO COPY AND USE ANY WORLDWIDE MICROTRONICS,
INC. PROGRAM, INCLUDING DAZZLE. We have never (as of this writing) issued an
open or unlimited license, and probably will not. Please be certain that you
know the limits of the license under which you are making copies. Honesty and
prevention are much cheaper options for EVERYBODY.  But then, our attorney's
have children to feed also, so we do not hesitate to utilize their resources.
 
3.5. Future Products
      Self-activating DOS, Windows 3.1, and Windows-NT Screen Saver RAZZLE
DAZZLE 3D is available at better U.S.A. computer software retail stores.
International distribution still under review as of this writing. Ingram-
Merisel does make our retail programs available to retail outlets in Europe,
and perhaps other nations by the time you read this. All the features of the
prior DAZLOGO program are now incorporated in the retail RAZZLE DAZZLE 3D
program. This product is distinct from the DAZZLE shareware program, and it is
NOT provided as part of the upgrade offer to DAZZLE registrants. Information
about international availability of RAZZLE DAZZLE 3D can be acquired from Road
Scholar, Inc. at (713) 266-7623, or write to us at WMT for direct order
information. A fuller description of the RAZZLE DAZZLE 3D program is attached
to the end of this document.
 
      A full computer security version of MT-DAZE is available from Harcom
Security Systems Corp. For details call (800) 275-3438 or (212) 766-1802.
 
      DAZZLE, the music video, is available on stereo VHS video cassette from
your local Radio Shack, or from Miramar at (206) 284-4700. Miramar also can
tell you where to get the LaserDisk version of the video.
 
3.6. Royalties
      ALL COMMERCIAL RIGHTS TO THIS PROGRAM ARE RETAINED BY THE AUTHOR.
 
      The images generated by this program are intended for viewing on a
computer executing a registered copy of this software, and may be extracted,
projected, or otherwise translated onto other media only for personal
enjoyment or non-commercial use within companies which have registered this
software. Public display of DAZZLE images is permitted without royalty for
registered copies that are used for trade shows, point of sales, and offices,
where such usage is for entertainment or demonstration purposes, if no
admission is charged, and the display is incidental to the business being
conducted.
 
 
 
 
DAZ5.1 17-Mar-94 Programs & documentation (c)1994 WMT                6
 
 
3.7. Disclaimer
      Users of DAZZLE and related products must accept this disclaimer of
warranty: "DAZZLE is supplied for non-exclusive usage as is. The author
disclaims all warranties, expressed or implied, including, without limitation,
the warranties of merchantability and of fitness for any purpose. The author
assumes no liability for damages, direct or consequential, which may result
from the use of these programs."
 
3.8. Distribution Limitation
      During most of 1993 WMT was not approving new domestic distributors for
DAZZLE, and requested major shareware outlets to withdraw the program from
their supplies. This was mandated by the terms of our RAZZLE DAZZLE retail
publishing contract. As of this writing we have been granted permission to
resume shareware marketing. We are happy to resume direct shareware
promotions, and thank all the quality outlets for their excellent support.
 
      Anyone distributing DAZZLE for any kind of remuneration should notify
Worldwide MicroTronics, Inc., use of the supplied form (refer to section "15.
DAZZLE Distribution Authorization" below) is recommended. CD-ROM distributors,
FTP sites, and ASP recognized BBS operators are encouraged to post and
distribute this program, others are required to submit the Distribution
Authorization form below BEFORE distributing this program. Distribution of
Worldwide MicroTronics, Inc. shareware products, even free of charge, without
clearly explaining to the recipient their legal requirement to register the
program is strictly forbidden, and a violation of copyright law.
 
3.9. Ombudsman
      Worldwide MicroTronics, Inc. (formerly, MicroTronics) is an associate
member of the Association of Shareware Professionals (ASP). ASP wants to make
sure that the shareware principle works for you. If you are unable to resolve
a shareware-related problem with an ASP member by contacting the member
directly, ASP may be able to help. The ASP Ombudsman can help you resolve a
dispute or problem with an ASP member, but does not provide technical support
for members' products. Please write to the ASP Ombudsman at 545 Grover Road,
Muskegon, MI 49442 or send a Compuserve message via Compuserve E-Mail to ASP
Ombudsman 70007,3536.
 
4. COMMAND LINE OPTIONS
      A number of options that control the action of the DAZZLE family of
programs can be specified on the command line when the program is invoked.
With the exception of the "/$" and the "/Z" options, all command line options
can be controlled from a self-documenting menu system. Enter "DAZZLE /#" to
access this menu from the command line, or use the "F2" key while the program
is running and press "C" for the CONFIG menu.
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
DAZ5.1 17-Mar-94 Programs & documentation (c)1994 WMT                7
 
 
4.1. Main Options Menu
      When you enter the command "DAZZLE -?" at the DOS prompt you will be
presented with the following display.
 
The following options can be specified on the command line and are used to
customize and control the action of "Dazzle". These options can also be
specified in a batch (.BAT) file for automatic activation.
 
   /$  Display order information.
   /2  2-part palette, fixes flickering screens but slows drawing.
   /a  Alternate Palette Speed - automatically changes cycling speed.
   /b  Bashful - no closing credits & pressing any key quits the program.
   /c  Compatible mode - use the PC's BIOS for better compatibility.
   /d  Delay - slows the drawing speed for faster PC's.
       "/d=xxxx" delays drawing speed by the specified value.
   /i  Insecure - CRC checking is not performed when program starts.
   /m  Mad - uses fastest color cycling speed...a real attention getter!
   /q  Quiet - no tones (this option has no effect on warning beeps).
   /s  Show - displays a single image then quits.
       "/s=xxxx" shows for the specified number of seconds then quits.
   /w  Window - changes defaults for use with Windows.
   /x  XT compatible - for use on 8088/8086 PC's with EGA or VGA.
   /z  Create DAZZLE.DOC file on current disk path!
For example - if you want to start "DAZZLE" so that no tones are heard,
no CRC checking is performed, and operate in Windows compatible mode,
type the following command:
                  DAZZLE /q /i /w
Press any key to continue
 
4.2. Additional Options Menu
      When you press a key at the "Press Any Key" prompt you will be presented
with the following display.
 
While "DAZZLE" is running, the [Tab] key will freeze the display until
the [Space] bar is pressed.
The [F1] key activates on-line help during the program. The [F2] key provides
a menu of configuration options. The [Esc] key terminates the program.
 ** Refer to DAZZLE.DOC for more details **
 
 Additional command line options:
   /+  Empty keyboard buffer on exit.
   /!  Monitor Screen Saver driver interface.
   /e  EGA - forces EGA display mode.
   /f  Fade VGA brightness during use (Screen Dimmer).
   /g  iGnore mouse - don't let it terminate the program.
   /h  Hide EGA border - forces a black border in EGA mode.
   /k  Keyboard Typematic - allows program to change the typematic rate.
   /r  Retract hard disk heads at program startup (see manual).
   /t  Tall Video - forces the program to use standard BIOS aspect ratio.
   /v  VGA mode forced, disable SVGA (see manual).
 
4.3. Specifying Options
      The Dazzle program accepts any combination of options on the initial
command line that affect its mode of operation. The options may be preceded
with either the "/" (slash) character or the "-" (minus) character. If you use
the SwitchChar feature of MS-DOS, the "/" (slash) option marker character can
be changed to any other key. At least one space must exist between the Dazzle
 
 
DAZ5.1 17-Mar-94 Programs & documentation (c)1994 WMT                8
 
 
command and the first option. For example, "DAZZLE -FC" instructs Dazzle to
execute with Fixed colors and in Compatible mode. The options are not case-
sensitive -- uppercase and lowercase letters are treated identically. The
options may either be concatenated into a single string or entered separately
(-FC is treated the same as -F -C). The optional input file may be specified
anywhere on the command line. For example, "DAZZLE  -I  MTDAZZLE.DZL" has the
same effect as "DAZZLE  MTDAZZZLE.DZL  -I". Both commands instruct Dazzle to
start up in Insecure mode and to load the configuration file MTDAZZLE.DZL
before starting the image generation process. Note that Dazzle will
automatically attempt to locate and load a configuration file named
MTDAZZLE.DZL unless explicitly instructed otherwise with the "*" (asterisk) or
"-*" (minus asterisk) command line options. The effects of each option are
detailed below.
 
We provide this documentation on using the command line options directly for
completeness, but strongly encourage the use of the "DAZZLE /#" access to the
menu driven interface as a superior means of controlling the program.
 
4.4. Compatibility Options
      Some of the options for DAZZLE are specifically related to increasing
portability of the program to various computers and displays. The "2", "c",
"d", "e", "k", "v", and "x" options default to the most desirable modes, but
can be controlled by the user. VGA users also should refer to the "t" option
for details.
 
/2 = 2-part palette, fixes flickering screens but slows drawing.
      Normally the entire color palette is updated at one time for each tick
      of the color cycling clock. If the CPU clock speed or the VGA palette
      register update rate is too slow, the upper part, or perhaps all of the
      display, will flicker badly during the display. To determine if this is
      due to palette updates, press and hold the "-" (minus) key during the
      running graphics display until it beeps (this is the slowest cycling
      clock rate). If the display flickers only when the color changes, then
      palette update speed is a problem. Using the "2" option splits the VGA
      palette update request into two almost equal groups that are handled
      sequentially. This should remove, or at least significantly reduce,
      cycling induced flicker. This option should not be used if not needed,
      as it slows the entire display generation process. This option affects
      operation with VGA adapters only, since they allow longer 256 color
      palettes. Short 16 color palettes for EGA's are never divided into two
      separate updates.
 
/C = Compatible mode - use the PC's BIOS for better compatibility.
      Normally DAZZLE bypasses the video adapters BIOS code for maximum speed
      in color palette cycling. However, some rare adapters may have problems
      with this mode of operation. To cause DAZZLE to use the provided BIOS
      the "C" option can be used. If your display flickers or distorts, or
      the color fails to cycle smoothly during the display, then try this
      option to determine if it corrects the problem. This option reduces
      program performance speed and should not be used if not needed.
 
/D = Delay - slows the drawing speed for faster PC's.
 "/d=xxxx" delays drawing speed by the specified value.
      This option serves both artistic and compatibility purposes. On faster
      computers the DAZZLE drawing algorithms can be too fast to appreciate
      as an evolving image. If the computer is too fast, or if you simply
      desire to induce a slower drawing speed for purely aesthetic reasons,
 
 
DAZ5.1 17-Mar-94 Programs & documentation (c)1994 WMT                9
 
 
      this option can be used to delay the drawing process. If used simply as
      "/D", without specifying any delay units, the program will use a
      default delay amount. To adjust the amount of delay a specific value
      can be provided after the "=" (equal) character. There is no exact
      relationship of the delay unit value and the impact on the drawing
      speed, it must be experimentally determined on each computer. The
      larger the number, the slower the drawing.
 
      The delay unit value ranges from 1 (minimum) to 8191(maximum), and can
      be entered without leading zero's. There must be no spaces or tabs
      between the "D", the "=", and the numbers for the delay units. This
      option can be concatenated with other non-numeric options. Thus
      "/AD=250W" is a legal command option string.
 
/E = EGA - forces EGA display mode.
      Normally DAZZLE will automatically detect the video adapter hardware
      attached and adjust itself to use either the EGA or the VGA mode. This
      "/E" option allows VGA users to select and view the EGA mode of
      operation, which is 640x350 16-color in format. As of revision 4.0 this
      option, like the "/V" option, will prevent DAZZLE from aborting if it
      thinks that it has detected an unacceptable video controller/monitor
      combination, though it will still give its usual error messages during
      startup. Refer to the "/V" option below for more information.
 
/K = Keyboard Typematic - allows program to change the typematic rate.
      "Keyboard Acceleration" utilities cause the self-repeating "typematic"
      function of the keyboard to repeat far more rapidly. They come in two
      flavors:
 
      *     Those that tell the keyboard to send keys more often.
      *     Those that trick DOS into thinking that more keys arrive than
            actually are sent by the keyboard.
 
      When specifying this command line option, DAZZLE will set the
      "typematic" rate of the keyboard to it's minimum value for best program
      performance. When DAZZLE terminates it puts the "typematic" speed back
      to a value typical of most DOS defaults. Those that use a keyboard
      speed-up utility that stops having an effect after DAZZLE has been
      executed have the first type of such a utility. If you want the keys
      back to their quicker speed you can re-execute your speed-up command.
 
/V = VGA mode forced, disable SVGA (see manual).
      Normally DAZZLE will automatically detect the video adapter hardware
      attached and adjust itself to use either the EGA or the VGA mode.
 
      The retail RAZZLE DAZZLE 3D program can detect and use a VESA
      compatible SVGA driver for 640x480 sized 256 color images. Using this
      option with that program forbids the use of SVGA, and makes the program
      run in the normal VGA mode.
 
      In the shareware DAZZLE product this option generally SHOULD NOT BE
      NECESSARY, OR USED. It should be unable to cause any damage, but is
      intended for rare compatibility conflicts where the startup code in
      DAZZLE falsely rejects the video controller/monitor combination as
      unacceptable. This option, like the "/E" option, will allow the error
      messages to be reported (so that you can write us of the problem), but
      will prevent the program from aborting itself. If the
 
 
DAZ5.1 17-Mar-94 Programs & documentation (c)1994 WMT               10
 
 
      controller/monitor is really VGA compatible, or really EGA compatible
      if using the "/E" option, then normal image generation should be
      observed. Unlike the "/E" option, this option lacks artistic usage or
      impact.
 
      The VGA mode uses all 256 color palette registers for a far more subtle
      and interesting series of displays. The default VGA mode of DAZZLE uses
      a specially enhanced 320x400 256-color mode that is not properly
      captured by many commercial products. The VGA modes require no more
      than 256kB of video memory.
 
/X = XT compatible - for use on 8088/8086 PC's with EGA or VGA.
      This option allows DAZZLE to execute on 8088 or 8086 based PC/XT type
      computers with EGA or VGA adapters and color displays. This option will
      be automatically initiated if the 808x style CPU is detected at program
      startup, but specifying the command line option avoids the warning
      message. The EGA performance on XT computers seems acceptable, but the
      VGA mode may be noticeably inferior to the performance of an 80x86
      based computer. The faster the CPU clock the better the overall
      performance and fluidity of DAZZLE.
 
4.5. Artistic Options
      These options adjust the image generating algorithms used by the
program. They are largely artistic in nature but allow customizing the
presentation to various environments and requirements.
 
/A = Alternate Palette Speed - automatically changes cycling speed.
      The default color cycling mode is the slowest, with the most subtle
      shadings and transitions. The mad speed ("/M") is the fastest. There
      are a total of three color cycling modes within the program. The
      cycling rate used in shaping the palette contents. The effect is
      distinct from, but can complement, the "+" and "-" keys that can be
      used while the program is active.
 
      This option causes the program to automatically change between the
      three color cycling modes within the program. This produces the most
      varied and divergent kinds and tempo's of displays.
 
/F = Fade VGA brightness during use (Screen Dimmer).
      Normally DAZZLE will randomize the color palette registers between each
      screen erase before starting the next image generation. This allows all
      the possible colors (up to a quarter million on VGA) to be used by the
      program. Sometimes the program will use darker colors, sometimes
      bright.
 
      This option forces the VGA palette to grow continually darker while the
      program is operating, until it finally reaches a minimum brightness
      stage (usually about 20 to 30 minutes of operation). Most CRT monitors
      draw less electrical power as the general brightness of the display is
      reduced. Some can save as much as 80% of their consumption when dark as
      opposed to fully illuminated. This feature allows the user to realize
      the benefits of the relaxing DAZZLE artwork, and also reduce the idle
      power use of their system when it is not in active use -- conserving
      resources, and MONEY.
 
 
 
 
 
DAZ5.1 17-Mar-94 Programs & documentation (c)1994 WMT               11
 
 
/H = Hide EGA border - forces a black border in EGA mode.
      Some folks find the colored border on the EGA display distracting, and
      some displays do not perform retrace masking properly. This option will
      cause the border color in EGA modes to be forced to black at all times.
 
/M = Mad - uses fastest color cycling speed...a real attention getter!
      This option not only greatly accelerates the color palette contents
      rotation, but it also increases the number of images that can be
      displayed in "Auto" mode at one time before the screen is erased. The
      effect is a far busier screen, a more intense visual experience. This
      is particularly suited to attention-getting in showrooms and other
      public displays, whereas the default mode is more practical for
      personal meditation and relaxation.
 
/S = Show - displays a single image then quits.
 "/s=xxxx" shows for the specified number of seconds then quits.
      The "/S" option gives a single panel of images and then terminates
      automatically. This is most useful when DAZZLE is to be executed from
      within other programs or batch files. The image displayed is different
      each time.
 
      The "/S=xxxx" option allows DAZZLE to execute for a specified length of
      time, after which it will terminate at the end of the next fade.
 
      The duration value ranges from 1 (minimum) to 3600(maximum), and can be
      entered without leading zero's. There must be no spaces or tabs between
      the "S", the "=", and the numbers for the duration. This option can be
      concatenated with other non-numeric options. Thus "/AS=250W" is a legal
      command option string.
 
/T = Tall Video - forces program to use standard BIOS aspect ratio.
      Normally the EGA mode of DAZZLE uses a 16 color 640x350 resolution
      display with a modified aspect ratio (screen is mapped as if it had
      640x700 resolution).
 
      The default VGA mode uses 256 color 320x400 resolution. The "/T" option
      causes the program to use the standard BIOS supported 320x200 screen
      resolution and aspect ratio in generating all images. The effect is
      somewhat faster image generation, but with a noticeably tall aspect
      ratio. Note that due to VGA hardware limitations, using this option
      will prevent the display of "dual page" effects (where a screen
      composed of a different image than the one being displayed is "panned"
      or "scrolled" onto the visible display area).
 
4.6. Other Options
 
/$ = Display order information.
      Issuing this option when invoking DAZZLE will cause the program to
      output a convenient order form that can be quickly completed and sent
      to Worldwide MicroTronics, Inc. for product orders, information
      request, and shareware registration. To send this form directly to a
      printer use the MSDOS output redirection character ">" (greater-than or
      right-pointer) to specify the destination. For example, if you have a
      printer that can accept standard ASCII text on your computer port PRN:,
      then the command to use would be:
            DAZZLE /$ > PRN:
 
 
 
DAZ5.1 17-Mar-94 Programs & documentation (c)1994 WMT               12
 
 
      Complete the form and mail it to the indicated address. Enclose any
      indicated funds in U.S. Dollar instruments, payable to Worldwide
      MicroTronics, Inc.
 
/B = Bashful - no closing credits & pressing any key quits program.
      DAZZLE will identify itself, including its revision level, when the
      program is started. The BASHFUL option will prevent closing credits
      when the program terminates (similar to the SHOW option), and
      additionally prevents DAZZLE from clearing the type ahead keyboard
      buffer when it exits. This allows usage of DAZZLE in a more classical
      "Screen Saver" mode, since whatever key is pressed to exit is not lost.
 
      This mode disables ALL key interpretation of DAZZLE. Even the "+" and
      the "-" keys will cause DAZZLE to terminate. The shareware version of
      DAZZLE does not initiate itself in a "Screen Saver" fashion under DOS
      or Windows, this flag is used by the retail Screen Saver drivers from
      Worldwide MicroTronics, Inc. This mode blocks the use of the keyboard
      LED's to indicate the state condition of the executing DAZZLE program.
      DAZZLE has been successfully used within MS/Windows (copyright
      Microsoft), but use of this option will prevent window selection
      keystrokes. Use of the command line option "/W" was added for the
      windows environment as detailed below.
 
/G = iGnore mouse, don't let it terminate the program.
      Specifying this option prevents this program from attempting to
      communicate with your mouse driver. This option makes any activity on
      the mouse invisible to this program.
 
/I = Insecure - CRC checking is not performed when program starts.
      Before starting the image display process DAZZLE will normally perform
      a test on the disk copy of itself in an attempt to assure that no
      unauthorized modifications ("hacks") have been made to the program
      after it was distributed from Worldwide MicroTronics, Inc. . This is a
      safety feature added for YOUR protection! Please note that this is NOT
      a system-wide scan for virus infection-only the current disk copy of
      the DAZZLE.EXE file is checked, nor is the self-check completely
      exhaustive. Once you have used your copy of DAZZLE, after it has passed
      its antiviral test and you no longer wish to endure the delay at every
      invocation for this testing, you can use this command line option to
      bypass this safety feature. IF YOUR COPY OF DAZZLE FAILS THIS TEST,
      PLEASE NEVER USE THIS OPTION! INSTEAD WRITE TO THE SUPPLIER THAT GAVE
      YOU THE BAD COPY! A clean copy can be in your hands in a very short
      time, and might save your software investment (NOTE: Worldwide
      MicroTronics, Inc. only supplies disk to our registered users.)
 
/Q = Quiet, no tones (no effect on beeps).
      This option will block the tones that DAZZLE emits at various points in
      its operations. But warning beeps are generally not restricted. DAZZLE
      uses programmed tones for most alerts and signals that it issues. These
      tones are of short duration, and change pitch depending on the
      condition being signaled. With the increase in operational options
      these tones are very helpful in determining the state the program is
      in. The one place where these tones are superfluous is the tiny tune in
      the closing credits, but this tune can be aborted with any keypress.
 
      In the retail RAZZLE DAZZLE 3D program this command also controls the
      volume of the midi music composer.
 
 
DAZ5.1 17-Mar-94 Programs & documentation (c)1994 WMT               13
 
 
 
/R = Retract hard disk heads at program startup.
      This option instructs DAZZLE to "park" your hard disk heads in a safe
      "landing zone" position. Retracting the disk heads is a safety
      precaution provided to reduce the possibility of disk damage from an
      unexpected loss of power to the computer while DAZZLE is executing.
      Older drives that do not automatically retract at the loss of power
      might benefit from retracting the heads before turning the power off.
      Retracting the heads, and removing electrical power, is also prudent
      before physically moving a computer. DAZZLE issues a standard BIOS
      "PARK DISK" (Int 13h, Function 19h) call to retract the disk, therefore
      it is the BIOS in your own computer that performs the retraction. We
      can answer no questions about how this is done, nor warrant that the
      action taken is that which is desired. We are not responsible for
      direct or consequential problems or losses that may arise from using
      this option. We know of no reason to be concerned about using this
      option, but suggest not using it if you have any reason to doubt its
      impact on your computer. On some models of disk drives it is possible
      that an unusual sound will be made the next time the hard disk is
      accessed after having been parked. This is usually a "recalibration"
      step, and generally not a technical cause for concern.
 
/W = Window - changes defaults for use with Windows.
      This option was added to simplify use of DAZZLE within MS/Windows
      environments. It prevents the startup antiviral check (please see the
      "/I" option for a discussion of the risk involved), and all startup
      messages. This mode blocks the use of the keyboard LED's to indicate
      the state condition of the executing DAZZLE program. It allows normal
      "switch" key commands to Windows for task switching. DAZZLE will still
      show the closing credits graphic image, but not the closing text
      messages. This option can be used even if DAZZLE is not operating
      within Windows.
 
/Z = Create DAZZLE.DOC file on current disk path!
      DAZZLE keeps the entire Users Manual within itself in an efficient
      manner that has minimal impact on total usage of the program. By
      specifying this option DAZZLE will create a new DAZZLE.DOC Users Manual
      file on your current default disk directory, which you can then print.
      Note that this file is formatted for generic text printers.
 
/+ = Empty keyboard buffer on exit.
       This option forces the program to clear the keyboard buffer when
      exiting back to DOS, even if using the "/B" option.
 
/! = Monitor Screen Saver driver interface.
      The retail versions of RAZZLE DAZZLE 3D and related products allow
      execution as a self activating Screen Saver under both DOS and Windows.
      This option allows the retail version of the program to monitor the
      Screen Saver driver interface so that it performs normally in that
      environment, which is the default mode invoked by DAZTSR.
 
4.7. Specifying the INPUTFILE
      DAZZLE can accept the optional specification of an input file on the
command line. This file must contain a text script that is consistent with the
program's language specification. The specification of a path as well as a
filename is acceptable. Be sure to separate the file name from options with at
least one space.
 
 
DAZ5.1 17-Mar-94 Programs & documentation (c)1994 WMT               14
 
 
 
      DAZZLE will automatically attempt to locate and load a configuration
file named MTDAZZLE.DZL unless explicitly instructed otherwise with the "*" or
"-*" command line options.
 
5. ON-LINE HELP
      DAZZLE supports an on-line help menu system. You may press the "F1"
function key to activate the help subsystem. This system is intentionally
limited in size and scope to keep the program from growing too large, but it
offers useful summaries of the newest and most pertinent features of DAZZLE.
The graphics screen that was being displayed when help is activated is erased
when help is exited.
 
5.1. Cursor Keys within HELP
      When within the help subsystem DAZZLE recognizes the various standard
cursor keys. The "HOME" key jumps to the first page of help text. The "END"
key jumps to the last page of help text. The "PgDn" key advances to the next
page of help text, the "PgUp" returns to the previous page. The arrow keys
also can be used. Note that the bottom right of the text window shows what
page movement keys are valid at that point.
 
5.2. Exiting HELP
      The text menu subsystems, including the help system, can be exited by
pressing the same key that invokes that subsystem. Thus to exit help press the
"F1" key again.
 
6. LED Indications during DAZZLE
      The DAZZLE family of programs control the lighting of the Num Lock, Cap
Lock, and Scroll Lock LED's (Light Emitting Diodes) on the keyboard to
indicate to the user the state of the program as it moves through the various
conditions or "states" in normal operation. These LED's (or lights) can be on,
off, or blink; each represents a different condition as detailed below. Note
that use of the "/W" or the "/B" command line options prevent the DAZZLE
program from changing the keyboard LED indicators.
 
6.1. Scroll Lock LED
      This light indicates 1 of 3 possible conditions for the program.
 
1) When off, the program is not in any pause state, something is actively
being computed or displayed.
 
2) When blinking, the program is in an active countdown of a normal pause
delay. When the delay expires the program will proceed to the next action
without any need for user intervention.
 
3) When on, the program is halted in a pause state, and will not proceed until
the user takes some action. This can be induced by pressing either the "TAB"
key or the "H" fade key. Refer to the details elsewhere for these specific
keys to understand how to release the program from this state. This condition
also occurs when any text menu is on the display, use the specified menu exit
command to restore normal program execution.
 
6.2. Num Lock LED
      This light indicates that the program is either computing or displaying
a "Pan/Scroll Fade" process. If no activity is visible on the screen then the
program is building a new image on the "hidden" display so that it can be
 
 
 
DAZ5.1 17-Mar-94 Programs & documentation (c)1994 WMT               15
 
 
moved onto the active or "visible" display area. Refer to the "P" fade key for
additional details.
 
6.3. Cap Lock LED
      This light indicates that the program is computing a new VGA color
palette to use on the active display. The duration of this period is directly
dependent on the math speed of your computer. This indication was added to
inform users when their program seems halted that valid computations are
progressing unseen within the system. Refer to the "Shift-F10" key description
for additional details.
 
7. PRIMARY DAZZLE MODES
      DAZZLE has two primary modes of operation. The original "Automatic"
(a.k.a. "Auto") mode, which is fully self generating; and a new
"Semi-Automatic" (a.k.a. "Semi-Auto") mode, which allows interactive control
of the image generation process. Some keys are only effective in the
"Semi-Automatic" mode, others are active at all times.
 
7.1. Selecting Modes
      Selection between these two modes is done by pressing the "ALT"
(Alternate) key and the "F9" function key. This combination is referred to as
"Alt-F9". At program startup DAZZLE is always in "Auto" mode.
 
      To enter "Semi-Auto" mode press "Alt-F9". There is a short high pitched
tone. The display is cleared. The palette is reinitialized to a new setting
(this may take a few seconds on a slow VGA machine). Then a short multi-tone
chirp is emitted to indicate that "Semi-Auto" is ready for image drawing
commands.
 
      To return to "Auto" mode press "Alt-F9". There is a short lower pitched
tone. The display is cleared. The palette is reinitialized to a new setting.
Then the self generating engine begins creating random image displays.
 
8. KEYS ACTIVE IN ALL MODES
      Some key commands that DAZZLE recognizes are active regardless of the
current display mode. The meaning of some keys change slightly depending on
the current display mode.
 
 ESCAPE : Program Termination
      "The first and most important thing to learn about any program is how
      to get out of it." This key will do the job for you regardless of where
      you are in the program, just keep banging it till you get back to the
      DOS prompt. Note that when not in the various text menu screens, that
      "ENTER" also will terminate the program.
 
 TAB : Freeze Image
      The "TAB" key can be pressed at any time when not in a text menu to
      "freeze" the current graphics image display. Once pressed, DAZZLE will
      remain in "freeze" mode until the "SPACE" key is pressed (the "n" key
      will also work). While in "freeze" mode, the "TAB" can be repeatedly
      pressed to toggle between color-cycling and color-static modes. The
      "Shift-F10" key can be used to change the palette of an image in
      "freeze" mode. This is most useful in stabilizing a specific display
      for image capture. Even an image in the midst of a fade or pan can be
      put into "freeze" mode. This key is also active in the "Semi-Automatic"
      mode, though here its usefulness is limited to halting a fade in mid-
      execution.
 
 
DAZ5.1 17-Mar-94 Programs & documentation (c)1994 WMT               16
 
 
 
      The Scroll Lock LED on the keyboard will be continuously lighted to
      indicate that "freeze" is active. Refer to the section on Scroll Lock
      LED above for more details.
 
 F5 : Dump Screen PCX Image to Disk File
      Pressing the "F5" function key converts the display memory into an
      industry standard PCX disk image file. The program will name the file
      "DAZ xxxx.PCX", where xxxx is replaced with a number from 0000 to 9999,
      depending on what filenames already exist on the current disk path. The
      image format will match the current video mode of the program. The
      program will resume normal display after the file is completely
      written. If a "Pan/Scroll" fade is in effect when "F5" is pressed the
      "current" display will assume full screen position for the duration of
      the file creation, then the fade will return to normal action. Please
      note that all images from this program are copyrighted property of
      Worldwide MicroTronics, Inc. (refer to section "3.6. Royalties" above).
 
 F6 : Dump Screen BMP Image to Disk File
      Pressing the "F6" function key converts the display memory into an
      Windows standard BMP disk image file. The program will name the file
      "DAZ xxxx.BMP", where xxxx is replaced with a number from 0000 to 9999,
      depending on what filenames already exist on the current disk path. The
      image format will match the current video mode of the program. The
      program will resume normal display after the file is completely
      written. If a "Pan/Scroll" fade is in effect when "F6" is pressed the
      "current" display will assume full screen position for the duration of
      the file creation, then the fade will return to normal action. Please
      note that all images from this program are copyrighted property of
      Worldwide MicroTronics, Inc. (refer to section "3.6. Royalties" above).
 
 "." : Toggle Quiet Mode
      Pressing the "." (period) key while the program is drawing will toggle
      the Quiet mode (refer to "/Q" command line option) on and off. This
      allows muting of the program sounds without having to terminate
      execution.
 
 "+" and "-" : Color Cycling Clock Adjustment
      The fluid changing of DAZZLE images is largely the result of a clock
      driven rotation of the display's color palette. The user can adjust the
      rate of this clock at any time by using the "-" (minus) key or the "+"
      (plus) key. Pressing "-" reduces the clock rate, pressing "+" increases
      the clock rate. Note that DAZZLE defaults to maximum speed in VGA
      modes, and almost maximum rate in EGA modes. When either the maximum or
      the minimum clock rate is reached the console emits a short tone. This
      process is distinct from, yet can complement, the palette control
      command line options (see descriptions for "/A" and "/M" options
      above).
 
 "PgUp" and "PgDn" VGA Color Cycling Step Adjustment
      The degree of color change that occurs at each event of the color clock
      can be adjusted on VGA displays using the "Page Up" (PgUp) and "Page
      Down" (PgDn) keys. The program starts in the minimum step condition
      when loaded. This effect is distinct from, yet strongly complements,
      the "+" and "-" key functions described above.
 
 
 
 
DAZ5.1 17-Mar-94 Programs & documentation (c)1994 WMT               17
 
 
 Shf-F10 : Reinitialize the Color Palette
      Pressing the "SHIFT" key and also the "F10" function key simultaneously
      (Shf-F10) causes the current color palette of the display to be
      reinitialized to a new random condition. There is a short tone at the
      start of the request, and another tone when the process is completed.
      In EGA modes the process is almost instantaneous. In VGA modes it can
      take up to a few seconds, and the Cap Lock LED will light while the new
      palette is being computed. Refer to the Cap Lock LED description for
      further details.
 
 CTL-F10 : Select New Background Color
      Pressing the "CONTROL" key and also the "F10" function key
      simultaneously (CTL-F10) causes the background color of the current
      display to be changed to a new random value.
 
 The Fade Control keys
      DAZZLE allows the user to select which fades will be used. The actions
      of these keys vary slightly depending on the current mode. In "Auto"
      mode, pressing one of the fade keys sets which fade will be used next
      but allows the normal image generation process to continue. In the
      "Semi-Automatic" mode the fade keys induce the selected fade
      immediately.
 
      The "Fade Enable Control" screen in the "Configuration" menu shows
      which key (without the "Alt", "Ctl", or "Shf" keys being used) can be
      pressed to select a specific fade algorithm.
 
 Special Fade Control keys
      The following behave a little differently, so they have been set aside
      for special discussion.
 
 P : Pan/Scroll fade
      Unlike the previous fade keys, this one has to be pressed at a certain
      time to have any effect in the "Automatic" mode. When DAZZLE is drawing
      in "Auto" mode it is in the "Auto-DAZE" state (no LED's are lit, see
      details above about LED usage). Once the last image has been drawn it
      switches to the "Fade-Out" state (the Scroll Lock LED is lit). The
      first thing this latter state usually does is just pause for a while so
      that you can appreciate the incredible beauty of the display. The "P"
      key is only recognized in "Auto" mode if pressed while still in the
      "Auto-DAZE" state (before Scroll Lock lights). Once the last image has
      been drawn and the pause delay starts this key will simply be ignored.
 
      If a Pan/Scroll is in progress as indicated by the lighting of the Num
      Lock LED, then pressing the "P" key will assure that both a pan and
      also a scroll are presented.
 
      In the "Semi-Automatic" mode this key will not induce a Pan/Scroll.
      Since that effect is not supported in the "Semi-Auto" mode, pressing
      "P" causes one of the other fades to be randomly selected and executed
      immediately.
 
 H : Hold current display
      This is distinct from, yet similar to, the "freeze" command that is
      called with the "TAB" key. This key is simply ignored in the "Semi-
      Auto" mode. In the "Auto" mode it lets the "Auto-DAZE" state (refer to
      Pan/Scroll description above) continue to normal completion, and will
 
 
DAZ5.1 17-Mar-94 Programs & documentation (c)1994 WMT               18
 
 
      even let a Pan/Scroll proceed normally if one happens to have been
      selected by the "Fade-Out" state. But it causes the "Fade-Out" state to
      jam in the pause delay mode forever. Here the program will wait until
      you manually select a fade. Note that the fade that you select will
      commence immediately. The Scroll Lock LED will light solidly,
      indicating that user intervention is required to allow the program to
      proceed normally. Refer to the Scroll Lock LED description above for
      more details.
 
      If you press "H" as soon at DAZZLE enters the pause delay mode, then
      any fade select key, the delay is effectively canceled -- allowing you
      to immediately induce any fade you wish.
 
 N : Next display now
      This key has been made immediately effective in all modes. It stops any
      current image generation or fade, and begins a screen clear process.
      This is the fastest way to blank the screen.
 
 Mouse Clicks
      DAZZLE will test for the presence of a Microsoft compatible Mouse
driver. If any mouse button is pressed (or if the screen is contacted when
using a Touch Screen system that is Microsoft Mouse compatible) DAZZLE will
usually interpret that action as being the same as pressing the "ENTER" key.
Note that in the text menu subsystem of this current version a mouse click
aborts the program. See "/G" option for ignoring the mouse.
 
9. KEYS ACTIVE IN "SEMI-AUTO" MODE
      We document the functionality of this feature below, but to limit the
already massive size of this document we did not include the tutorial for this
mode that can be found in the current (as of spring 1994) retail
RAZZLE DAZZLE 3D manual. Thus experimentation is encouraged.
 
      DAZZLE supports a whole set of commands to allow the user to control the
image generation process of the program. Refer to "Selecting Modes" above for
details on accessing the "Semi-Automatic" mode. Note that configuration
options that disable a fade cause that fade to be unavailable in the "Semi-
Auto" mode also. In addition to the keys described in the "KEYS ACTIVE IN ALL
MODES" section above, the following keys can be used while in the "Semi-Auto"
mode.
 
 F8 : Toggle continuous drawing mode
      This key is similar to the F10 Draw Current Image key, except that "F8"
      will draw the selected image continuously until the next press of the
      "F8" key. All other keys maintain their normal function even while the
      continuous drawing mode is active. This mode is switched off when you
      exit 'Semi-Automatic' operation, but remains active through a fade or
      menu access. Review the section below with the F10 key description for
      more details.
 
 F9 : Select Random Image
      If the user wishes to let DAZZLE randomly select the next image
      generating algorithm to be drawn then press the "F9" function key. It
      selects another image each time it is pressed. Note that specific
      images can be selected as detailed below.
 
 
 
 
 
DAZ5.1 17-Mar-94 Programs & documentation (c)1994 WMT               19
 
 
 F10 : Draw Current Image
      Once an image algorithm has been selected by whatever means, the "F10"
      key is pressed to draw that image. The image will be drawn for as long
      as you hold down this key. You may release the key, and when you press
      it again it will simply resume where it left off if you have not
      pressed another key. It is suggested that you start an image with just
      a tap of this key, note what it is doing, and then decide how long you
      wish to hold it. Since there are no limits on image generation time
      with this key, you can let a really interesting pattern grow
      continuously, producing visual effects that "Auto" mode will never
      duplicate. This key will remember the image being played even if you
      perform a "fade". So if a great image gets too busy, you can "fade" it
      and press "F10" again and pick up where you left off.
 
      Due to the behavior of the "typematic" key repeat built into the
      keyboard controller, it is possible for DAZZLE to get confused about
      when you release the "F10" key. If this happens then the selected image
      will continue drawing after you release this key. Just a quick tap of
      this key again will bring it to a halt.
 
 Alt-F10 : Reinitialize Current Algorithm
      This key allows the continued use of the same currently selected image
      algorithm. But it causes the image algorithm to be reinitialized to new
      random settings. This is most useful for changing between various modes
      of the same algorithm. Some images support use of exclusive-OR for
      "ghosting" or mosaic texturing, some can change shape, most will change
      color and screen location when this is pressed.
 
 Specific Image Selection Keys
      It is possible to specify exactly which image algorithm you wish DAZZLE
      to use by pressing one of the Alt-keys 0 through 9, or A through Z.
      Press the "Alt" key, and a letter key or number key (use the numbers
      along the top of the keyboard, not the ones over on the side calculator
      pad). Each represents a specific image selection. The "Image Size"
      display in the "Configuration" menu list the name of each algorithm,
      and the Alt-key that can be used to select that image.
 
      In addition to the Alt-keys pattern selection, Ctl-keys A through Z can
      be used to select images that are detailed in the second "Image Size"
      display in the "Configuration" menu list of algorithms.
 
10. CONFIGURATION
      DAZZLE allows the user to customize many of the characteristics of the
image generation and fade actions. At any time you may press the "F2" function
key to activate the configuration menu subsystem. This system offers useful
enhancements and controls.
 
10.1. Cursor Keys within CONFIGURE
      When within the configure subsystem DAZZLE recognizes the various
standard cursor keys. The "HOME" key jumps to the first entry field of the
current screen. The "END" key jumps to the last entry field of the current
screen. The "PgDn" key advances to the next screen, the "PgUp" returns to the
previous screen. The arrow keys also can be used. Note that the bottom right
of the text window shows what page movement keys are valid at that point.
 
 
 
 
 
DAZ5.1 17-Mar-94 Programs & documentation (c)1994 WMT               20
 
 
10.2. Exiting CONFIGURE
      The text menu subsystems, including the configure system, can be exited
by pressing the same key that invokes that subsystem. Thus to exit configure
press the "F2" key again.
 
10.3. CONFIG versus IMAGE control
      The first menu presented allows you to select between the CONFIG and the
IMAGE set of control menus. The IMAGE menus allow you to customize the actual
graphics created by the self-directing "Auto" mode, and to save the settings
in a file. IMAGE controls are documented in the remainder of this section
below.
 
      The CONFIG selection brings up a menu that allows you to make any of the
command line options of the program permanent. You can also access this menu
directly from the DOS command line with the "/#" command line option.
 
      Each of the configuration options accepted by the program can be
controlled from this menu. Simply press the letter associated with the option.
A text window will appear and explain the function of the option, and allow
you to decide if you wish to activate the function. After you have set all the
options desired simply press the "ENTER" key. When it ask if you wish to make
the settings permanent press "Y".
 
10.4. Image Size Control
      These two screens allow the user to customize the images generated in
the "Auto" mode of DAZZLE. When an image is called, it is allowed to draw on
the display for a variable amount of time, the duration of which centers
around the number entered in this menu. This number is multiplied by an
internal value that reflects the size of the display and the resolution of the
current active video mode. Therefore these numbers are relative and not
absolute in their impact. Since the screen resolution varies from EGA to VGA,
it is also true that the maximum value that can be entered changes between
video modes. You may enter any large number, DAZZLE will reduce your input to
the legal range for the current mode. The minimum value is 0, thus allowing
the complete disabling of images as you desire. At least one image must have a
non-zero value, a configuration file that fails this criteria may cause DAZZLE
to abort during startup.
 
      As the "Image Size" number is increased the selected image is allowed to
draw longer, producing either larger patterns, more patterns, and/or a greater
variety of pattern variations.
 
      The "KEY" field shows which Alt-key or Ctl-key (refer to "Specific Image
Selection Keys" above) will select that specific image drawing algorithm. The
"NAME" field shows the internal name of that image. The "SIZE" field shows the
current relative size limit for that image. Note that the first Image Size
screen is for use with Alt-key images, and the second Image Size screen is for
use with Ctl-key images.
 
10.5. Fade Enable Control
      This screen allows the user to selectively enable or disable specific
fades. If disabled, the fade will be unavailable in either "Auto" or "Semi-
Automatic" modes. If the user presses a fade command key (refer to "The Fade
Control Keys" above) for a fade that has been disabled then DAZZLE will
randomly select an enabled fade to execute. Note that in addition to the
listed fades, DAZZLE uses a "fade to black" process to clear the screen at the
end of each fade.
 
 
DAZ5.1 17-Mar-94 Programs & documentation (c)1994 WMT               21
 
 
 
      The "KEY" field shows which key (without the "Alt", "Ctl", or "Shf" keys
being used) will select that specific fade algorithm. The "FADE" field shows
the internal name of that fade. The "ENABLE" field shows the current state for
that fade.
 
10.6. Auto Mode Display Customization
      This menu shows two numbers; "Minimum images per display" and "Maximum
images per display". These values control the number of images that will be
overlaid on a single screen during the Auto Mode of operation. When set to
small numbers only a few images will be mixed together on one display prior to
the next fade. This reduces how busy the screen becomes. When set to large
numbers many images will be mixed together on a display prior to the next
fade. This creates a much more complex display.
 
      This menu also allows you to control how long the program pauses in an
idle state before initiating a fade. This time is provided to allow a screen
to be appreciated before it is removed.
 
10.7. File Access Menu
      This screen allows the user to save or load a DAZZLE configuration file.
There are three entry fields on this screen. Two additional function keys are
also recognized only when viewing this screen.
 
Select Mode
      At this entry the user can select either to "Save" the current
      configuration information, or to "Load" an existing file. Press either
      the "S" key or the "L" key, then "ENTER".
 
File Name
      At this entry the user can specify the file to be saved or loaded. Note
      that a default name is provided if one was not used at program
      invocation. To replace the name simply begin typing it in, and press
      "ENTER" when completed. It is suggested that a file extension (the last
      three characters in the name, on the right of the period) of ".DZL" be
      used. The following extensions are illegal : .BAT, .COM, .EXE.
 
      Beneath this field is an unmarked "File Status" field. If you attempt
      to load a nonexistent file this will show "NOT FOUND". If you try to
      save over an existing file this will show "EXIST", unless the file is
      protected from overwriting, in which case it will show "READ ONLY".
 
      If you specify a wildcard character ("*" or "?") within this entry,
      then DAZZLE will automatically invoke a directory list to aid in your
      selection process.
 
Path
      The current disk and directory path is displayed in this field. You may
      specify any variation of disk and path information that DOS would
      normally support. Each of the following are legal:
 
            ..          (changes to previous directory)
            C:          (changes to C drive)
            \WMT        (to WMT directory on current disk)
            D:\         (to root directory on D drive)
 
 
 
 
DAZ5.1 17-Mar-94 Programs & documentation (c)1994 WMT               22
 
 
F3 : View Disk Directory
      Pressing the "F3" function key invokes the disk directory display. Note
      that if you have begun an entry in any of the menu's fields you must
      press "ENTER" before this key can take effect.
 
      Once a disk directory is displayed you may use the various cursor keys
      to move around. Arrow keys work, and the "HOME" key jumps to the top of
      the display, the "END" key jumps to the bottom. The "PgUp" and "PgDn"
      keys can be used to move about more quickly. Press "ENTER" to select a
      specific file, or "F3" again to exit this display.
 
      If you select a field that ends with a "\" (backslash) character, you
      are selecting a directory, and the display will be updated to reflect
      the contents of this new default path. The path field in the File
      Access Menu also will be updated to this new path.
 
      File names displayed in lower case letters are "Read Only".
 
F4 : Execute Save/Load
      Once the desired file has been specified, the "F4" function key can be
      pressed to execute the specified command. If the "F4" key is ignored,
      then you may still have a pending input entry; simply press "ENTER"
      then try the "F4" key again.
 
11. USAGE WITHIN WINDOWS
      DAZZLE has been tested with both Windows2.0 and Windows3.x, both with
excellent results. While a true Windows Application Interface is available (at
an additional cost) from Worldwide MicroTronics, Inc. , this version is very
usable as is. DAZZLE can be left inactive in the background, and brought up on
the screen where it was last interrupted with a simple Alt-TAB (or equivalent)
key press. In Extended 386/486/etc. system the DAZZLE image will start intact
from an interruption, otherwise the image may be corrupted when DAZZLE is
first resumed but it will correct itself once the next fade operation is
completed.
 
As a basic starting point create DAZZLE.PIF with these entries:
 
      Program Parameters : /W
      Memory Required: 350KB, Memory Desired 350KB
      Display Usage:ull Screen
      Close Window on Exit
      Allow Close on Exit
 
All other options should be disabled. Especially avoid any video monitor
selections. If you are not using a 386/486 computer you may not be asked to
set each of these options.
 
12. CONFIGURATION FILE FORMAT
      The file that is used by DAZZLE is an editable text file that follows a
simple format. Each entry in the file must be on a separate line, and consist
of a "Key ID" and a "Configuration Value". It is suggested that the user
invoke DAZZLE in it's default mode, use the File Access Menu to "Save" a copy
of the program's configuration. That file should then be printed. With DAZZLE
in the Configuration Menu mode, a printout of the configuration file, and a
copy of this document in hand, the whole process should prove to be very
clear.
 
 
 
DAZ5.1 17-Mar-94 Programs & documentation (c)1994 WMT               23
 
 
12.1. Shift Key Tokens
      A token in DAZZLE is a character that represents a condition. In order
to represent within the configuration file the condition of the three shift
keys-Alternate, Control, Shift-a group of tokens have been assigned as
follows:
 
      Alternate = ~       (Tilde character)
      Control = ^         (Caret character)
      Shift  = `          (grave or backwards-quote character)
 
Thus to specify the Alt-A key, the file entry would be "~A". To specify the
Ctl-F key, the file entry would be "^F".
 
12.2. Special Token
      This file also contains a special token to allow the specification of
menu configuration entries that do not match any shift key function. The "$"
(dollar) token is used to mark such a field. The values for Auto Mode Display
Customization are contained in this file as:
 
$I : the mInimum number of images on one display
$X : the maXimum number of images on one display
$F : Fade delay time in Auto mode
 
12.3. Key ID
      A "Key ID" entry in the file consist of the key to be designated, with
an optional shift key token prefix. Refer to Shift Key Tokens above for
examples.
 
12.4. Configuration Value
      The value to be specified must be surrounded in square brackets; "[" and
"]".
 
      If the value is for an Image Size or configuration entry, then the use
of an unsigned integer value is required. Unsigned meaning no "+" or "-"
values. Integer meaning no fractions, decimal points, or exponents. Therefore
legal values are: "[25]" or "[0001]" or "[ 99 ]". Illegal values would
include: "[-1]" or " 25]" or "[14.5]".
 
      If the value is for a fade entry, then the use of either a "Y" or an "N"
character is required: "[Y]" or "[N]".
 
12.5. Comment Lines
      While reading (parsing) any line of text in the file, when a ";"
(semicolon) is encountered DAZZLE stops reading that line. This allows the
liberal insertion of various comments within the file. DAZZLE is very casual
about parsing this file. It tolerates extra space and tab characters, so you
can generally make the file look any way you like.
 
12.6. Version Flag
      The first non-comment line in the file should be the version flag. It
consists of a "#" (hash) character followed by an unsigned integer of the
DAZZLE version of the creating program. This is intended for future
compatibility between upgrades and should not be changed.
 
13. PROGRAM INTEGRITY
      All reasonable effort has been made to assure that the use of this
program on any compatible computer system can have no detrimental side
 
 
DAZ5.1 17-Mar-94 Programs & documentation (c)1994 WMT               24
 
 
effects. In addition to extensive Quality Assurance testing, the DAZZLE
program contains an internal integrity check (read the section on the "/I"
command line option above). If someone makes any code modifications to this
program, it probably will be detected and the program will refuse to execute.
Any persons making unauthorized modifications will be aggressively pursued and
prosecuted. As of revision 5.0 the antiviral system uses a faster and better
CRC checking algorithm. See the section above about the "/R" option before
using it with your computer.
 
14. PROGRAMMERS COMMENTS
      DAZZLE is written mostly in Borland C (copyright Borland). Assembler
code was used for direct video control.
 
      Talented and accomplished people are always an asset. If you might be
interested in contributing to a Worldwide MicroTronics, Inc. project, then
please write, and if possible include a NON-CONFIDENTIAL sample of your work.
 
      Some of you have questioned me about the "Our Creator, evidenced by our
creativity" message on the program credits artwork screen. This section is
perhaps the best way to answer all the questions. I hope you will receive it
in the same friendly spirit in which it is offered. If you are inclined
towards censorship, or easily offended by simple truth, DON'T READ IT!
 
HIDDEN TRUTH
      What is the reason for human creativity? Why were we given this desire
      and capability that surpasses all physical survival needs? Could it be
      that it is a signature on our character of the very nature of our
      Creator? This suggest a personal transcendent supernatural God who
      cares about his creation, and is therefore relevant to our daily lives.
      Are you willing to think about it honestly, or will you dismiss truths
      without ever questioning what motivates your prejudice and fear?
 
      "Even if the truth is veiled, it is veiled to those who are perishing.
      The false god of this age has blinded the minds of unbelievers, so that
      they cannot see the light of the good news of the glory of the anointed
      one, who is the image of God." (2 Cor 4:3,4)
 
REVEALED IN SUPERNATURAL POWER
      The truth of the good news about Yeshua/Jesus the Messiah (Christ) is
      that he is the Son of God (Isa. 7:14 and Mark 1:1) who will save us and
      call us to a holy life - not because of anything we have done but
      because of his own purpose and grace (2 Tim 1:9).
 
      Do not be afraid or ashamed of this truth, because it is the power of
      your creator God for the salvation of everyone who believes (Rom 1:16)
 
      "The Spirit of the Lord is on me, because he has anointed me to preach
      good news to the poor. He has sent me to proclaim freedom for the
      prisoners and recovery of sight for the blind, to release the
      oppressed, to proclaim the year of the Lord's favor." (Isa. 61:1,2 and
      Luke 4:18,19)
 
THERE IS A PURPOSE FOR YOUR LIFE
      "My purpose is that they may be encouraged in heart and united in love,
      so that they may have the full riches of complete understanding, in
      order that they may know the mystery of God, namely, Christ, in whom
      are hidden all the treasures of wisdom and knowledge. I tell you this
 
 
DAZ5.1 17-Mar-94 Programs & documentation (c)1994 WMT               25
 
 
      so that no one may deceive you by fine-sounding arguments [and New Age
      deceptions]." (Col 2:2-4)
 
SALVATION MUST PRECEDE PURPOSE
      "Surely God is my salvation; I will trust and not be afraid. The Lord
      is my strength and my song; he has become my salvation. With joy I will
      draw water from the wells of salvation." (Isa 12:2,3)
 
OUR ETERNAL HOPE
      "When the kindness and love of God our Savior appeared, he saved us,
      not because of righteous things we had done, but because of his mercy.
      He saved us through the washing of rebirth and renewal by the Holy
      Spirit, whom he poured out on us generously through Jesus Christ our
      Savior, so that, having been justified by his grace, we might become
      heirs having the hope of eternal life." (Titus 3:4-7)
 
CHALLENGE
Read this section again from the beginning with the viewpoint of "What if this
just happens to be true?" What do you risk to simply give it a try? When you
are ready for the true answers to life's hardest questions remember the source
of all wisdom, Jesus/Yeshua of the Holy Bible.
 
CREDITS
Scriptures liberally taken from the New International Version, copyright
International Bible Society.
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
DAZ5.1 17-Mar-94 Programs & documentation (c)1994 WMT               26
 
 
15. DAZZLE Distribution Authorization
 
      This statement of agreement is valid only for those persons and
organizations distributing for a fee shareware files from Worldwide
MicroTronics, Inc.(WMT) Possession and use of registered executable copies of
our Shareware programs does not require the signing of this agreement.
Distribution of Worldwide MicroTronics, Inc. shareware products, even free of
charge, without clearly explaining to the recipient their legal requirement to
register the program is strictly forbidden, and a violation of copyright law.
 
      The enclosed DAZZLE program is hereby offered for your non-exclusive use
and distribution as a Shareware product. Anyone wishing to charge people a fee
for giving them a copy of any Worldwide MicroTronics, Inc. programs MUST sign
and return this form to Worldwide MicroTronics, Inc., or will be in violation
of copyright restrictions. Distributors recognized by the Association of
Shareware Professionals, CD-ROM distributors, and FTP sites, are not required
to file this form, but we do strongly request that you notify us of your
offering of our software so that we may keep your copies current!
 
Name of Organization :
Your Name :
Address :
 
 
 
TERMS OF DISTRIBUTION OF DAZZLE:
1.   The fee charged may not exceed US$10, including postage, mailer and any
     other charges.
 
2.   Your library's catalog or listing must state that this program is not
     free, but is copyrighted software that is provided to allow the user to
     evaluate it before paying.
 
3.   The offering and sale of DAZZLE will be stopped at any time the author
     so requests.
 
4.   Duplicates must be made from the copy of DAZZLE sent to you directly
     from Worldwide MicroTronics, Inc. . The program and its documentation
     files must be supplied in their entirety, without modification,
     truncation, or omission.
 
5.   Problems or complaints will be reported to the author for resolution.
 
In return for the right to charge a fee for the distribution of the program
DAZZLE, I agree to comply with the above terms of distribution.
 
 
 
Your signature                  Date            Title
 
WMT is a member of the Association of Shareware Professionals
 
 
 
 
 
 
 
 
DAZ5.1 17-Mar-94 Programs & documentation (c)1994 WMT               27
 
 
Appendix A -- retail RAZZLE DAZZLE 3D description
 
What is Razzle Dazzle 3D?
                               The full answer:
 
What we have created is the single most unique Screen Saver available for
either DOS or Windows.  How so?  We've taken just about everyone's wish-list
developed over the one year life span of the prior version of the retail
product, added the kitchen sink, and tossed together as much as we could with
the available time and resources.  This version of the program is busting out
all over with features, and comes far closer to being a full multimedia
presentation system than we ever imaged it would.  This is a multifaceted
graphical experience meekly hiding in Screen Saver's clothing.
 
Behold the beauty of math in all it's glorious colors.  We started with about
twice the number of graphic routines as in the DAZZLE shareware, and then went
really wild.  The 2D program has all your favorite DAZZLE effects, but so very
much more, and at higher SVGA resolutions!  There are fractals, to be sure, if
for no other reason than everybody wants it, even if they don't know what it
is.  But RAZZLE DAZZLE is structured to be pleasing to the eye, easy on the
psyche, and gentle on the computer (wait till you see our new RazDaz Ecology
Saver features -- no joke).  This program is as much of an aid for you as it
is for your computer.  You'll know this is true the first time you realize
that you've just been mesmerized for the longest time by the images, when you
only thought to look it's way for a moment.  How is it possible for so very
many images to be stored in one program?  Simple, they aren't.  Instead we put
in the math that describes a collection of beautiful and complementary shapes
and forms.  These are mixed using various colors and spatial relationships to
produce an almost endless variety of viewscapes.
 
Okay, so it draws incredibly beautiful pictures capable of soothing the savage
beast, what else is up it's sleeve?  Music!  Now two of your senses can be
massaged by the formula's that run at the heart of RAZZLE DAZZLE.  This is the
first Screen Saver to actually compose it's own music on the fly while you are
watching the images.  You can add other music styles to the internal music
composer with supplemental packages that are already available.  In addition,
you can feed any music of your own liking to the program to have it played
along with the graphical images.
 
Wow, graphics and music!  How could one top that?  Animation!  You can play
industry standard movie and animation files.  Supply your own flying corporate
logo, or use animation's from a variety of sources and libraries.  By
supplying still images, or animation's, in the variety of formats listed
below, you can totally customize your screen saver.  You can even have the
saver play a specific set of audio files with your custom animation's for a
multimedia presentation that is fantastic at trade shows, in office lobbies or
waiting rooms, during breaks at large meetings, or as a enterprise-wide
informational display (it's great by those ever-so-slow elevators).
 
But wait, there's more...  Video!  The native Windows versions of the program
(WinDaze) supports the AVI Video For Windows standard (some restrictions
apply, see below).  Grab some popular material from your favorite AVI source,
and enjoy the show.
 
Add to all of that, the new DOS VESA/SVGA support, DOS Security, DOS dual
activity monitors so that it knows the difference between the user being
inactive and the computer being idle, and improved Novell Netware interaction.
 
 
DAZ5.1 17-Mar-94 Programs & documentation (c)1994 WMT               28
 
 
Impressed?  But we haven't even mentioned the very reason for the program name
change: 3D!  There is now a 3-Dimensional walk-through simulation using the
latest in PC game technology to place you in one of a number of environments
that are provided with the program.  Additional environments are already
available.  You may look up at your PC to find that you are roaming an old
mansion, or perhaps an open modern art gallery, or even a futuristic massive
space station.  The program moves you randomly through the maze, seeking
various wall panels where it can draw some of the RAZZLE DAZZLE 2D imagery.
It will close in on the target panel, draw a new picture, and back away,
leaving the picture pasted on the wall.  Then off it goes looking for another
panel to draw.  And this program is INTERACTIVE!  You can assume control of
 
the movements with your cursor keys or mouse.  You can tell it to paint on a
drawable panel, and you can even adjust the motion speed.  When your day
becomes too demanding, take a moment out to try to solve the maze and find all
the drawable panels.  Each environment has a whole new maze, and is a very
different challenge.
 
Awesome!  And all of this comes in one box for one low price.  What else could
we possibly offer?  Well, you should know that RAZZLE DAZZLE continues to
connect with the ACS/PC-Watchman program for the utmost in corporate and
governmental PC security needs (available from Harcom Security Corp. at 1-800-
275-3438).  And for your friends that don't have a PC, there is DAZZLE the
Long Form Music Video on both stereo VHS and video LaserDisk (call Miramar at
206-284-4700 for availability in your area).
 
RAZZLE DAZZLE now has much more on-line documentation to answer your specific
questions at the point when you have them, especially in the areas where new
features are encountered.
 
Have we redefined eclectic, or what?
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
DAZ5.1 17-Mar-94 Programs & documentation (c)1994 WMT               29
 
 
                               Just the facts:
 
This package consist of a number of programs, each offering a variation of the
primary theme of the RAZZLE DAZZLE Screen Saver.
 
RAZZLE DAZZLE 2.0 SVGA 2D Screen Saver for both DOS and Windows 3.1
 
  Up to VESA/SVGA (640x480 256 color) video mode displays.
 
  Supports RZM music composer files (sound card required).
 
  Supports XMI Extended-MIDI music files (sound card required).
 
  Reads PCX image files, and outputs both PCX and BMP image files.
 
  Supports FLI and FLC animation files (VGA required, no SVGA resolutions).
 
  Has an interactive (non screen saver) mode that provides extensive
  customization controls and allows you to compose your own unique graphic
  images in Semi-Automatic mode.
 
  Provides DOS password security.
 
RAZZLE DAZZLE 3D VGA Screen Saver for both DOS and Windows 3.1.
 
  Supports RZ3 virtual reality 3D environment files.
 
  Allows interactive controls during Screen Saver operation.
 
  Provides DOS password security.
 
WinDaz16 native Windows 3.1 2D Screen Saver, 16-bit version.
 
  Supports WAV and MIDI music files (sound card required).
 
  Supports AVI Video for Windows files (sound card and support files
  required).
 
  Supports FLI and FLC animation files (some restrictions apply).
 
  Supports BMP image files.
 
  Provide Windows password security.
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
DAZ5.1 17-Mar-94 Programs & documentation (c)1994 WMT               30
 
 
WinDaz32 native Windows-NT 2D Screen Saver, 32-bit version.
 
  A true Multi-threaded 32-bit native Windows-NT screen saver.
 
  Can be executed under Windows 3.1 (some restrictions apply).
 
  Supports WAV and MIDI music files (sound card required).
 
  Supports AVI Video for Windows files (sound card and support files
  required).
 
  Supports FLI and FLC animation files (some restrictions apply).
 
  Supports BMP image files.
 
  Provides password security.
 
 
Razzle Dazzle, and Razzle Dazzle 3D are registered trademarks of Road Scholar,
Inc.  WinDaze, WinDaz16, WinDaz32, and Mark of the Beast, are trademarks and
registered trademarks of Worldwide MicroTronics, Inc.
 
                             System Requirements
NOTE: RAZZLE DAZZLE 1.0 is available for users with 8086, or PC/XT, or other
PC systems (with color EGA or better) that do not meet the system requirements
of RAZZLE DAZZLE 2.0
 
RAZZLE DAZZLE 2.0
 
  EGA, VGA, or VESA/SVGA color monitor and video card.
 
  286 CPU, 12Mhz minimum. Math processor suggested.
 
  480K of free conventional RAM memory (TSR size is less than 15K).
 
  EMS and/or XMS optional.
 
  8 or 16 bit sound card optional (required for music).  Works with most
  popular sound cards.
 
  DOS 3.1 or higher required. Windows 3.1 or higher optional.
 
RAZZLE DAZZLE 3D
 
  VGA color monitor and video card.
 
  386 CPU, 33Mhz minimum. Math processor optional.
 
  545K of free conventional RAM memory (TSR size is less than 15K).
 
  EMS optional.
 
  2Mb free XMS minimal, 4Mb free XMS suggested.
 
  DOS 3.1 or higher required. Windows 3.1 or higher optional.
 
 
 
 
DAZ5.1 17-Mar-94 Programs & documentation (c)1994 WMT               31
 
 
WinDaz16
 
  Windows 3.1
 
  Installed Windows compatible sound card optional (required for music &
  audio).
 
  386 CPU, 33Mhz minimum. 486/66Mhz suggested.
 
WinDaz32
 
  Windows-NT
 
  Installed Windows compatible sound card optional (required for music &
  audio).
 
  386 CPU, 33Mhz minimal. 486/50Mhz suggested.
 
Four Screen Savers in one!  Remember, when you order RAZZLE DAZZLE 3D, you get
all four programs specified above in one box, for a single low price.  The
screen saver that grows with you.  Additional music and virtual reality
environments are already available for purchase to expand and enhance the
already amazing RAZZLE DAZZLE 3D offering. RAZZLE DAZZLE was rated BEST BUY by
Windows User magazine. Wow!  If you have any questions about where to get this
program in your area call Road Scholar software at (713) 266-7623.  Program
available from most better retail PC computer software stores and catalogs.
Ask for it by name: RAZZLE DAZZLE 3D!
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
DAZ5.1 17-Mar-94 Programs & documentation (c)1994 WMT               32�
Dazzle 5.2
 
 
 
 
 
                                 D A Z Z L E 
 
                    The Ultimate Graphics Image Generator 
 
 
                                  Shareware 
                               Usage Agreement 
                                     and 
                                User's Manual 
 
 
 
 
                        Documentation for Revision 5.2 
                               17 January, 1997 
 
 
 
 
 
                         Worldwide MicroTronics, Inc. 
                                 P.O.Box 8759 
                          Spring, TX USA 77387-8759 
                          76236.1573@compuserve.com 
                         http://www.microtronics.com/ 
 
 
 
BY USING THIS SOFTWARE YOU ARE AGREEING TO ALL THE TERMS, LIMITATIONS, AND 
CONDITIONS CONTAINED HEREIN. This software is NOT FREE, see the SHAREWARE 
section for details 
 
Please take the time to review this whole document as soon as possible in your 
use of DAZZLE. The program is far more configurable and flexible than it 
initially appears, and the great majority of questions that arise are 
addressed herein. The size of this document lends itself to being printed for 
easier review and reference. 
 
Information in this document is subject to change without notice and does not 
represent a commitment on the part of Worldwide MicroTronics, Inc.(WMT). The 
software described in this document is furnished under a license agreement. 
The software may be used or copied only in accordance with the terms of the 
agreement. 
 
Programs & documentation Copyright(c)1989-97 Worldwide MicroTronics,Inc.(WMT) 
 
 
 
1. DAZZLE OVERVIEW...........................................................1 
 
 
2. INTRODUCTION..............................................................1 
 
 
3. SHAREWARE.................................................................2 
 
3.1. USAGE LIMITATION........................................................3 
3.2. REVISION CONTROL........................................................3 
3.3. CURRENT REGISTRATION FEE AND CREDIT CARDS...............................3 
3.4. ONLINE ORDERS FOR FULL FEATURED SCREEN SAVER............................4 
3.5. SITE LICENSES...........................................................4 
3.6. FUTURE PRODUCTS.........................................................5 
3.7. ROYALTIES...............................................................5 
3.8. DISCLAIMER..............................................................5 
3.9. DISTRIBUTION LIMITATION.................................................5 
 
4. COMMAND LINE OPTIONS......................................................5 
 
4.1. MAIN OPTIONS MENU.......................................................6 
4.2. ADDITIONAL OPTIONS MENU.................................................6 
4.3. SPECIFYING OPTIONS......................................................6 
4.4. COMPATIBILITY OPTIONS...................................................7 
4.5. ARTISTIC OPTIONS........................................................9 
4.6. OTHER OPTIONS..........................................................10 
4.7. SPECIFYING THE INPUTFILE...............................................12 
 
5. ON-LINE HELP.............................................................13 
 
5.1. CURSOR KEYS WITHIN HELP................................................13 
5.2. EXITING HELP...........................................................13 
 
6. LED INDICATIONS DURING DAZZLE............................................13 
 
6.1. SCROLL LOCK LED........................................................13 
6.2. NUM LOCK LED...........................................................13 
6.3. CAP LOCK LED...........................................................14 
 
7. PRIMARY DAZZLE MODES.....................................................14 
 
7.1. SELECTING MODES........................................................14 
 
8. KEYS ACTIVE IN ALL MODES.................................................14 
 
ESCAPE : PROGRAM TERMINATION................................................14 
TAB : FREEZE IMAGE..........................................................14 
F5 : DUMP SCREEN PCX IMAGE TO DISK FILE.....................................15 
F6 : DUMP SCREEN BMP IMAGE TO DISK FILE.....................................15 
"." : TOGGLE QUIET MODE.....................................................15 
"+" AND "-" : COLOR CYCLING CLOCK ADJUSTMENT................................15 
"PGUP" AND "PGDN" VGA COLOR CYCLING STEP ADJUSTMENT.........................15 
SHF-F10 : REINITIALIZE THE COLOR PALETTE....................................16 
CTL-F10 : SELECT NEW BACKGROUND COLOR.......................................16 
THE FADE CONTROL KEYS.......................................................16 
SPECIAL FADE CONTROL KEYS...................................................16 
 
 
DAZ5.2 17-Jan-97 Programs & documentation (c)1994-96 WMT             i 
 
 
MOUSE CLICKS................................................................17 
 
9. KEYS ACTIVE IN "SEMI-AUTO" MODE..........................................17 
 
F8 : TOGGLE CONTINUOUS DRAWING MODE.........................................17 
F9 : SELECT RANDOM IMAGE....................................................17 
F10 : DRAW CURRENT IMAGE....................................................18 
ALT-F10 : REINITIALIZE CURRENT ALGORITHM....................................18 
SPECIFIC IMAGE SELECTION KEYS...............................................18 
 
10. CONFIGURATION...........................................................18 
 
10.1. CURSOR KEYS WITHIN CONFIGURE..........................................18 
10.2. EXITING CONFIGURE.....................................................19 
10.3. CONFIG VERSUS IMAGE CONTROL...........................................19 
10.4. IMAGE SIZE CONTROL....................................................19 
10.5. FADE ENABLE CONTROL...................................................19 
10.6. AUTO MODE DISPLAY CUSTOMIZATION.......................................20 
10.7. FILE ACCESS MENU......................................................20 
 
11. USAGE WITHIN WINDOWS....................................................21 
 
 
12. CONFIGURATION FILE FORMAT...............................................21 
 
12.1. SHIFT KEY TOKENS......................................................21 
12.2. SPECIAL TOKEN.........................................................21 
12.3. KEY ID................................................................22 
12.4. CONFIGURATION VALUE...................................................22 
12.5. COMMENT LINES.........................................................22 
12.6. VERSION FLAG..........................................................22 
 
13. PROGRAM INTEGRITY.......................................................22 
 
 
14. PROGRAMMERS COMMENTS....................................................22 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
DAZ5.2 17-Jan-97 Programs & documentation (c)1994-96 WMT            ii 
 
 
1. DAZZLE Overview 
version number: 5.2 
 
         The only Screen Saver so stunning that it has been made into a 
                             Long Form Music Video! 
 
This software is a graphics image generator that you can run manually as a 
screen saver. If you want the FULL FEATURED self-starting screen saver for 
DOS, Windows 3, and Windows 95 then see section "3.4. ONLINE ORDERS FOR FULL 
FEATURED SCREEN SAVER" below for more information. 
 
Transform your color VGA or EGA-equipped PC into a stunning source of 
computer-generated beauty. DAZZLE is a hypnotizing graphics image generator 
acclaimed in computer magazines as the best self-directing art program 
available. It fills the computer monitor with continually evolving displays 
that protect the screen from image burn. A popular diversion for waiting 
rooms, reception areas, and family rooms at home. Used in conjunction with 
your favorite music, there is no form of entertainment quite like it. 
 
*    Award winning interactive color kaleidoscopic program that provides 
     endless changing visual viewscapes. 
 
*    Performance art for the eyes featuring a rich selection of drawing 
     algorithms, fades, and special effects. 
 
*    Includes a self-directing mode which is an effective and entertaining 
     attention getter. 
 
 
System Requirements 
 
*    Personal computer using the 8088, 286, 386, or higher processor. 
 
*    EGA, VGA, 8514/A graphics card, or compatible video graphics adapter and 
     color monitor. 
 
*    MS-DOS or PC-DOS operating system version 3.1 or higher. 
 
 
 
2. INTRODUCTION 
      DAZZLE is an award winning self directing color image generator for DOS 
and Windows computers with EGA or VGA compatible color displays and adapters. 
Performance art for the eyes. 
 
      A source of beauty; sometimes subtle, sometimes vibrant, always 
changing. The image engine has numerous primary image drawing algorithms, most 
of which have at least two styles of presentation, many of which have multiple 
internal drawing variations. There is an assortment of fades, including split 
screens and pans, used by the imaging system for greater diversity of 
presentation. 
 
      When the "Semi-Automatic" mode of DAZZLE is active, the user can play 
the program from the keyboard. Specifically selecting each pattern to draw, or 
letting the program select the pattern randomly. The selected pattern is 
generated for as long as the user holds the draw key. There are no limits on 
the mixing of image patterns. The user can then invoke a specific fade effect, 
 
 
DAZ5.2 17-Jan-97 Programs & documentation (c)1994 WMT                1 
 
 
or let the program select an effect randomly. The types of displays that can 
be generated in this fashion are far more varied, and personal, than anything 
that "Auto" mode ever produces. 
 
      There is a configuration menu that allows the customization of DAZZLE 
image generation. It also allows the selective disabling of various fades. 
This configuration information can be written to an editable text file, and 
either loaded again from the menu or loaded automatically at program 
invocation by specifying the file name on the DAZZLE command line. 
 
      An on-line HELP text window system is included in DAZZLE. 
 
      In the self generating "Auto" mode the primary image algorithms are 
mixed randomly on the screen. An adjustable number of images are overlaid at a 
time, producing a very large assortment of possible displays. Each display 
remains for a while to be appreciated, then the screen is cleared via a fade 
algorithm, and another set of patterns is presented. Mathematically speaking, 
an exact pattern match might not occur for many weeks of continuous operation. 
Human perception is far less exacting and will discern repetition well ahead 
of these extremes, but the general effect is impressive and frequently 
surprising. Note that the starting patterns of the program will be different 
each time it is executed. If the program seems predictable, exit it and start 
it over again. 
 
      DAZZLE can be used in a variety of ways. At the office it keeps the 
screen from being burned by constant display of an unchanging prompt. Simply 
start the program when leaving your desk or answering the phone or otherwise 
diverted. When you register this program you will receive the self-starting 
DOS and Windows Screen Saver capability, and optional password protection. 
This shareware version is NOT a self activating memory resident screen saver. 
 
      DAZZLE can be used to aid relaxation. In its slower cycling VGA modes 
(where this program REALLY shines) it is often soothing and helps one to shift 
conscious attention from the cares of the day. Watching DAZZLE may cause a 
reduction of blood-pressure, general relaxation, and heightened alpha states 
in the brain. When overwhelmed with problems or pressures, it is often true 
that shifting one's focus from an immediate concern allows the objectivity 
needed to enhance decision making and settle the nerves. 
 
      DAZZLE is a performing art realization on a computer platform. Used with 
your favorite music DAZZLE can be highly entertaining and regenerating. In its 
self-directing play mode it is great "living" mobile art. 
 
3. SHAREWARE 
      Shareware is a brave concept in software marketing that allows you to 
"try before you buy." Shareware authors retain all rights under their 
copyright, but allow free distribution of their programs within specified 
limits. Distributors of shareware -- including on-line BBS and catalog 
outlets -- usually do not charge for the shareware software itself. The 
distributors are charging for their own services in providing access to their 
resources. Registration payment directly to the author entitles the user to 
additional services, information, and newer products. It is a great deal for 
users, authors, and distributors alike. Please support this honor system 
marketing technique so that more great programs of increasingly professional 
quality can reasonably be provided via this system. 
 
 
 
 
DAZ5.2 17-Jan-97 Programs & documentation (c)1994 WMT                2 
 
 
      Copyright laws apply to both shareware and commercial software, and the 
copyright holder retains all rights, with a few specific exceptions clearly 
stated by the author. Shareware authors are accomplished programmers, just 
like commercial authors, and the programs are of comparable quality -- in both 
cases there are good programs and bad ones! The main difference is in the 
method of distribution. The shareware author specifically grants the right to 
copy and distribute the software to all. 
 
      You are encouraged to pass a copy of DAZZLE along to your friends for 
evaluation, BUT PLEASE DO NOT GIVE IT AWAY ALTERED OR AS PART OF ANOTHER 
SYSTEM (unless you have an OEM license from WMT). Please encourage them to 
register their copy if they find that they can use it. Businesses, BBS's, and 
catalog operations please note: distribution of Worldwide MicroTronics, Inc. 
(WMT) shareware products, even free of charge, without clearly explaining to 
the recipient their legal requirement to register the program is strictly 
forbidden, and a violation of USA copyright law and International Treaty 
Provisions. 
 
3.1. Usage Limitation 
      Please note that this program is NOT FREE. You are entitled to use it 
for evaluation over a short time (not more than 15 days) to determine if it 
functions adequately for your needs, after which time a registration fee paid 
directly to Worldwide MicroTronics, Inc. is required by copyright law, and 
greatly appreciated by all of us. Any distribution or on-line fee paid by you 
to copy DAZZLE is (usually) not forwarded to Worldwide MicroTronics, Inc. by 
the distributor, and therefore would not constitute payment of a registration 
fee. The purchase price you paid for a book or a magazine authorized to 
distribute this software does NOT constitute payment of the mandatory 
registration fee due directly to Worldwide MicroTronics, Inc. (WMT). 
 
If you purchase the full featured screen saver then it should be used in place 
of this shareware product, and therefore you do not need to register this 
program. 
 
      The images generated by this program are protected under copyright law 
(see section "3.7. Royalties" below). 
 
      Businesses and government agencies MUST register every copy of this 
program in use anywhere within their operations, facilities, or place of 
business. Use of this software without proof of registration payment is 
strictly forbidden. 
 
3.2. Revision Control 
      Worldwide MicroTronics, Inc. is NOT responsible for revision control of 
DAZZLE through any source other than direct mailings from our office. If you 
request a copy from any other source please be certain of the revision level 
that you are acquiring, and that it contains all related files and 
documentation. 
 
      Your registration fee for DAZZLE entitles you to legally use the copy of 
DAZZLE in your possession beyond the 15 day evaluation period. We also are now 
sending the full featured self-starting DOS and Windows Screen Saver to those 
who pay the registration fee. 
 
3.3. Current registration fee and credit cards 
      The registration fee for this version of DAZZLE is $15 ($20US for 
customers outside the continental U.S.A. please). You may enter the command 
 
 
DAZ5.2 17-Jan-97 Programs & documentation (c)1994 WMT                3 
 
 
"DAZZLE  /$" to display a convenient order form. The output is standard 
English ASCII text. If you have a dot-matrix printer, or a LaserJet, or other 
device that can print normal ASCII text attached to your computer, you can use 
this command to print the form: "DAZZLE  /$  >  PRN:  " (don't include the 
quotes). If you have a postscript printer, or other device that will not 
accept normal ASCII text, use whatever tools are provided to print standard 
DOS type text files. If you must print from a file, you can use this command: 
"DAZZLE  /$  >  ORDRFORM.TXT  " (don't include the quotes). Basically, 
whatever commands you used to print this manual should also work for the order 
form. 
 
      A single registration fee will license one copy for use on any one 
computer at any one time. You must treat this software just like a book. An 
example is that this software may be used by any number of people and may be 
freely moved from one computer location to another, so long as there is no 
possibility of it being used at one location while it's being used at another. 
Just as a book cannot be read by two different persons at the same time. 
 
      Additional registration offices are being considered to service 
customers outside of the continental U.S.A. As we receive additional 
registrations from international customers we will be able to improve the 
level and accessibility of support, and produce multilingual programs. 
 
 
3.4. ONLINE ORDERS FOR FULL FEATURED SCREEN SAVER 
 
Download & Purchase RAZZLE DAZZLE Savers Electronically: 
  Visit our WEB site to BUY IT NOW ONLINE at http://www.microtronics.com 
 
For Information Or Other Inquiries: 
  Worldwide MicroTronics Inc 
  P.O. Box 8759 
  Spring, TX USA 77387-8759 
 
  +1 (281) 297-4123 (voice) 
  +1 (281) 297-4124 (fax) 
 
All Support And E-Mail Inquiries: 
  76236.1573@compuserve.com 
  shiflett@microtronics.com 
  http://www.microtronics.com/ 
 
3.5. Site Licenses 
      Also available are MULTI-COPY or SITE LICENSES -- minimum quantity 5 
copies. The licensee receives one "master" copy of the program and all related 
documentation, additional master copies of disk and/or documentation are 
available for an extra charge. These may be copied by the licensee for 
multiple users at the designated location (site) up to the number of licensed 
copies. The following discounts are currently allowed if ordered directly from 
Worldwide MicroTronics, Inc. This price is for the shareware DAZZLE program 
ONLY. The user must buy one "master" copy of the program at the normal price 
(plus shipping/handling), then copies can be made from that master disk. 
Contact Worldwide MicroTronics Inc for price and availability. 
 
      SITE LICENSES AND MULTICOPY LICENSES MUST BE PAID DIRECTLY TO WORLDWIDE 
MICROTRONICS, INC.. NOT TO ANY OTHER REPRESENTATIVE, OUTLET, AGENT, OR OTHER 
ENTITY. 
 
 
DAZ5.2 17-Jan-97 Programs & documentation (c)1994 WMT                4 
 
 
 
      PLEASE DO NOT ASSUME THAT ANY SITE, OFFICE, COMPANY, OR GOVERNMENT 
OPERATION HAS AN UNLIMITED LICENSE TO COPY AND USE ANY WORLDWIDE MICROTRONICS, 
INC. PROGRAM, INCLUDING DAZZLE. We have never (as of this writing) issued an 
open or unlimited license, and probably will not. Please be certain that you 
know the limits of the license under which you are making copies. Honesty and 
prevention are much cheaper options for EVERYBODY.  But then, our attorney's 
have children to feed also, so we do not hesitate to utilize their resources. 
 
3.6. Future Products 
      A full computer security version of MT-DAZE is available from Harcom 
Security Systems Corp. For details call (800) 275-3438 or (212) 766-1802. 
 
      DAZZLE, the music video, is available on stereo VHS video cassette at 
(800) 767-4748. 
 
3.7. Royalties 
      ALL COMMERCIAL RIGHTS TO THIS PROGRAM ARE RETAINED BY THE AUTHOR. 
 
      The images generated by this program are intended for viewing on a 
computer executing a registered copy of this software, and may be extracted, 
projected, or otherwise translated onto other media only for personal 
enjoyment or non-commercial use within companies which have registered this 
software. Public display of DAZZLE images is permitted without royalty for 
registered copies that are used for trade shows, point of sales, and offices, 
where such usage is for entertainment or demonstration purposes, if no 
admission is charged, and the display is incidental to the business being 
conducted. 
 
3.8. Disclaimer 
      Users of DAZZLE and related products must accept this disclaimer of 
warranty: "DAZZLE is supplied for non-exclusive usage as is. The author 
disclaims all warranties, expressed or implied, including, without limitation, 
the warranties of merchantability and of fitness for any purpose. The author 
assumes no liability for damages, direct or consequential, which may result 
from the use of these programs." 
 
3.9. Distribution Limitation 
      CD-ROM distributors, FTP sites, and ASP recognized BBS operators are 
encouraged to post and distribute this program, others are required to submit 
a Distribution Authorization form BEFORE distributing this program. 
Distribution of Worldwide MicroTronics, Inc. shareware products, even free of 
charge, without clearly explaining to the recipient their legal requirement to 
register the program is strictly forbidden, and a violation of copyright law. 
 
 
4. COMMAND LINE OPTIONS 
      A number of options that control the action of the DAZZLE family of 
programs can be specified on the command line when the program is invoked. 
With the exception of the "/$" and the "/Z" options, all command line options 
can be controlled from a self-documenting menu system. Enter "DAZZLE  /#" to 
access this menu from the command line, or use the "F2" key while the program 
is running and press "C" for the CONFIG menu. 
 
 
 
 
 
 
DAZ5.2 17-Jan-97 Programs & documentation (c)1994 WMT                5 
 
 
4.1. Main Options Menu 
      When you enter the command "DAZZLE  /?" at the DOS prompt you will be 
presented with the following display. 
 
The following options can be specified on the command line and are used to 
customize and control the action of "Dazzle". These options can also be 
specified in a batch (.BAT) file for automatic activation. 
 
   /$  Display order information. 
   /2  2-part palette, fixes flickering screens but slows drawing. 
   /a  Alternate Palette Speed - automatically changes cycling speed. 
   /b  Bashful - no closing credits & pressing any key quits the program. 
   /c  Compatible mode - use the PC's BIOS for better compatibility. 
   /d  Delay - slows the drawing speed for faster PC's. 
       "/d=xxxx" delays drawing speed by the specified value. 
   /i  Insecure - CRC checking is not performed when program starts. 
   /m  Mad - uses fastest color cycling speed...a real attention getter! 
   /q  Quiet - no tones (this option has no effect on warning beeps). 
   /s  Show - displays a single image then quits. 
       "/s=xxxx" shows for the specified number of seconds then quits. 
   /w  Window - changes defaults for use with Windows. 
   /x  XT compatible - for use on 8088/8086 PC's with EGA or VGA. 
   /z  Create DAZZLE.DOC file on current disk path! 
For example - if you want to start "DAZZLE" so that no tones are heard, 
no CRC checking is performed, and operate in Windows compatible mode, 
type the following command: 
                  DAZZLE /q  /i /w 
Press any key to continue 
 
4.2. Additional Options Menu 
      When you press a key at the "Press Any Key" prompt you will be presented 
with the following display. 
 
While "DAZZLE" is running, the [Tab] key will freeze the display until 
the [Space] bar is pressed. 
The [F1] key activates on-line help during the program. The [F2] key provides 
a menu of configuration options. The [Esc] key terminates the program. 
 ** Refer to DAZZLE.DOC for more details ** 
 
 Additional command line options: 
   /+  Empty keyboard buffer on exit. 
   /!  Monitor Screen Saver driver interface. 
   /e  EGA - forces EGA display mode. 
   /f  Fade VGA brightness during use (Screen Dimmer). 
   /g  iGnore mouse - don't let it terminate the program. 
   /h  Hide EGA border - forces a black border in EGA mode. 
   /k  Keyboard Typematic - allows program to change the typematic rate. 
   /r  Retract hard disk heads at program startup (see manual). 
   /t  Tall Video - forces the program to use standard BIOS aspect ratio. 
   /v  VGA mode forced, disable SVGA (see manual). 
 
4.3. Specifying Options 
      The Dazzle program accepts any combination of options on the initial 
command line that affect its mode of operation. The options may be preceded 
with either the "/" (slash) character or the "-" (minus) character. If you use 
the SwitchChar feature of MS-DOS, the "/" (slash) option marker character can 
be changed to any other key. At least one space must exist between the Dazzle 
 
 
DAZ5.2 17-Jan-97 Programs & documentation (c)1994 WMT                6 
 
 
command and the first option. For example, "DAZZLE  /FC" instructs Dazzle to 
execute with Fixed colors and in Compatible mode. The options are not case- 
sensitive -- uppercase and lowercase letters are treated identically. The 
options may either be concatenated into a single string or entered separately 
(/FC is treated the same as  /F  /C). The optional input file may be specified 
anywhere on the command line. For example, "DAZZLE  /I  MTDAZZLE.DZL" has the 
same effect as "DAZZLE  MTDAZZZLE.DZL  /I". Both commands instruct Dazzle to 
start up in Insecure mode and to load the configuration file MTDAZZLE.DZL 
before starting the image generation process. Note that Dazzle will 
automatically attempt to locate and load a configuration file named 
MTDAZZLE.DZL unless explicitly instructed otherwise with the "*" (asterisk) or 
"/*" (slash asterisk) command line options. The effects of each option are 
detailed below. 
 
We provide this documentation on using the command line options directly for 
completeness, but strongly encourage the use of the "DAZZLE  /#" access to the 
menu driven interface as a superior means of controlling the program. 
 
4.4. Compatibility Options 
      Some of the options for DAZZLE are specifically related to increasing 
portability of the program to various computers and displays. The "2", "c", 
"d", "e", "k", "v", and "x" options default to the most desirable modes, but 
can be controlled by the user. VGA users also should refer to the "t" option 
for details. 
 
/2 = 2-part palette, fixes flickering screens but slows drawing. 
      Normally the entire color palette is updated at one time for each tick 
      of the color cycling clock. If the CPU clock speed or the VGA palette 
      register update rate is too slow, the upper part, or perhaps all of the 
      display, will flicker badly during the display. To determine if this is 
      due to palette updates, press and hold the "-" (minus) key during the 
      running graphics display until it beeps (this is the slowest cycling 
      clock rate). If the display flickers only when the color changes, then 
      palette update speed is a problem. Using the "2" option splits the VGA 
      palette update request into two almost equal groups that are handled 
      sequentially. This should remove, or at least significantly reduce, 
      cycling induced flicker. This option should not be used if not needed, 
      as it slows the entire display generation process. This option affects 
      operation with VGA adapters only, since they allow longer 256 color 
      palettes. Short 16 color palettes for EGA's are never divided into two 
      separate updates. 
 
/C = Compatible mode - use the PC's BIOS for better compatibility. 
      Normally DAZZLE bypasses the video adapters BIOS code for maximum speed 
      in color palette cycling. However, some rare adapters may have problems 
      with this mode of operation. To cause DAZZLE to use the provided BIOS 
      the "C" option can be used. If your display flickers or distorts, or 
      the color fails to cycle smoothly during the display, then try this 
      option to determine if it corrects the problem. This option reduces 
      program performance speed and should not be used if not needed. 
 
/D = Delay - slows the drawing speed for faster PC's. 
 "/d=xxxx" delays drawing speed by the specified value. 
      This option serves both artistic and compatibility purposes. On faster 
      computers the DAZZLE drawing algorithms can be too fast to appreciate 
      as an evolving image. If the computer is too fast, or if you simply 
      desire to induce a slower drawing speed for purely aesthetic reasons, 
 
 
DAZ5.2 17-Jan-97 Programs & documentation (c)1994 WMT                7 
 
 
      this option can be used to delay the drawing process. If used simply as 
      "/D", without specifying any delay units, the program will use a 
      default delay amount. To adjust the amount of delay a specific value 
      can be provided after the "=" (equal) character. There is no exact 
      relationship of the delay unit value and the impact on the drawing 
      speed, it must be experimentally determined on each computer. The 
      larger the number, the slower the drawing. 
 
      The delay unit value ranges from 1 (minimum) to 32767(maximum), and can 
      be entered without leading zero's. There must be no spaces or tabs 
      between the "D", the "=", and the numbers for the delay units. This 
      option can be concatenated with other non-numeric options. Thus 
      "/AD=250W" is a legal command option string. 
 
/E = EGA - forces EGA display mode. 
      Normally DAZZLE will automatically detect the video adapter hardware 
      attached and adjust itself to use either the EGA or the VGA mode. This 
      "/E" option allows VGA users to select and view the EGA mode of 
      operation, which is 640x350 16-color in format. As of revision 4.0 this 
      option, like the "/V" option, will prevent DAZZLE from aborting if it 
      thinks that it has detected an unacceptable video controller/monitor 
      combination, though it will still give its usual error messages during 
      startup. Refer to the "/V" option below for more information. 
 
/K = Keyboard Typematic - allows program to change the typematic rate. 
      "Keyboard Acceleration" utilities cause the self-repeating "typematic" 
      function of the keyboard to repeat far more rapidly. They come in two 
      flavors: 
 
      *     Those that tell the keyboard to send keys more often. 
      *     Those that trick DOS into thinking that more keys arrive than 
            actually are sent by the keyboard. 
 
      When specifying this command line option, DAZZLE will set the 
      "typematic" rate of the keyboard to it's minimum value for best program 
      performance. When DAZZLE terminates it puts the "typematic" speed back 
      to a value typical of most DOS defaults. Those that use a keyboard 
      speed-up utility that stops having an effect after DAZZLE has been 
      executed have the first type of such a utility. If you want the keys 
      back to their quicker speed you can re-execute your speed-up command. 
 
/V = VGA mode forced, disable SVGA (see manual). 
      Normally DAZZLE will automatically detect the video adapter hardware 
      attached and adjust itself to use either the EGA or the VGA mode. 
 
      The retail RAZZLE DAZZLE 3D program can detect and use a VESA 
      compatible SVGA driver for 640x480 sized 256 color images. Using this 
      option with that program forbids the use of SVGA, and makes the program 
      run in the normal VGA mode. 
 
      In the shareware DAZZLE product this option generally SHOULD NOT BE 
      NECESSARY, OR USED. It should be unable to cause any damage, but is 
      intended for rare compatibility conflicts where the startup code in 
      DAZZLE falsely rejects the video controller/monitor combination as 
      unacceptable. This option, like the "/E" option, will allow the error 
      messages to be reported (so that you can write us of the problem), but 
      will prevent the program from aborting itself. If the 
 
 
DAZ5.2 17-Jan-97 Programs & documentation (c)1994 WMT                8 
 
 
      controller/monitor is really VGA compatible, or really EGA compatible 
      if using the "/E" option, then normal image generation should be 
      observed. Unlike the "/E" option, this option lacks artistic usage or 
      impact. 
 
      The VGA mode uses all 256 color palette registers for a far more subtle 
      and interesting series of displays. The default VGA mode of DAZZLE uses 
      a specially enhanced 320x400 256-color mode that is not properly 
      captured by many commercial products. The VGA modes require no more 
      than 256kB of video memory. 
 
/X = XT compatible - for use on 8088/8086 PC's with EGA or VGA. 
      This option allows DAZZLE to execute on 8088 or 8086 based PC/XT type 
      computers with EGA or VGA adapters and color displays. This option will 
      be automatically initiated if the 808x style CPU is detected at program 
      startup, but specifying the command line option avoids the warning 
      message. The EGA performance on XT computers seems acceptable, but the 
      VGA mode may be noticeably inferior to the performance of an 80x86 
      based computer. The faster the CPU clock the better the overall 
      performance and fluidity of DAZZLE. 
 
4.5. Artistic Options 
      These options adjust the image generating algorithms used by the 
program. They are largely artistic in nature but allow customizing the 
presentation to various environments and requirements. 
 
/A = Alternate Palette Speed - automatically changes cycling speed. 
      The default color cycling mode is the slowest, with the most subtle 
      shadings and transitions. The mad speed ("/M") is the fastest. There 
      are a total of three color cycling modes within the program. The 
      cycling rate used in shaping the palette contents. The effect is 
      distinct from, but can complement, the "+" and "-" keys that can be 
      used while the program is active. 
 
      This option causes the program to automatically change between the 
      three color cycling modes within the program. This produces the most 
      varied and divergent kinds and tempo's of displays. 
 
/F = Fade VGA brightness during use (Screen Dimmer). 
      Normally DAZZLE will randomize the color palette registers between each 
      screen erase before starting the next image generation. This allows all 
      the possible colors (up to a quarter million on VGA) to be used by the 
      program. Sometimes the program will use darker colors, sometimes 
      bright. 
 
      This option forces the VGA palette to grow continually darker while the 
      program is operating, until it finally reaches a minimum brightness 
      stage (usually about 20 to 30 minutes of operation). Most CRT monitors 
      draw less electrical power as the general brightness of the display is 
      reduced. Some can save as much as 80% of their consumption when dark as 
      opposed to fully illuminated. This feature allows the user to realize 
      the benefits of the relaxing DAZZLE artwork, and also reduce the idle 
      power use of their system when it is not in active use -- conserving 
      resources, and MONEY. 
 
 
 
 
 
DAZ5.2 17-Jan-97 Programs & documentation (c)1994 WMT                9 
 
 
/H = Hide EGA border - forces a black border in EGA mode. 
      Some folks find the colored border on the EGA display distracting, and 
      some displays do not perform retrace masking properly. This option will 
      cause the border color in EGA modes to be forced to black at all times. 
 
/M = Mad - uses fastest color cycling speed...a real attention getter! 
      This option not only greatly accelerates the color palette contents 
      rotation, but it also increases the number of images that can be 
      displayed in "Auto" mode at one time before the screen is erased. The 
      effect is a far busier screen, a more intense visual experience. This 
      is particularly suited to attention-getting in showrooms and other 
      public displays, whereas the default mode is more practical for 
      personal meditation and relaxation. 
 
/S = Show - displays a single image then quits. 
 "/s=xxxx" shows for the specified number of seconds then quits. 
      The "/S" option gives a single panel of images and then terminates 
      automatically. This is most useful when DAZZLE is to be executed from 
      within other programs or batch files. The image displayed is different 
      each time. 
 
      The "/S=xxxx" option allows DAZZLE to execute for a specified length of 
      time, after which it will terminate at the end of the next fade. 
 
      The duration value ranges from 1 (minimum) to 3600(maximum), and can be 
      entered without leading zero's. There must be no spaces or tabs between 
      the "S", the "=", and the numbers for the duration. This option can be 
      concatenated with other non-numeric options. Thus "/AS=250W" is a legal 
      command option string. 
 
/T = Tall Video - forces program to use standard BIOS aspect ratio. 
      Normally the EGA mode of DAZZLE uses a 16 color 640x350 resolution 
      display with a modified aspect ratio (screen is mapped as if it had 
      640x700 resolution). 
 
      The default VGA mode uses 256 color 320x400 resolution. The "/T" option 
      causes the program to use the standard BIOS supported 320x200 screen 
      resolution and aspect ratio in generating all images. The effect is 
      somewhat faster image generation, but with a noticeably tall aspect 
      ratio. Note that due to VGA hardware limitations, using this option 
      will prevent the display of "dual page" effects (where a screen 
      composed of a different image than the one being displayed is "panned" 
      or "scrolled" onto the visible display area). 
 
4.6. Other Options 
 
/$ = Display order information. 
      Issuing this option when invoking DAZZLE will cause the program to 
      output a convenient order form that can be quickly completed and sent 
      to Worldwide MicroTronics, Inc. for product orders, information 
      request, and shareware registration. To send this form directly to a 
      printer use the MSDOS output redirection character ">" (greater-than or 
      right-pointer) to specify the destination. For example, if you have a 
      printer that can accept standard ASCII text on your computer port PRN:, 
      then the command to use would be: 
            DAZZLE  /$  >  PRN: 
 
 
 
DAZ5.2 17-Jan-97 Programs & documentation (c)1994 WMT               10 
 
 
      Complete the form and mail it to the indicated address. Enclose any 
      indicated funds in U.S. Dollar instruments, payable to Worldwide 
      MicroTronics, Inc. 
 
/B = Bashful - no closing credits & pressing any key quits program. 
      DAZZLE will identify itself, including its revision level, when the 
      program is started. The BASHFUL option will prevent closing credits 
      when the program terminates (similar to the SHOW option), and 
      additionally prevents DAZZLE from clearing the type ahead keyboard 
      buffer when it exits. This allows usage of DAZZLE in a more classical 
      "Screen Saver" mode, since whatever key is pressed to exit is not lost. 
 
      This mode disables ALL key interpretation of DAZZLE. Even the "+" and 
      the "-" keys will cause DAZZLE to terminate. The shareware version of 
      DAZZLE does not initiate itself in a "Screen Saver" fashion under DOS 
      or Windows, this flag is used by the retail Screen Saver drivers from 
      Worldwide MicroTronics, Inc. This mode blocks the use of the keyboard 
      LED's to indicate the state condition of the executing DAZZLE program. 
      DAZZLE has been successfully used within MS/Windows (copyright 
      Microsoft), but use of this option will prevent window selection 
      keystrokes. Use of the command line option "/W" was added for the 
      windows environment as detailed below. 
 
/G = iGnore mouse, don't let it terminate the program. 
      Specifying this option prevents this program from attempting to 
      communicate with your mouse driver. This option makes any activity on 
      the mouse invisible to this program. 
 
/I = Insecure - CRC checking is not performed when program starts. 
      Before starting the image display process DAZZLE will normally perform 
      a test on the disk copy of itself in an attempt to assure that no 
      unauthorized modifications ("hacks") have been made to the program 
      after it was distributed from Worldwide MicroTronics, Inc. . This is a 
      safety feature added for YOUR protection! Please note that this is NOT 
      a system-wide scan for virus infection-only the current disk copy of 
      the DAZZLE.EXE file is checked, nor is the self-check completely 
      exhaustive. Once you have used your copy of DAZZLE, after it has passed 
      its antiviral test and you no longer wish to endure the delay at every 
      invocation for this testing, you can use this command line option to 
      bypass this safety feature. IF YOUR COPY OF DAZZLE FAILS THIS TEST, 
      PLEASE NEVER USE THIS OPTION! INSTEAD WRITE TO THE SUPPLIER THAT GAVE 
      YOU THE BAD COPY! A clean copy can be in your hands in a very short 
      time, and might save your software investment (NOTE: Worldwide 
      MicroTronics, Inc. only supplies disk to our registered users.) 
 
/Q = Quiet, no tones (no effect on beeps). 
      This option will block the tones that DAZZLE emits at various points in 
      its operations. But warning beeps are generally not restricted. DAZZLE 
      uses programmed tones for most alerts and signals that it issues. These 
      tones are of short duration, and change pitch depending on the 
      condition being signaled. With the increase in operational options 
      these tones are very helpful in determining the state the program is 
      in. The one place where these tones are superfluous is the tiny tune in 
      the closing credits, but this tune can be aborted with any keypress. 
 
      In the retail RAZZLE DAZZLE 3D program this command also controls the 
      volume of the midi music composer. 
 
 
DAZ5.2 17-Jan-97 Programs & documentation (c)1994 WMT               11 
 
 
 
/R = Retract hard disk heads at program startup. 
      This option instructs DAZZLE to "park" your hard disk heads in a safe 
      "landing zone" position. Retracting the disk heads is a safety 
      precaution provided to reduce the possibility of disk damage from an 
      unexpected loss of power to the computer while DAZZLE is executing. 
      Older drives that do not automatically retract at the loss of power 
      might benefit from retracting the heads before turning the power off. 
      Retracting the heads, and removing electrical power, is also prudent 
      before physically moving a computer. DAZZLE issues a standard BIOS 
      "PARK DISK" (Int 13h, Function 19h) call to retract the disk, therefore 
      it is the BIOS in your own computer that performs the retraction. We 
      can answer no questions about how this is done, nor warrant that the 
      action taken is that which is desired. We are not responsible for 
      direct or consequential problems or losses that may arise from using 
      this option. We know of no reason to be concerned about using this 
      option, but suggest not using it if you have any reason to doubt its 
      impact on your computer. On some models of disk drives it is possible 
      that an unusual sound will be made the next time the hard disk is 
      accessed after having been parked. This is usually a "recalibration" 
      step, and generally not a technical cause for concern. This option 
      should not be used when external images are being presented by Dazzle 
      as it will slow the performance of this program. 
 
/W = Window - changes defaults for use with Windows. 
      This option was added to simplify use of DAZZLE within MS/Windows 
      environments. It prevents the startup antiviral check (please see the 
      "/I" option for a discussion of the risk involved), and all startup 
      messages. This mode blocks the use of the keyboard LED's to indicate 
      the state condition of the executing DAZZLE program. It allows normal 
      "switch" key commands to Windows for task switching. DAZZLE will still 
      show the closing credits graphic image, but not the closing text 
      messages. This option can be used even if DAZZLE is not operating 
      within Windows. 
 
/Z = Create DAZZLE.DOC file on current disk path! 
      DAZZLE keeps the entire Users Manual within itself in an efficient 
      manner that has minimal impact on total usage of the program. By 
      specifying this option DAZZLE will create a new DAZZLE.DOC Users Manual 
      file on your current default disk directory, which you can then print. 
      Note that this file is formatted for generic text printers. 
 
/+ = Empty keyboard buffer on exit. 
      This option forces the program to clear the keyboard buffer when 
      exiting back to DOS, even if using the "/B" option. 
 
/! = Monitor Screen Saver driver interface. 
      The retail versions of RAZZLE DAZZLE 3D and related products allow 
      execution as a self activating Screen Saver under both DOS and Windows. 
      This option allows the retail version of the program to monitor the 
      Screen Saver driver interface so that it performs normally in that 
      environment, which is the default mode invoked by DAZTSR. 
 
4.7. Specifying the INPUTFILE 
      DAZZLE can accept the optional specification of an input file on the 
command line. This file must contain a text script that is consistent with the 
program's language specification. The specification of a path as well as a 
 
 
DAZ5.2 17-Jan-97 Programs & documentation (c)1994 WMT               12 
 
 
filename is acceptable. Be sure to separate the file name from options with at 
least one space. 
 
      DAZZLE will automatically attempt to locate and load a configuration 
file named MTDAZZLE.DZL unless explicitly instructed otherwise with the "*" or 
"-*" command line options. 
 
5. ON-LINE HELP 
      DAZZLE supports a limited on-line help menu system. You may press the 
"F1" function key to activate the help subsystem. This system is intentionally 
limited in size and scope to keep the program from growing too large, but it 
offers useful summaries of the newest and most pertinent features of DAZZLE. 
The graphics screen that was being displayed when help is activated is erased 
when help is exited. 
 
5.1. Cursor Keys within HELP 
      When within the help subsystem DAZZLE recognizes the various standard 
cursor keys. The "HOME" key jumps to the first page of help text. The "END" 
key jumps to the last page of help text. The "PgDn" key advances to the next 
page of help text, the "PgUp" returns to the previous page. The arrow keys 
also can be used. Note that the bottom right of the text window shows what 
page movement keys are valid at that point. 
 
5.2. Exiting HELP 
      The text menu subsystems, including the help system, can be exited by 
pressing the same key that invokes that subsystem. Thus to exit help press the 
"F1" key again. 
 
6. LED Indications during DAZZLE 
      The DAZZLE family of programs control the lighting of the Num Lock, Cap 
Lock, and Scroll Lock LED's (Light Emitting Diodes) on the keyboard to 
indicate to the user the state of the program as it moves through the various 
conditions or "states" in normal operation. These LED's (or lights) can be on, 
off, or blink; each represents a different condition as detailed below. Note 
that use of the "/W" or the "/B" command line options prevent the DAZZLE 
program from changing the keyboard LED indicators. 
 
6.1. Scroll Lock LED 
      This light indicates 1 of 3 possible conditions for the program. 
 
1) When off, the program is not in any pause state, something is actively 
being computed or displayed. 
 
2) When blinking, the program is in an active countdown of a normal pause 
delay. When the delay expires the program will proceed to the next action 
without any need for user intervention. 
 
3) When on, the program is halted in a pause state, and will not proceed until 
the user takes some action. This can be induced by pressing either the "TAB" 
key or the "H" fade key. Refer to the details elsewhere for these specific 
keys to understand how to release the program from this state. This condition 
also occurs when any text menu is on the display, use the specified menu exit 
command to restore normal program execution. 
 
6.2. Num Lock LED 
      This light indicates that the program is either computing or displaying 
a "Pan/Scroll Fade" process. If no activity is visible on the screen then the 
 
 
DAZ5.2 17-Jan-97 Programs & documentation (c)1994 WMT               13 
 
 
program is building a new image on the "hidden" display so that it can be 
moved onto the active or "visible" display area. Refer to the "P" fade key for 
additional details. 
 
6.3. Cap Lock LED 
      This light indicates that the program is computing a new VGA color 
palette to use on the active display. The duration of this period is directly 
dependent on the math speed of your computer. This indication was added to 
inform users when their program seems halted that valid computations are 
progressing unseen within the system. Refer to the "Shift-F10" key description 
for additional details. 
 
7. PRIMARY DAZZLE MODES 
      DAZZLE has two primary modes of operation. The original "Automatic" 
(a.k.a. "Auto") mode, which is fully self generating; and a new 
"Semi-Automatic" (a.k.a. "Semi-Auto") mode, which allows interactive control 
of the image generation process. Some keys are only effective in the 
"Semi-Automatic" mode, others are active at all times. 
 
7.1. Selecting Modes 
      Selection between these two modes is done by pressing the "ALT" 
(Alternate) key and the "F9" function key. This combination is referred to as 
"Alt-F9". At program startup DAZZLE is always in "Auto" mode. 
 
      To enter "Semi-Auto" mode press "Alt-F9". There is a short high pitched 
tone. The display is cleared. The palette is reinitialized to a new setting 
(this may take a few seconds on a slow VGA machine). Then a short multi-tone 
chirp is emitted to indicate that "Semi-Auto" is ready for image drawing 
commands. 
 
      To return to "Auto" mode press "Alt-F9". There is a short lower pitched 
tone. The display is cleared. The palette is reinitialized to a new setting. 
Then the self generating engine begins creating random image displays. 
 
8. KEYS ACTIVE IN ALL MODES 
      Some key commands that DAZZLE recognizes are active regardless of the 
current display mode. The meaning of some keys change slightly depending on 
the current display mode. 
 
 ESCAPE : Program Termination 
      "The first and most important thing to learn about any program is how 
      to get out of it." This key will do the job for you regardless of where 
      you are in the program, just keep banging it till you get back to the 
      DOS prompt. Note that when not in the various text menu screens, that 
      "ENTER" also will terminate the program. 
 
 TAB : Freeze Image 
      The "TAB" key can be pressed at any time when not in a text menu to 
      "freeze" the current graphics image display. Once pressed, DAZZLE will 
      remain in "freeze" mode until the "SPACE" key is pressed (the "n" key 
      will also work). While in "freeze" mode, the "TAB" can be repeatedly 
      pressed to toggle between color-cycling and color-static modes. The 
      "Shift-F10" key can be used to change the palette of an image in 
      "freeze" mode. This is most useful in stabilizing a specific display 
      for image capture. Even an image in the midst of a fade or pan can be 
      put into "freeze" mode. This key is also active in the "Semi-Automatic" 
 
 
 
DAZ5.2 17-Jan-97 Programs & documentation (c)1994 WMT               14 
 
 
      mode, though here its usefulness is limited to halting a fade in mid- 
      execution. 
 
      The Scroll Lock LED on the keyboard will be continuously lighted to 
      indicate that "freeze" is active. Refer to the section on Scroll Lock 
      LED above for more details. 
 
 F5 : Dump Screen PCX Image to Disk File 
      Pressing the "F5" function key converts the display memory into an 
      industry standard PCX disk image file. The program will name the file 
      "DAZ_xxxx.PCX", where xxxx is replaced with a number from 0000 to 9999, 
      depending on what filenames already exist on the current disk path. The 
      image format will match the current video mode of the program. The 
      program will resume normal display after the file is completely 
      written. If a "Pan/Scroll" fade is in effect when "F5" is pressed the 
      "current" display will assume full screen position for the duration of 
      the file creation, then the fade will return to normal action. Please 
      note that all images from this program are copyrighted property of 
      Worldwide MicroTronics, Inc. (refer to section "3.7. Royalties" above). 
 
 F6 : Dump Screen BMP Image to Disk File 
      Pressing the "F6" function key converts the display memory into an 
      Windows standard BMP disk image file. The program will name the file 
      "DAZ_xxxx.BMP", where xxxx is replaced with a number from 0000 to 9999, 
      depending on what filenames already exist on the current disk path. The 
      image format will match the current video mode of the program. The 
      program will resume normal display after the file is completely 
      written. If a "Pan/Scroll" fade is in effect when "F6" is pressed the 
      "current" display will assume full screen position for the duration of 
      the file creation, then the fade will return to normal action. Please 
      note that all images from this program are copyrighted property of 
      Worldwide MicroTronics, Inc. (refer to section "3.7. Royalties" above). 
 
 "." : Toggle Quiet Mode 
      Pressing the "." (period) key while the program is drawing will toggle 
      the Quiet mode (refer to "/Q" command line option) on and off. This 
      allows muting of the program sounds without having to terminate 
      execution. 
 
 "+" and "-" : Color Cycling Clock Adjustment 
      The fluid changing of DAZZLE images is largely the result of a clock 
      driven rotation of the display's color palette. The user can adjust the 
      rate of this clock at any time by using the "-" (minus) key or the "+" 
      (plus) key. Pressing "-" reduces the clock rate, pressing "+" increases 
      the clock rate. Note that DAZZLE defaults to maximum speed in VGA 
      modes, and almost maximum rate in EGA modes. When either the maximum or 
      the minimum clock rate is reached the console emits a short tone. This 
      process is distinct from, yet can complement, the palette control 
      command line options (see descriptions for "/A" and "/M" options 
      above). 
 
 "PgUp" and "PgDn" VGA Color Cycling Step Adjustment 
      The degree of color change that occurs at each event of the color clock 
      can be adjusted on VGA displays using the "Page Up" (PgUp) and "Page 
      Down" (PgDn) keys. The program starts in the minimum step condition 
      when loaded. This effect is distinct from, yet strongly complements, 
      the "+" and "-" key functions described above. 
 
 
DAZ5.2 17-Jan-97 Programs & documentation (c)1994 WMT               15 
 
 
 
 Shf-F10 : Reinitialize the Color Palette 
      Pressing the "SHIFT" key and also the "F10" function key simultaneously 
      (Shf-F10) causes the current color palette of the display to be 
      reinitialized to a new random condition. There is a short tone at the 
      start of the request, and another tone when the process is completed. 
      In EGA modes the process is almost instantaneous. In VGA modes it can 
      take up to a few seconds, and the Cap Lock LED will light while the new 
      palette is being computed. Refer to the Cap Lock LED description for 
      further details. 
 
 CTL-F10 : Select New Background Color 
      Pressing the "CONTROL" key and also the "F10" function key 
      simultaneously (CTL-F10) causes the background color of the current 
      display to be changed to a new random value. 
 
 The Fade Control keys 
      DAZZLE allows the user to select which fades will be used. The actions 
      of these keys vary slightly depending on the current mode. In "Auto" 
      mode, pressing one of the fade keys sets which fade will be used next 
      but allows the normal image generation process to continue. In the 
      "Semi-Automatic" mode the fade keys induce the selected fade 
      immediately. 
 
      The "Fade Enable Control" screen in the "Configuration" menu shows 
      which key (without the "Alt", "Ctl", or "Shf" keys being used) can be 
      pressed to select a specific fade algorithm. 
 
 Special Fade Control keys 
      The following behave a little differently, so they have been set aside 
      for special discussion. 
 
 P : Pan/Scroll fade 
      Unlike the previous fade keys, this one has to be pressed at a certain 
      time to have any effect in the "Automatic" mode. When DAZZLE is drawing 
      in "Auto" mode it is in the "Auto-DAZE" state (no LED's are lit, see 
      details above about LED usage). Once the last image has been drawn it 
      switches to the "Fade-Out" state (the Scroll Lock LED is lit). The 
      first thing this latter state usually does is just pause for a while so 
      that you can appreciate the incredible beauty of the display. The "P" 
      key is only recognized in "Auto" mode if pressed while still in the 
      "Auto-DAZE" state (before Scroll Lock lights). Once the last image has 
      been drawn and the pause delay starts this key will simply be ignored. 
 
      If a Pan/Scroll is in progress as indicated by the lighting of the Num 
      Lock LED, then pressing the "P" key will assure that both a pan and 
      also a scroll are presented. 
 
      In the "Semi-Automatic" mode this key will not induce a Pan/Scroll. 
      Since that effect is not supported in the "Semi-Auto" mode, pressing 
      "P" causes one of the other fades to be randomly selected and executed 
      immediately. 
 
 H : Hold current display 
      This is distinct from, yet similar to, the "freeze" command that is 
      called with the "TAB" key. This key is simply ignored in the "Semi- 
      Auto" mode. In the "Auto" mode it lets the "Auto-DAZE" state (refer to 
 
 
DAZ5.2 17-Jan-97 Programs & documentation (c)1994 WMT               16 
 
 
      Pan/Scroll description above) continue to normal completion, and will 
      even let a Pan/Scroll proceed normally if one happens to have been 
      selected by the "Fade-Out" state. But it causes the "Fade-Out" state to 
      jam in the pause delay mode forever. Here the program will wait until 
      you manually select a fade. Note that the fade that you select will 
      commence immediately. The Scroll Lock LED will light solidly, 
      indicating that user intervention is required to allow the program to 
      proceed normally. Refer to the Scroll Lock LED description above for 
      more details. 
 
      If you press "H" as soon at DAZZLE enters the pause delay mode, then 
      any fade select key, the delay is effectively canceled -- allowing you 
      to immediately induce any fade you wish. 
 
 N : Next display now 
      This key has been made immediately effective in all modes. It stops any 
      current image generation or fade, and begins a screen clear process. 
      This is the fastest way to blank the screen. 
 
 Mouse Clicks 
      DAZZLE will test for the presence of a Microsoft compatible Mouse 
driver. If any mouse button is pressed (or if the screen is contacted when 
using a Touch Screen system that is Microsoft Mouse compatible) DAZZLE will 
usually interpret that action as being the same as pressing the "ENTER" key. 
Note that in the text menu subsystem of this current version a mouse click 
aborts the program. See "/G" option for ignoring the mouse. 
 
9. KEYS ACTIVE IN "SEMI-AUTO" MODE 
      We document the functionality of this feature below, but to limit the 
already massive size of this document we did not include the tutorial for this 
mode that can be found in the current (as of spring 1994) retail 
RAZZLE DAZZLE 3D manual. Thus experimentation is encouraged. 
 
      DAZZLE supports a whole set of commands to allow the user to control the 
image generation process of the program. Refer to "Selecting Modes" above for 
details on accessing the "Semi-Automatic" mode. Note that configuration 
options that disable a fade cause that fade to be unavailable in the "Semi- 
Auto" mode also. In addition to the keys described in the "KEYS ACTIVE IN ALL 
MODES" section above, the following keys can be used while in the "Semi-Auto" 
mode. 
 
 F8 : Toggle continuous drawing mode 
      This key is similar to the F10 Draw Current Image key, except that "F8" 
      will draw the selected image continuously until the next press of the 
      "F8" key. All other keys maintain their normal function even while the 
      continuous drawing mode is active. This mode is switched off when you 
      exit 'Semi-Automatic' operation, but remains active through a fade or 
      menu access. Review the section below with the F10 key description for 
      more details. 
 
 F9 : Select Random Image 
      If the user wishes to let DAZZLE randomly select the next image 
      generating algorithm to be drawn then press the "F9" function key. It 
      selects another image each time it is pressed. Note that specific 
      images can be selected as detailed below. 
 
 
 
 
DAZ5.2 17-Jan-97 Programs & documentation (c)1994 WMT               17 
 
 
 F10 : Draw Current Image 
      Once an image algorithm has been selected by whatever means, the "F10" 
      key is pressed to draw that image. The image will be drawn for as long 
      as you hold down this key. You may release the key, and when you press 
      it again it will simply resume where it left off if you have not 
      pressed another key. It is suggested that you start an image with just 
      a tap of this key, note what it is doing, and then decide how long you 
      wish to hold it. Since there are no limits on image generation time 
      with this key, you can let a really interesting pattern grow 
      continuously, producing visual effects that "Auto" mode will never 
      duplicate. This key will remember the image being played even if you 
      perform a "fade". So if a great image gets too busy, you can "fade" it 
      and press "F10" again and pick up where you left off. 
 
      Due to the behavior of the "typematic" key repeat built into the 
      keyboard controller, it is possible for DAZZLE to get confused about 
      when you release the "F10" key. If this happens then the selected image 
      will continue drawing after you release this key. Just a quick tap of 
      this key again will bring it to a halt. 
 
 Alt-F10 : Reinitialize Current Algorithm 
      This key allows the continued use of the same currently selected image 
      algorithm. But it causes the image algorithm to be reinitialized to new 
      random settings. This is most useful for changing between various modes 
      of the same algorithm. Some images support use of exclusive-OR for 
      "ghosting" or mosaic texturing, some can change shape, most will change 
      color and screen location when this is pressed. 
 
 Specific Image Selection Keys 
      It is possible to specify exactly which image algorithm you wish DAZZLE 
      to use by pressing one of the Alt-keys 0 through 9, or A through Z. 
      Press the "Alt" key, and a letter key or number key (use the numbers 
      along the top of the keyboard, not the ones over on the side calculator 
      pad). Each represents a specific image selection. The "Image Size" 
      display in the "Configuration" menu list the name of each algorithm, 
      and the Alt-key that can be used to select that image. 
 
      In addition to the Alt-keys pattern selection, Ctl-keys A through Z can 
      be used to select images that are detailed in the second "Image Size" 
      display in the "Configuration" menu list of algorithms. 
 
10. CONFIGURATION 
      DAZZLE allows the user to customize many of the characteristics of the 
image generation and fade actions. At any time you may press the "F2" function 
key to activate the configuration menu subsystem. This system offers useful 
enhancements and controls. 
 
10.1. Cursor Keys within CONFIGURE 
      When within the configure subsystem DAZZLE recognizes the various 
standard cursor keys. The "HOME" key jumps to the first entry field of the 
current screen. The "END" key jumps to the last entry field of the current 
screen. The "PgDn" key advances to the next screen, the "PgUp" returns to the 
previous screen. The arrow keys also can be used. Note that the bottom right 
of the text window shows what page movement keys are valid at that point. 
 
 
 
 
 
DAZ5.2 17-Jan-97 Programs & documentation (c)1994 WMT               18 
 
 
10.2. Exiting CONFIGURE 
      The text menu subsystems, including the configure system, can be exited 
by pressing the same key that invokes that subsystem. Thus to exit configure 
press the "F2" key again. 
 
10.3. CONFIG versus IMAGE control 
      The first menu presented allows you to select between the CONFIG and the 
IMAGE set of control menus. The IMAGE menus allow you to customize the actual 
graphics created by the self-directing "Auto" mode, and to save the settings 
in a file. IMAGE controls are documented in the remainder of this section 
below. 
 
      The CONFIG selection brings up a menu that allows you to make any of the 
command line options of the program permanent. You can also access this menu 
directly from the DOS command line with the "/#" command line option. 
 
      Each of the configuration options accepted by the program can be 
controlled from this menu. Simply press the letter associated with the option. 
A text window will appear and explain the function of the option, and allow 
you to decide if you wish to activate the function. After you have set all the 
options desired simply press the "ENTER" key. When it ask if you wish to make 
the settings permanent press "Y". 
 
10.4. Image Size Control 
      These two screens allow the user to customize the images generated in 
the "Auto" mode of DAZZLE. When an image is called, it is allowed to draw on 
the display for a variable amount of time, the duration of which centers 
around the number entered in this menu. This number is multiplied by an 
internal value that reflects the size of the display and the resolution of the 
current active video mode. Therefore these numbers are relative and not 
absolute in their impact. Since the screen resolution varies from EGA to VGA, 
it is also true that the maximum value that can be entered changes between 
video modes. You may enter any large number, DAZZLE will reduce your input to 
the legal range for the current mode. The minimum value is 0, thus allowing 
the complete disabling of images as you desire. At least one image must have a 
non-zero value, a configuration file that fails this criteria may cause DAZZLE 
to abort during startup. 
 
      As the "Image Size" number is increased the selected image is allowed to 
draw longer, producing either larger patterns, more patterns, and/or a greater 
variety of pattern variations. 
 
      The "KEY" field shows which Alt-key or Ctl-key (refer to "Specific Image 
Selection Keys" above) will select that specific image drawing algorithm. The 
"NAME" field shows the internal name of that image. The "SIZE" field shows the 
current relative size limit for that image. Note that the first Image Size 
screen is for use with Alt-key images, and the second Image Size screen is for 
use with Ctl-key images. 
 
10.5. Fade Enable Control 
      This screen allows the user to selectively enable or disable specific 
fades. If disabled, the fade will be unavailable in either "Auto" or "Semi- 
Automatic" modes. If the user presses a fade command key (refer to "The Fade 
Control Keys" above) for a fade that has been disabled then DAZZLE will 
randomly select an enabled fade to execute. Note that in addition to the 
listed fades, DAZZLE uses a "fade to black" process to clear the screen at the 
end of each fade. 
 
 
DAZ5.2 17-Jan-97 Programs & documentation (c)1994 WMT               19 
 
 
 
      The "KEY" field shows which key (without the "Alt", "Ctl", or "Shf" keys 
being used) will select that specific fade algorithm. The "FADE" field shows 
the internal name of that fade. The "ENABLE" field shows the current state for 
that fade. 
 
10.6. Auto Mode Display Customization 
      This menu shows two numbers; "Minimum images per display" and "Maximum 
images per display". These values control the number of images that will be 
overlaid on a single screen during the Auto Mode of operation. When set to 
small numbers only a few images will be mixed together on one display prior to 
the next fade. This reduces how busy the screen becomes. When set to large 
numbers many images will be mixed together on a display prior to the next 
fade. This creates a much more complex display. 
 
      This menu also allows you to control how long the program pauses in an 
idle state before initiating a fade. This time is provided to allow a screen 
to be appreciated before it is removed. 
 
10.7. File Access Menu 
      This screen allows the user to save or load a DAZZLE configuration file. 
There are three entry fields on this screen. Two additional function keys are 
also recognized only when viewing this screen. 
 
Select Mode 
      At this entry the user can select either to "Save" the current 
      configuration information, or to "Load" an existing file. Press either 
      the "S" key or the "L" key, then "ENTER". 
 
File Name 
      At this entry the user can specify the file to be saved or loaded. Note 
      that a default name is provided if one was not used at program 
      invocation. To replace the name simply begin typing it in, and press 
      "ENTER" when completed. It is suggested that a file extension (the last 
      three characters in the name, on the right of the period) of ".DZL" be 
      used. The following extensions are illegal : .BAT, .COM, .EXE. 
 
      Beneath this field is an unmarked "File Status" field. If you attempt 
      to load a nonexistent file this will show "NOT FOUND". If you try to 
      save over an existing file this will show "EXIST", unless the file is 
      protected from overwriting, in which case it will show "READ ONLY". 
 
      If you specify a wildcard character ("*" or "?") within this entry, 
      then DAZZLE will automatically invoke a directory list to aid in your 
      selection process. 
 
Path 
      The current disk and directory path is displayed in this field. You may 
      specify any variation of disk and path information that DOS would 
      normally support. Each of the following are legal: 
 
            ..          (changes to previous directory) 
            C:          (changes to C drive) 
            \WMT        (to WMT directory on current disk) 
            D:\         (to root directory on D drive) 
 
 
 
 
DAZ5.2 17-Jan-97 Programs & documentation (c)1994 WMT               20 
 
 
F3 : View Disk Directory 
      Pressing the "F3" function key invokes the disk directory display. Note 
      that if you have begun an entry in any of the menu's fields you must 
      press "ENTER" before this key can take effect. 
 
      Once a disk directory is displayed you may use the various cursor keys 
      to move around. Arrow keys work, and the "HOME" key jumps to the top of 
      the display, the "END" key jumps to the bottom. The "PgUp" and "PgDn" 
      keys can be used to move about more quickly. Press "ENTER" to select a 
      specific file, or "F3" again to exit this display. 
 
      If you select a field that ends with a "\" (backslash) character, you 
      are selecting a directory, and the display will be updated to reflect 
      the contents of this new default path. The path field in the File 
      Access Menu also will be updated to this new path. 
 
      File names displayed in lower case letters are "Read Only". 
 
F4 : Execute Save/Load 
      Once the desired file has been specified, the "F4" function key can be 
      pressed to execute the specified command. If the "F4" key is ignored, 
      then you may still have a pending input entry; simply press "ENTER" 
      then try the "F4" key again. 
 
11. USAGE WITHIN WINDOWS 
      When you register this shareware product you will receive the full- 
featured self-starting DOS and Windows (3.1 and 95) screen saver product. This 
shareware program is not designed to be used as a Windows screen saver. 
 
12. CONFIGURATION FILE FORMAT 
      The file that is used by DAZZLE is an editable text file that follows a 
simple format. Each entry in the file must be on a separate line, and consist 
of a "Key ID" and a "Configuration Value". It is suggested that the user 
invoke DAZZLE in it's default mode, use the File Access Menu to "Save" a copy 
of the program's configuration. That file should then be printed. With DAZZLE 
in the Configuration Menu mode, a printout of the configuration file, and a 
copy of this document in hand, the whole process should prove to be very 
clear. 
 
12.1. Shift Key Tokens 
      A token in DAZZLE is a character that represents a condition. In order 
to represent within the configuration file the condition of the three shift 
keys-Alternate, Control, Shift-a group of tokens have been assigned as 
follows: 
 
      Alternate = ~       (Tilde character) 
      Control = ^         (Caret character) 
      Shift  = `          (grave or backwards-quote character) 
 
Thus to specify the Alt-A key, the file entry would be "~A". To specify the 
Ctl-F key, the file entry would be "^F". 
 
12.2. Special Token 
      This file also contains a special token to allow the specification of 
menu configuration entries that do not match any shift key function. The "$" 
(dollar) token is used to mark such a field. The values for Auto Mode Display 
Customization are contained in this file as: 
 
 
DAZ5.2 17-Jan-97 Programs & documentation (c)1994 WMT               21 
 
 
 
$I : the mInimum number of images on one display 
$X : the maXimum number of images on one display 
$F : Fade delay time in Auto mode 
 
12.3. Key ID 
      A "Key ID" entry in the file consist of the key to be designated, with 
an optional shift key token prefix. Refer to Shift Key Tokens above for 
examples. 
 
12.4. Configuration Value 
      The value to be specified must be surrounded in square brackets; "[" and 
"]". 
 
      If the value is for an Image Size or configuration entry, then the use 
of an unsigned integer value is required. Unsigned meaning no "+" or "-" 
values. Integer meaning no fractions, decimal points, or exponents. Therefore 
legal values are: "[25]" or "[0001]" or "[ 99 ]". Illegal values would 
include: "[-1]" or " 25]" or "[14.5]". 
 
      If the value is for a fade entry, then the use of either a "Y" or an "N" 
character is required: "[Y]" or "[N]". 
 
12.5. Comment Lines 
      While reading (parsing) any line of text in the file, when a ";" 
(semicolon) is encountered DAZZLE stops reading that line. This allows the 
liberal insertion of various comments within the file. DAZZLE is very casual 
about parsing this file. It tolerates extra space and tab characters, so you 
can generally make the file look any way you like. 
 
12.6. Version Flag 
      The first non-comment line in the file should be the version flag. It 
consists of a "#" (hash) character followed by an unsigned integer of the 
DAZZLE version of the creating program. This is intended for future 
compatibility between upgrades and should not be changed. 
 
13. PROGRAM INTEGRITY 
      All reasonable effort has been made to assure that the use of this 
program on any compatible computer system can have no detrimental side 
effects. In addition to extensive Quality Assurance testing, the DAZZLE 
program contains an internal integrity check (read the section on the "/I" 
command line option above). If someone makes any code modifications to this 
program, it probably will be detected and the program will refuse to execute. 
Any persons making unauthorized modifications will be aggressively pursued and 
prosecuted. As of revision 5.0 the antiviral system uses a faster and better 
CRC checking algorithm. See the section above about the "/R" option before 
using it with your computer. 
 
14. PROGRAMMERS COMMENTS 
      DAZZLE is written mostly in Borland C (copyright Borland). Assembler 
code was used for direct video control. 
 
      Talented and accomplished people are always an asset. If you might be 
interested in contributing to a Worldwide MicroTronics, Inc. project, then 
please write, and if possible include a NON-CONFIDENTIAL sample of your work. 
 
 
 
 
DAZ5.2 17-Jan-97 Programs & documentation (c)1994 WMT               22 
 
 
      Some of you have questioned me about the "Our Creator, evidenced by our 
creativity" message on the program credits artwork screen. This section is 
perhaps the best way to answer all the questions. I hope you will receive it 
in the same friendly spirit in which it is offered. If you are inclined 
towards censorship, or easily offended by simple truth, DON'T READ IT! 
 
HIDDEN TRUTH 
      What is the reason for human creativity? Why do we have this desire and 
      capability that surpasses all physical survival needs, and serve no 
      real evolutional purpose? Could it be that our creativity is the 
      evidence that we are made in our Creator's image? Doesn't this suggest 
      a personal transcendent, supernatural God who cares about his creation, 
      and should therefore be relevant in our daily lives? Are you willing to 
      think about it honestly, or will you dismiss this without questioning 
      what motivates your prejudice or fear? Do you honestly believe that our 
      awesome universe and all the life and processes in it occurred by a 
      theoretical, chance, mechanistic, process? Can disorder produce highly 
      complex order? Why are the laws of physics suspended only when 
      biological evolution is involved? Why would you have such "blind faith" 
      in so scientifically improbable a dogma, without even considering the 
      possibility of "informed faith" in a more consistent and probable 
      systematic explanation? Isn't the logical evidence for design, order 
      and purpose that surrounds us quite overwhelming? 
 
      "Even if the truth is veiled, it is veiled to those who are perishing. 
      The false god of this age has blinded the minds of unbelievers, so that 
      they cannot see the light of the good news of the glory of the anointed 
      one, who is in the image of God." (2 Corinthians 4:3,4) 
 
REVEALED IN SUPERNATURAL POWER 
      The truth of the good news about Yeshua/Jesus the Messiah (Christ) is 
      that he is the Son of God (Isaiah. 7:14 and Mark 1:1) who will save us 
      and call us to a holy life - not because of anything we have done but 
      because of his own purpose and grace (2 Timothy 1:9). 
 
      Do not be afraid or ashamed of this truth, because it is the power of 
      your creator God for the salvation of everyone who believes (Romans 
      1:16) 
 
      "The Spirit of the Lord is on me, because he has anointed me to preach 
      good news to the poor. He has sent me to proclaim freedom for the 
      prisoners and recovery of sight for the blind, to release the 
      oppressed, to proclaim the year of the Lord's favor." (Isaiah. 61:1,2 
      and Luke 4:18,19) 
 
THERE IS A PURPOSE FOR YOUR LIFE 
      "My purpose is that they may be encouraged in heart and united in love, 
      so that they may have the full riches of complete understanding, in 
      order that they may know the mystery of God, namely, the messiah, in 
      whom are hidden all the treasures of wisdom and knowledge. I tell you 
      this so that no one may deceive you by fine-sounding arguments [and New 
      Age deceptions]." (Colossians 2:2-4) 
 
SALVATION MUST PRECEDE PURPOSE 
      "Surely God is my salvation; I will trust and not be afraid. The Lord 
      is my strength and my song; he has become my salvation. With joy I will 
      draw water from the wells of salvation." (Isaiah 12:2,3) 
 
 
DAZ5.2 17-Jan-97 Programs & documentation (c)1994 WMT               23 
 
 
 
OUR ETERNAL HOPE 
      "When the kindness and love of God our Savior appeared, he saved us, 
      not because of righteous things we had done, but because of his mercy. 
      He saved us through the washing of rebirth and renewal by the Holy 
      Spirit, whom he poured out on us generously through Jesus the Christ 
      (Yeshua ha Mesheah) our Savior, so that, having been justified by his 
      grace, we might become heirs having the hope of eternal life." (Titus 
      3:4-7) 
 
CHALLENGE 
Please read this section again from the beginning with the viewpoint of "What 
if this just happens to be true?" What do you risk to simply give it a try? 
When you are ready for the true answers to life's hardest questions remember 
the wisdom revealed and exemplified by Jesus/Yeshua of the Holy Bible. 
 
CREDITS 
Scriptures liberally taken from the New International Version, copyright 
International Bible Society. 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
DAZ5.2 17-Jan-97 Programs & documentation (c)1994 WMT               24 

Order Details
Software products can be ordered from Worldwide MicroTronics, Inc.
at the address below. Please include this completed form with your
check. See the User's Manual (DAZZLE.DOC) for information about
placing orders. Buy it NOW at http://www.microtronics.com/
Otherwise, please mail this completed form with your check.

Please PRINT your full name and mailing address clearly.


Program name : DAZZLE 
Revision     : 5.2b 20Jan97 
ID codes     : r1=10520,  r2=01000

mail to:
WORLDWIDE MICROTRONICS, INC.
P.O.Box 8759
Spring, TX. U.S.A. 77387-8759

 *** Worldwide MicroTronics, Inc. product REGISTRATION and ORDER FORM ***
Mail US$15 (plus shipping/handling listed on order form) payable to
Worldwide MicroTronics, Inc. required after 15 days usage, which gets you
a copy of the full DOS & Windows self-starting screen saver.
See DAZZLE.DOC for distribution limitations, and copyright statements.
Buy it NOW at http://www.microtronics.com/ on the internet! 


  We ship 3-inch DSHD [High Density] disk.

When registering this shareware program you will receive the
current version of the full featured self-starting
screen saver for DOS and Windows 3.1/95

Shipping and Handling charges: USA free, Canada/Mexico US$2.50
everywhere else US$5.00 (if ordered directly from us)


DAZZLE, the music video on stereo VHS cassette, is available in
VHS and LaserDisk from Miramar (800) 767-4748.

Please review the User's Manual and the software license for an abundance of
useful information, DAZZLE Multi-Copy or Site License prices and legal
limitations on the use of this program and it's images.
Enter "DAZZLE -?" at the DOS prompt for a short help screen,
 and instructions on extracting the manual.


External References

Discussion