home *** CD-ROM | disk | FTP | other *** search
/ CD Actual 24 / CDACTUAL24.iso / SHARE / os2 / sound / SOUND.HLP (.txt) < prev    next >
Encoding:
OS/2 Help File  |  1997-02-08  |  16.2 KB  |  450 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. About the Sound Scheme Editor ΓòÉΓòÉΓòÉ
  3.  
  4. IBM's Warp 4.0(aka Merlin) expanded on the system event sounds available in 
  5. previous versions of OS/2 by allowing the user to select entire sets of system 
  6. sounds at once. These sound collections are called Sound Schemes and allow the 
  7. user to easily switch between a variety of sound configurations. Warp 4.0 comes 
  8. with four sound schemes to choose from: "Desktop", "Garden", "Ocean" and 
  9. "Space". 
  10.  
  11. Unfortunately, Warp provides no means to create additional sound schemes or to 
  12. edit the existing ones. As interesting as the supplied shemes may be, none of 
  13. them suited me. Of course I could still set my system sounds individually, but 
  14. having had a taste of the quick changes the sound schemes allowed, that was no 
  15. longer satisfactory. 
  16.  
  17. The result was the Sound Scheme Editor. The program was initially written to 
  18. allow the user to add/edit/delete sound schemes but was later enhanced to 
  19. enable entire schemes to be exported and imported and to compensate for an 
  20. apparent MMOS/2 installation bug. 
  21.  
  22. The one major limitation to the program is that while it will edit sound 
  23. schemes it will not apply them. To make a sound scheme active the user go to 
  24. the sound properties Scheme page and apply the new sound scheme. As far as I 
  25. can tell, there is no way for me to do this from within Sound Scheme Editor. If 
  26. anyone knows otherwise, tell me how and I'll add it. 
  27.  
  28. I hope you find the program helpful and easy to use. The program is freeware so 
  29. you don't have to feel guilty for using it. Suggestions for enhancements are 
  30. welcome(but no guarantees). 
  31.  
  32.  
  33. ΓòÉΓòÉΓòÉ 2. The Main Window ΓòÉΓòÉΓòÉ
  34.  
  35. The following section describes Sound Scheme Editor's main window. 
  36.  
  37.    1. The Menu 
  38.  
  39.    2. The Named Sound Scheme listbox 
  40.  
  41.    3. The Files listbox 
  42.  
  43.    4. The Load Current Scheme button 
  44.  
  45.    5. The Stop Playing button 
  46.  
  47.  
  48. ΓòÉΓòÉΓòÉ 2.1. The Menu ΓòÉΓòÉΓòÉ
  49.  
  50. The main menu contains the following choices: 
  51.  
  52.    1. File 
  53.  
  54.    2. System 
  55.  
  56.    3. Help 
  57.  
  58.  
  59. ΓòÉΓòÉΓòÉ 2.1.1. File ΓòÉΓòÉΓòÉ
  60.  
  61. The File menu contains the following choices: 
  62.  
  63.    1. Add 
  64.  
  65.    2. Replace 
  66.  
  67.    3. Delete 
  68.  
  69.    4. Import 
  70.  
  71.    5. Export 
  72.  
  73.  
  74. ΓòÉΓòÉΓòÉ 2.1.1.1. Add ΓòÉΓòÉΓòÉ
  75.  
  76. The Add menu option allows the user to add a new sound scheme to the system. 
  77. This option will not allow you to add a sound scheme with the same name as an 
  78. existing sound scheme. The system INI file will be updated to contain the new 
  79. scheme. 
  80.  
  81. The set of sounds displayed in the Display Box can optionally be copied into a 
  82. directory below the MMOS2\SOUNDS directory with the same name as the sound 
  83. scheme. If this option is chosen sound schemes with names longer than eight 
  84. characters will be saved in a directory whose name is that of the sound scheme 
  85. except that on FAT file systems the directory name will be truncated to eight 
  86. characters. This could cause files to be overwritten if another sound scheme 
  87. exists with a similar name. 
  88.  
  89.  
  90. ΓòÉΓòÉΓòÉ 2.1.1.2. Replace ΓòÉΓòÉΓòÉ
  91.  
  92. The Replace menu option allows the user to change the definition of a currently 
  93. existing sound scheme. The set of sounds displayed in the Display Box will be 
  94. used to replace the existing sounds. 
  95.  
  96. The user will be warned that an existing sound scheme is about to be altered. 
  97.  
  98.  
  99. ΓòÉΓòÉΓòÉ 2.1.1.3. Delete ΓòÉΓòÉΓòÉ
  100.  
  101. The Delete menu option allows the user to remove existing sound schemes from 
  102. the system. No files are deleted; only the system INI file is updated to 
  103. reflect the change. 
  104.  
  105. The user will be warned that an existing sound scheme is about to be deleted. 
  106.  
  107.  
  108. ΓòÉΓòÉΓòÉ 2.1.1.4. Import ΓòÉΓòÉΓòÉ
  109.  
  110. The Import menu option allows the user to import a collection of sound files 
  111. previously saved with the Export menu option into a new sound scheme. The 
  112. behavior is simlilar to the Add menu option except that the user is supplied 
  113. with a default sound scheme name which may be changed if desired. 
  114.  
  115.  
  116. ΓòÉΓòÉΓòÉ 2.1.1.5. Export ΓòÉΓòÉΓòÉ
  117.  
  118. The Export menu option allows the user to export an existing sound scheme into 
  119. a single file containing the sound files, their names and the name of the sound 
  120. scheme. The sound scheme selected in the Sound Scheme Listbox will be the one 
  121. exported, not the sounds shown in the Display Box. 
  122.  
  123. The resulting file may then be imported by other users. A word of warning, this 
  124. file may be quite large and the user is advised compress the file before 
  125. uploading it for distribution. 
  126.  
  127.  
  128. ΓòÉΓòÉΓòÉ 2.1.2. System ΓòÉΓòÉΓòÉ
  129.  
  130. The System menu contains the following choices: 
  131.  
  132.    1. Load Current 
  133.  
  134.    2. Stop Playing 
  135.  
  136.    3. Create Icon 
  137.  
  138.    4. Remap Drives 
  139.  
  140.  
  141. ΓòÉΓòÉΓòÉ 2.1.2.1. Load Current ΓòÉΓòÉΓòÉ
  142.  
  143. The Load Current menu option will populate the Display Box with the currently 
  144. active sound scheme. If changes have been made to the sounds in the Display Box 
  145. the user will be warned that unsaved changes will be lost. 
  146.  
  147.  
  148. ΓòÉΓòÉΓòÉ 2.1.2.2. Stop Playing ΓòÉΓòÉΓòÉ
  149.  
  150. The Stop Playing menu option allows the user to stop the currently playing 
  151. sound file. Normally this will not be necessary since playing a new sound 
  152. interrupts the current one. 
  153.  
  154.  
  155. ΓòÉΓòÉΓòÉ 2.1.2.3. Create Icon ΓòÉΓòÉΓòÉ
  156.  
  157. The Create Icon menu option will create a program icon on the desktop to run 
  158. Sound Scheme Editor. 
  159.  
  160. It is assumed that all files from the distribution zip file are present and 
  161. have their original names. 
  162.  
  163.  
  164. ΓòÉΓòÉΓòÉ 2.1.2.4. Remap Drives ΓòÉΓòÉΓòÉ
  165.  
  166. The Remap Drives menu option is used to compensate for an apparent bug in the 
  167. MMOS/2 installation procedure. Most users will never use it and those that do 
  168. need only use it once. 
  169.  
  170.  
  171. ΓòÉΓòÉΓòÉ 2.1.3. Help ΓòÉΓòÉΓòÉ
  172.  
  173. The Help menu contains the following choices: 
  174.  
  175.    1. Table Of Contents 
  176.  
  177.    2. General Help 
  178.  
  179.    3. Product Information 
  180.  
  181.  
  182. ΓòÉΓòÉΓòÉ 2.1.3.1. Table Of Contents ΓòÉΓòÉΓòÉ
  183.  
  184. The Table Of Contents menu option brings up the table of contents for the Sound 
  185. Scheme Editor help file. 
  186.  
  187.  
  188. ΓòÉΓòÉΓòÉ 2.1.3.2. General Help ΓòÉΓòÉΓòÉ
  189.  
  190. The General Help menu option brings up the Sound Scheme Editor help file. 
  191.  
  192.  
  193. ΓòÉΓòÉΓòÉ 2.1.3.3. Product Information ΓòÉΓòÉΓòÉ
  194.  
  195. The Product Information menu option displays the title and version number of 
  196. this software. 
  197.  
  198. In addition, the author's name and contact information can be found there. 
  199.  
  200.  
  201. ΓòÉΓòÉΓòÉ 2.2. The Named Sound Scheme listbox ΓòÉΓòÉΓòÉ
  202.  
  203. The listbox on the left side of the main window displays a list of all of the 
  204. named sound schemes installed in the system. The highlighted sound scheme may 
  205. be replaced, deleted or exported using the appropriate menu selections. 
  206.  
  207. In addition, double-clicking on an entry in the listbox will replace the files 
  208. in the display box with the files defined by the selected named sound scheme. 
  209. If the files in the display box have been changed but have not been saved by 
  210. either adding or replacing a sound scheme the user will be warned that changes 
  211. will be lost. 
  212.  
  213. The named sound scheme listbox is updated immediately when a scheme is added, 
  214. deleted or imported. 
  215.  
  216.  
  217. ΓòÉΓòÉΓòÉ 2.3. The Files listbox ΓòÉΓòÉΓòÉ
  218.  
  219. The listbox on the right side of the main window is used to select or play 
  220. sound files and to navigate to directories and drives. 
  221.  
  222. The entry <None> or a wave file can be dragged to an entry field in the display 
  223. box to change a system sound. Dragging <None> causes the corresponding system 
  224. sound to be silent. 
  225.  
  226. In addition, the user may double-click a wave file to play it or may 
  227. double-click a directory or drive entry to change to that directory or drive. 
  228.  
  229.  
  230. ΓòÉΓòÉΓòÉ 2.4. The Load Current Scheme button ΓòÉΓòÉΓòÉ
  231.  
  232. The Load Current Scheme button is identical in function to the Load Current 
  233. menu option. 
  234.  
  235. It will populate the Display Box with the currently active sound scheme. If 
  236. changes have been made to the sounds in the Display Box the user will be warned 
  237. that unsaved changes will be lost. 
  238.  
  239.  
  240. ΓòÉΓòÉΓòÉ 2.5. The Stop Playing button ΓòÉΓòÉΓòÉ
  241.  
  242. The Stop Playing button is identical in function to the Stop Playing menu 
  243. option. 
  244.  
  245. It allows the user to stop the currently playing sound file. 
  246.  
  247.  
  248. ΓòÉΓòÉΓòÉ 3. The Display Box ΓòÉΓòÉΓòÉ
  249.  
  250. The following section describes Sound Scheme Editor's sound file display box. 
  251.  
  252.  
  253. ΓòÉΓòÉΓòÉ 3.1. Sound Scheme Display Box ΓòÉΓòÉΓòÉ
  254.  
  255. The second window in Sound Scheme Editor is used to display and set system 
  256. sounds. The display fields contain the filespec for the wave file assigned to 
  257. the corresponding system sound or the entry <None> if the system sound is 
  258. silent. 
  259.  
  260. On startup the fields are valued with the currently active system sounds. The 
  261. values may be changed all at once by loading a scheme by double-clicking on the 
  262. Named Sound Scheme listbox, selecting the Load Current menu option or selecting 
  263. the Load Current Scheme button. 
  264.  
  265. Alternately, and more importantly, the entry fields may be changed individually 
  266. by dragging a file from the Files listbox, from another entry field on the 
  267. Display Box window, from a directory folder or from a PM drag and drop enabled 
  268. file manager. 
  269.  
  270. The files from this window are used as the source for the Add menu option. 
  271.  
  272.  
  273. ΓòÉΓòÉΓòÉ 4. MMOS/2 Installation Bug ΓòÉΓòÉΓòÉ
  274.  
  275. The installation process for OS/2 4.0's MMOS/2 has a bug. Most users will 
  276. probably never encounter it but for the rest of us it is a pain. If MMOS/2 is 
  277. installed on a drive other than the OS/2 boot drive, the paths for the named 
  278. sound schemes' files incorrectly reference the boot drive instead of the drive 
  279. where MMOS/2 was installed. 
  280.  
  281. Specifically, in my case, I installed OS/2 on the F: drive and MMOS/2 on the G: 
  282. drive. When I started the system all seemed fine. All of my system sounds 
  283. worked just like always. However, when I used the sound settings page to apply 
  284. a new scheme, all system sounds disappeared. It turned out that the files were 
  285. pathed to F:\MMOS2\SOUNDS\... instead of G:\MMOS2\SOUNDS\... 
  286.  
  287. A little poking around led me to the INI file entries I had to edit to correct 
  288. the problem and that was that. Later, after I had released my Sound Scheme 
  289. Editor program I saw messages from others complaining about the same problem so 
  290. I added a feature to the program to correct the error. 
  291.  
  292. If the user selects the Remap Drives menu option the program will search the 
  293. named sound schemes for paths referencing MMOS/2 on drives other than the one 
  294. pointed to by the MMBASE environment variable and if it finds any will change 
  295. the drive letter in the path appropriately. 
  296.  
  297. A small warning about this: if the MMOS2 directory exists on multiple drives 
  298. and the sound file is meant to be played from that directory tree, Sound Scheme 
  299. Editor will incorrectly change the path to point to the drive named by MMBASE. 
  300.  
  301.  
  302. ΓòÉΓòÉΓòÉ 5. Sound Scheme details ΓòÉΓòÉΓòÉ
  303.  
  304. Each named sound scheme consists of a collection of up to thirteen sound files, 
  305. each of which is associated with a system event. Any or all of the system 
  306. events may be defined as silent in which case no sound file is assigned to the 
  307. event. 
  308.  
  309. The default named sound schemes reside in subdirectories of the \MMOS2\SOUNDS 
  310. directory on the drive specified by the MMBASE environment variable. It is not, 
  311. however, necessary that the files be at that location. For consistancies sake I 
  312. have chosen to make Sound Scheme Editor place the schemes it adds there. 
  313.  
  314. The OS2SYS.INI file contains an application named PM_SOUND_SCHEMES_LIST which 
  315. is used by MMOS2 to access the named sound schemes. It contains keys who's 
  316. values are the application names for the individual sound schemes. 
  317.  
  318. For example, if a system has two sound schemes named "One" and "Two", 
  319. PM_SOUND_SCHEMES_LIST would have two keys named One and Two with values of 
  320. PM_SOUNDS_ONE and PM_SOUNDS_TWO respectively. 
  321.  
  322. In addition, the OS2SYS.INI file would contain two applications named 
  323. PM_SOUNDS_ONE and PM_SOUNDS_TWO. The application PM_SOUNDS_ONE would have 
  324. thirteen keys with the names 0 through 12. Each of the keys has a fully 
  325. qualified filename or the literal "<None>" as a value. The application 
  326. PM_SOUNDS_TWO would have the same format(though presumably different files as 
  327. key values). 
  328.  
  329. Note: if you use rexx to create OS2SYS.INI file entries for sound schemes, you 
  330. must make sure that null terminators are added to each key value as it is 
  331. inserted. Rexx will not do this automatically and the inserted scheme will not 
  332. work otherwise. 
  333.  
  334.  
  335. ΓòÉΓòÉΓòÉ 6. Import/Export file format ΓòÉΓòÉΓòÉ
  336.  
  337. The import/export file used by Sound Scheme Editor is quite simple. You could 
  338. figure it out easily but I'll save any interested parties the trouble. 
  339.  
  340. The file consists of the null terminated scheme name followed by the 
  341. specifications of each of the thirteen sounds. The file specification consists 
  342. of the null terminated file name followed by the a null terminated ascii 
  343. representation of the file size followed by the wave file data. The exception 
  344. to this file specification is that the literal "<None>" will be in the place of 
  345. the name when there is no sound for the system event. In this event, there will 
  346. be no size information or file data. 
  347.  
  348. In versions of Sound Scheme Editor prior to v1.4 import and export did not 
  349. handle silent system events properly. 
  350.  
  351.  
  352. ΓòÉΓòÉΓòÉ 7. Release Notes ΓòÉΓòÉΓòÉ
  353.  
  354. v1.6 
  355.  
  356.      Fixed a bug adding a sound scheme which contained silent sounds. 
  357.      Fixed a bug that prevented Sound Scheme Editor from playing wave files 
  358.       with names containing a space character. 
  359.  
  360.  v1.5 
  361.  
  362.      Added popup menus to display box, sound scheme list and files list. 
  363.      Added "<None>" to display box popup menu so the user need not drag the 
  364.       "<None>" item from the files listbox to silence a system event. 
  365.      Added sort by none/name/size capability to the files listbox. 
  366.      Added menu option to create an icon to run the program. 
  367.      Adjusted field sizes for display on 1280x1024 screens. 
  368.      Attempted to fix bug where saving a sound scheme with a blank entry 
  369.       crashed the program. I don't know if this was successful since I can't 
  370.       recreate it but I read a review of the software that mentioned the 
  371.       problem. If the problem persists, someone get back to me about it, 
  372.       please. 
  373.  
  374.  v1.4 
  375.  
  376.      Added context sensitive online help. 
  377.      Corrected the importing and exporting of sound schemes containing silent 
  378.       system events. 
  379.      Added the option to copy the sound files to the \MMOS2\SOUNDS directory 
  380.       tree when adding or replacing sound schemes. 
  381.  
  382.  v1.3 
  383.  
  384.      Added sound scheme import and export functionality. 
  385.      Added warnings if the user attempts to exit or load a sound scheme 
  386.       without saving changes made to the files in the Sound Scheme Display Box. 
  387.  
  388.  v1.2 
  389.  
  390.      Added function to remap sound schemes to the drive specified by the 
  391.       MMBASE environment variable. 
  392.  
  393.  v1.1 
  394.  
  395.      Added the capability to stop a file that is currently playing. 
  396.      Added "<None>" to the files listbox so a system event could be made 
  397.       silent. 
  398.  
  399.  v1.0 
  400.  
  401.      Initial release of Sound Scheme Editor. 
  402.  
  403.  
  404. ΓòÉΓòÉΓòÉ <hidden> Continue ΓòÉΓòÉΓòÉ
  405.  
  406. Select Continue to remap sound scheme files to the drive specified in the 
  407. MMBASE environment variable. 
  408.  
  409. See MMOS/2 installation bug. 
  410.  
  411.  
  412. ΓòÉΓòÉΓòÉ <hidden> Cancel ΓòÉΓòÉΓòÉ
  413.  
  414. Select Cancel to avoid remapping sound scheme files to the drive specified in 
  415. the MMBASE environment variable. 
  416.  
  417. See MMOS/2 installation bug. 
  418.  
  419.  
  420. ΓòÉΓòÉΓòÉ <hidden> Suggested Import Scheme Name ΓòÉΓòÉΓòÉ
  421.  
  422. This field displays the name of the sound scheme supplied by the user who 
  423. originally exported it. 
  424.  
  425.  
  426. ΓòÉΓòÉΓòÉ <hidden> Import Scheme Name ΓòÉΓòÉΓòÉ
  427.  
  428. This field displays the name which will be assigned to the imported sound 
  429. scheme. This value may be changed by the user. 
  430.  
  431.  
  432. ΓòÉΓòÉΓòÉ <hidden> Import ΓòÉΓòÉΓòÉ
  433.  
  434. Select Import to import the sound scheme using the name displayed above. 
  435.  
  436.  
  437. ΓòÉΓòÉΓòÉ <hidden> Cancel ΓòÉΓòÉΓòÉ
  438.  
  439. Select Cancel to cancel the sound scheme import. 
  440.  
  441.  
  442. ΓòÉΓòÉΓòÉ <hidden> Export Scheme Name ΓòÉΓòÉΓòÉ
  443.  
  444. This field contains the name of the sound scheme being exported. 
  445.  
  446.  
  447. ΓòÉΓòÉΓòÉ <hidden> Export File Name ΓòÉΓòÉΓòÉ
  448.  
  449. This field contains the name of the file to which the sound scheme is being 
  450. saved.