Black Box 4

home *** CD-ROM | disk | FTP | other *** search

/ Black Box 4 / BlackBox.cdr / dosutils / psmenu14.arj / PSMENU.DOC < prev next >

Wrap

Text File | 1992-05-03 | 156.8 KB | 3,601 lines

P.S.Menu Picture Shell Hard Disk Menu System Version 1.4 "P.S. Where Have You Been All My Life!" Copyright (C)1991,1992 David R. Green. All rights reserved. AdLib is (TM) of AdLib Incorporated Epson (R) Epson America Inc. GIF is (TM) of Compuserve and H&R Block IBM, PC, PC/XT, PC/AT, PS/2 are (TM) International Business Machines MPU-401 is (TM) Roland Corporation MS-DOS is (TM) Microsoft Corporation MT-32, MT-100, CM-32L, CM-64, LAPC-1, SC-55 are (TM) Roland Corporation PCX file format is (TM) ZSoft Corporation Windows is (C) Microsoft Corporation 8088, 8086, 80286, 80386, 80486 are (TM) Intel Corporation Certain Icon graphics are (C) or (TM) of their respective holders ────────────────────────────────────────────────────────────────── i TABLE OF CONTENTS Introduction ......................... Pg. 1 Conventions .......................... Pg. 1 Features ............................. Pg. 2 System Requirements .................. Pg. 2 Disk Contents ........................ Pg. 3 Installation ......................... Pg. 3 P.S.MENU ............................. Pg. 5 Overview ........................... Pg. 5 Using the P.S.Menu section ......... Pg. 6 In Case Of Difficulty .............. Pg. 6 P.S.EDIT ............................. Pg. 9 Entry System ....................... Pg. 9 Status/Options/Help ................ Pg. 10 Printout ........................... Pg. 12 Sample Entry ....................... Pg. 14 P.S.DRAW ............................. Pg. 17 Cursor ............................. Pg. 17 Exit Button ........................ Pg. 17 Tool Box ........................... Pg. 17 Palette Box ........................ Pg. 25 File Box ........................... Pg. 26 Drawing Area ....................... Pg. 27 PCX Import/Export .................... Pg. 29 DRAW Tips and Techniques ............. Pg. 30 Appendix A: Error Messages ........... Pg. 34 Appendix B: Sound .................... Pg. 36 Appendix C: Quick Reference .......... Pg. 41 Appendix D: Registration ............. Pg. 44 Appendix E: Version Guide ............ Pg. 52 Index ................................ Pg. 53 Glossary ............................. Pg. 54 ────────────────────────────────────────────────────────────────── ii INTRODUCTION Welcome to P.S.Menu, an advanced Hard Disk Shell Menu system. P.S.Menu brings the world of multi-color high-resolution graphics to the Personal Computer Hard Drive Menu program. 256-color images and sculpted 3D screens help you visually access all of the applications on your computer system. P.S.Menu affords you the luxury of Windows-like Icon pictures, that graphically represent each of your applications. P.S.Menu has the ability to run large DOS programs, such as many of the current games, as well as the advantage of NO system memory overhead* like many other Text-based and Graphical User Interface (GUI) menu programs. Each Icon is composed of more colors than most GUIs, PLUS P.S.Menu supports industry standard Sound Cards for Sound Effects (SFX) during program execution instead of the usual simple PC beeps. * Certain programs may require the use of a small resident section of P.S.MENU to insure return to the Menu system. This section requires just over 1k of system RAM to work. BE SURE TO REGISTER YOUR COPY OF P.S.MENU TO RECEIVE YOUR FREE BONUS DISK OF OVER 150 ADDITIONAL P.S.MENU ICONS, AND MANUAL. CONVENTIONS This manual uses the following typographical conventions: Keystrokes are surrounded by brackets, example [ESC] means to press the ESC key on the keyboard. [^v<>] are cursor arrow keys. Any Acronyms will be spelled out when first encountered, example Sound Effects (SFX). This manual uses a Beginner/Advanced method of describing many of the menu functions. With Beginner describing the easiest method for accomplishing each function, while Advanced explains a more in-depth method with information concerning what is actually occurring to certain files, etc. This program requires the use of a Mouse. Where stated, mouse actions are as follows: ∙ Click to quickly press and release the mouse's left button ∙ Click Left to quickly press and release the mouse's left button ∙ Click Right to quickly press and release the mouse's right button ∙ Drag to hold down the mouse button while you slide the mouse ────────────────────────────────────────────────────────────────── Introduction / Conventions 1 FEATURES ∙ 3D sculpted "push-button" menu screen with full mouse control ∙ 256-color Icon graphics ∙ 4 pages of 25 menu selections, allowing a total of 100 selections ∙ Support for AdLib and Roland Sound systems ∙ Integrated Menu Maintenance program (Edit) ∙ Integrated Icon Paint program (Draw) ∙ PCX 320x200 256 color file format Import and Export ∙ Written entirely in machine language for small size and fast speed ∙ 55 Icons included ∙ User ability to expand the Icon library ∙ No System RAM requirements when running a program SYSTEM REQUIREMENTS ■ An IBM Personal Computer model PC, PC/XT, PC/AT, (8088/8086/ 80286/80386/80486) or PS/2 series computer, or 100% compatible. ■ DOS Version 3.3 or greater. ■ At least one hard-disk drive and one or more floppy-disk drives. The Hard Disk must have 360k free space for the original install, and between 60k and 380k free space (depending on the number of Icons used), for final operation. ■ 360k (kilobytes) of available memory (FREE RAM after DOS, resident programs (TSRs), and any drivers such as a mouse). 448k or more installed system RAM. ■ A VGA Video Adapter that is 100% IBM VGA Register and BIOS compatible. ■ A Microsoft or compatible mouse. OPTIONAL: ■ An AdLib Music Synthesizer Card or compatible (Sound Blaster, Covox Game Master, etc.) ■ A Roland MT-32, CM-32L, CM-64, SC-55, or LAPC-1 MIDI DeskTop Music Sound Module. NOTE all of the above Roland sound modules with the exception of the LAPC-1 require: A Roland MPU-401 MIDI Processing Unit with MIF-IPC Interface Kit or a Roland MPU-IPC MIDI Processing Unit. The LAPC-1 has an integrated MIDI Processing Unit. ────────────────────────────────────────────────────────────────── 2 Features / System Requirements DISK CONTENTS Main Program Files: ICON .PCX .... a blank Icon to be used with PCX paint programs INSTALL .EXE .... P.S.Menu installation program PSMENU .EXE .... main program (do not execute this directly) PSMENU .DAT .... an example data file Included Icons: * .ICN .... a variety of pre-drawn Icons Last Minute Updates: README .DOC .... last minute details and additions to the P.S.Menu program and manual. Please read this file. INSTALLATION Before you begin, make a copy of the original diskette. This will be your backup in case anything should happen to the original. Refer to your DOS manual on the procedure for copying disks (see the DISKCOPY command). The Install program must be used to install P.S.Menu on your hard drive system, as it creates a machine-dependant file. Any attempt to bypass the install will cause the menu program to function incorrectly. To install P.S.Menu on your hard drive, follow this procedure: STEP 1 insert the P.S.Menu disk into the appropriate drive (5¼" or 3½") STEP 2 change or "log-on" to that drive: A: [ENTER] or B: [ENTER] STEP 3 type: INSTALL [ENTER] ────────────────────────────────────────────────────────────────── Disk Contents / Installation 3 The installation program will perform the following: 1. Prompt for which hard drive letter to install onto. 2. Create the PSMENU directory on the hard drive. 3. Copy all P.S.Menu files to the hard drive. 4. Create the PS.BAT file, tailored to your computer system and installation drive letter. 5. The PATH must be set to include \PSMENU. You will be asked whether the install should do this for you, or if you prefer to manually perform this operation. If the PATH in the AUTOEXEC.BAT file is NOT set to \PSMENU, the program will NOT function correctly. 6. If your computer boots from the hard drive, you can have P.S.Menu automatically start each time the system is turned on. Answer YES to this option if desired. PS will be appended to the end of the AUTOEXEC.BAT file. 7. Inform you as to which Extended Sound systems your machine supports. 8. Provide a screen of post-installation information. 9. You may now remove the P.S.Menu disk from the drive, and reboot your computer. NOTE that steps 5 and/or 6 save your original AUTOEXEC.BAT file to one named AUTOEXEC.OLD. NOTE that step 6 assumes that you were not using any menu program previous to installing P.S.Menu. If you were, you will have to delete the line from the AUTOEXEC.BAT file that ran the previous menu program. The finished install should look like this: C:\ (or which ever drive you specified to install onto) │ ~ │ ├─PSMENU \ │ ICON .PCX │ INSTALL .EXE │ PS .BAT (created by INSTALL.EXE) PSMENU .EXE ~ PSMENU .DAT PSTMP .BAT (variable size, created at run-time) * .ICN (all icon files) ────────────────────────────────────────────────────────────────── 4 Installation Your AUTOEXEC.BAT file should have the following additions: PATH original_paths;C:\PSMENU (PSMENU directory added to path) PS (if auto-run on boot selected) The Icon files may be viewed, used in the menu system, and if unused, optionally deleted from the \PSMENU directory to conserve hard drive space and increase program speed. If you are not using all of the Icons, you should remove the unused ones. Directory search time is dependant on the number of files located in the directory, the more files, the slower the search. In other words, if you have a lot of unused Icons in the PSMENU directory, it will take longer for the program to start up and load in all of the used Icons. If you want to be able to keep a large number of Icons on your hard disk, you could create a directory called ICONS off of the PSMENU directory, and put all of the unused Icons there. Please note that if you do this, you will still have to copy any files to the PSMENU directory to use them or edit them with Draw. For more information on PATH and AUTOEXEC.BAT, refer to your DOS manual. P.S.MENU Once installed, to use P.S.Menu, reboot your computer so the changes to your AUTOEXEC.BAT file take effect. If you opted not to have P.S.Menu run everytime you turn on your computer, reboot, then type PS [ENTER]. OVERVIEW P.S.Menu is divided into three seperate sections or programs: P.S.Menu - the Main screens of Icon Buttons P.S.Edit - the Menu Maintenance program P.S.Draw - the Icon Paint program ────────────────────────────────────────────────────────────────── Installation / P.S.Menu / Overview 5 USING THE P.S.MENU SECTION When P.S.Menu runs, a screen full of square "3D Buttons" is displayed, in addition to a mouse arrow cursor. To select a program to run, simply click the Left mouse button on the desired screen selection. The "Button" will move inward, a sound will occur (if a sound source other than None is selected, see the P.S.Edit section), and the defined program will then execute. Please note that the Icons on the original install screens do not run their corresponding programs. The screens simply contain references to all supplied Icons in order to show you what Icons are available. It is suggested you select from among the supplied Icons for the programs that are present on your hard drive, and modify the P.S.Menu data file for the proper drive/path/executable to each of these programs. To move from the first page of selections to the next, click the Right Mouse Button. Notice that the tiny number on the mouse cursor changes to reflect the current selection page. P.S.Menu is also the gateway to the Edit and Draw sections. Keyboard Command Quick Reference: ESC .... exit P.S.Menu to DOS. F1 .... go to the P.S.Edit Menu Maintenance section. F2 .... go to the P.S.Draw Icon Paint section. Mouse Command Quick Reference: Left button .... run a selection, by pressing a "Button". Right button .... cycle through the four selection screens. Movement .... move the arrow around the screen. IN CASE OF DIFFICULTY ∙ If you hear a single beep when you start P.S.Menu. Beginner: This means the program cannot find its data file: PSMENU.DAT. A new blank file will now be present in the Menu. You can at this time, either enter new information using the Edit [F1] program, or exit P.S.Menu by pressing [ESC] and find the missing or deleted PSMENU.DAT file. Advanced: The PSMENU.DAT file is missing, deleted, or damaged. It must be located in the PSMENU directory with the PSMENU.EXE program. Deleting the PSMENU.DAT file is a quick way to start with a clean menu, as all entries will then be blank, and all Options reset to default. ────────────────────────────────────────────────────────────────── 6 Using The P.S.Menu Section / In Case Of Difficulty ∙ If a Button has no effect when it is clicked on. Beginner: In other words, it doesn't run a program. One or more of the lines in the Edit text file is blank (check that you didn't forget to enter the Drive, Path, or Name entries). Advanced: The Drive, Path, and Name entries are checked for any actual text before running the selection. The Icon may still be shown on screen if there is a valid Icon name in the Icon entry. Verify and fill in the appropriate text for the selection. Remember, even if the program is in the Root directory of the drive, you still must put the "\" on the Path line. ∙ If you hear a beep, and a Blank Button is displayed where an actual Icon is supposed to be. Beginner The Icon entry for that Button contains an invalid Icon name. Check the spelling of the Icon file, and make sure it is in the PSMENU directory with the rest of the P.S.Menu program. Advanced The Icons must be located in the same directory as the P.S.Menu program. When P.S.Menu is started, it searches all of the Icon entries in the data file, and loads those Icons into four pages for display. A missing Icon file or misspelled entry will result in a blank Button being displayed in its place. ∙ If you do not return to P.S.Menu when the selected program is done. Beginner Check to see if the file that runs the selected program is a Batch file (extension is ".BAT"). If it is, be sure to include the ".BAT" extension on the P.S.Menu Name line. If this still will not make the selected program return, check to see if the program's batch file runs another batch file within a second directory (an example of this is Sierra's Space Quest IV, the SQ4.BAT in the \SIERRA directory runs another SQ4.BAT in the \SIERRA\SQ4 directory). If this is the case, put the full path in the Path line (example \SIERRA\SQ4) and the final batch file name into the Name line (example SQ4.BAT). Certain programs will never return to P.S.Menu, regardless of whether you specify the extension or final program directory. In these cases, place an asterisk "*" in front of the Name in the Edit data. Example *PROGRAM.EXE It is good practice to always include the file name extension on the File line, whether it is a COM, EXE, or BAT file. ────────────────────────────────────────────────────────────────── In Case Of Difficulty 7 Advanced The program that was just ran, is a batch file, or has possibly destroyed or modified the Batch processing portion of COMMAND.COM. An example is if a second Command processor is Shelled to (usually by using the DOS EXEC function). Also when a batch file runs another batch file (example if PSTMP.BAT calls SQ3.BAT), the information in the first batch file is lost. You must therefore include the ".BAT" file extension on the Name line, which forces P.S.Menu to return. Certain programs will never return because they destroy the area that is required for Batch processing, etc. In these cases, you must use the resident P.S.Menu portion to force a return. This is accomplished by placing an asterisk "*" in front of the Name in the Edit data. If you use this feature, it is mandatory that the file name extension be included. ────────────────────────────────────────────────────────────────── 8 In Case Of Difficulty P.S.EDIT P.S.Edit is the Menu Maintenance section of P.S.Menu. Menu Maintenance is used to add, delete, or change program selections and system options. Once all program selection data and options are entered, you never need to use P.S.Edit again until you want to make modifications or additions to your menu. P.S.Edit has features found on expensive word processors, such as Cut, Copy, and Paste to Clipboard, in addition to full keyboard cursor control. The screen is divided into two halves, the left being a word- processor-like entry system, and the right contains multiple status, option, and help boxes. ENTRY SYSTEM The entry system is where the actual information for each screen Button is located. Each selection is broken into 5 entry fields: Title .... The name of the program, up to 20 characters long. This is present only for easy identification of the program selection. It has no effect on the text, if any, on the Icons themselves, or the name of the Icon or executable file. Icon .... The name of the Icon file you wish to associate with this selection. The .ICN extension is not required, as the program will add it prior to loading the Icon file. This Icon must exist in the PSMENU directory. Drive .... The drive where the actual program selection resides. Valid drives are A through Z. The colon (ie C:) is required, but do not use a backslash (ie C:\). Path .... The complete path to the program's executable file, less the drive letter. The initial backslash must be present. If the program is located in the Root directory, simply put a "\" on the path line. Example \SIERRA\SQ3. Name .... The actual program's executable file, usually an EXE, COM, or BAT file. This is the name you would normally enter from DOS to execute the program. You should include the EXE or COM extension. BAT extensions must be included if you wish to return to P.S.Menu when the program finishes. NOTE that permanent or "always used" command tail options may be put on the Name line along with the program name. For example, if you use DOS 5's EDIT.COM in VGA 50-line mode, the Name line would look like this: NAME EDIT.COM /h ────────────────────────────────────────────────────────────────── P.S.Edit / Entry System 9 [*] Resident Option If the file will not return regardless of the extension inclusion, you will have to place an asterisk "*" in front of the name, which forces the use of the P.S.Menu resident portion. In this case, you must also be sure to supply the file extension, example "*PROGRAM.EXE". [?] Command-Tail Parameter Option The Command-Tail Parameter Option allows you to pass optional values to the selected program. Certain programs require or optionally allow you to pass parameters to the program, to perform such operations as a file to load into the program, or to change the programs environment such as sound card support or video mode. The Command-Tail Parameter Option allows for up to 32 characters on the command line. The following keystrokes are used when entering the parameters: ESC .... bypass or ignore parameter entry ENTER .... accept entered parameters BACKSPACE .... backspace left over entry to correct errors NOTE The Resident Option and Command-Tail Parameter Option characters may be in any order on the Name line, so long as they are the first 2 characters on the line. Example "*?name.ext" or "?*name.ext" STATUS/OPTIONS/HELP This side contains multiple windows, each one having a particular function: Button .... Displays the location of the current entry with regards to the main Menu display screens. Buttons are numbered from left to right, and top to bottom. The top left is 1, the bottom right is 25. This window is used to help with the placement of programs according to the 5 by 5 layout of the Buttons. Cursor .... Displays the Page (1 through 4), Entry number (1 through 25, identical to the Button number), Line number within the current Entry (1 through 5, with Title being line 1 and Name being line 5), and the current cursor column within the Entry line. ────────────────────────────────────────────────────────────────── 10 Entry System / Status Options Help Audio .... Selects which sound function to use for SFX when a Button is pressed. The "■" shows which option is enabled. Note that P.S.Menu will not allow you to select an option who's hardware is not present in your system. Use [Alt+Hilighted_letter] or click the Left Mouse Button on the desired line to make your selection. None - no sound PC - internal PC speaker AdLib - AdLib music synthesizer card or compatible Roland - Roland MT-32/CM-32L/CM-64/LAPC-1/SC-55 This section also includes the ability to select from multiple sounds, in addition to adjusting the volume of the sound. Timbre is used to select from among the various sounds for each of the sound sources. You can select from the 191 instruments built into the Roland modules. The AdLib currently has 8 different Timbres, and the PC sound changes frequency with the Timbre value. See Appendix B for a list of the PC, AdLib, and Roland sounds and their values. Volume is used to adjust the loudness of the effect, and works for both the Roland and AdLib sounds. The PC volume is not adjustable. NOTE that while other MIDI sound modules, even other brands, will usually work with this feature, no other modules other than the previously listed Roland MT32 and compatibles are guaranteed to function correctly. Help .... Displays the keyboard special keys for performing entry editing functions. Options ... Toggles the Pause option for running every selection. The Pause option causes a selection to pause when it is done prior to returning to P.S.Menu. A [■] means the option is enabled. Use [Alt+Hilighted_letter] or click the Left Mouse Button on the line to select. Adjusts the Screen-Dim or Screen-Saver option. This option, when enabled, causes the screen to dim to ¼ of its normal brightness to prevent monitor burn-in. A value of 0 is Off (no screen dimming), while values from 1-30 are the number of minutes before the screen dims if no key/mouse input occurs. Press any key or mouse button to restore the screen to its normal brightness, after a dim has occurred. CAP .... Indicates if the Caps Lock is currently on. NUM .... Indicates if the Num Lock is currently on. ────────────────────────────────────────────────────────────────── Status Options Help 11 SCR .... Indicates if the Scroll Lock is currently on. INS .... Indicates if the Editor is currently in Insert or Typeover mode. The cursor also changes to reflect the state of this function, a box cursor for Insert, and a line cursor for Typeover. The Audio Timbre/Volume and Screen Dim options are modified by pressing the appropriate [Alt+Hilighted_letter] combination or clicking the Left Mouse Button on the line, then using the [Up] and [Down] arrow keys to increase or decrease the value. Finally press the [ENTER] key to accept the change. If you accidentally press the [Alt+Hilighted_letter] keystroke or click on the line, you may exit without modifying the current value by pressing [ESC] or [ENTER]. PRINTOUT A hardcopy of the complete contents of the Menu Maintenance file, PSMENU.DAT may be output to an Epson or compatible printer, for easier viewing of all entries and options. A printer that supports the IBM Graphics Character set is required. Printing the data file: 1. Set paper to top of form (see your printer manual). 2. Turn on the printer. 3. Select NLQ or Draft quality and Font as desired, if selectable from the printer panel. 4. Press [F10] from the EDIT screen, a dialog box will appear, press [ENTER] or click on the dialog text "<ENTER = OK>" to print, or press [ESC] or click on the dialog text "<ESC = Cancel>" to exit the print function. 5. The data will then print out, formatted the same as the Main Icon screen layout, with 5 columns across the paper. A total of 2 pages is used to print out all 4 Icon Pages. If an error is encountered during printing, such as Paper Out, or any other printer error, a dialog box will appear on screen and the computer will beep. Press any key to continue. If the printout is incomplete, rectify the printer error, and retry the print function. Printer Codes and technical data: A printer initialization is performed just prior to starting the print. The top line is printed in the default printer font (usually Pica 10cpi draft), and the remaining text is printed in Condensed (printer code 15) with 1/8 line spacing (printer code ESC 0 or 27 48). A Form Feed (printer code 12) is used to eject the final page to its end. All printer codes are reset after the print has completed. The printout uses the IBM character 250 "·" for lines between pages. ────────────────────────────────────────────────────────────────── 12 Status Options Help / Printout The page printout is in the following format, which directly corresponds to the screen layout. The "-" line depicts the paper perforation. ┌────────────────────────────────────────┐ │ │ │ Program and Copyright Information │ │ │ │ pg1- 1 pg1- 2 pg1- 3 pg1- 4 pg1- 5 │ │ pg1- 6 pg1- 7 pg1- 8 pg1- 9 pg1-10 │ │ pg1-11 pg1-12 pg1-13 pg1-14 pg1-15 │ │ pg1-16 pg1-17 pg1-18 pg1-19 pg1-20 │ │ pg1-21 pg1-22 pg1-23 pg1-24 pg1-25 │ │ │ │ ······································ │ │ │ │ pg2- 1 pg2- 2 pg2- 3 pg2- 4 pg2- 5 │ │ pg2- 6 pg2- 7 pg2- 8 pg2- 9 pg2-10 │ │ pg2-11 pg2-12 pg2-13 pg2-14 pg2-15 │ │ pg2-16 pg2-17 pg2-18 pg2-19 pg2-20 │ │ pg2-21 pg2-22 pg2-23 pg2-24 pg2-25 │ │ │ │----------------------------------------│ │ │ │ pg3- 1 pg3- 2 pg3- 3 pg3- 4 pg3- 5 │ │ pg3- 6 pg3- 7 pg3- 8 pg3- 9 pg3-10 │ │ pg3-11 pg3-12 pg3-13 pg3-14 pg3-15 │ │ pg3-16 pg3-17 pg3-18 pg3-19 pg3-20 │ │ pg3-21 pg3-22 pg3-23 pg3-24 pg3-25 │ │ │ │ ······································ │ │ │ │ pg4- 1 pg4- 2 pg4- 3 pg4- 4 pg4- 5 │ │ pg4- 6 pg4- 7 pg4- 8 pg4- 9 pg4-10 │ │ pg4-11 pg4-12 pg4-13 pg4-14 pg4-15 │ │ pg4-16 pg4-17 pg4-18 pg4-19 pg4-20 │ │ pg4-21 pg4-22 pg4-23 pg4-24 pg4-25 │ │ │ │ │ │ │ └────────────────────────────────────────┘ ────────────────────────────────────────────────────────────────── Printout 13 SAMPLE ENTRY The following is an example of creating a selection. 1. Take note of the drive, directory, and executable filename for the application you wish to add to P.S.Menu. 2. Run P.S.Menu, press [F1] to enter the Edit section. 3. Move to the desired Page and Entry number using the [PgUp] [PgDn] and [^v<>] arrow keys. 4. Put the cursor on the Title line, and enter a description of the program, usually its name, example SPACE QUEST III 5. Press [ENTER] or [v<] to move to the Icon line, and enter the name of the corresponding Icon, the .ICN is not required, example SQ3 6. Press [ENTER] or [v<] to move to the Drive line, and enter the letter of the drive containing the program, the : is required, but don't use a \, example D: 7. Press [ENTER] or [v<] to move to the Path line, and enter the COMPLETE path to the program's executable file, the initial \ is required, example \SIERRA 8. Press [ENTER] or [v<] to move to the Name line, and enter the actual filename that is used to run the program, please include the extension, especially if it is a .BAT file. It is recommended that you always include the extension. In some cases you may have to add an asterisk "*" to the front of the name, be sure to include the file name extension if you use the * function. Example SQ3.BAT The final on-screen lines would then appear like: Title Space Quest III Icon SQ3 Drive D: Path \SIERRA Name SQ3.BAT 9. Press [ESC] to exit the Edit section, or click the Left Mouse button on "EXIT" at the top left of the screen. A dialog box will appear with ! Quit Editing P.S. Menu Data? [Y/N] Press Y for yes or N for no, or use the mouse to click on the appropriate letter. ────────────────────────────────────────────────────────────────── 14 Sample Entry 10.IF you selected Y for yes, a second dialog box will appear ! Save the P.S. Menu Data File? [Y/N] Press Y for yes to save any changes you have made, or N for no to discard all changes made. You may also use the mouse by clicking on the appropriate letter. Keyboard Command Quick Reference: ESC .... exit to P.S.Menu section. ^v<> .... (arrow keys) move the cursor around the Entries. ENTER .... accept input data. HOME .... move the cursor to the left column in the current Entry. END .... move the cursor to the right column in the current Entry. TAB .... move the cursor to the start of the next word in the current Entry. INS .... toggle the Insert/Typeover mode. DEL .... delete the character under the cursor, move remaining line left. BSpc .... delete the character to the left of the cursor, move remaining line left. PgUp .... go to the previous Page. PgDn .... go to the next Page. F5 .... Insert a new blank Entry at the current cursor. Moves all Entries after the cursor up one place, the last Entry, #25, on that page, is deleted. F6 .... Cut the current Entry. This moves the Entry data into the clipboard, and moves all Entries (on that page only) after the cursor down one place. a blank Entry is inserted into #25. F7 .... Copy the current Entry to the clipboard. F8 .... Paste the data in the Clipboard to the current Entry. F10 .... Print the data file contents to an Epson compatible printer. Alt+U .... toggle Selection Execute with PAUSE option on and off. Alt+S .... change the Screen Dim value. Alt+N .... select None sound. Alt+P .... select PC speaker sound. Alt+A .... select AdLib sound. Alt+R .... select Roland sound. Alt+T .... change the Sound Timbre (sound type). Alt+V .... change the AdLib or Roland volume level. ────────────────────────────────────────────────────────────────── Sample Entry / Quick Reference 15 Mouse Command Quick Reference: Left button on EXIT .... exit to P.S.Menu section. Left button on None .... select None Sound. Left button on PC .... select PC Sound. Left button on AdLib .... select AdLib Sound. Left button on Roland .... select Roland Sound. Left button on Timbr .... adjust Sound Timbre. Left button on Volum .... adjust Sound Volume (AdLib and Roland). Left button on Pause .... toggle Return Pause. Left button on Dim .... select Dim feature and delay time. Command-Tail Parameter Option Entry Quick Reference: ESC .... bypass or ignore parameter entry. ENTER .... accept entered parameters. BACKSPACE .... backspace left over entry to correct errors. ────────────────────────────────────────────────────────────────── 16 Quick Reference P.S.DRAW Draw is a full-featured miniature Paint program used to create or modify Icons. While many Icons are included with this program, you may wish to create customized Icons for your particular applications. NOTE that P.S.Menu Icon files (*.ICN) are NOT compatible with the Icons from Microsoft Windows. Undetermined results may occur if an attempt is made to use a Windows Icon. The P.S.Draw screen contains the following items: CURSOR The Cross-Hair Cursor is used to select from the various Draw selection areas, in addition to drawing lines and other objects in the Zoom Window drawing area. EXIT BUTTON Click the Left Mouse button on the Exit button, or press [ESC], to quit the Draw program and return to the Main Menu section. You will be asked if you want to quit, to give you a chance to save any drawings before you exit. Click on the Y or N, or press the corresponding [Y] or [N] key. TOOLBOX The current selected tool is surrounded by a red hi-light square, and is the Freehand Draw Tool when you first enter the Draw section. Clicking the Left Mouse button on another tool, makes it the current selection. Selecting the UNDO or CLEAR Tools performs that particular function, but does not change the current Tool selection hi-light square. All Tools that allow or require mouse dragging, to perform such operations as defining a second coordinate, constrain the mouse cursor to the Zoom Window while the dragging is in effect. This alleviates any problems of accidentally dragging the cursor off of the Zoom Window. ────────────────────────────────────────────────────────────────── P.S.Draw / Cursor / Exit Button / Toolbox 17 Freehand Draw [d] Allows free-hand drawing on the Zoomed window in the current color. 1. Select the Freehand Tool from the Toolbox, using the Left Mouse Button or by pressing [d] on the keyboard. 2. Select the color you want from the Palette Box. 3. Position the Cursor on the Zoom Window. 4. Press the Left Mouse button and Drag the Cursor to draw continuous or broken free-hand lines. The speed at which you move the mouse, determines whether the line will be solid or broken (dashed). 5. Release the Button to stop drawing. Line [l] Allows you to draw straight Lines at any angle in the current color. 1. Select the Line Tool from the Toolbox, using the Left Mouse Button or by pressing [l] on the keyboard. 2. Select the color you want the Line to be from the Palette Box. 3. Position the Cursor on the Zoom Window. 4. Press the Left Mouse Button to anchor one end of the Line. 5. While holding down the Mouse Button, Drag the rubber-banding line around the Zoom Window. 6. When you are satisfied with the Line position and length, release the Button to make the Line permanent. 7. If you find you are displeased with the Line, after it has been placed on the Icon, select Undo to remove it. Eraser [e] Erases the pixel under the cursor, to the grey background color. 1. Select the Eraser Tool from the Toolbox, using the Left Mouse Button or by pressing [e] on the keyboard. 2. Position the Cursor on the Zoom Window, press the Left Mouse Button and Drag the Cursor over the areas you want to erase. All areas that are touched by the cursor will change to the Grey background color. 3. Release the Button to stop erasing. ────────────────────────────────────────────────────────────────── 18 Freehand / Line / Eraser Color Eraser [E] Erases the pixel under the cursor, only if it is the same color as the currently selected palette color, to the grey background color. 1. Select the Color Eraser Tool from the Toolbox, using the Left Mouse Button or by pressing [E] on the keyboard. 2. Select the color you want to erase from the Palette Box. 3. Position the Cursor on the Zoom Window, press the Left Mouse Button and Drag the Cursor over the areas you want to erase. The Color Eraser changes any occurrances of the selected Palette Box color to the background Grey color, without changing any other surrounding colors. 4. Release the Button to stop erasing. Hollow Box [b] The Box Tool lets you draw Hollow Boxes in the selected color. 1. Select the Hollow Box Tool from the Toolbox, using the Left Mouse Button or by pressing [b] on the keyboard. 2. Select the color you want the Box to be from the Palette Box. 3. Position the Cursor on the Zoom Window. 4. Press the Left Mouse Button to anchor one corner of the Box. 5. While holding down the Mouse Button, Drag the rubber-banding box around the Zoom Window. 6. When you are satisfied with the Box position and size, release the Button to make the Box permanent. 7. If you find you are displeased with the Box, after it has been placed on the Icon, select Undo to remove it. ────────────────────────────────────────────────────────────────── Color Eraser / Hollow Box 19 Filled Box [B] The Box Tool lets you draw Filled Boxes in the selected color. 1. Select the Filled Box Tool from the Toolbox, using the Left Mouse Button or by pressing [B] on the keyboard. 2. Select the color you want the Box to be from the Palette Box. 3. Position the Cursor on the Zoom Window. 4. Press the Left Mouse Button to anchor one corner of the Box. 5. While holding down the Mouse Button, Drag the rubber-banding box around the Zoom Window. 6. When you are satisfied with the Box position and size, release the Button to make the Box permanent. 7. If you find you are displeased with the Box, after it has been placed on the Icon, select Undo to remove it. Hollow Circle [c] The Circle Tool lets you draw Hollow Circles in the selected color. 1. Select the Hollow Circle Tool from the Toolbox, using the Left Mouse Button or by pressing [c] on the keyboard. 2. Select the color you want the Circle to be from the Palette Box. 3. Position the Cursor on the Zoom Window. 4. Press the Left Mouse Button to anchor the center of the Circle. 5. While holding down the Mouse Button, Drag the rubber-banding circle around the Zoom Window. 6. When you are satisfied with the Circle position and size, release the Button to make the Circle permanent. 7. If you find you are displeased with the Circle, after it has been placed on the Icon, select Undo to remove it. ────────────────────────────────────────────────────────────────── 20 Filled Box / Hollow Circle Filled Circle [C] The Circle Tool lets you draw Filled Circles in the selected color. 1. Select the Filled Circle Tool from the Toolbox, using the Left Mouse Button or by pressing [C] on the keyboard. 2. Select the color you want the Circle to be from the Palette Box. 3. Position the Cursor on the Zoom Window. 4. Press the Left Mouse Button to anchor the center of the Circle. 5. While holding down the Mouse Button, Drag the rubber-banding circle around the Zoom Window. 6. When you are satisfied with the Circle position and size, release the Button to make the Circle permanent. 7. If you find you are displeased with the Circle, after it has been placed on the Icon, select Undo to remove it. Fill Region [f] The Fill Tool allows you to fill in any enclosed shape or area with the current selected Palette Box color. You can fill a hollow area which is enclosed by a solid border, or fill a solid object with a different color. 1. Select the Fill Region Tool from the Toolbox, using the Left Mouse Button or by pressing the [f] on the keyboard. 2. Select the color you want to fill with from the Palette Box. 3. Position the Cursor on the Zoom Window, and click the Left Mouse Button inside of the area you want to fill. The area will fill with the selected Palette Box color. 4. If you find you are displeased with the Fill, after it has been placed on the Icon, select Undo to remove it. ────────────────────────────────────────────────────────────────── Filled Circle / Fill Region 21 Airbrush / Spray [a] The Airbrush Tool (also called Spray) produces a circular spray of colored dots. 1. Select the Airbrush Tool from the Toolbox, using the Left Mouse Button or by pressing the [a] on the keyboard. 2. Select the Airbrush color you want to use from the Palette box. 3. Move the cursor into the Zoom Window. 4. Press the Left Mouse Button to start the spray, and drag the cursor. The speed of the drag determines the density of the spray. 5. Release the Button to stop spraying. Copy / Scissors [y] You can copy a square section of your drawing to the Clipboard, by defining the area to copy with the Copy/Scissors Tool. 1. Select the Copy Tool from the Toolbox, using the Left Mouse Button or by pressing [y] on the keyboard. 2. Move the Cursor into the Zoom Window. 3. Press the Left Mouse Button to anchor a starting point. 4. While holding down the Mouse Button, Drag the rubber-banding box around the object(s) you want to copy. 5. When you have completely surrounded the area, release the Mouse Button. The area within the box (including the pixels under the box border lines) is copied to the Clipboard. The Copy Clipboard is large enough to copy the entire contents of the drawing area. The Clipboard always holds the most recent Copy contents. Performing a Copy replaces the previous contents of the Clipboard with the new copied section. ────────────────────────────────────────────────────────────────── 22 Airbrush / Copy Paste Hand [p] Copies the current Clipboard contents to the Zoom Window, for subsequent Pasting. 1. Select the Paste Tool from the Toolbox, using the Left Mouse Button or by pressing [p] on the keyboard. 2. Select a color from the Palette Box as the *Keying Color. 3. Position the Cursor on the Zoom Window. 4. Press the Left Mouse Button, and the contents on the Clipboard will appear on screen. Certain areas of the Image may be transparent depending on the presence or absence of the Keying Color in the Image. 5. Drag the Image around the Zoom window until you are satisfied with its location, and release the Button. * The current Palette Box color is a "Keying" or "Transparent" color in the pasted image. Any area of the original Copied Image that is the selected Palette Box color, will be transparent when pasted onto the Zoom Window. Undo [u] Undoes the last action performed to the drawing. Selecting a Tool or Palette color copies the current graphic on the Icon display to the undo buffer. 1. Select Undo from the Toolbox, using the Left Mouse Button or by pressing [u] on the keyboard. Selecting Undo a second time, "Undoes" the first Undo, effectively restoring the screen to the state it was in prior to the first Undo. Clear [r] Clears the current Icon and Zoom drawing areas. Selecting Undo will undo the Clear function. Clicking twice on Clear clears the Undo buffer. 1. Select Clear from the Toolbox, using the Left Mouse Button or by pressing [r] on the keyboard. Selecting Clear twice in a row clears the Undo buffer, removing any chance of recovering the Clear by using Undo. ────────────────────────────────────────────────────────────────── Paste / Undo / Clear 23 Get-Color / Eyedropper [g] Changes the current Palette Box color to one selected from the Zoom Window. 1. Select the Get-Color Tool from the Toolbox, using the Left Mouse Button or by pressing [g] on the keyboard. 2. Position the Cursor over the desired color pixel in the Zoom Window. 3. Click the Left Mouse Button to change the Palette Box selection to that color. This is useful where you have many shades or luminance values close together on screen, and you wish to choose one of them as the current drawing color. Get-Color can also be used to select a Keying color from the screen while using the Paste Tool. Use the Get-Color Eyedropper to retrieve the grey background color if you want to erase large areas with the Filled Circle or Square. Text [t] You add text to your Icon with the Text Tool. The text appears in the current selected Palette box color, in a variety of selectable sizes. 1. Select the desired Font Size, by pressing [F1] 4x5, [F2] 5x6, [F3] 6x6, or [F4] 6x8, or by clicking the Right Mouse Button on the Text Tool, and then selecting the desired Font size with the Left Mouse Button. 2. Select the Text Tool from the Toolbox, using the Left Mouse Button or by pressing [t] on the keyboard. 3. Select the Text color you want to use from the Palette box. This becomes the Foreground color. The colors around the text characters are not changed by the Text Tool. 4. Move the cursor to where you want the text positioned in the Zoom Window, and press the Left Mouse Button. The Cross-Hair Mouse Cursor will disappear, and an "Underscore Cursor" will appear to show you where the text will be placed. The cursor is only for initial alignment, and is removed once you start entering text. The bottom left corner or "Base" of the text is positioned at the center of the Cross-Hair Cursor. The text base is positioned at the text's decender line, where the underscore "_" character drops to. ────────────────────────────────────────────────────────────────── 24 Get Color / Text 5. Use the following keyboard keys to control text placement: ∙ ESC quits the Text Tool function, and restores the original Zoom Window. ∙ ENTER keeps your Text. ∙ BACKSPACE removes characters one at a time from right to left, to allow fixing of typing errors. * The Text Tool accepts the following 63 characters plus Space, all lower case letters are converted to upper case due to the small size of all Fonts. !"#$%&'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_ * The following Font Sizes are available: [F1] or Right Mouse Button on Text Tool+select Font = 4x5 Font [F2] or Right Mouse Button on Text Tool+select Font = 5x6 Font [F3] or Right Mouse Button on Text Tool+select Font = 6x6 Font [F4] or Right Mouse Button on Text Tool+select Font = 6x8 Font * No Font clipping is performed on any of the sizes, all Fonts must lie inside of the Zoom Window. If an attempt is made to place a Font where part of the character would overlap the edge of the Zoom Window, the Font is automatically adjusted back inside of the Window. * Pressing the Right Mouse Button on the Text Tool displays the Font selection dialog box. Click the Left Mouse button on the Font Size you wish to use (the default size is 6x6). If you accidentally bring the Font Size dialog box up, you can exit the dialog by pressing [ESC] or clicking the Left Mouse Button OUTSIDE of the Font Size dialog box. PALETTE BOX The Palette box contains all 256 of the available colors for creating or modifying your Icon. A red hi-light square shows which palette color is the current drawing color. Click the Left Mouse button on a new color box to select that color as the current drawing color. You may also use the Get-Color/Eyedropper Tool to select Palette colors directly from the Zoom window. See the Get-Color Tool description in the ToolBox section. ────────────────────────────────────────────────────────────────── Text / Palette Box 25 FILE BOX The File box is used to Load and Save Icons, and Import/Export PCX format Icon Files. All ICN and PCX Icon files must be located in the PSMENU directory for Draw to Load/Import them. Load [L] ∙ Click the Left Mouse Button on the Load Button, it will move in and back out. ∙ The current Directory of Icons (those located in the PSMENU directory only) will appear in the File List window. The directory is sorted alphabetically. ∙ If there are more than 6 entries, the Down Arrow Button will appear, if not, both Arrow Buttons will be blank. ∙ Click on the Arrow Button(s) (if applicable) to move to the desired Icon selection in the File List Window. ∙ Click on the desired Icon selection to load it into P.S.Draw. Load remembers the last location of the Arrow Buttons, and any subsequent Loads will always show the Directory listing relative to that position. This is useful for rapid viewing of all of the available Icons, as you do not have to scroll down using the Arrow Buttons, to the last Icon you previously loaded. A Blank Arrow Button means that you are unable to scroll the File List in that direction any more, in other words, you have reached the first or last entry of the directory. You may click outside of the File Box or press [ESC] at any time to exit the Load function, and return to the drawing. Load Function Keyboard Reference: ESC ............ exit the Load function, return to drawing. Save [S] ∙ Click the Left Mouse Button on the Save Button, it will move in and back out. ∙ The current Icon name (if the Icon was previously Loaded) will appear in the File List window, if this is a new Icon, the File List will be blank except for the red cursor. ∙ Enter the name for the Icon, or if this is a previously Loaded Icon you may rename it prior to saving, or keep the existing name. ∙ You may at any time press [ESC] to exit the Save function and return to the drawing. ∙ Use the [Left] and [Right] keyboard cursor arrows to move the red cursor and edit the Icon name if desired. Use [SPACE] to remove any unwanted trailing characters in the name. ∙ Press [ENTER] to save the Icon using the name shown in the File List Box. ────────────────────────────────────────────────────────────────── 26 File Box / Load / Save If the name in the File List Box is already in use, you will be asked if you want to overwrite the old Icon. Press [Y] for yes or [N] for no. Save Function Keyboard Reference: ESC ............ exit the Save function, return to drawing. ENTER .......... save the Icon using the name in the File List. LEFT ARROW ..... move the red edit cursor to the left. RIGHT ARROW .... move the red edit cursor to the right. SPACE .......... remove trailing characters. Import [I] ∙ The Import function works identical to the Load function above, with the exception that it is accessed by clicking the Right Mouse Button on the File Load Button or by pressing [I]. It loads in PCX 320x200 256 color files that contain a single 64x40 Icon graphic. See the section on PCX Import/Export below. Export [X] ∙ The Export function works identical to the Save function above, with the exception that it is accessed by clicking the Right Mouse Button on the Save Button or by pressing [X]. It saves to a PCX 320x200 256 color file that contains a single 64x40 Icon graphic. See the section on PCX Import/Export below. DRAWING AREA Zoom Window or Zoomed Icon Display This is where you perform all of your drawing functions. This window is a 200% zoomed copy of the Icon display window, and therefore all pixels on the Zoom Window will be the size of a 4-pixel square in relationship to 1 pixel on the actual size Icon. The zoomed feature allows easier pixel and object painting. Please note that all Tools reference their points to coordinates within the Zoom Window, therefore, all Tools that allow or require mouse dragging will constrain the mouse cursor to within the boundaries of the Zoom Window while the drag is in effect. Coordinates Indicator These two values display the current mouse cursor coordinates within the Zoom Window display, and are translated to correspond to the actual size of the final Icon. Icons are 64 pixels wide and 40 pixels high, but the drawing area is restricted to 60 by 36. ────────────────────────────────────────────────────────────────── Import / Export / Drawing Area 27 The coordinates are supplied to make creating adjacent or symmetrical objects easier. Icon Display This window shows the actual size Icon, and is used to obtain an accurate idea of the look of the final Icon graphic. Keyboard Command Quick Reference: ESC .... exit Draw to the P.S.Menu Main section. d .... select Freehand Draw Tool. l .... select Line Tool. e .... select Eraser Tool. E .... select Color Eraser Tool. b .... select Hollow Box Tool. B .... select Filled Box Tool. c .... select Hollow Circle Tool. C .... select Filled Circle Tool. f .... select Region Fill Tool. a .... select Airbrush / Spray Tool. y .... select Copy / Scissor Tool. p .... select Paste Hand Tool. u .... select Undo Tool. r .... select Clear Tool. g .... select Get-Color / Eyedropper Tool. t .... select Text Tool. L .... Load an Icon from disk. S .... Save current Icon to disk. I .... Import PCX Icon. X .... Export PCX Icon. F1 .... Select 4x5 Font. F2 .... Select 5x6 Font. F3 .... Select 6x6 Font. F4 .... Select 6x8 Font. Mouse Command Quick Reference: Left Button .... select Toolbox Tool, Palette Box Color, File Box Function, draw on Zoom Window, or Exit. Right Button ... select Import PCX (File Load), Export PCX (File Save), or Font Size (Text Tool) dialog boxes. Text Tool Quick Reference: ESC .... Exit Text function, restore original Icon. ENTER .... Keep Text, paste onto Icon. BSpc .... Backspace left across text to correct an error. Use 63 Alphanumeric and punctuation keys plus Space for text, all lower case letters are converted to upper case: !"#$%&'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_ ────────────────────────────────────────────────────────────────── 28 Quick Reference Font Size Dialog Quick Reference: ESC .... Exit Font Size dialog. Left Mouse Button .... select Font Size, or exit if outside dialog box. Load/Import Function Quick Reference: ESC .... Exit Load function, return to drawing. Save/Export Function Quick Reference: ESC .... Exit Save function, return to drawing. ENTER .... Save Icon, using name shown in File List Box. <> .... Move red cursor to edit Icon Name in File List Box. SPACE .... Remove trailing characters. PCX Import/Export This feature is supplied for those who would like to use the mega-power of the new paint and desktop video editing programs to create your Icons. You may also use a screen capture program, there may be one supplied with your paint program, to capture a program's title screen for use as an Icon. Simply grab the picture, copy a small square out of the image (or possibly resize a section) for use on the Icon button face. The use of the ICON.PCX file is a must, as it contains the Menu program's palette. Modifying the default, or the use of a different palette will cause undesired coloring of the Icon when loaded into the Menu. A PCX version of the Icon is supplied since PCX is the most popular 320x200 256 color format for paint programs. A program that allows Palette re-mapping is required if you have captured the icon graphics from a game, etc. P.S.Menu directly Imports PCX format 320x200 256 color graphic files, by scanning the 320x200 picture file for the FIRST pixel that is non-black (Palette value 0), so NEVER paint outside of the Icon square. It then copies a 64x40 pixel square with that pixel as the top left corner. It is not required that the Icon be in the exact center on the 320x200 screen, so you may move the Icon where ever is convenient for editing. You may also duplicate the Icon many times on the same page for ease of editing, or to view more than one version of an Icon before selecting your final choice, BUT BE SURE to erase all but the final ONE before Importing. You must also erase the Icons using the first palette color (palette number 0, which is Black, with RGB values of 000). To create the most pleasing Icon effect, be sure to leave a single pixel line of the face color untouched, and NEVER change the 3D sculpting colors on the four outsides. Use the supplied Icons as examples when creating your own. ────────────────────────────────────────────────────────────────── Quick Reference / PCX Import Export 29 P.S.Menu will Export the current Icon in the Draw program to a PCX 320x200 256 color file, with the Icon located in the center of the screen. This is provided to allow you to modify any existing .ICN format Icon with a PCX Paint program, and then re-Import it back into P.S.Draw. CAUTION! ∙ NEVER modify the palette of the ICON.PCX file, or the resulting Icons will NOT work correctly with P.S.Menu. ∙ NEVER paint outside of the Icon square. Leave a single pixel line of the button face color intact. ∙ NEVER attempt to convert a PCX file with more that 1 Icon square on it. If an attempt is made, Paint will convert the Icon closest to the top left of the screen, leaving the other Icons alone. ∙ This program uses palette color 0 (Black or R0 G0 B0) as transparent. ∙ This program will not read any other formats such as GIF or TIF. DRAW Tips and Techniques ∙ Luminance Ramps One of the advantages of creating graphics in 256 colors, is the ability to utilize multiple luminance values of a particular color. Draw's Palette consists of 15 sets of luminance ramps plus 1 set of standard EGA/VGA colors. Each ramp is composed of 16 luminance values ranging from dark to light, in 15 varying colors across the spectrum. To get a glimpse of what luminance can do, perform the following short tutorial. 1. Click on CLR to clear the Icon and Zoom Windows. 2. Select the Line Tool, and the leftmost luminance in the grey ramp (almost black), the grey ramp is the top right set of 16 color squares in the Palette. 3. Draw a vertical line about an inch long near the center left side of the Zoom Window. 4. Select the next color square to the right of the current color. 5. Draw another vertical line just to the right of the first one. 6. Continue doing steps 4 and 5 until you have used all 16 luminance values in the ramp. You should have ended on the white color at the extreme right. For added effect you can also repeat the same steps but use the luminance ramp in reverse order (white to black), to create a column or tube on screen. ────────────────────────────────────────────────────────────────── 30 PCX Import Export / Draw Tips ∙ Dithering Dithering or "Anti-Aliasing" is a technique used to smooth the jagged edges of a graphic image. These "jaggies" are most often seen as the stair-step of diagonal lines and roughness of circles. Dithering is accomplished by placing intermediate colors where two distictly different or varying colors touch. The result is a more pleasing, albeit fuzzier or unfocused, display. To learn how to perform manual, or freehand dithering, follow this simple tutorial. 1. Click on CLR to clear the Icon and Zoom Windows. 2. Select the Filled Circle Tool, and the middle Yellow Palette color from the 16-shade ramp of yellows. 3. Click the Left Mouse Button in the center of the Zoom Window, and drag the mouse to create a circle of approximately 1 inch in diameter. Notice how the edges of the circle are coarse. 4. Select the yellow color TWO squares to the LEFT of the yellow used to create the filled circle. 5. Select the Freehand Draw Tool. 6. Place a single pixel around the outside of the circle, changing the grey color to dark yellow. Do not change any of the filled circle yellow pixels. Notice how the resulting circle in the Icon Window has a much more pleasing "roundness". ∙ True Circles The Circle Tool produces a circle that is actually round when considering the number of pixels in each of the symmetrical quadrants. Due to the 4:3 aspect ratio of the 320x200 VGA graphic screen, the resulting circle appears like an oval squeezed at the sides. The simplest method for creating false "true circles", is to change an existing circle's aspect ratio. Follow this simple tutorial. 1. Click on CLR to clear the Icon and Zoom Windows. 2. Select the Filled Circle Tool, and the dark blue Palette color from the top left ramp of 16 solid colors. 3. Click the Left Mouse Button in the center of the Zoom Window, and drag the mouse to create a circle of approximately 1 inch in diameter. Notice how the circle is taller than it is wide. 4. Select the Scissors Tool, and copy the top half of the circle. 5. Select any color from the Palette except the blue and grey background colors. 6. Select the Paste Tool and paste the top half of the circle down two pixels lower than where you originally copies it. Notice how the circle is now more "round". This same technique can be used to create circles that are more oval in shape than the current Circle Tool, or even ones that are oval in the opposite direction. ────────────────────────────────────────────────────────────────── Draw Tips 31 ∙ Text Effects Shadowed or 3D text can be created by using the 256 color VGA palette. To create shadowed text follow this simple tutorial. 1. Click on CLR to clear the Icon and Zoom Windows. 2. Select the Eyedropper tool, and click on the empty Zoom Window, this will show you which Palette color is the blank background. Select the darker grey color 2 boxes to the left of the background color. 3. Select the Text Tool, press [F3] for the 6x6 Font, and click in the center of the Zoom Window, at the coordinates of 10 X and 16 Y. Type "HELLO" and then press [ENTER]. 4. Select a nice bright blue color from the pure blue ramp (about the middle color). 5. Move the cursor back to the Zoom Window, and click at the coordinate of 9 X and 15 Y (notice that these coordinates are 1 pixel up and left of the last ones). Type "HELLO" and then press [ENTER]. Notice that the word HELLO has a nice shadow. Mixing of two Font may be used to create such effects as large initial capitals, followed by small caps. 1. Click on CLR to clear the Icon and Zoom Windows. 2. Select the blue color at the top left of the Palette (next to the black). 3. Select the 5x6 Font by pressing [F2]. 4. Click on the Text Tool, then on the Zoom Window at coordinates 10 X and 16 Y. Type "H" and then press [ENTER]. 5. Select the 4x5 Font by pressing [F1]. 6. Click on the Zoom Window at coordinates 16 X and 16 Y. Type "ELLO" and then press [ENTER]. The word HELLO has a larger initial letter. Using increasing or decreasing color luminance values on a text character provides a pleasing text appearance. Try this: 1. Click on CLR to clear the Icon and Zoom Windows. 2. Select a white color near the right side of the 16-color grey ramp (top right 16 colors). 3. Select the 6x6 Font by pressing [F3]. 4. Click on the Text Tool, then on the center of the Zoom Window. Type "A" and then press [ENTER]. 5. Select the Freehand Draw Tool. 6. Select the next color in the Palette box to the LEFT of the previous color used. 7. Fill in the pixels in the letter A, in a single pixel thick horizontal line, starting at the second line from the top. 8. Select the next color to the left of the previous. 9. Continue filling each line across in the letter with darker colors. The final letter should start at white at the top, and end in grey at the bottom. ────────────────────────────────────────────────────────────────── 32 Draw Tips ∙ Using the Clipboard with Copy and Paste The Keying or Transparency function of the Paste Tool can be used to place objects on top of each other. 1. Click on CLR to clear the Icon and Zoom Windows. 2. Select a blue color in the middle of the blue ramp. 3. Select 6x6 Font, move over to the icon and Click. Type "HELLO" and press [ENTER] 4. Select the Copy Tool, draw a square around the word Hello, to copy it to the Clipboard (close to the edges of the letters). 5. Click on CLR to clear the Windows. 6. Select a red color in the middle of the red ramp. 7. Select the Filled Square Tool, and draw a large red square in the center of the icon, about 1 inch across. 8. Select the Paste/Hand Tool, and paste the text on top of the square. 9. Click on a different color in the Palette Box. Try the Paste again (notice how the text now has the grey background to the size of the copy square that you copied originally). Notice how the "Background" color of the text was transparent. Which ever color is selected in the Palette Box when a Paste is performed becomes the transparency color. If you change the Palette Box color to something other than red, the blue text and grey background show up (are NOT transparent). If you select the blue color used for the text, you will get a square with transparent letters on it. If you select the grey background color, you will get just the text. Any other color and you will see both the blue text and the grey background. ────────────────────────────────────────────────────────────────── Draw Tips 33 APPENDIX A: Error Messages PSMENU.EXE, standard mode ∙ Sorry, you require DOS Version 3.3 or greater. An attempt was made to use PSMENU on a system running a version of DOS prior to 3.3. Upgrade the DOS version. ∙ Sorry, you need at least 448k of RAM. An attempt was made to use PSMENU on a system with less than 448k of installed RAM. Install more system RAM. ∙ Sorry, you require a VGA display adapter. An attempt was made to use PSMENU on a system without a VGA adapter card installed. Change your video adapter. ∙ Sorry, you require a Mouse, no Mouse Driver Found. An attempt was made to use PSMENU on a system that does not have a mouse installed. Install a mouse. ∙ Sorry, you require a Mouse, Mouse not Found. An attempt was made to use PSMENU on a system that does not have a mouse installed. Install a mouse. ∙ Not enough Free RAM, Memory Allocation Error! PSMENU had problems running on your system, because there are too many other programs, such as TSRs using too much of the RAM. You will have to free up some RAM by removing some drivers before trying to use PSMenu again. NOTE Disk-Caching programs, Virtual Ramdisk programs, Printer spoolers, in addition to other hardware and software drivers take up some of your system RAM. If you are encountering this error, you may have to temporarily disable or remove one of these functions. See the particular program's owner's manual or your DOS manual for more information on this procedure. ∙ Memory De-Allocation Error! PSMENU reported an error while returning to DOS. You may have to reboot your computer. ∙ There has been a Disk Write Error. PSMENU reported an error while attempting to read or write to the hard drive. Verify that your drive system is functioning correctly. ────────────────────────────────────────────────────────────────── 34 Appendix A Error Messages ∙ A Critical Disk Error Has Occurred! Program Terminated! PSMENU reported an error while attempting to read or write to the hard drive. Verify that your drive system is functioning correctly. ∙ Invalid PCX. The file you attempted to convert was NOT a 320x200 256 color PCX picture, or was a PCX version Paint does not recognize. PSMENU.EXE, resident mode ∙ Couldn't Find Specified File! Press a key. There was an error on the Drive/Path/Name line(s). The Drive/ Path/Name was misspelled or didn't exist. Correct the error with the Edit program. ∙ Couldn't Shell! Press a key. The resident portion of P.S.Menu encountered a problem running the specified file. Make sure you don't have any large TSRs running, or are attempting to run P.S.Menu from another hard drive shell. Check that the specified file and path are actually capable of being executed, in other words, does it run correctly when you manually run the program directly from DOS. ────────────────────────────────────────────────────────────────── Appendix A Error Messages 35 APPENDIX B: Sound PC speaker The PC sound currently supports only a single tone output, with the Timbre value specifying the actual output frequency. The frequency is adjustable from 36Hz (Timbre = 0) to 9297Hz (Timbre = 255). The PC sound volume is not adjustable. AdLib The AdLib card currently supports 8 Timbres: ┌───────────────┐ │ 0│ Bell │ │ 1│ Laser Warp │ │ 2│ Gong │ │ 3│ Ping │ │ 4│ Piano │ │ 5│ Drum │ │ 6│ JewsHarp │ │ 7│ Marimba │ └───────────────┘ The Timbre numbers repeat every 8 values, ie Timbre 0 and 8 are Bell, Timbre 1 and 9 are Laser Warp, etc. The AdLib volume is scaled from the 0-127 value in the options box to the actual AdLib capability of 0-63. Roland The Roland sound uses the 128 instruments, the 30 Percussion, and 33 PCM Sound Effects. The following tables represent the available CM-32L/LAPC-1 instrument sounds (MT-32 users disregard the 33 PCM Sound Effects, as they are unavailable on this model): ────────────────────────────────────────────────────────────────── 36 Appendix B Sound Instruments Timbre Timbre ┌────────────────┐ ┌───────────────┐ │ 0│ AcouPiano 1 │ │32│ Fantasy │ │ 1│ AcouPiano 2 │ │33│ Harmo Pan │ │ 2│ AcouPiano 3 │ │34│ Chorale │ │ 3│ ElecPiano 1 │ │35│ Glasses │ │ 4│ ElecPiano 2 │ │36│ Soundtrack │ │ 5│ ElecPiano 3 │ │37│ Atmosphere │ │ 6│ ElecPiano 4 │ │38│ Warm Bell │ │ 7│ Honkytonk │ │39│ Funny Vox │ │ 8│ Elec Org 1 │ │40│ Echo Bell │ │ 9│ Elec Org 2 │ │41│ Ice Rain │ │10│ Elec Org 3 │ │42│ Oboe 2001 │ │11│ Elec Org 4 │ │43│ Echo Pan │ │12│ Pipe Org 1 │ │44│ DoctorSolo │ │13│ Pipe Org 2 │ │45│ Schooldaze │ │14│ Pipe Org 3 │ │46│ Bellsinger │ │15│ Accordion │ │47│ SquareWave │ │16│ Harpsi 1 │ │48│ Str Sect 1 │ │17│ Harpsi 2 │ │49│ Str Sect 2 │ │18│ Harpsi 3 │ │50│ Str Sect 3 │ │19│ Clavi 1 │ │51│ Pizzicato │ │20│ Clavi 2 │ │52│ Violin 1 │ │21│ Clavi 3 │ │53│ Violin 2 │ │22│ Celesta 1 │ │54│ Cello 1 │ │23│ Celesta 2 │ │55│ Cello 2 │ │24│ SynBrass 1 │ │56│ ContraBass │ │25│ SynBrass 2 │ │57│ Harp 1 │ │26│ SynBrass 3 │ │58│ Harp 2 │ │27│ SynBrass 4 │ │59│ Guitar 1 │ │28│ Syn Bass 1 │ │60│ Guitar 2 │ │29│ Syn Bass 2 │ │61│ Elec Gtr 1 │ │30│ Syn Bass 3 │ │62│ Elec Gtr 2 │ │31│ Syn Bass 4 │ │63│ Sitar │ └────────────────┘ └───────────────┘ ────────────────────────────────────────────────────────────────── Appendix B Sound 37 Timbre Timbre ┌───────────────┐ ┌────────────────┐ │64│ AcouBass 1 │ │ 96│ Brs Sect 2 │ │65│ AcouBass 2 │ │ 97│ Vibe 1 │ │66│ ElecBass 1 │ │ 98│ Vibe 2 │ │67│ ElecBass 2 │ │ 99│ Syn Mallet │ │68│ SlapBass 1 │ │100│ Windbell │ │69│ SlapBass 2 │ │101│ Glock │ │70│ Fretless 1 │ │102│ Tube Bell │ │71│ Fretless 2 │ │103│ Xylophone │ │72│ Flute 1 │ │104│ Marimba │ │73│ Flute 2 │ │105│ Koto │ │74│ Piccolo 1 │ │106│ Sho │ │75│ Piccolo 2 │ │107│ Shakuhachi │ │76│ Recorder │ │108│ Whistle 1 │ │77│ Pan Pipes │ │109│ Whistle 2 │ │78│ Sax 1 │ │110│ Bottleblow │ │79│ Sax 2 │ │111│ Breathpipe │ │80│ Sax 3 │ │112│ Timpani │ │81│ Sax 4 │ │113│ MelodicTom │ │82│ Clarinet 1 │ │114│ Deep Snare │ │83│ Clarinet 2 │ │115│ ElecPerc 1 │ │84│ Oboe │ │116│ ElecPerc 2 │ │85│ Engl Horn │ │117│ Taiko │ │86│ Bassoon │ │118│ Taiko Rim │ │87│ Harmonica │ │119│ Cymbal │ │88│ Trumpet 1 │ │120│ Castanets │ │89│ Trumpet 2 │ │121│ Triangle │ │90│ Trombone 1 │ │122│ Orche Hit │ │91│ Trombone 2 │ │123│ Telephone │ │92│ Fr Horn 1 │ │124│ Bird Tweet │ │93│ Fr Horn 2 │ │125│ OneNoteJam │ │94│ Tuba │ │126│ WaterBells │ │95│ Brs Sect 1 │ │127│ JungleTune │ └───────────────┘ └────────────────┘ ────────────────────────────────────────────────────────────────── 38 Appendix B Sound PCM Percussion and Effects* Timbre Timbre ┌────────────────┐ ┌────────────────┐ │128│ -- │ │160│ -- │ │129│ -- │ │161│ -- │ │130│ -- │ │162│ -- │ │131│ -- │ │163│ Bass Drum │ │132│ -- │ │164│ Bass Drum │ │133│ -- │ │165│ Rim Shot │ │134│ -- │ │166│ Snare Drum │ │135│ -- │ │167│ Hand Clap │ │136│ -- │ │168│ Snare Drum │ │137│ -- │ │169│ Low Tom │ │138│ -- │ │170│ Closed Hat │ │139│ -- │ │171│ Low Tom │ │140│ -- │ │172│ Open Hat 2 │ │141│ -- │ │173│ Middle Tom │ │142│ -- │ │174│ Open Hat 1 │ │143│ -- │ │175│ Middle Tom │ │144│ -- │ │176│ High Tom │ │145│ -- │ │177│ Crash Cymb │ │146│ -- │ │178│ High Tom │ │147│ -- │ │179│ Ride Cymb │ │148│ -- │ │180│ -- │ │149│ -- │ │181│ -- │ │150│ -- │ │182│ Tambourine │ │151│ -- │ │183│ -- │ │152│ -- │ │184│ Cowbell │ │153│ -- │ │185│ -- │ │154│ -- │ │186│ -- │ │155│ -- │ │187│ -- │ │156│ -- │ │188│ High Bongo │ │157│ -- │ │189│ Low Bongo │ │158│ -- │ │180│ M Hi Conga │ │159│ -- │ │191│ High Conga │ └────────────────┘ └────────────────┘ ────────────────────────────────────────────────────────────────── Appendix B Sound 39 Timbre Timbre ┌────────────────┐ ┌────────────────┐ │192│ Low Conga │ │224│ Pistol │ │193│ Hi Timbale │ │225│ MachineGun │ │194│ Lo Timbale │ │226│ LaserGun │ │195│ High Agogo │ │227│ Explosion │ │196│ Low Agogo │ │228│ Dog │ │197│ Cabasa │ │229│ Horse │ │198│ Maracas │ │230│ Birds │ │199│ Short Whis │ │231│ Rain │ │200│ Long Whist │ │232│ Thunder │ │201│ Quijada │ │233│ Wind │ │202│ -- │ │234│ Waves │ │203│ Claves │ │235│ Stream │ │204│ Laughing │ │236│ Bubble │ │205│ Screaming │ │237│ -- │ │206│ Punch │ │238│ -- │ │207│ Heartbeat │ │239│ -- │ │208│ Footsteps1 │ │240│ -- │ │209│ Footsteps2 │ │241│ -- │ │210│ Applause │ │242│ -- │ │211│ Creaking │ │243│ -- │ │212│ Door │ │244│ -- │ │213│ Scratch │ │245│ -- │ │214│ Windchime │ │246│ -- │ │215│ Engine │ │247│ -- │ │216│ Car-stop │ │248│ -- │ │217│ Car-pass │ │249│ -- │ │218│ Crash │ │250│ -- │ │219│ Siren │ │251│ -- │ │220│ Train │ │252│ -- │ │221│ Jet │ │253│ -- │ │222│ Helicopter │ │254│ -- │ │223│ Starship │ │255│ -- │ └────────────────┘ └────────────────┘ * 1. Note that the 33 PCM Sound Effects are not available on the Roland MT-32. 2. Note that some of the Sound Effects do not make any sound when selected since they require a longer Note-On time than the duration of the Menu Button press. The full MIDI volume range of 0-127 is supported on all Roland modules. P.S.Menu utilizes MIDI's Velocity feature to control volume as opposed to MIDI Control Change 7. ────────────────────────────────────────────────────────────────── 40 Appendix B Sound APPENDIX C: Quick Reference ■ Menu Section Keyboard Command Quick Reference: ESC .... exit P.S.Menu to DOS. F1 .... go to the P.S.Edit Menu Maintenance section. F2 .... go to the P.S.Draw Icon Paint section. Mouse Command Quick Reference: Left button .... run a selection, by pressing a "Button". Right button .... cycle through the four selection screens. Movement .... move the arrow around the screen. ■ Edit Section Keyboard Command Quick Reference: ESC .... exit to the P.S.Menu Main section. ^v<> .... (arrow keys) move the cursor around the entries. ENTER .... accept input data. HOME .... move the cursor to the left column in the current Entry. END .... move the cursor to the right column in the current Entry. TAB .... move the cursor the the start of the next word in the current Entry. INS .... toggle the Insert/Typeover mode. DEL .... delete the character under the cursor, move remaining line left. BSpc .... delete the character to the left of the cursor, move remaining line left. PgUp .... go to the previous page. PgDn .... go to the next page. F5 .... Insert a new blank Entry at the current cursor. Moves all Entries after the cursor up one place, the last Entry #25 is deleted (on this Page only). F6 .... Cut the current Entry. This moves the Entry data into the clipboard, and moves all Entries after the cursor down one place. a blank Entry is inserted into #25 (on this Page only). F7 .... Copy the current Entry to the clipboard. F8 .... Paste the data in the clipboard to the current Entry. F10 .... Print the data file contents to an Epson compatible printer. Alt+U .... toggle Selection Execute with PAUSE option on and off. Alt+S .... change the Screen Dim value. Alt+N .... select None sound. Alt+P .... select PC speaker sound. Alt+A .... select AdLib sound. Alt+R .... select Roland sound. Alt+T .... change the Roland Timbre (sound type). Alt+V .... change the AdLib or Roland volume level. ────────────────────────────────────────────────────────────────── Appendix C Quick Reference 41 Mouse Command Quick Reference: Left button on EXIT .... exit to the P.S.Menu Main section. Left button on None .... select None Sound. Left button on PC .... select PC Sound. Left button on AdLib .... select AdLib Sound. Left button on Roland .... select Roland Sound. Left button on Timbr .... adjust Sound Timbre. Left button on Volum .... adjust Sound Volume. Left button on Pause .... toggle Return Pause. Left button on Dim .... select Dim feature and delay time. Command-Tail Parameter Option Entry Quick Reference: ESC .... bypass or ignore parameter entry. ENTER .... accept entered parameters. BACKSPACE .... backspace left over entry to correct errors. ■ Draw Section Keyboard Command Quick Reference: ESC .... exit to the P.S.Menu Main section. d .... select Freehand Draw Tool. l .... select Line Tool. e .... select Eraser Tool. E .... select Color Eraser Tool. b .... select Hollow Box Tool. B .... select Filled Box Tool. c .... select Hollow Circle Tool. C .... select Filled Circle Tool. f .... select Region Fill Tool. a .... select Airbrush / Spray Tool. y .... select Copy / Scissor Tool. p .... select Paste Hand Tool. u .... select Undo Tool. r .... select Clear Tool. g .... select Get-Color / Eyedropper Tool. t .... select Text Tool. L .... Load an Icon from disk. S .... Save current Icon to disk. I .... Import PCX Icon. X .... Export PCX Icon. F1 .... Select 4x5 Font. F2 .... Select 5x6 Font. F3 .... Select 6x6 Font. F4 .... Select 6x8 Font. Mouse Command Quick Reference: Left Button .... select Toolbox Tool, Palette Box Color, File Box Function, draw on Zoom Window, or Exit. Right Button ... select Import PCX (File Load), Export PCX (File Save), or Font Size (Text Tool) dialog box. ────────────────────────────────────────────────────────────────── 42 Appendix C Quick Reference Text Tool Quick Reference: ESC .... Exit Text function, restore original Icon. ENTER .... Keep Text, paste onto Icon. BSpc .... Backspace left across text to correct an error. Use 63 Alphanumeric and punctuation keys plus Space for text, all lower case letters are converted to upper case: !"#$%&'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_ Font Size Dialog Quick Reference: ESC .... Exit Font Size dialog. Left Mouse Button .... select Font Size, or exit if outside dialog box. Load/Import Function Quick Reference: ESC .... Exit Load function, return to drawing. Save/Export Function Quick Reference: ESC .... Exit Save function, return to drawing. ENTER .... Save Icon, using name shown in File List Box. <> .... Move red cursor to edit Icon Name in File List Box. SPACE .... Remove trailing characters. ────────────────────────────────────────────────────────────────── Appendix C Quick Reference 43 APPENDIX D: Registration REGISTRATION !! Please Read This !! Registration of programs from David R. Green grants you the following features: 1. A Registered Program Disk, with your name as Licensee instead of "Non-Registered Copy" text, as displayed in the program (applies to certain programs only). 2. A printed Owner's Manual (applies to certain programs only. See program descriptions above.). 3. Certain programs have a Bonus disk available, which will be sent First Class mail as soon as the paid Registration is received. Bonus disks contain additional accessories or files for the program, possibly developed after the initial release of the program. 4. Program support for 1 full year from the registration date. If you apply for support after the year is over, you will be charged a fee for whatever remedy is required, ie re-compiling, telephone charges, postage, etc. If you apply for support on an old version of any program, you will be asked to purchase the upgraded version or revision (at the 25% or 50% discount rate of course) since the new version or revision would probably have the bug fixed already. Support refers to: A. Program problem on particular Hardware, ie won't work properly on a certain Video card or with a particular Mouse. B. Loss of one or more of the program's files due to accident or media failure. A replacement disk(s) will be issued for the cost of the disk(s), duplication time, and shipping. C. Questions concerning Program Operation, perhaps with particular hardware, or when adding a new peripheral. D. Problems getting the program to work on certain hardware, PRIOR to registration, ASSUMING YOU DESIRE TO REGISTER WHEN THE BUG IS FIXED. 5. All Registered users will receive Shareware Distributed Version upgrades for a reduced fee. Minor upgrades are only 25%, and Major upgrades are only 50%, of their regular Registration Fee. For example, if you registered PROGRAM1 version 1.0, when version 1.1 becomes available you will only pay $10 to register assuming version 1.1 has a Registration fee of $40. Registration of version 2.0 would likewise be $20. Anyone registering a new version, who has not registered a previous version will of course pay the full amount. You already paid for the License to use the program with the first Registration, you shouldn't have to pay full pop again. ────────────────────────────────────────────────────────────────── 44 Appendix D Registration 6. Registered users will receive free newsletters detailing what's new for programs and versions. This service is also valid for overseas parties, so please give your correct address. Registration of these programs does not fund a faceless corporation that is already excessively wealthy; writing programs is how I make my living and feed my family. I am trying to provide Retail-or-better quality programs at low Shareware prices, using volume sales instead of high prices. I am currently not allowing registration by credit card, due to the fact that I would have to increase my prices to cover the cost of the credit card fees (VISA would charge me 3-4% on each sale). If you wouldn't mind paying a little more, and would like the ease of credit card payment, please indicate this on the Registration form or Order form. If enough people want it, I'll do it. I can not be held responsible for delays or loss of Order or Registration forms in our mail system (we all know how fast they are!), but if you have any questions or problems, please contact me, I need your business, and am here to help. SHAREWARE These programs are NOT FREE, they are Copyrighted. These programs are currently distributed by the Shareware method which is merely a means of program distribution, not a grant of copyright or license. David R. Green makes no guarantee that the above listed programs shall always be distributed as Shareware. These programs may not be distributed by any commercial Shareware distribution house, or for profit, without the express written permission of David R. Green. Shareware distribution vendors are requested to contact David R. Green prior to distributing any of the above listed programs. The Shareware method of program distribution, allows you to test a program for suitability of use prior to purchase. This test period may be up to but not exceeding four (4) weeks from the date of program acquisition. Once the trial period has expired, you have two options (a) you MUST register with the copyright holder or (b) to destroy the contents of the disk and any copies. This Program is available in two versions, the Shareware Distribution version, and the Registration version. The difference being the displayed "UNREGISTERED" versus "LICENSED TO your_name" text contained in the program. Distribution versions may be freely copied and distributed, so long as no fee is charged for the PROGRAM, and all copyright notices are reproduced on the copy. Registered parties are requested to not distribute copies of their personally Registered version, give the person a copy of the Shareware version, or inform them of where you obtained yours. ────────────────────────────────────────────────────────────────── Appendix D Registration 45 REGISTERED VERSION PROGRAM LICENSE AND COPYRIGHT INFORMATION This legal document is an agreement between you, the end user, and David R. Green. BY USING THIS PROGRAM FOR A PERIOD EXCEEDING THE MENTIONED SHAREWARE TRIAL PERIOD, YOU ARE AGREEING TO BECOME BOUND BY THE TERMS OF THIS AGREEMENT, WHICH INCLUDES THE SOFTWARE LICENSE, LIMITED WARRANTY AND ACKNOWLEDGEMENT. IF YOU DO NOT AGREE TO THE TERMS OF THIS AGREEMENT, DO NOT USE THIS PRODUCT. PROMPTLY RETURN THE DISK PACKAGE AND OTHER ITEMS (INCLUDING WRITTEN MATERIALS, PACKAGING, AND HARDWARE, IF ANY) WHICH ARE PART OF THIS PRODUCT TO THE PLACE WHERE YOU OBTAINED THEM. IF YOU OBTAINED THIS PRODUCT FROM A BBS, DESTROY THE COMPLETE CONTENTS OF THE DISK(S) AND ANY PRINTED DOCUMENTATION. In order to preserve and protect his rights under applicable laws, David R. Green does not sell any rights in his SOFTWARE. Rather, David R. Green grants the right to use his SOFTWARE by means of a SOFTWARE LICENSE. David R. Green specifically retains title to all his computer software. SOFTWARE LICENSE 1. GRANT OF LICENSE. In consideration of payment of the License fee which is a part of the price you pay for this product upon Registration, and your agreement to abide by the terms and conditions of this License and the Limited Warranty, David R. Green, as Licensor, grants to you, the LICENSEE, a nonexclusive right to use and display this copy of the software program (herinafter the "SOFTWARE") on a single COMPUTER at a single location so long as you comply with the terms of this License. If the single computer on which you use the SOFTWARE is a multiuser system, the License covers all users on that single system, without further License payments. David R. Green reserves all rights not expressly granted to LICENSEE. 2. OWNERSHIP OF SOFTWARE. As the LICENSEE, you own the magnetic or other physical media on which the SOFTWARE is originally or subsequently recorded or fixed, but an express condition of this License is that David R. Green retains title and ownership of the SOFTWARE recorded on the original disk copy(ies) and all subsequent copies of the SOFTWARE, regardless of the form or media in or on which the original and other copies may exist. This License is not a sale of the original SOFTWARE or any copy. 3. COPY RESTRICTIONS, REGISTERED VERSION. This SOFTWARE and any accompanying written materials are copyrighted. Unauthorized copying of the SOFTWARE, including SOFTWARE which has been modified, merged, or included with other software, or of the written materials is expressly forbidden. You may be held legally responsible for any copyright infringement which is caused or encouraged by your failure to abide by the terms of this License. Subject to the restrictions above, you may make one (1) copy of the SOFTWARE solely for backup purposes. You must reproduce and include the copyright notice on the backup copy. ────────────────────────────────────────────────────────────────── 46 Appendix D Registration 4. USE RESTRICTIONS. As the LICENSEE, you may physically transfer the SOFTWARE from one computer to another provided that the SOFTWARE is used on only one computer at a time. You may not electronically transfer the SOFTWARE from one computer to another over a network. You may not distribute copies of the SOFTWARE or accompanying written materials to others. You may not modify, adapt, translate, reverse engineer, decompile, disassemble, or create derivative works based on the SOFTWARE. You may not modify, adapt, translate or create derivative works based on the written materials without the prior written consent of David R. Green. 5. TRANSFER RESTRICTIONS. This SOFTWARE is licensed only to you, the LICENSEE, and may not be transferred to anyone without the prior written consent of David R. Green. Any unauthorized transferee of the SOFTWARE shall be bound by the terms and conditions of this License and Limited Warranty. In no event may you transfer, assign, rent, lease, sell or otherwise dispose of the SOFTWARE on a temporary or permanent basis except as expressly provided herein. 6. TERMINATION. This License is effective until terminated. This License will terminate automatically without notice from David R. Green if you fail to comply with any provision of this License. Upon termination you shall destroy any written materials and all copies of the SOFTWARE, including modified copies, if any. 7. UPDATE POLICY. David R. Green may create, from time to time, updated versions of the SOFTWARE. At his option, David R. Green will make such updates available to LICENSEE and transferees who have paid the update fee and returned the Registration card to David R. Green. 8. MISCELLANEOUS. This License is governed by the Federal laws of Canada and shall benefit David R. Green, his successors and assigns. LICENSEE consents to jurisdiction in the Provincial and Federal courts located in Canada. LIMITED WARRANTY THE SOFTWARE AND ACCOMPANYING WRITTEN MATERIALS (INCLUDING INSTRUCTIONS FOR USE) ARE PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. FURTHER, DAVID R. GREEN DOES NOT WARRANT, GUARANTEE OR MAKE ANY REPRESENTATIONS REGARDING THE USE, OR THE RESULTS OF USE, OF THE SOFTWARE OR WRITTEN MATERIALS IN TERMS OF CORRECTNESS, ACCURACY, RELIABILITY, CURRENTNESS, OR OTHERWISE. THE ENTIRE RISK AS TO THE RESULTS AND PERFORMANCE OF THE SOFTWARE IS ASSUMED BY YOU. IF THE SOFTWARE OR WRITTEN MATERIALS ARE DEFECTIVE YOU, AND NOT DAVID R. GREEN OR ANY BBS, DISTRIBUTORS, AGENTS, OR EMPLOYEES, ASSUME THE ENTIRE COST OF ALL NECESSARY SERVICING, REPAIR, OR CORRECTION. ────────────────────────────────────────────────────────────────── Appendix D Registration 47 David R. Green warrants to the original LICENSEE that the disk(s) on which the SOFTWARE is recorded is free from defects in material and workmanship under normal use and service for a period of ninety (90) days from the date of delivery as evidenced by a copy of the Registration receipt. David R. Green warrants to the original LICENSEE that the hardware accompanying the SOFTWARE is free from defects in materials and workmanship under normal use and service for a period of ninety (90) days from the date of delivery as evidenced by a copy of the Registration receipt. David R. Green's entire liability and your exclusive remedy as to the disk(s) or hardware shall be, at David R. Green's option, either (a) return of the purchase price or (b) replacement of the disk or hardware which does not meet David R. Green's Limited Warranty and which is returned to David R. Green postage prepaid with a copy of the receipt. If failure of the disk or hardware has resulted from accident, abuse, or misapplication, David R. Green shall have no responsibility to replace the disk or hardware or refund the purchase price. In the event of replacement of the disk or hardware, the replacement disk or hardware will be warranted for the remainder of the original warranty period or thirty (30) days, whichever is the longer. THE ABOVE IS THE ONLY WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, STATUTORY OR OTHERWISE, INCLUDING BUT NOT LIMITED TO THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE THAT IS MADE BY DAVID R. GREEN ON THIS PRODUCT. NO ORAL OR WRITTEN INFORMATION OR ADVICE GIVEN BY DAVID R. GREEN, BBS, DISTRIBUTORS, AGENTS OR EMPLOYEES SHALL CREATE A WARRANTY OR IN ANY WAY INCREASE THE SCOPE OF THIS WARRANTY AND YOU MAY NOT RELY ON ANY SUCH INFORMATION OR ADVICE. NEITHER DAVID R. GREEN NOR ANYONE ELSE WHO HAS BEEN INVOLVED IN THE CREATION, PRODUCTION OR DELIVERY OF THIS PRODUCT SHALL BE LIABLE FOR ANY DIRECT, INDIRECT, CONSEQUENTIAL OR INCIDENTAL DAMAGES (INCLUDING DAMAGES FOR LOSS OF BUSINESS PROFITS, BUSINESS INTERRUPTION, LOSS OF BUSINESS INFORMATION, AND THE LIKE) ARISING OUT OF THE USE OR INABILITY TO USE SUCH PRODUCT EVEN IF DAVID R. GREEN HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. THIS WARRANTY GIVES YOU SPECIFIC RIGHTS. YOU MAY HAVE OTHER RIGHTS WHICH VARY AND CERTAIN LIMITATIONS CONTAINED IN THIS LIMITED WARRANTY MAY NOT APPLY TO YOU. IN THE EVENT OF ANY CONFLICTION BETWEEN ANY PROVISION IN THIS LIMITED WARRANTY AND ANY APPLICABLE LEGISLATION, THE APPLICABLE LEGISLATION TAKES PRECEDENCE OVER THE CONTRAVENING PROVISION. This Limited Warranty is governed by the laws of the Province of British Columbia, Canada, and shall benefit David R. Green, his successors and assigns. ────────────────────────────────────────────────────────────────── 48 Appendix D Registration ACKNOWLEDGEMENT YOU ACKNOWLEDGE THAT YOU HAVE READ THIS LICENSE AND LIMITED WARRANTY, UNDERSTAND THEM, AND AGREE TO BE BOUND BY THE TERMS AND CONDITIONS. YOU ALSO AGREE THAT THE LICENSE AND LIMITED WARRANTY ARE THE COMPLETE AND EXCLUSIVE STATEMENT OF AGREEMENT BETWEEN THE PARTIES AND SUPERSEDE ALL PROPOSALS OR PRIOR AGREEMENTS ORAL OR WRITTEN, AND ANY OTHER COMMUNICATIONS BETWEEN THE PARTIES RELATING TO THE SUBJECT MATTER OF THE LICENSE OR THE LIMITED WARRANTY. Should you have any questions concerning this License or this Limited Warranty, or if you desire to contact David R. Green for any reason, please contact via any of the following: David R. Green 9605-13th Street Dawson Creek, BC CANADA V1G 3V9 CompuServe, David R. Green, User ID 70621,1362 If you are not a member, and would like to join, contact CompuServe Customer Service at: U.S.A. 800-848-8990 Canada & Foreign 1-614-457-8650 U.K. 0800 289 458 Germany 0130-4643 Thank you. Please Register all software, it's what keeps Shareware going. To Register, please fill out and return this Registration form. ────────────────────────────────────────────────────────────────── Appendix D Registration 49 ┌─────────────────────────────────────────────────────────────────┐ │ REGISTRATION FORM │ │─────────────────────────────────────────────────────────────────│ │ │ │ SEND TO: David R. Green P.S.Menu 1.4 │ │ 9605-13th Street Copyright (C)1991/2 │ │ Dawson Creek, BC David R. Green │ │ CANADA V1G 3V9 All Rights Reserved │ │ │ │ │ │ NAME ________________________________________________________ │ │ │ │ COMPANY _____________________________________________________ │ │ │ │ ADDRESS _____________________________________________________ │ │ │ │ CITY ________________________________________________________ │ │ │ │ STATE / PROV ________________________________________________ │ │ │ │ COUNTRY _____________________________________________________ │ │ │ │ ZIP / POSTAL CODE __________________ DATE __________________ │ │ month/day/year │ │ PHONE _____________________ COMPUSERVE ID __________________ │ │ │ │ Computer Brand ______________________________________________ │ │ │ │ Processor []∙88/86 []∙286 []∙386SX []∙386DX []∙486SX []∙486DX │ │ │ │ Clock Speed _________ MHz │ │ │ │ Amount of RAM _______ total [______] EMS [______] XMS │ │ │ │ Floppy Drive(s) []∙360k []∙720k []∙1.2MB []∙1.44MB []∙2.88MB │ │ │ │ Video Card Brand and Model __________________________________ │ │ │ │ REGISTRATION FEE: $40.00 Canadian (BC Residents add 6% PST) │ │ │ │ Make your cheque or money order payable to David R. Green. │ │ Sorry No Credit Cards │ │ │ │ If you have any comments, please let me know. │ │ │ │ COMMENTS ____________________________________________________ │ │ │ │ ____________________________________________________ │ │ │ │ Thank You! │ └─────────────────────────────────────────────────────────────────┘ ────────────────────────────────────────────────────────────────── 50 Registration Form ┌─────────────────────────────────────────────────────────────────┐ │ SUPPORT FORM │ │─────────────────────────────────────────────────────────────────│ │ │ │ SEND TO: David R. Green P.S.Menu 1.4 │ │ 9605-13th Street Copyright (C)1991/2 │ │ Dawson Creek, BC David R. Green │ │ CANADA V1G 3V9 All Rights Reserved │ │ │ │ │ │ NAME ________________________________________________________ │ │ │ │ COMPANY _____________________________________________________ │ │ │ │ ADDRESS _____________________________________________________ │ │ │ │ CITY ________________________________________________________ │ │ │ │ STATE / PROV ________________________________________________ │ │ │ │ COUNTRY _____________________________________________________ │ │ │ │ ZIP / POSTAL CODE _______________ DATE (m/d/y) _____________ │ │ │ │ HOME _____________ BUSINESS _____________ FAX _____________ │ │ │ │ COMPUSERVE ID _______________________________________________ │ │ │ │ Computer Brand ______________________________________________ │ │ │ │ Processor []∙88/86 []∙286 []∙386SX []∙386DX []∙486SX []∙486DX │ │ │ │ Clock Speed _________ MHz │ │ │ │ Amount of RAM _______ total [______] EMS [______] XMS │ │ │ │ Floppy Drive(s) []∙360k []∙720k []∙1.2MB []∙1.44MB []∙2.88MB │ │ │ │ Video Card Brand and Model __________________________________ │ │ │ │ Additional I/O cards ___________________ ___________________ │ │ │ │ ___________________ ___________________ │ │ │ │ Config.Sys ________________ Autoexec.Bat _________________ │ │ ________________ _________________ │ │ ________________ _________________ │ │ ________________ _________________ │ │ ________________ _________________ │ │ ________________ _________________ │ │ │ │ Problem _____________________________________________________ │ │ _____________________________________________________ │ │ │ │ Thank You! use other side » │ └─────────────────────────────────────────────────────────────────┘ ────────────────────────────────────────────────────────────────── Support Form 51 APPENDIX E: Version Guide Version 1.0 ─────────── Initial 4th Q 1991 Version 1.1 ─────────── Update November 1991 ∙ DRAW: Constrained Cursor within Zoom Window. Version 1.2 ─────────── Update Release January 1992 ∙ DRAW: Fixed Paste Tool (lock-up on Paste before Cut). ∙ DRAW: Added sorted directory listing during Load/Import. Version 1.3 ─────────── Update Release March 1992 ∙ Removed 2 second delay from opening screen About Box. ∙ INSTALL: correctly support file copy of PSMenu Manual. Version 1.4 ─────────── Update Release April 1992 ∙ DRAW: Fixed PCX-Import Error Message display (when attempting to Import PCX format other than 320x200x256). ∙ DRAW: Fixed Copy Tool, crash when X2Y2 second coordinates are above X1Y1 first coordinates. ────────────────────────────────────────────────────────────────── 52 Appendix E Version Guide INDEX Airbrush ......... 22,28,42 Clear ............ 17,23,28,30,31,32,33,42 Color Eraser ..... 19,28,42 Copy ............. 9,15,22,28,31,33,41,42 Cut .............. 9,15,41 Draw ............. 2,6,17,18,26,28,30,42 Drive ............ 7,9,14 Edit ............. 6,7,12,14,41 Eraser ........... 18,19,28,42 Eyedropper ....... 24,28,42 Fill Region ...... 21,28,42 Filled Box ....... 20,28,42 Filled Circle .... 21,28,42 Freehand ......... 17,18,28,31,32,42 Get-color ........ 24,25,28,42 Hollow Box ....... 19,28,42 Hollow Circle .... 20,28,42 Icon ............. 7,9,14,17 Line ............. 17,18,28,30,42 Palette .......... 18,19,20,21,22,23,24,28,29,30,31,32,33,42 Paste ............ 9,15,23,28,31,33,41,42 Path ............. 4,7,9,14 Scissors ......... 22,28,31,42 Spray ............ 22,28,42 Text ............. 24,28,42 Title ............ 9,10,14 Undo ............. 17,18,19,20,21,23,28,42 ────────────────────────────────────────────────────────────────── Index 53 GLOSSARY ACRONYM ∙ an abbreviation for a group of words. ASSEMBLER ∙ a program that converts assembly language source code into machine code. ASSEMBLY LANGUAGE ∙ a low-level language whose mnemonics and syntax closely reflect the internal workings of the microprocessor's registers. BATCH FILE ∙ a file composed of one or more lines of text, with the text being comprised of valid DOS commands. The file is parsed and executed line by line by the command interpreter. BIOS ∙ assembly language routines stored as machine code in ROM which provide Basic Input/Output Services for DOS and applications programs. BIT ∙ a single unit of binary logic. BInary-digiT. BITBLT ∙ an acronym for BIT Boundary bLock Transfer. One of several means of animation. BUFFER ∙ a temporary storage space for data. BYTE ∙ an 8-bit number which may indicate values from 0 to 255, or 00h to 0FFh in hexadecimal. CHANNEL ∙ refering to the MIDI channel scheme, the MIDI protocol allows for Voice and Mode messages to be sent on 16 discrete channels. CHROMA KEY ∙ see Color Key. COLOR KEY ∙ a color-based video overlay method that lets you drop all areas of a selected color out of a foreground image so that the corresponding areas of the background image can show through it. Also called Chroma-keying or just Keying. COORDINATE ∙ the arrangement of XY axes in a 2-Dimensional display. COPYRIGHT ∙ the right to copy an intellectual property such as a book, manuscript, software program, painting, photograph, and so forth. CPU ∙ an acronym for Central Processing Unit, also called a microprocessor. DOS ∙ Disk Operating System. ────────────────────────────────────────────────────────────────── 54 Glossary EDITOR ∙ refers to the interface which allows the user to create and modify program dependant data. HARDWARE ∙ the physical and mechanical components of a microcomputer system. I/O ∙ Input Output. KEYING ∙ to show one image superimposed on another, by utilizing a Chroma key or Color key effect. LICENSE ∙ the right to use an intellectual property such as a book, manuscript, software program, painting, photograph, etc. Copyright is the right to copy an intellectual property, which is rarely included in software licenses. LSB ∙ Least Significant Bit. LUMINANCE ∙ varying levels or degrees of color brightness. MASM ∙ an acronym for MAcro aSseMbler, an assembly language compiler capable of including seperately created modules into the finished program. MIDI ∙ Musical Instrument Digital Interface. MODULAR ∙ comprised of individual modules, subroutines, or components. MOUSE ∙ a hand-held device used to control on-screen cursor movement. MSB ∙ Most Significant Bit. OPTIMIZE ∙ to improve a program's speed of execution. OVERLAY ∙ to show one image superimposed on another. Especially in video images, to show text on top of a picture or computer output on top of moving video (GenLock). See Keying/Color-keying. PARAMETER ∙ a variable which a subroutine expects to receive when it is called, also called an argument. PEL ∙ an acronym for Picture ELement, also called a pixel. PIXEL ∙ the smallest addressable dot or graphic on a display screen. RAM ∙ an acronym for Random Access Memory. RAM DISK ∙ a virtual or simulated disk which resides in RAM memory. RAMP ∙ a difference in levels; a sloping value. ────────────────────────────────────────────────────────────────── Glossary 55 ROM ∙ an acronym for Read Only Memory. SFX ∙ Sound effects. SOURCE CODE ∙ program instructions written in the original programming language. SUBROUTINE ∙ a subordinate, self-contained portion (or module) of a program designed to perform a specific task. SYNTAX ∙ the grammar to be used with a programming language. SYSTEM OVERHEAD ∙ the amount of time the microcomputer allocates to general housekeeping functions instead of executing programs. TSR ∙ Terminate and Stay Resident. A memory-resident program or driver, such as a Mouse driver or a pop-up program. VARIABLE ∙ a quantity whose value changes during program execution. VGA ∙ Video Graphics Array, an IBM type of video adapter. Z ∙ Zzat's all folks; Ze end of ze manual. ────────────────────────────────────────────────────────────────── 56 Glossary