home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 35 Internet / 35-Internet.zip / webwav.zip / WAVPlay.txt < prev   
Text File  |  1996-04-12  |  8KB  |  205 lines
  1. ******************
  2. ** INSTRUCTIONS **
  3. ******************
  4.  
  5. The following are instrucions for setting up WAVPlayer for WebEx.
  6. Please make sure you have read and agree to the license agreement
  7. before using this program.
  8.  
  9.  
  10. INSTALLATION
  11. ============
  12.  
  13.  
  14. <SELECT LOCATION FOR PROGRAM FILES>
  15.  
  16. To install this program, simply create a directory (eg.: "C:\WebWAV"),
  17. copy all files contained in this package into that directory.
  18.  
  19.  
  20. <EDIT SYSTEM FILES>
  21.  
  22. Once you have copied the files into the directory of your choice, you
  23. must make sure the following references are added to your PATH and
  24. DPATH statements in your config.sys file:
  25.  
  26.         x:\WebWAV       <---- or whatever the drive and directory are named
  27.                                         that you installed the application in.
  28.  
  29.  
  30. <SET UP WEB EXPLORER TO USE THE BROWSER>
  31.  
  32. Start WebExplorer, select "Setup" then "Viewers". Choose .WAV file
  33. and type WAVPLAY.EXE for the viewer name. You may do the same
  34. thing with .MID and any other audio file OS/2 and MMPM/2 support
  35. on your system (inotherwords, if you have an OS/2 plug-in for .au files
  36. that allows you to use any of the IBM OS/2 players or system
  37. commands to play it, this program will take advantage of it and play
  38. that type of audio file). Close WebExplorer to allow the changes to be
  39. saved. Make sure you did not have multiple copies of WebExplorer
  40. running when you changed your WebExplorer settings and exited.
  41.  
  42.  
  43. <SHUTDOWN AND RESTART OS/2 FOR CHANGES TO TAKE EFFECT>
  44.  
  45. Once you have shut down OS/2 and reloaded it, you are ready to go.
  46. Wherever there is a link to a supported audio file, simply clicking
  47. on it will launch the Player.
  48.  
  49.  
  50. <ABOUT THE PROGRAM>
  51.  
  52. The program, through the use of OS/2 system services and APIs,
  53. plays any MMPM/2 supported audio file. Thus, by adding support
  54. for a new audio file, our player will be capable of playing
  55. it. It does not launch the WAV Player that comes with OS/2,
  56. nor take as long to work.
  57.  
  58. When you select a supported link, WebExplorer will load the file,
  59. pass it to the player (as a temp file in a format like "09x90900.WAV"
  60. or something similar. The player will launch and size itself to the
  61. top left of the screen, giving you 4 options:
  62.  
  63.         SAVE:           Saves the file where specified and exits
  64.                         back to WebExplorer.
  65.  
  66.         PLAY:           Plays the file and exits back to WebExplorer.
  67.  
  68.         SAVE n PLAY:    Launches a separate thread to play the
  69.                         audio file and simultaneously asks where you
  70.                         want it stored and named.
  71.  
  72.         EXIT:           Exit's with no action taken. The file will
  73.                         not be stored or played.
  74.  
  75.  
  76. <STOPPING THE FILE FROM PLAYING>
  77.  
  78. The play action may be stopped one of two different methods
  79. depending on the choice you pick to initiate play. If you
  80. choose "PLAY", you can stop play by closing the player window
  81. by double-clicking the close button on the top left of the player window.
  82.  
  83. If you choose "SAVE n PLAY", you must pull up your window
  84. list and shut down the player thread from there. "SAVE n PLAY"
  85. spawns a separate thread which we have named and added
  86. to the task list for this purpose. This method also works for
  87. the "PLAY" choice by selecting and stopping the main app
  88. from the window list.
  89.  
  90. <FILES DO NOT PLAY>
  91.  
  92. If a file does not play, generally the cause is the file is not
  93. supported by MMPM/2. If you have a third party player that supports
  94. the selected file, it does NOT make MMPM/2 enabled to support it.
  95. You need to have a plug-in codec either with it's own installation
  96. routine, or installed through the MMPM/2 installer to allow
  97. formats that were not supported with the base OS/2 product to be
  98. supported by our player.
  99.  
  100. Another cause is another process that is locking the sound card.
  101. Usually, in this case, the player will wait till the card is avaiable and
  102. play the file then. Usually, it is a WinApp or FastLoad or such.
  103.  
  104.  
  105. <ABOUT THE PROGRAM>
  106.  
  107. The program is re-entrant multitasking, multithreaded code
  108. (though part of the second thread is in an EXE file, it and it's
  109. shared code in the main process are spawned and maintained as a
  110. separate thread making calls to the same shared code in the DLL's).
  111. You may launch as many copies of it as you have resources to handle.
  112. The program does not share the sound card with other apps, though
  113. it is a simple change we are considering. It does work fine when other OS/2
  114. programs are using the sound card, though it will take over use to play
  115. the file and return use when finished. If more than one copy of the program
  116. are trying to play the file at the same time, whichever one has focus
  117. will play and the other will stop and wait.
  118.  
  119. The program will automatically exit when it has finished it's task. If
  120. you selected "PLAY" you will notice this as the program shuts down
  121. and returns focus to WebExplorer or whatever app called it. If you
  122. selected "SAVE n PLAY", it will close the main window and let
  123. the thread close itself when playing is complete. The thread was
  124. dependent on the main process that called it, but we preferred this
  125. way, allowing a thread to be spawned to request, initiate and start
  126. the multimedia controls required, load the secondary player and
  127. pass the file info to it. The main process is calling the file dialog
  128. box and waits for an entry to save the file. This does not affect
  129. the player thread or secondary program.
  130.  
  131. While the program is playing the audio file, you have full usage
  132. of the WebExplorer and may continue to browse through the web
  133. or even start other audio files loading. So far, we havent hit
  134. on a limit to the number of open players you may have.
  135.  
  136.  
  137. <REASON FOR THIS PROGRAM>
  138.  
  139. We wrote this program for internal use and initially had it set
  140. up to load minimized (we created and registered a window and
  141. it's classes to allow an errant process to be shut down
  142. from the task list) and play the file and exit. One of the
  143. employees (Matt), in his enthusiam to make this difficult
  144. for what was supposed to be a ten minute app, suggested
  145. (annoyed the heck out of till I agreed??) that I add a SAVE
  146. capability and a PLAY button, hence it's current format.
  147.  
  148. This program was written for internal use only as we were
  149. quite tired of waiting for OS/2's Audio Player to load, load
  150. the file, and then play it, wait for us to select exit, wait
  151. for it to shut down, etc, etc...
  152.  
  153. Eventually (within 10 minutes of completion) we figured if
  154. this might be of interest to someone else and of any use,
  155. we might as well make it available for everyone. So, here
  156. it is!
  157.  
  158.  
  159. <ABOUT CYBERCOM>
  160.  
  161. CYBERCOM is an OS/2 and computer (hardware and software)
  162. consulting company. We write custom OS/2 apps, do OS/2
  163. networking, installations and upgrades. We also are staffed with
  164. A+ Certified Service Technicians (certified for/by Compaq,
  165. HP, IBM, Toshiba, Acer, CompUSA/Compudyne and many others).
  166. Most of our employees are TeamOS/2 members and
  167. CYBERCOM is a pending IBM BESTeam member.
  168.  
  169. Our current main programming project (non-Web related) is
  170. an accounting package designed from the ground up for OS/2,
  171. fully exploiting the following OS/2 technologies:
  172.  
  173.         Top tabs (Lotus infobox style)
  174.         VoiceType Dictation and control
  175.         Multiple threads
  176.         Multiple printer usage and network printer support
  177.         Multimedia usage for various parts of the application
  178.                 (such as "walk-through" help)
  179.         Full integration with the WPS and fully object
  180.                 oriented interface
  181.  
  182. The application will also provide many of the features found
  183. in it's WinXX counterparts, along with other features (some mentioned
  184. above) that cannot be easily or usably implemented
  185. on their 16bit OS platforms.
  186.  
  187.  
  188.  
  189. CYBERCOM is located in Virginia and can be reached by email at:
  190.  
  191.         cybercom@erols.com
  192.  
  193.  
  194. Please drop us a line and let us know whether the WAV program
  195. is of any use to you - also feel free to comment on our other projects
  196. or any other programs you would like to see us write.
  197.  
  198.  
  199. This document (c) 1996 CYBERCOM
  200.  
  201. WAVPlayer for WebEx     (c) 1996 CYBERCOM and
  202.                         (c) 1995-1996 OnLine Data. All rights reserved.
  203.  
  204.  
  205.