home *** CD-ROM | disk | FTP | other *** search
/ ARM Club 3 / TheARMClub_PDCD3.iso / hensa / sound / a157_1 / fplay_doc < prev   
Text File  |  1993-05-26  |  8KB  |  233 lines
  1. Readme for FPlay v1.43 by Frank van de Pol
  2. ==========================================
  3.  
  4. 26 May 1992
  5.  
  6.  
  7.  
  8. Description
  9. ===========
  10.  
  11. FPlay is a utility that allows you to play huge sound samples directly
  12. from disc. To cope with small pauses in disc transfer (seek times) all
  13. data is buffered in RAM. Using a optimised buffering scheme, it is
  14. possible to play 20.833 kHz samples even from floppy disc.
  15.  
  16. The maximum size is currently restricted to 4 giga byte (if the filing
  17. system permits). This yields in a sampling time of over 57 hours using
  18. 20.833 kHz sampling frequency (the standard on the archimedes).
  19.  
  20. To provide a decent quality when using low sample rates, it is possible
  21. to use oversampling with linear interpolation. This makes the sound
  22. quality of 8 kHz speech (or even music) samples quite acceptable 
  23. (contrary to !Armadeus). This option is very useful if you have an
  24. external amplifier connected to the unfiltered sound output of the
  25. archimedes (thus bypassing the low-pass filter), to reduce the 
  26. harshness of the sound (caused by intermodulation).
  27.  
  28.  
  29.  
  30. Disclaimer
  31. ==========
  32.  
  33. The author will not be liable for any damage, loss of profits,
  34. goodwill or for any indirect or consequential loss arising out of
  35. your use of this application, or your inability to use it, even if
  36. the author has been advised of the possibility of such loss.
  37.  
  38. All efforts have been made to ensure the accuracy of the application.
  39. However, should any errors be detected, the author would greatly
  40. appreciate being informed of them. The above notwithstanding, the
  41. authors can assume no responsibility for any errors.
  42.  
  43.  
  44.  
  45. Copyright notice 
  46. ================
  47.  
  48. The FPlay utility is copyright © 1992,1993 of Frank van de Pol.
  49.  
  50. You may freely copy and use this program under the following
  51. conditions:
  52.  
  53.  
  54.  1. You can GIVE this package to anyone you like, if and only if it
  55.     is distributed with all original files and with no changes made
  56.     to it.
  57.  
  58.  2. If you want to put it on a BBS, include it in a PD library, or
  59.     store it at a FTP site you can do so, taking these notices into
  60.     account. You may not charge any money for it, apart from postage
  61.     and storage medium costs.
  62.  
  63.  3. The entire package remains copyright of Frank van de Pol under 
  64.     all circumstances. The copyright is NOT transferable.
  65.  
  66.     
  67.  
  68. Installation
  69. ============
  70.  
  71. For practical use, you should place the utility in a directory that
  72. is in the Run$Path. Normally this will be the $.library directory on
  73. the current filing system. 
  74.  
  75. If you find it convenient to let FPlay playback your samples when they
  76. will be double-clicked, you should set the following system variables:
  77.  
  78.     Set alias$@RunType_D3C FPlay -armadeus -file %0 
  79.     Set alias$@RunType_DF9 FPlay -start &1F0 -file %0 
  80.  
  81.  
  82.  
  83. Usage
  84. =====
  85.  
  86. FPlay can be controlled from the command line (*commands). Simply 
  87. typing FPlay results in FPlay displaying it syntax:
  88.  
  89.     FilePlayer v 1.43 - (C) 26 May 1992 by F.K.W. van de Pol
  90.  
  91.     Syntax: FPlay <Keywords>
  92.  
  93.     Keywords are:
  94.       -file         [filename]
  95.       -rate / -us   [samplerate in µs]         default=48
  96.       -unsigned
  97.       -buffers      [number of buffers]        default=4
  98.       -buffersize   [buffersize in bytes]      default=4096
  99.       -start        [offset in file in bytes]
  100.       -oversampling [1, 2, 4 or 8 times]       default=1
  101.       -armadeus     [play armadeus format]
  102.       -ulaw         [play ulaw format]
  103.  
  104.  
  105.   Keyword 'file'         : This keyword specifies which file should be
  106.                            played. If the filename is the first para-
  107.                            meter, it can be omitted.
  108.  
  109.   Keyword 'rate'         : Use '-rate' to set the sampling rate ie. the
  110.                            time between two samples expressed in micro
  111.                            seconds. This equals to 1E6/sampling_freq.
  112.   
  113.   Keyword 'us'           : This has the same effect as the 'rate' 
  114.                            keyword.
  115.  
  116.   Keyword 'unsigned'     : Specify this flag if the samples are stored
  117.                            in the unsigned format. As archimedes
  118.                            samples are normally stored in signed format,
  119.                            this flag is rarely used.
  120.   
  121.   Keyword 'buffers'      : This specifies the number of buffers in use.
  122.   
  123.   Keyword 'buffersize'   : This specifies the number of bytes per 
  124.                            buffer. The optimum value of the number of
  125.                            buffers and the buffersize depend on the
  126.                            seek time and data transfer rate of the
  127.                            drive used. If the playback is not smooth
  128.                            (small bits of silence while playing), you
  129.                            should experiment with these values.
  130.   
  131.   Keyword 'start'        : Use this keyword to instruct FPlay to skip
  132.                            the specified number of bytes. Use this to
  133.                            skip the header used in some formats.
  134.   
  135.   Keyword 'oversampling' : This keyword makes FPlay increase the 
  136.                            sampling frequency by a factor 1,2,4 or 8.
  137.                            Intermediate samples are calculated using
  138.                            linear interpolation. Care should be taken
  139.                            not to overload the CPU, as oversampling 
  140.                            involves quite a lot of processing power.
  141.                            Using a value too high will result in a 
  142.                            rather bad sound quality.
  143.   
  144.   Keyword 'armadeus'     : The 'armadeus' flag let FPlay derive the
  145.                            sampling frequency from the samplefile
  146.                            (the first byte in an !Armadeus file 
  147.                            represents the sampling rate.
  148.  
  149.   Keyword 'ulaw'         : Accept ulaw compressed logarithmic samples
  150.                            instead of the usual 8 bit linear format.
  151.  
  152.  
  153.  
  154. Examples
  155. ========
  156.       
  157. You can play a sample (with name samplefile) using default settings:
  158.   
  159.     *FPlay samplefile
  160. or
  161.     *FPlay -file samplefile
  162.  
  163.      
  164. Playing an !Armadeus file:
  165.   
  166.     *FPlay samplefile -armadeus
  167.     
  168.  
  169. Playing an !Armadeus file with a low sampling frequency:
  170.   
  171.     *FPlay samplefile -armadeus -oversampling 4
  172.  
  173.     
  174. Playing a EMR soundsynth file:
  175.  
  176.     *FPlay samplefile -start &1F0 -oversampling 2
  177.  
  178. etc.
  179.  
  180.  
  181.  
  182. Known bugs
  183. ==========
  184.  
  185. None
  186.  
  187.  
  188.  
  189. How to contact the author
  190. =========================
  191.  
  192. You can contact me at the following address:
  193.   
  194.      Frank van de Pol
  195.      mgr. Nelislaan 10
  196.      4741 AB Hoeven
  197.      The Netherlands
  198.      
  199.      Postgiro account: 5826066
  200.      
  201.      
  202. Internet Email may be addressed to:
  203.   
  204.      frankp@stack.urc.tue.nl  
  205.  
  206.      or
  207.  
  208.      erikp@stack.urc.tue.nl
  209.  
  210.  
  211.  
  212. Last message
  213. ============
  214.  
  215. Any reactions, comments, bug reports (???), money, letters of thanks,
  216. programs, hardware, etc. can be sent to the addresses specified above.
  217.  
  218. Please remember: - If you don't like it at all, don't use it.
  219.  
  220.                  - If you have some complaints or wishes, find out what
  221.                    you would like to have added or changed in order to
  222.                    make this program useful to you, and maybe I can do
  223.                    something about it.
  224.  
  225.                  - If you like it a lot, I would very much like to hear
  226.                    that from you too. Humans do like compliments (like
  227.                    dogs do), so if you want to, you can send a nice 
  228.                    colourful post card to the address below.
  229.  
  230.                  - If you don't like my english, send me an english
  231.                    dictionary!
  232.  
  233.