The Devil's Doorknob BBS Capture (1996-2003)/devilsdoorknobbbscapture1996-2003.iso/Dloads/ANSIANDO/DAZZLE.ZIP/DAZZLE.DOC

Text File | 1992-07-28 | 85KB | 1,963 lines

                                  DAZZLE

                   The Ultimate Graphics Image Generator


                                 Shareware
                              Usage Agreement
                                    and
                               User's Manual




                      Documentation for Revision 5.0
                                22 May 1992





                               MicroTronics
                               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.





1. DAZZLE Overview................................................1
2. INTRODUCTION...................................................2
3. SHAREWARE......................................................3
     3.1. Usage Limitation........................................4
     3.2. Revision Control........................................4
     3.3. Current registration fee and discounts..................5
     3.4. Site Licenses...........................................5
     3.5. OEM/VAR Licenses........................................5
     3.6. Future Products.........................................6
     3.7. Royalties...............................................6
     3.8. Disclaimer..............................................7
     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.5. Artistic Options........................................11
     4.6. Other Options...........................................12
     4.7. Specifying the INPUTFILE................................14
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.........................................15
     6.2. Num Lock LED............................................15
     6.3. Cap Lock LED............................................15
7. PRIMARY DAZZLE MODES...........................................15
     7.1. Selecting Modes.........................................15
8. KEYS ACTIVE IN ALL MODES.......................................16
     8.1. ESCAPE : Program Termination............................16
     8.2. TAB : Freeze Image......................................16
     8.3. F5 : Dump Screen Image to Disk File.....................16
     8.4. "+" and "-" : Color Cycling Clock Adjustment............17
     8.5. "PgUp" and "PgDn" VGA Color Cycling Step Adjustment.....17
     8.6. Shf-F10 : Reinitialize the Color Palette................17
     8.7. CTL-F10 : Select New Background Color...................17
     8.8. The Fade Control keys...................................17
     8.9. Special Fade Control keys...............................17
     8.10. Mouse Clicks...........................................18
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................19
     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.....................................20
     10.4. Fade Enable Control....................................21
     10.5. Auto Mode Display Customization........................21
     10.6. File Access Menu.......................................22
11. USAGE WITHIN WINDOWS..........................................23


DAZ50-200592 Programs & documentation (c)c1992 MicroTronics          i





12. CONFIGURATION FILE FORMAT.....................................23
     12.1. Shift Key Tokens.......................................23
     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. THE MEANING OF LIFE...........................................25
16. DAZZLE Distribution Authorization.............................28
17. EPILOGUE......................................................29












































DAZ50-200592 Programs & documentation (c)c1992 MicroTronics         ii






1. DAZZLE Overview
version number: 5.0

     The only Screen Saver so stunning that it is being 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.
*    Compose images of varying complexity which can be exported or printed
     to supplement any presentation, publication, or display project.
     Royalty free for non-commercial usage.
*    Includes a self-directing mode which is an effective and entertaining
     attention getter with a variety of uses in trade shows, reception
     areas, showrooms, store fronts, schools, nearly anywhere.

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.

Options
*    Desktop publishing, graphics drawing, or other programs to edit or
     utilize the PCX format graphics files output by DAZZLE.
*    Monochrome or color printer, film recorder, or plotter to create hard
     copy of generated images. Peripheral drivers not included, DAZZLE
     outputs industry standard PCX format disk files that most systems
     support.
*    VGA to NTSC adapter to record DAZZLE animation directly onto video
     tape.











DAZ50-200592 Programs & documentation (c)c1992 MicroTronics          1





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,
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.


DAZ50-200592 Programs & documentation (c)c1992 MicroTronics          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. Additional programs are available from
MicroTronics that provide self-starting DOS and Windows Screen Saver
capability, 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 (selling or distributing any program that
includes DAZZLE requires an active OEM agreement with MicroTronics).

     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
regenerating. In its self-directing play mode it is great "living" mobile
art. Capture stills, record it on your VCR, use the images as backgrounds
for your slide presentations, or play it live with your band (note the
Royalty section below). Applications are boundless.


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


DAZ50-200592 Programs & documentation (c)c1992 MicroTronics          3





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 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.


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 MicroTronics 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 MicroTronics by the distributor,
and therefore would not constitute payment of a registration fee. The
images generated by this program are subject to usage limits and royalty
fees, refer to the Royalties section for additional details.


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 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,


DAZ50-200592 Programs & documentation (c)c1992 MicroTronics          4





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.


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.


3.5. OEM/VAR Licenses
     Multi-copy OEM/VAR licenses are available at a reduced cost for
developers that wish to incorporate MicroTronics programs into their own
product for resale. There is also an open-ended license that allows


DAZ50-200592 Programs & documentation (c)c1992 MicroTronics          5





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

     Self activating DOS and Windows Screen Saver drivers, and a full
