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