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.