computer security version of MT-DAZE, are available from MicroTronics.
These are retail enhancements to the shareware versions of the DAZZLE
family of programs.

     A 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.

     By the summer of 1992, MicroTronics will make available DAZZLE
merchandise of a broad variety, including: Music Videos, Shirts, Mugs,
Cards, Prints, Stick'EMs, and such.

     The rapid success of DAZZLE 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.
Revenue or any other form of remuneration resulting from images captured or
photographed or in any way derived from DAZZLE, or any MicroTronics
programs, are subject to usage limitations, royalties, fee's, or other
claims by the author. Contact J.R.Shiflett at MicroTronics for a license
agreement and royalty rates for commercial usage of this program or it's
images. 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. Any public or commercial use of
derived images must assure that credit for, and address of, MicroTronics is
prominently displayed in the distributed work and/or documentation.






DAZ50-200592 Programs & documentation (c)c1992 MicroTronics          6






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
     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.

Usage: DAZZLE -options inputfile
     -$   Display order information.
     -2   2 part palette update to fix flickering screens (slower).
     -a   Alternate (faster) color cycling speed.
     -b   Bashful, no closing credits & any key aborts.
     -c   Compatible mode, use BIOS for better portability.
     -d   Delay, slow down drawing for faster PC's.
           "-d=xxxx" delay xxxx units.
     -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 warning beeps).
     -s   Show mode, quick single image.
           "-s=xxxx" Show mode, duration xxxx seconds.
     -w   Window environment, no messages & changes some defaults.
     -x   XT compatible, inferior but works.
     -z   Create DAZZLE.DOC file on current disk path!

During the display 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.




DAZ50-200592 Programs & documentation (c)c1992 MicroTronics          7






4.2. Additional Options Menu
     When you press a key at the "Press Any Key" prompt you will be
presented with the following display.

If an "inputfile" is not specified, the program will try to locate and load
MTDAZZLE.DZL from the current path. To prevent this load specify an
inputfile name of "*"

Additional Options
     -e   EGA operation mode forced.
     -h   Hide EGA border.
     -k   Keyboard typematic unchanged.
     -t   Tall video aspect ratio mode.

***** limited use command line options *****
     -+   Ignore TARGA+64, even if present.
     -!   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 can be preceded
with either the "/" (slash) character or the "-" (minus) character. If you
use the SwitchChar feature of MSDOS, 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  -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. Note that DAZZLE will automatically attempt
to locate and load a configuration file named MTDAZZLE.DZL unless
explicitly instructed otherwise with the "*" or "-*" 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", "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.






DAZ50-200592 Programs & documentation (c)c1992 MicroTronics          8





  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 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 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.

  4.4.3.  /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.

  4.4.4.  /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



DAZ50-200592 Programs & documentation (c)c1992 MicroTronics          9





give its usual error messages during startup. Refer to the "/V" option
below for more information.

  4.4.5.  /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
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.

  4.4.6.  /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
aware 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.7.  /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


DAZ50-200592 Programs & documentation (c)c1992 MicroTronics         10





specially enhanced 320x400x256 mode that is not properly captured by many
commercial products. The VGA modes require no more than 256kB of video
memory.

  4.4.8.  /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.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. Note Royalty section
above.).

  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.


DAZ50-200592 Programs & documentation (c)c1992 MicroTronics         11






  4.5.6.  /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.

  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. 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.  /$ = 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
MicroTronics 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:

     Complete the form and mail it to the indicated address. Enclose any
indicated funds in U.S.Dollar instruments, payable to MicroTronics.

  4.6.2.  /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


DAZ50-200592 Programs & documentation (c)c1992 MicroTronics         12





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 MicroTronics. 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.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 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: 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.

  4.6.6.  /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.




DAZ50-200592 Programs & documentation (c)c1992 MicroTronics         13





  4.6.7.  /+ = Ignore TARGA+64, even if present.
     The TARGA+64 card from Truevision can be used with a special limited-
availability non-shareware version of DAZZLE to produce high quality NTSC
video images. This option allows the special TARGA compatible version of
the program to ignore the video card so that it will use the computers
normal VGA display.

  4.6.8.  /! = Monitor Screen Saver driver interface.
     The retail versions of MT-DAZE 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


DAZ50-200592 Programs & documentation (c)c1992 MicroTronics         14





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 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.


DAZ50-200592 Programs & documentation (c)c1992 MicroTronics         15






     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.


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.


DAZ50-200592 Programs & documentation (c)c1992 MicroTronics         16







8.4. "+" 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.5. "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.6. 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.7. 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.8. 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.9. Special Fade Control keys
     The following behave a little differently, so they have been set aside
for special discussion.



DAZ50-200592 Programs & documentation (c)c1992 MicroTronics         17





  8.9.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.9.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.

  8.9.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.10. 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.





DAZ50-200592 Programs & documentation (c)c1992 MicroTronics         18






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.


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"


