home *** CD-ROM | disk | FTP | other *** search
/ Best Objectech Shareware Selections / UNTITLED.iso / boss / musi / misc / 005 / vpeng.doc < prev    next >
Encoding:
Text File  |  1993-03-24  |  9.9 KB  |  261 lines
  1. Visual Player
  2. Version 1.0, Barcelona, October '92
  3. Player & FFT by Héctor Martínez
  4. Graphics & program by Luis Crespo
  5. Sound Blaster Pro by David López & Angel Trigo (authors of ProMod)
  6.  
  7.  
  8. Visual Player is a graphic MOD player.
  9. While the music is playing, Visual Player can display the waveform of the
  10. four voices of the MOD, the final waveform, four real volume bars, and a
  11. realtime spectrum analyzer. This program has been made to "look" at the
  12. music while you listen to it. Everything in Visual Player is real,
  13. everything that is displayed is calculated from the digital data and not
  14. from the score.
  15.  
  16.  
  17. How to use VP:
  18. --------------
  19. To run Visual Player, you must enter:
  20.  
  21.    VP modname
  22.  
  23. At the DOS command prompt, where "modname" is the name of the MOD file you
  24. want to listen to. You can use wildcards when specifying the file name, for
  25. example:
  26.  
  27.    VP a*
  28.  
  29. Will play all the MOD files that start with "a".
  30.  
  31.  
  32. Hardware requirements:
  33. ----------------------
  34. VP can play music through the internal PC speaker, the Sound Blaster card,
  35. the Sound Blaster Pro card, or one or two digital to analog converters (DAC)
  36. connected to the printer ports, LPT1 and LPT2. It is very cheap and easy to
  37. build a DAC and plug it on the printer port. A simple circuit design is
  38. given below.
  39.  
  40. VP needs a VGA card, and because of the graphic features of the program,
  41. the faster the computer is, the better VP will run. If you have already
  42. tried the program and the display is too slow, you will have to modify the
  43. VP.CFG file and turn off some graphic features or decrease the sampling
  44. frequency. It is recommendable to read VP.CFG anyway, because it has some
  45. important additional information.
  46.  
  47. VP does not need a lot of memory to run, but some MOD files are very big
  48. and then a lot of memory will be needed. If there is not enough memory once
  49. a MOD file is loaded, the help screen and the OS Shell will not work.
  50.  
  51. It is better not to use programs and drivers that leave the 386 in virtual
  52. mode, like EMM386, QEMM, 386MAX, etc, because they slow down the computer
  53. and they decrease the sound quality. This is more important if you have a
  54. slow 386 or a SB or a SB Pro.
  55.  
  56.  
  57. The Keys:
  58. ---------
  59. Here is a quick keyboard reference for the impatient people:
  60.  
  61.  
  62.         PgUp     : Decrement Pattern
  63.         PgDown   : Increment Pattern
  64.  
  65.         +        : Increment Sampling Frequency
  66.         -        : Decrement Sampling Frequency
  67.  
  68.         P        : Change Playing Device
  69.         F        : Toggle Sound Blaster Pro Filter
  70.  
  71.         1..4     : Toggle Voice
  72.  
  73.         F1..F5   : Toggle Oscilloscope
  74.         SF1..SF5 : Toggle Oscilloscope Wave Sync
  75.  
  76.         F6       : Toggle Spectrum Analyzer
  77.         L        : Toggle Spectrum Logarithmic Scale
  78.         M        : Toggle Spectrum FFT Method
  79.  
  80.         F7       : Toggle Volume Bars
  81.  
  82.         S        : OS Shell
  83.         Enter    : Next MOD / Quit Visual Player
  84.         ESC      : Quit Visual Player
  85.  
  86.         F9       : Help screen
  87.  
  88.  
  89. The mixing frequency:
  90. ---------------------
  91. The mixing frequency, also called sampling frequency or sampling rate, is
  92. the speed at which the sound is processed. That means that the higher the
  93. sampling frequency, the better the quality of the sound, especially with
  94. the high pitched sounds like charles, bells, etc. A fast machine will allow
  95. a faster sampling frequency. If you have a slow machine and run the program
  96. with a high sampling frequency, the graphic display will slow down. Also if
  97. you decrease the sampling frequency under 13 Khz, the oscilloscopes will
  98. display trash.
  99.  
  100. The oscilloscopes:
  101. ------------------
  102. The 4 upper oscilloscopes display the waveform of the voices that are being
  103. played, and the central oscilloscope displays the sum of the 4 voices. The
  104. graphs can be synchronized with the beginning of the waveform, so that in
  105. most of the cases the waveform will be displayed at the same place. If you
  106. have a stereo output, like an SB Pro, you will see that the voices 1 and 4
  107. sound through the left channel, and the voices 2 and 3 sound through the
  108. right channel. If you have built your own stereo DAC, we recommend you that
  109. you put the output cables following this criterion, so that the volume bars
  110. display will be coherent.
  111.  
  112. The volume bars:
  113. ----------------
  114. The volume bars are located at each side of the central oscilloscope, and
  115. are placed so that the voices that sound through the left channel, voices
  116. 1 and 4, are at the left side of the oscilloscope, and the voices that
  117. sound through the right channel, voices 2 and 3, are at the right side of
  118. the oscilloscope.
  119.  
  120. The spectrum analyzer:
  121. ----------------------
  122. The spectrum analyzer is the most time-consuming feature of the program. It
  123. displays the power of each frequency in the sound. The spectrum analyzer is
  124. implemented with an FFT algorithm with integer arithmetic. The FFT is
  125. calculated from 128 samples taken from a buffer that sounds during a 1/50th
  126. of second, so that the first spectrum bar shows the power of F=0 Hz, the
  127. second shows F=50 Hz, the third F=100 Hz, the fourth F=150 Hz, and so on,
  128. independently of the mixing frequency. That stands for method number 1.
  129. Method number 2 takes 64 samples from the buffer and shows half the bars of
  130. method number 1, so it is faster but less accurate than method number 1.
  131. Method number 3 is an hybrid of 1 and 2: it takes 64 samples and fills the
  132. other 64 with zeroes, so every bar takes 25 Hz.
  133.  
  134. The programmer of a famous Mod Player, says in his docs that his program is
  135. the only one that implements a realtime spectrum analyzer. That was not
  136. true when he programmed his spectrum analyzer, because it already existed
  137. TrakBlaster 2.0, but now it will be less true. And the spectrum analyzer
  138. routines are ours, we have not taken them from anywhere.
  139.  
  140.  
  141. Next versions:
  142. --------------
  143. In the next versions, our program will have:
  144.  
  145. - Mouse support.
  146. - SB Pro Mixer control.
  147. - MOD title display, instruments display, total MOD time display, etc.
  148. - Stereo-in-One support.
  149. - Sound Blaster 3.0 support, if we get one of those cards.
  150. - Other sound cards support, as soon as somebody "donates" us some of those
  151.   cards for testing and programming.
  152. - File selection menu.
  153. - "Juke Box" mode: you will be able to listen sequentially to the MOD files
  154.   listed in a file.
  155.  
  156.  
  157. Credits:
  158. --------
  159. Greetings go to:
  160.  
  161. Juan Carlos Arévalo, Victor Neira, Manolo Ruiz Moscoso, Juan Pedro Teruel,
  162. Hakan Gustavsson (The CodeBlasters, Sweden), James Chow (SBNet, Canada),
  163. Xavier Mundó Balcells (For the ARJ comment screen).
  164.  
  165. ...And all the beta testers that have been evaluating the program.
  166.  
  167.  
  168. Shareware:
  169. ----------
  170. Visual Player is distributed as shareware. If you have obtained VP from a
  171. friend, a BBS or similar source, you have an unregistered version. In the
  172. unregistered version a reminding text appears from time to time at the most
  173. interesting parts of the screen.
  174.  
  175. When you register, you get:
  176. - A 3'5", 720 KB diskette with a copy of the latest version of VP registered
  177.   to you, without the annoying texts of the unregistered version.
  178. - Free next version registration.
  179. - Due notice of every new version.
  180. - The MOD files that you choose from the list that come with the program:
  181.   MODS.LST.  (All only in one diskette)
  182.  
  183. To register, send a letter to:
  184.  
  185.    Luis Crespo
  186.    P.O. Box 93142
  187.    08080 Barcelona, SPAIN
  188.  
  189. With your full name and address and 3.000 Ptas if you live in Spain, or $35
  190. if you live outside Spain.
  191.  
  192.  
  193. Copyright/License/Warranty:
  194. ---------------------------
  195. Visual Player must be distributed unmodified and with its full
  196. documentation and files. The registered version must not be distributed.
  197.  
  198. Visual Player is copyright of the authors. The authors allow to: use
  199. software, make copies of it, give copies to anybody and distribute it
  200. through electronic media.
  201.  
  202. It is not allowed to ask for money or donations for any copy or copies of
  203. the program, neither distribute the software and/or documentation with
  204. commercial products, without previous written acknowledgement of the
  205. authors.
  206.  
  207. There is not warranty of any kind, and the authors are not responsible for
  208. any kind of damage that the use of the software may cause. When using this
  209. software, you agree with everything written above.
  210.  
  211.  
  212. How to contact the authors:
  213. ---------------------------
  214. We are waiting for your comments and opinions about our program. Our
  215. electronic addresses are:
  216.  
  217. Luis Crespo: FidoNet 2:343/108.21
  218. Angel Trigo: FidoNet 2:343/121.242
  219. David Lopez: FidoNet 2:343/121.989
  220.  
  221. The circuit:
  222. ------------
  223. And here it is the circuit: a Digital to Analog Converter that plugs into
  224. the printer port and to the amplifier. To build it, you will just need 18 1%
  225. resistors, 2 capacitors, a male D-25 connector, and a jack. It is very
  226. important that the resistors have 1% tolerance, because if they have 5% or
  227. more, the thing will sound like hell.
  228.  
  229.  
  230.           Printer Port
  231.  
  232.           signal   pin
  233.                               20k   20k
  234.           D0       2      >───░░░─┬─░░░──0v (GND, pin 20)
  235.                               20k ░ 10k
  236.           D1       3      >───░░░─┤
  237.                               20k ░ 10k
  238.           D2       4      >───░░░─┤
  239.                               20k ░ 10k
  240.           D3       5      >───░░░─┤
  241.                               20k ░ 10k
  242.           D4       6      >───░░░─┤
  243.                               20k ░ 10k
  244.           D5       7      >───░░░─┤
  245.                               20k ░ 10k
  246.           D6       8      >───░░░─┤
  247.                               20k ░ 10k
  248.           D7       9      >───░░░─┤
  249.                               20k ░ 10k  100nF
  250.                                   ├──────┤├─┬──> To Amplifier
  251.                                   │         │
  252.                                   ░ 10k     ┴ 10nF
  253.                                   │         ┬
  254.           GND      20     >───────┼─────────┴──>
  255.                                   0v
  256.  
  257.  
  258. This circuit is an enhancement of the one that came with Mark J.Cox ModPlay,
  259. so we thank Mark J.Cox for his original design.
  260.  
  261.