home *** CD-ROM | disk | FTP | other *** search
/ Audio 4.94 - Over 11,000 Files / audio-11000.iso / msdos / sndbords / proaudio / pcmtools / pcmtools.arj / TPCM.ARJ / TPCM.DOC < prev    next >
Text File  |  1992-08-31  |  7KB  |  186 lines
  1. TPCM - Test PCM 
  2.  
  3.  
  4. Syntax
  5.  
  6.     tpcm [-dqmls] [-v#] [-p#] [-c#] [-B#] [-D#] [-R#] [-iname OR wavfiles] 
  7.  
  8.  
  9.  
  10. Options
  11.  
  12.     -d    debug mode, output status
  13.     -q    quiet mode (no sound)
  14.     -m    toggle use Monochrome Screen Buffer for DMA 
  15.     -l    Loop sound continuously
  16.     -s    treat as stereo
  17.  
  18.     -v[#]    #= video Function # (1-3, see ref) default: 1
  19.     -p#    #= palette # (1-8) default: 2 (6 if -v2 specified)
  20.     -c#    #= palette cycle delay (default: 1)
  21.  
  22.     -B#    #= DMA Buffer size (KB), default: 4K if video, else 32K
  23.     -D#    #= number of DMA Divisions, default: 8
  24.  
  25.     -R#    #= default samplerate (decimal) default: 11025
  26.  
  27.     -i inpname    inpname= name of input PCM file (use -R and -s)
  28.     OR
  29.     wavfiles ...    filenames to play (overrides -R and -s)
  30.         Note: -iinpname and wavfiles... are mutually exclusive
  31.  
  32.  
  33. Examples
  34.  
  35.     C:> tpcm sound.wav
  36.  
  37.         This simply plays the file "sound.wav".
  38.  
  39.     C:> tpcm -v sound.wav
  40.  
  41.         This displays and plays the file "sound.wav".  
  42.  
  43.     C:> tpcm -v *.wav
  44.  
  45.         This displays and plays all .wav files.
  46.  
  47.     C:> tpcm -vp7c600 *.wav
  48.  
  49.         This displays and plays all .wav files using palette 7
  50.         with a delay of "600" (computer speed dependent).
  51.  
  52.     C:> tpcm -isound.snd -R22050 -s
  53.  
  54.         This plays the PCM file "sound.snd" at 22050Hz in stereo.
  55.  
  56.     C:> tpcm -vm *.wav
  57.  
  58.         This displays and plays all sound files, but uses
  59.         the monochrome screen memory for the DMA buffer.
  60.  
  61. Display Control
  62.  
  63. During display of the waveform, several keys are processed:
  64.  
  65.     P    palette select - the program waits for either:
  66.         0= no palette, 1 through 8= palettes 1 through 8
  67.  
  68.     c,C    auto cycle delay (+1/10), increasing delay as you hold key
  69.     r    reverse cycle, c,C now decreases delay as you hold key
  70.     SPACE    stop cycling
  71.     f,F    manually cycle one way (256/16 colors)
  72.     b,B    manually cycle the other (256/16 colors)
  73.     u,d    change RGB up/down 1 
  74.     U,D    change RGB up/down 10
  75.     CR    restore palette
  76.     ESC    exit 
  77.  
  78. Operation
  79.  
  80. This program requires the TSR pcm.com to be loaded in memory.
  81.  
  82. Use this program to play .wav files, and display them in real time.
  83.  
  84. As you can see, there are many options available to affect the flow
  85. of the program.
  86.  
  87. Use the -q option to suppress the output of sound and have the program
  88. simply run through the file.  Note that there will be no display (if the 
  89. -v option was specified) as there is no DMA activity and so no User 
  90. Function calls.  Use the -d option to see the progress of loading the
  91. file and the associated simulated DMA transfers.
  92.  
  93. Use the -d option to observe the queueing of data and the waiting for
  94. DMA to finish.  When redirecting this output to a file on a ramdrive,
  95. you can see how much time there is available for additional processing.
  96.  
  97. Use the -m option to cause the program to use monochrome screen memory
  98. for the DMA buffer.  Note: this memory may be used as DOS UMB (loadhigh),
  99. and overwriting this area with sound data is not suggested!  However, if 
  100. you do have a monochrome monitor, then you can watch the data slam by.  
  101.  
  102.     Why use the monochrome screen buffer for DMA?  Well, nowadays,
  103.     with VGA and multi-megabyte-memory machines, the B segment is
  104.     a nice 32K block of memory commonly unused, and perfect for
  105.     scratch memory (like sound, where overwrites are merely noisy,
  106.     not fatal).
  107.  
  108.     Unfortunately, this memory is too slow for use with 44,100 Hz
  109.     sounds, so this is not a perfect solution.
  110.  
  111. Use the -l option to loop on the sound file continuously.  Press ESCAPE
  112. to exit the loop and proceed to the next file (if any).
  113.  
  114. Use the -s option to cause the program to treat the -i specified file as
  115. a stereo PCM file.  Note: when files are specified without the -i option
  116. and they are determined to be .wav files, then the format data specified
  117. within is used, regardless of the -s and -R options.
  118.  
  119. Use the -i option to specify a filename (no DOS wildcards allowed).  Use
  120. the -s and -R options to specify the number of channels and the sample
  121. rate.
  122.  
  123. Use the -B option to specify the size of the DMA buffer in KB.  This
  124. number is expressed in decimal, and should be either 4, 8, 16, 32 or 64.
  125. This number is forced to at least 4, unless the -v option is given, in
  126. which case it is made to be 4 for stereo output, and 2 for mono.
  127.  
  128. Use the -D option to specify the number of parititions for the DMA buffer.
  129. This number is expressed in decimal, and should be a power of 2 greater
  130. than 1.  If the -V option is given, then it is made to be 2 in order to
  131. ensure synchronous sound and display output.
  132.  
  133. Use the -R option to specify the samplerate for .wav files specified 
  134. with the -i option, and for non .wav files.  This value can range from
  135. 100 (?) to 88200 for mono files, and 100 (?) to 44100 for stereo files.
  136.  
  137. Use the -V option to select a picture to display:
  138.  
  139.     1    tpcm.scr    256-color gradient
  140.     2    tpcm2.scr    me
  141.     3    tpcm3.scr    lame-looking "deck" with useless knobs
  142.  
  143.     These must be simple "memory dump" files, 320x200x8bit.
  144.  
  145. Mono/Stereo display is selected automatically according to the channels
  146. for recognized .wav files.
  147.  
  148. You can specify multiple files to process, if the -i option is not also
  149. used, by naming them at the end of the command line.  You can use DOS
  150. wildcards: "tpcm *.wav".  These files are examined to determine their
  151. type, and .wav files have their format information used to specify the
  152. number of channels and samplerate, but the command line parameters or
  153. default values are used for non-.wav files.
  154.  
  155.  
  156. Requirements
  157.  
  158. MediaVision Pro Audio Spectrum (any model).
  159.  
  160. Does not support any compression.
  161.  
  162. This program requires a graphics monitor with the ability to display 
  163. 320x200x256 colors in order to display the waveform.
  164.  
  165.  
  166. Secrets
  167.  
  168. It is possible to specify the location of the DMA buffer manually using
  169. two options not documented above, however, this can be very dangerous.
  170. Use the -S# and -O# options to specify the segment and offset (in hex)
  171. of the DMA buffer (use the -B# and -D# option to specify the size and
  172. divisions).  You can then have the program display the waveform using
  173. the -V option, and direct the DMA buffer to A000:0, thus seeing the 
  174. PCM data appear on the screen in graphics mode.  Interesting?  Maybe,
  175. but since we can, why not?
  176.  
  177.     If you have the "setdma.exe" and "freedma.exe" programs, 
  178.     you can use them to allocate and deallocate a 16K block of 
  179.     memory from the very top (thereby eliminating any waste).  
  180.     The "setdma.exe" program displays the segment to specify 
  181.     with the tpcm -S option (and to "freedma.exe").
  182.  
  183. Copyright (c) 1992.  Media Vision, Inc.  All Rights Reserved.
  184. Programmer: Bart Crane
  185.  
  186.