Brief documentation for EPM Speech Support Manager ----- Description ----- EPM Speech Support Manager allows you to have dictation in any application using EPM windows or the E-MLE. It works with the IBM Personal Dictation System, and uses the power of the E Toolkit rather than the IPDS Dictation window. ----- Installation ----- Copy EPMSPCH.EXE to a directory in your PATH, ETKSPCH.DLL to a directory in your LIBPATH. If using EPM 5.51, copy ETKSPCH.551 to a directory in your EPMPATH, renaming it to ETKSPCH.EX. If using EPM 6.03a, do the same for ETKSPCH.603. (If using both, the 5.51 version .ex file should be found before the 6.03 version so that both versions will work properly. If using a different version of EPM, recompile ETKSPCH.E with the appropriate version of ETPM.) If using EPM 6 and you want to add speech support to the toolbar, copy the BMP files to your EPM directory or a directory in your EPMPATH. ----- Using EpmSpch ----- The package consists of an EXE, a DLL, and EX files. It can be started from the edit window or from an OS/2 command window. It runs in a separate process, and so can be used in different applications, even if you close the application that first started the speech connection. EpmSpch accepts the following options: /MIN Start minimized. /CONNECT Tries to start a session with the speech engine. If no user id, enrollment id or task name is specified, the user information dialog will pop up before starting the session. /NOLOG No logging information displayed in the EPMSPCH window. /HWND= The edit window specified is selected and receives the speech focus. /USERID= Speaker ID used for the session. /ENROLLID= Enrollment ID /TASK= Task name (usually STARTUS) Note: The userid, enroll ID, task name and log level are saved in the INI file so you don't need to set them every time. The window positions and presentation parameters are also saved. To start from an edit window, link the appropriate .ex file and execute the command SpStartDictationSupport. This will start EpmSpch minimized, autoconnected, and with the current edit window selected. ----- Speech Focus ----- Since you can have multiple applications using several edit windows on your screen, EpmSpch has to know which one is going to receive the recognized words and display them. This is called the speech focus. If EpmSpch is started from an edit window, that window automatically receives the speech focus. To give the focus to another window, you can use the Select option from the EpmSpch menu. The mouse pointer will change to a +, indicating that you can choose which window you want to select by clicking on it. Starting EpmSpch with the /HWND= option is another way to give the focus to an edit window. ----- E Macro Commands ----- The following commands can be used by any edit window: SPStartDictationSupport Starts the dictation support and gives the speech focus to the edit window. SPMikeOn Turns the mike on. SPMikeOff Turns the mike off. SPCorrectWord Corrects the word located at the cursor. ----- How to configure your toolbar in EPM 6 ----- Add the following items to your toolbar : 1. Bmp : SPEECH.BMP Action : Function : * Param : mc /link epmspch/SPStartDictationSupport (to start and initialize EPM speech manager from EPM) 2. Bmp : MIKEON.BMP Action : Function : * Param : SPMikeOn 3. Bmp : MIKEOFF.BMP Action : Function : * Param : SPMikeOff ----- Correction Context Menu ----- A double-click on a word with mouse button 1 will bring up the correction context menu and automatically replay the word. It allows you to replay the word (to recall what you said), perform some formatting commands, delete it, or replace it with one of the alternate words which the decode found. The maximum number of alternates has been set to 10; this can be changed by modifying the MAXNBOFALTERNATES constant in ETKSPCH.E and recompiling the macro with ETPM. If you double-click on a word that was not dictated, the pop-up menu will not appear. ----- Logging Information ----- EpmSpch has a logging facility. It can display messages in the EpmSpch status window. The log level can be set using the Logging menu item. (Multiple levels can be active at the same time.) The levels are: ERRORS Display all error messages (from the speech engine or EpmSpch) MESSAGES Display all status messages (e.g., mike on or mike off) E-MACROS Displays all E-Macro commands before posting them to the edit window WORDS Displays all the words that are recognized by the engine