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