APPLICATION NOTE #152 USING THE LOGITECH SERIAL MOUSE WITH XYWRITE III PLUS Rev. 03 The Logitech Serial Mouse, which is a product of Logitech, Inc., is a hand-held pointing device that allows you to move the cursor quickly around the screen. This application note explains the procedure for using the Logitech Mouse and a XYQUEST-developed mouse menu for XyWrite and XyWrite A La Carte Menus. PROGRAM REQUIREMENTS This procedure assumes you have installed a Logitech Serial Mouse according to the information in the Logitech Mouse User's Manual, and installed XyWrite III Plus according to the procedures in the XyWrite III Plus Installation Guide. Additionally, you need the following files: MENU.COM XYMOUSE.MNU XYLAMOUS.MNU The first file is a utility program available on the program disks supplied with the mouse from Logitech Corporation. It allows you to load special menu files, such as the ones provided by XYQUEST (see Note #1). The other two files, XYMOUSE.MNU and XYLAMOUS.MNU, are mouse menus developed by XYQUEST specifically for the Logitech Mouse. They are executable menu files which cannot be edited in XyWrite. XYMOUSE.MNU is for use with XyWrite with regular help files; XYLAMOUS.MNU is for use with the A La Carte Menus. Copies of XYMOUSE.MNU and XYLAMOUS.MNU are available upon request. Call or write Technical Services to obtain copies. INSTALLING THE XYWRITE MOUSE MENU To use the XyWrite mouse menu, be sure that MENU.COM and XYMOUSE.MNU or XYLAMOUS.MNU are on your working disk or in the XyWrite directory of your hard disk. To load a XyWrite mouse menu into memory, type one of the following commands at the DOS prompt before you go into XyWrite (see Note #2): menu \path\xymouse or menu \path\xylamous where \path is the directory that contains the mouse menus. To unload the mouse menu, type the following command at the DOS prompt (see Note #3). menu off If you prefer to load and unload the menu automatically each time you boot your system, refer to the section "Automatic Startup." MENU DESCRIPTIONS The mouse menu program utilizes the mouse movements, the mouse buttons, and four menus (main, edit, mode, and window). The functions of the buttons are as follows. (See Notes #4 and #5.) Button Function Left Execute (same as F9) Middle Escape (same as Esc) Right Display main menu Left+Middle Move cursor to and clear command line (same as F5) Left+Right Toggle cursor between command line and text area (same as F10) Middle+Right Unassigned Left+Middle+Right Quit XyWrite The main menu has the following opions: 1. EDITS--calls the edit menu 2. MODES--calls the mode menu 3. HELP--calls the help screens 4. SAVE--saves the file on the screen 5. WINDOWS--calls the window menu 6. DIRECTORY--displays a directory of the current drive and directory 7. DOS--exits to DOS from XyWrite 8. RETURN FROM DOS--returns to XyWrite from DOS 9. PRINT A FILE--prints the current file 10. CLEAR MENU--removes the menu from the screen 11. A LA CARTE MENU--calls the A La Carte Menu (available only in XYLAMOUS.MNU) The edit menu contains the following options: 1. BEGIN/END DEFINE (same as F1) 2. UNDELETE LAST (same as Alt_F3) 3. RELEASE DEFINE (same as F3) 4. DELETE DEFINE (same as Alt_F6) 5. COPY DEFINE (same as F7) 6. MOVE DEFINE (same as F8) 7. CLEAR MENU--clears menu The mode menu contains the following options: 1. MODE NORMAL--turns on mode normal (same as Ctrl_1) 2. MODE BOLD--turns on bold mode (same as Ctrl_2) 3. MODE UNDERLINE--turns on underline mode (same as Ctrl_3) 4. MODE REVERSE--turns on reverse mode (same as Ctrl_4) 5. MODE BOLD UNDERLINE--turns on bold underline mode (same as Ctrl_5) 6. MODE BOLD REVERSE--turns on bold reverse mode (same as Ctrl_6) 7. MODE SUPERSCRIPT--turns on superscript mode (same as Ctrl_7) 8. MODE SUBSCRIPT--turns on subscript mode (same as Ctrl_8) 9. CLEAR MENU--clears menu The window menu contains the following options: 1. GO TO WINDOW 1 (same as Ctrl_Shift_1) 2. GO TO WINDOW 2 (same as Ctrl_Shift_2) 3. GO TO WINDOW 3 (same as Ctrl_Shift_3) 4. GO TO WINDOW 4 (same as Ctrl_Shift_4) 5. GO TO WINDOW 5 (same as Ctrl_Shift_5) 6. GO TO WINDOW 6 (same as Ctrl_Shift_6) 7. GO TO WINDOW 7 (same as Ctrl_Shift_7) 8. GO TO WINDOW 8 (same as Ctrl_Shift_8) 9. GO TO WINDOW 9 (same as Ctrl_Shift_9) 10. SHOW WINDOW MENU (same as Ctrl_F10) 11. REMOVE WINDOW (same as F5rs) 12. NEXT WINDOW (same as Shift_F10) Please see Note #1 for information on customizing these menus or creating your own. USING A XYWRITE MOUSE MENU Once you have loaded the XyWrite mouse menu, you can use it to execute any of the functions listed in the menus. As an example, let's use it to display a word in bold mode. 1. Move the cursor to the beginning of the word you want in bold. You can use either the mouse or keyboard cursor keys to do this. 2. Press the right button on the mouse. Result: The XyWrite main menu appears in the middle of the screen. Using the mouse, you can highlight different menu options, but you cannot move the cursor outside of the menu borders. 3. Select the MODES option by moving the cursor to it and then clicking one of the mouse buttons. Result: The mode menu replaces the main menu. 4. Select the BOLD option by moving the cursor to it and then pressing one of the mouse buttons. Result: The menu clears from the screen, and all text from the current cursor position to the end of the file (or until the next mode command) appears in bold. 5. Move the cursor to the end of the word you want in bold. 6. Repeat steps 2 and 3. Result: The mode menu appears on the screen, with the MODE NORMAL option highlighted. 7. Press one of the mouse buttons. Result: The menu clears from the screen, and all text from the current cursor position to the end of the file (or until the next mode command) appears in normal. AUTOMATIC STARTUP If you would like the mouse menu automatically installed every time the computer is turned on, add one of the following commands to the AUTOEXEC.BAT file, before the command that starts the XyWrite editor: menu \path\xymouse or menu \path\xylamouse where path is the directory that contains XYMOUSE.MNU or XYLAMOUSE.MNU. If you want to unload the mouse menu after quitting XyWrite, add the following line to the AUTOEXEC.BAT file after the XyWrite editor: menu off Note #1 Customizing Menus. Neither XYMOUSE.MNU nor XYLAMOUS.MNU can be edited directly. It is necessary to make changes to a corresponding ASCII text file and then use Logitech's mouse menu compiler, NEWMENU.EXE, to make a new, executable mouse menu. For your convenience, the ASCII files used to create XyWrite's two mouse menus are included on the disk supplied by XYQUEST: XYMOUSE.DEF for XYMOUSE.MNU, and XYLAMOUS.DEF for XYLAMOUS.MNU. NEWMENU.EXE is available on the program disks supplied with the mouse by Logitech Corp. Its use is described in the Logitech Mouse User's Manual. Note #2 Memory Requirement. XYMOUSE.DEF and XYLAMOUS.DEF use approximately 4K of memory each. Note #3 Unloading Mouse Menu. The mouse menu runs independently of XyWrite and may conflict with other software packages. Therefore, you should turn off the XyWrite mouse menu when you exit XyWrite. Note #4 IBM.KBD. The XyWrite mouse menus assume you are using the standard XyWrite keyboard file, IBM.KBD. If you are using a customized keyboard, you may have to modify the menus according to the instructions in the Logitech Mouse User's Manual. For example, the mouse menu assumes the Execute function is mapped to F9. If you remapped the keyboard and assigned the Move function to F9, XyWrite will try to execute a Move when you press the left button on the mouse. Note #5 Linear Cursor Movement. For smoother cursor movement on the screen, assign the linear cursor functions (LL, LR, LU, LD) to the cursor keys in the XyWrite keyboard table. Remap all positions of the cursor keys that are not used for other functions (e.g., Shift_ÿ1A and Shift_ are used for column tables). ##