home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 3 / PDCD_3.iso / utilities / utilss / soundconv / !SoundCon / !Help < prev    next >
Text File  |  1995-04-17  |  15KB  |  339 lines
  1.                                   S o u n d C o n
  2.                                  =================
  3.                               version 1.41,  17-04-95
  4.                                   by Rick Hudson
  5.  
  6.  
  7. This software is FreeWare. It must only be distrubuted in its original form.
  8. The PlaySample module is also FreeWare and can be used in other applications
  9. but you must obtain my permission if you wish to distribute it separately
  10. from SoundCon.
  11.  
  12.  
  13.  
  14. Summary
  15. =======
  16.  
  17. SoundCon is an application for basic sound sample format conversion on the
  18. Archimedes. It can read and write samples in a variety of formats common on
  19. various computer platforms and can directly playback most the formats it can
  20. read (without converting it first). An important feature of SoundCon is that
  21. all processing and playback is done from disc meaning that the only memory
  22. required is for the application itself and there is no limit to the sample
  23. size.
  24.  
  25. As of version 1.40 SoundCon can respond to render requests from ArcWeb so
  26. that WWW sounds can be played by just clicking on them.
  27.  
  28.  
  29. Other documentation
  30. ===================
  31.  
  32. The Docs directory within !SoundCon conatins further information on the
  33. PlaySample module and the various sound formats supported. The latter
  34. contains format descriptions, what sub-formats are and aren't supported and
  35. which ones can be played without conversion.
  36.  
  37. Interactive help is supported. Theoretically, you should be able to stop
  38. reading this now and use that.
  39.  
  40.  
  41. Supported formats
  42. =================
  43.  
  44.    Major formats       sub-formats
  45.  
  46.    Audio IFF           8/16 bit, mono/stereo
  47.    Armadeus            n/a
  48.    ARMovie (read only) 8/16 bit, (un)signed linear, VIDC, mono/stereo
  49.    Sun Audio           8 bit µ-law, 8 bit lin, 16 bit lin, mono/stereo
  50.    AudioWorks          8/16 bit (un)signed, µ-law, VIDC, mono/stereo
  51.    IFF/8SVX            n/a
  52.    VOC                 n/a
  53.    Voice modules       4 volume modes, fixed/var frequency, voice/transient
  54.    RIFF WAVE           8/16 bit PCM, µ-law, MS ADPCM, DVI ADPCM, mono/stereo
  55.    Raw data            8/16 bit, (un)signed linear, µ-law, VIDC, mono/stereo
  56.  
  57. For more information on these formats see the file Docs.Formats which
  58. describes in more details what the formats can support and what the menu
  59. sub-options do.
  60.  
  61.  
  62.                                ==============
  63.                                Using SoundCon
  64.                                ==============
  65.  
  66. Loading a sample:
  67. ================
  68.  
  69. SoundCon is sample converter so it can't do anything until you give a
  70. sample. Drag a file onto the icon bar icon or any of it's windows to 'open'
  71. the sample. The settings of the preferences may cause some actions to happen
  72. automatically at this point (see later) but the default is not do anything
  73. except open the sample information window (click select on the icon bar icon
  74. to open it if you need to). This window displays information about the file
  75. loaded. If the format is not recognised (or a recognisable format is
  76. unsupported - WAVEs have several such formats) then an error message is
  77. reported and sample is loaded as raw data.
  78.  
  79.  
  80. Changing the interpretation:
  81. ===========================
  82.  
  83. Recognised formats will not usually have to be fiddled with but raw data
  84. will probably have to have the interpretation of the data changed to make
  85. it sound right - this is largely a trial and error process.
  86.  
  87. At the bottom of the sample info window (click on Toggle Size or scroll
  88. down) there is the interpretation format and frequency - use the pop-up
  89. menus to change these. The format selections are summarised by interactive
  90. help (if your version of RISC OS isn't too old) and described in more detail
  91. in the file docs.Formats.
  92.  
  93. The interpretation frequency set how many sample frames per second to
  94. assume. A sample frame is the samples on all channels at any given point and
  95. so frames per second means samples per channel per second. The menu provides
  96. a list of common frequencies as well as a writable entry for other
  97. frequencies.
  98.  
  99.  
  100. Listening to the sample
  101. =======================
  102.  
  103. The playback control window can be opened by clicking Adjust on the icon bar
  104. icon, clicking Adjust in the sample info window or by selecting the menu
  105. item in the sample info window or icon bar menus. The sample will be played
  106. based on the format and frequency set in the Interpret As section of the
  107. sample info window. An exception to this are samples that cannot be
  108. interpreted as raw data by SoundCon (ADPCM and Audioworks formats) which can
  109. only be played in their original format.
  110.  
  111. The CD-style buttons control the playback and their use should be obvious.
  112. The slider marking the sample progress can be dragged around as an
  113. alternative to setting the sample position with the cue and rewind buttons.
  114.  
  115. The volume slider controls the volume and the speaker button toggles the
  116. speaker on and off (as if that wasn't obvious). If the volume is changed or
  117. the speaker toggled from another application then SoundCon updates the
  118. volume slider and speaker button automatically. Note though that the volume
  119. is independant of the normal system volume so other system-volume
  120. controllers will have no effect.
  121.  
  122. Note that the ADPCM play routines are quite CPU intensive (since they
  123. decompress on the fly) and the sound quality will probably suffer when
  124. interrupts are used heavily (eg lots of disc activity).
  125.  
  126.  
  127. Converting the sample to another format
  128. =======================================
  129.  
  130. Open the conversion window from the info window or icon bar menus. The
  131. current destination format is shown with the usual elements of a save box.
  132. Change the format, sample rate and filename (if current settings are not
  133. suitable) and drag the icon to where you want the new sample to be or click
  134. OK/press Return if a complete path is already present. The conversion
  135. progress window will open and the conversion will occur in the background.
  136. The conversion can be paused if you need the computer to be more responsive
  137. for a while or aborted by clicking the appropriate button.
  138.  
  139. The filename initially present in the convert window will depend on the
  140. preferences (see Preferences for options).
  141.  
  142. The conversion produces a sample (in the specified format) so that playing
  143. it at the speed set in the 'Rate' box will sound the same as the original
  144. sample played at the speed set the 'Frequency' box of the 'Interpret As'
  145. section. That is, the sample is resampled at the new frequency. If the
  146. frequencies are different then new samples are generated by linearly
  147. interpolating between the original samples.
  148.  
  149. See the file Docs.Formats for a description of the supported formats and
  150. their sub formats.
  151.  
  152.  
  153. Preferences
  154. ===========
  155.  
  156. Default Conversion format: This controls what output format will initially
  157. be in the conversion save box when the program is loaded. This format may
  158. also be set on loading a new sample (see Auto Load Actions below). The
  159. effect of these settings is described in 'Converting a sample' above.
  160.  
  161. Interpret Unknown As: When an unrecogised sample is loaded, the data will be
  162. initially interpreted according the settings in this box. The pop-up menus
  163. are identical to those for the Interpret As part of the info window (see
  164. 'Changing The Interpretation' above).
  165.  
  166. Auto Actions On Load: Any combination (including none) of the following
  167. actions are performed when a new sample is opened.
  168.  
  169.   - Open info window: The window displaying the information on the sample is
  170.     opened.
  171.  
  172.   - Open convert window: The conversion/save window is opened.
  173.  
  174.   - Open play window: The play control window is opened.
  175.  
  176.   - Default format: The format and frequency used for the output sample is
  177.     set from the Default Conversion Format part of the preferences.
  178.  
  179.   - Convert: The conversion process is started using the format and filename
  180.     determined from other preference settings.
  181.  
  182.   - Play: The sample is played back.
  183.  
  184. If either convert or play (or both) are selected then the sample is cleared
  185. after their respective operation has completed to allow the next queued
  186. sample to be processed automatically. If convert AND play are selected then
  187. the sample is cleared after both have finished.
  188.  
  189. Sound: This section specifies how to set up the sound system on loading
  190. SoundCon:
  191.  
  192.   - Set