DAZ50-200592 Programs & documentation (c)c1992 MicroTronics         19





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.


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



DAZ50-200592 Programs & documentation (c)c1992 MicroTronics         20





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.

     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 (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))).





DAZ50-200592 Programs & documentation (c)c1992 MicroTronics         21






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)

  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.



DAZ50-200592 Programs & documentation (c)c1992 MicroTronics         22





     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. 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 MicroTronics, 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 -1
     Display Usage: Full Screen
     Close Window 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)

     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".


DAZ50-200592 Programs & documentation (c)c1992 MicroTronics         23







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


DAZ50-200592 Programs & documentation (c)c1992 MicroTronics         24





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.


14. PROGRAMMERS COMMENTS
     DAZZLE is written mostly in Borland C 3.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.


15. THE MEANING OF LIFE

     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

Why was I born? Is this all there is to my life, nothing more? What's the
point of my existence? Have I no purpose, no reason for being? Does someone
possess a hidden "Secret" to fulfillment, or am I blinded to the open
answer?

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). This
truth is evidenced with works of supernatural power when used rightly and
in love as commanded (Mark 16:15-18).



DAZ50-200592 Programs & documentation (c)c1992 MicroTronics         25





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

Many are the plans in a man's heart, but it is the Lord's purpose that
prevails (Prov 19:21). And we know that in all things God works for the
good of those who love him, who have been called according to his purpose
(Rom 8:28). In him we were also chosen, having been predestined according
to the plan of him who works out everything in conformity with the purpose
of his will (Eph 1:11), for it is God who works in you to will and to act
according to his good purpose (Phil 2:13).

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

The Lord will be the sure foundation for your times, a rich store of
salvation and wisdom and knowledge; the reverence of the Lord is the key to
this treasure (Isa 33:6). "Maintain justice and do what is right, for my
salvation is close at hand and my righteousness will soon be revealed" (Isa
56:1). Bear in mind that our Lord's patience means salvation (2 Pet 3:15),
though you have not yet seen him, you can love him; and even though you do
not see him now, you can believe in him and be filled with an inexpressible
and glorious joy, for you will be receiving the goal of your faith, the
salvation of your soul (1 Pet 1:8,9). We must pay more careful attention to
what we have heard, so that we do not drift away. How shall we escape if we
ignore such a great salvation (Heb 2:1-3)?

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

He alone is our rock and our salvation; he is our fortress, we will never
be shaken (Psa 62:2). We do not hide his righteousness in our heart; we
speak of his faithfulness and salvation. We do not conceal his love and his
truth from the masses (Psa 40:10). The salvation of the righteous comes
from the Lord; he is our stronghold in times of trouble (Psa 37:39).
Therefore, prepare your mind for action in his purpose; be self-controlled;
set your hope fully on the grace to be given you in Jesus Christ (1 Pet
1:13), as guaranteed in his resurrection from the dead (1 Pet 1:3).

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


DAZ50-200592 Programs & documentation (c)c1992 MicroTronics         26





          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 2:11-14  For the grace of God that brings salvation has appeared to
          all men. It teaches us to say "No" to ungodliness and worldly
          passions, and to live self-controlled, upright and godly lives in
          this present age, while we wait for the blessed hope-the glorious
          appearing of our great God and Savior, Jesus Christ, who gave
          himself for us to redeem us from all wickedness and to purify for
          himself a people that are his very own, eager to do what is good.

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.
































DAZ50-200592 Programs & documentation (c)c1992 MicroTronics         27






16. DAZZLE Distribution Authorization

     This statement of agreement is valid only for those persons
distributing for a fee shareware files from MicroTronics. Possession and
use of registered 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 any MicroTronics programs 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. 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.


_________________________________________ _________________________
Your signature                Date      Title









DAZ50-200592 Programs & documentation (c)c1992 MicroTronics         28






17. EPILOGUE

This program may be distributed as is AT NO CHARGE by the distributor
(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. Refer to the Royalty section above for important
information about limits on the usage of this program and the images it
creates.

Enter "DAZZLE -Z" at the DOS prompt to generate the User's Manual.
Enter "DAZZLE -$ > PRN:" at the DOS prompt to print an order form.

Comments and inquires about updates and other products are welcome at
our mailing address. $15 ($20US for non-U.S.A. sites) registration payable
to MicroTronics requested after 10 days usage, which makes you eligible
for an update disk and puts you on our PRIVATE mailing list.
Add $5 extra for a printed manual. DOS & Windows Screen Savers available
for an additional charge.


A production of J.R.Shiflett's Midnight Visions Workshop.

Mailing address (1992):            CompuServe [76236,1573]
MicroTronics                       Voice/FAX [phone]
P.O.Box 8759
Spring, Tx USA 77387-8759





























DAZ50-200592 Programs & documentation (c)c1992 MicroTronics         29