home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-387-Vol-3of3.iso / v / vmap11.zip / VMAP.TXT < prev   
Text File  |  1993-03-10  |  4KB  |  90 lines

  1. Vmap 1.1 (March 10, 1993)
  2. =========================
  3.  
  4. Phat Tran
  5.  
  6. INTRODUCTION
  7.  
  8. Normally, MIDI files written for Roland soundcards will sound strangely
  9. mute on the Gravis Ultrasound (GUS), with some tracks playing much
  10. softer than others.  This is because the volume response of the GUS is
  11. exponential whereas that of the Rolands is linear.  The loudness vs.
  12. volume setting plot for each type of card is shown below:
  13.  
  14.               |                                   /
  15.               |                                 / *
  16.   Perceived   |                               /   *
  17.   Loudness    |                             /     *
  18.               |                           /      *
  19.               |                         /        *
  20.               |                       /          *
  21.               |                     /           *
  22.               |                   /             *
  23.               |                 /              *
  24.               |               /               *
  25.               |             /               **
  26.               |   Roland  /               **
  27.               |         /               **
  28.               |       /              ***   GUS
  29.               |     /           ****
  30.               |   /        ****
  31.               | /********
  32.               +------------------------------------
  33.               0                                  127
  34.                           Volume Setting
  35.  
  36. What vmap does is remap the volume changes and key velocities in the
  37. MIDI file so that the notes will play with the same relative volume
  38. on the GUS as on the Rolands.  The formula used is:
  39.  
  40.                    V' = log(V + 1) * 127 / log(128)
  41.  
  42. A remapped Roland file will sound "fuller" on the GUS than the original
  43. would.
  44.  
  45. This mismatched volume problem goes both ways...  MIDI files composed
  46. for the GUS will sound dinly loud on the Rolands, with background tracks
  47. overwhelming the foreground.  Vmap 1.1 will also let you remap the
  48. volume changes and key velocities of GUS .mids for Rolands.
  49.  
  50. INSTRUCTIONS
  51.  
  52. To use vmap, invoke it at the command line as follows:
  53.  
  54.     vmap [-r] [-t] <in.mid> <out.mid>
  55.  
  56. Vmap will then process <in.mid> and output the result as <out.mid>.  (Of
  57. course, you would substitute your own filenames for <in.mid> and
  58. <out.mid>.  They must not be the same file.)
  59.  
  60. Vmap will also display the MIDI and track headers, and any text it finds
  61. in the file.
  62.  
  63. The default operation is a Roland to GUS remapping, but the -r (Roland)
  64. switch will tell vmap to convert GUS MIDI files to Roland.  Resolution
  65. will be lost due to rounding, so don't convert files back and forth
  66. between Roland and GUS more than necessary.
  67.  
  68. The -t (test) switch will tell vmap to go through the motions of
  69. remapping <in.mid>, but without outputting to a file.  Thus, you need
  70. not specify <out.mid>.
  71.  
  72. BUGS
  73.  
  74. Vmap has not been tested very thoroughly, so there may be bugs that will
  75. crop up as the program is exposed to .mids more exotic than the ones I
  76. have to test it with.  Bug reports and/or comments can be sent to
  77. my Internet account (ptran@sciborg.uwaterloo.ca).  Particulary, if vmap
  78. reports "Unexpected EOF." when processing a .mid file that you know is
  79. intact, tell me!  There may be several MIDI messages that I don't know
  80. about which can cause vmap to lose its framing.
  81.  
  82. REVISIONS
  83.  
  84. Version 1.0 -- Original release.
  85.  
  86. Version 1.1 -- New features:
  87.                - GUS to Roland remapping
  88.                - test mode
  89.                - text dump
  90.