home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / tolkit45.zip / os2tk45 / samples / mm / caption / caption.hlp (.txt) < prev    next >
OS/2 Help File  |  1999-05-12  |  8KB  |  226 lines

  1.  
  2. ΓòÉΓòÉΓòÉ 1. System overview ΓòÉΓòÉΓòÉ
  3.  
  4. Welcome to MMPM/2's sample captioning system.  We call it our sample captioning 
  5. system because we've provided it, source code and all, as an example of one way 
  6. to implement captioning with MMPM/2.  The system can be used as it's provided, 
  7. or it can be modified to suit your specific needs. 
  8.  
  9. This sample captioning system is made up of three parts.  The first part of the 
  10. system is this application, the Caption Creation Utility.  This allows you to 
  11. synchronize an audio file with a text file.  The second part of the system is 
  12. the Caption DLL.  This DLL provides three api's that allow an application to 
  13. display, manage, and hide a caption window.  The third part of the system is 
  14. Caption Sample Application.  It shows programmers how to use the three api's 
  15. provided by the Caption DLL in order to display a caption window in an 
  16. application. 
  17.  
  18.       To add captions to an audio file: 
  19.  
  20.         1. Choose an audio file by selecting Open audio... in the File submenu. 
  21.  
  22.         2. Choose a text file by selecting Open text... in the File submenu. 
  23.  
  24.         3. Select Start timing to start playing the audio. 
  25.  
  26.         4. As the audio plays, select Advance line to scroll the text to match 
  27.            the audio. 
  28.  
  29.         5. Once the audio has completed, select Review to check the timing. 
  30.  
  31.         6. You may repeat steps 3 through 5 above until the timing is 
  32.            satisfactory. 
  33.  
  34.         7. If you wish to retime just a portion of the file, use the Audio 
  35.            position slider bars to locate the part you wish to retime, and then 
  36.            follow steps 3 through 5 
  37.  
  38.         8. Select Save as... from the File submenu to save the caption file. 
  39.  
  40.       To review an existing Caption file: 
  41.  
  42.         1. Choose an Audio file by selecting Open audio... in the File submenu. 
  43.  
  44.         2. Choose a Caption file by selecting Open captions... in the File 
  45.            submenu. 
  46.  
  47.         3. Use the Audio position or Text position slider bars to locate the 
  48.            portion of the file you wish to review. 
  49.  
  50.         4. Select Play to check the timing. 
  51.  
  52.       Select Start timing  to synchronize the text captions with the audio 
  53.       file.  The audio file will begin playing from its current position when 
  54.       this button is selected.  As the audio plays, select the Advance line 
  55.       button to scroll new caption lines into the text window. 
  56.  
  57.       Select Play to review a caption file.  While the audio plays, the 
  58.       captions scroll by in the text window just as they would in the target 
  59.       application. This function can be used to check the captioning just after 
  60.       its timing has been set with the Start timing function, or it can be used 
  61.       to review an existing Caption file. 
  62.  
  63.       Select Advance line to scroll a new line of text into the text window 
  64.       during the Start timing function.  The timing of the Advance line events 
  65.       will be stored for subsequent Play, Save and/or Save as... operations. 
  66.  
  67.       Select Pause to temporarily suspend a Start timing or Play operation 
  68.       before the audio has finished playing.  While the audio is paused, the 
  69.       indicator on the button will remain highlighted.  A paused operation may 
  70.       be subsequently resumed by selecting the Pause button again, or it can be 
  71.       terminated altogether by selecting Stop. 
  72.  
  73.       Select Stop to terminate a Start timing or Play operation before the 
  74.       audio has completed playing. 
  75.  
  76.       Adjust the audio volume to a comfortable level by using the Volume 
  77.       control. 
  78.  
  79.       The Audio position control provides a graphic display of the current 
  80.       position of the audio file.  To change the audio position, drag the 
  81.       slider bar or select the pushbuttons at the left end of the slider.  If 
  82.       there is caption text present in the text window, the program will adjust 
  83.       its position to match the new position of the audio file. 
  84.  
  85.       Select the File submenu to open or save the files used by the 
  86.       application. 
  87.  
  88.       Select the Open submenu to specify the Audio, Text or Caption file which 
  89.       you wish to open. 
  90.  
  91.       Select the Audio... menu item to specify the audio file which you wish to 
  92.       caption. You will be promped by a file dialog box showing only those 
  93.       files having an extension of WAV. 
  94.  
  95.       Select the Text... menu item to specify a text file which you want to use 
  96.       as captions for an audio file.  You will be prompted with a file dialog 
  97.       box showing all of the files in your system having the extension of TXT. 
  98.  
  99.       Select the Caption... menu item to specify a Caption file which was 
  100.       previously created by the Caption Creation Utility.  You will be prompted 
  101.       with a file dialog box showing all of the files in your system having the 
  102.       extension of _CC. 
  103.  
  104.       Select Save to save the current caption file. 
  105.  
  106.       Select Save as... to save a Caption file after you have timed and 
  107.       reviewed it.  Selecting  Save as... will allow you to choose a name for 
  108.       the file being saved. 
  109.  
  110.       Select the Exit menu item when you wish to exit the Caption Creation 
  111.       Utility. 
  112.  
  113.       Select the Options submenu to control how many caption lines are 
  114.       displayed in the text window. 
  115.  
  116.       Select the Caption lines menu item to select one of the menu items to 
  117.       control the number of lines of captioning displayed in the text window. A 
  118.       check mark appears to the left of the number which is currently selected. 
  119.  
  120.       Use the Help submenu to access the help information for this program. 
  121.  
  122.  
  123. ΓòÉΓòÉΓòÉ <hidden> Help for keys ΓòÉΓòÉΓòÉ
  124.  
  125.  Key       Function 
  126.  
  127.  Alt       Highlight menu items. 
  128.  
  129.  Arrows    Move to another menu item. 
  130.  
  131.  Enter     Select a control or a menu item. 
  132.  
  133.  Tab       Move from one dialog box control to another. 
  134.  
  135.  F1        Display help information for highlighted item. 
  136.  
  137.  F3        Exit the program. 
  138.  
  139.  A         Advance the text one line while setting timing. 
  140.  
  141.  Alt + A   Open an audio file. 
  142.  
  143.  Alt + C   Open a caption file. 
  144.  
  145.  E         Pause or resume the current operation. 
  146.  
  147.  P         Play the audio file while scrolling the captions. 
  148.  
  149.  R         Rewind the audio and caption files. 
  150.  
  151.  S         Stop the current operation. 
  152.  
  153.  Alt + S   Save the caption file which is currently open. 
  154.  
  155.  T         Start the timing operation. 
  156.  
  157.  Alt + T   Open a text file 
  158.  
  159.  Alt + V   Save captions under a selected name. 
  160.  
  161.  Alt + 2   Display two lines in the text window. 
  162.  
  163.  Alt + 3   Display three lines in the text window. 
  164.  
  165.  Alt + 4   Display four lines in the text window. 
  166.  
  167.  Alt + 5   Display five lines in the text window. 
  168.  
  169.  Alt + 6   Display six lines in the text window. 
  170.  
  171.  
  172. ΓòÉΓòÉΓòÉ <hidden> Help for Open Audio ΓòÉΓòÉΓòÉ
  173.  
  174. The Drive list box displays the drives on your system.  Select the drive that 
  175. contains the audio files you want to caption. 
  176.  
  177. The Directory list box displays the directories on the selected drive.  Select 
  178. a directory to display the list of files from that directory in the File list 
  179. box. 
  180.  
  181. Select an audio file from the File list box or type in a file name that you 
  182. want to caption. 
  183.  
  184. Select the OK pushbutton to load the selected audio file to caption and to 
  185. remove this pop-up window. 
  186.  
  187. Select the Cancel pushbutton to remove this pop-up window. 
  188.  
  189. Select the Help pushbutton to view this help panel. 
  190.  
  191.  
  192. ΓòÉΓòÉΓòÉ <hidden> Help for Open Text ΓòÉΓòÉΓòÉ
  193.  
  194. The Drive list box displays the drives on your system.  Select the drive that 
  195. contains the text files you want to use. 
  196.  
  197. The Directory list box displays the directories on the selected drive.  Select 
  198. a directory to display the list of files from that directory in the File list 
  199. box. 
  200.  
  201. Select a text or caption file from the File list or type in a file name that 
  202. you want to use. 
  203.  
  204. Select the OK pushbutton to load the selected file to use and to remove this 
  205. pop-up window. 
  206.  
  207. Select the Cancel pushbutton to remove this pop-up window. 
  208.  
  209. Select the Help pushbutton to view this help panel. 
  210.  
  211.  
  212. ΓòÉΓòÉΓòÉ <hidden> Help for Save Caption ΓòÉΓòÉΓòÉ
  213.  
  214. Type the name of the file you want to save in the File name field 
  215.  
  216. The program is preset to use the name of the audio file with the extension ._CC 
  217.  
  218. The Drive list displays the drives on your system.  Select the drive where you 
  219. want to save the caption file. 
  220.  
  221. Select the Save as pushbutton to save the caption data under the selected file 
  222. name. 
  223.  
  224. Select the Cancel pushbutton to remove this pop-up window. 
  225.  
  226. Select the Help pushbutton to view this help panel.