home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / vpdart01.zip / DOS / readme.txt < prev   
Text File  |  1998-07-26  |  9KB  |  187 lines
  1. The "Mustune.ini" file needs to be in the same folder or directory as
  2. Mustune.  It controls many of the functions and parameters of the
  3. program.  Here is a description of the items represented:
  4.  
  5. Calibrate - If "Yes" is entered, the soundcard will be automatically
  6.  calibrated.  If tests with a tuning fork or other reliable device shows
  7.  this to be inaccurate change to "No" and enter a manual correction lower
  8.  down in the .ini file.
  9.  
  10. Mousetimer - just for beauty and may be useful for timing - will show
  11.  ticking digital clock instead of mouse pointer. As I found may not work
  12.  on some computers. 
  13.  
  14. Samplerate - sets sample rate of the sound card in Hertz. For analysing
  15.  higher pitches it may be better to set higher values for example 22000,
  16.  for lower 8000 is good enough. modulated pitch and stretching - for
  17.  constructing temperaments different from standard. 
  18.  
  19. UserScale - Different temperaments can be used by removing the semicolon
  20.  to the left of the series of numbers representing a particular temperament.
  21.  There should only be one missing semicolon so be sure to put one to the
  22.  left of the last one used before changing to another one. The pitches
  23.  are represented by percent (cent) variation from equal temperament.
  24.  
  25. StandardPitch - This is the base upon which all pitch readings are based.
  26.  Modern pitch is 440, Renaissance pitch is 460-466, Classical pitch is 430,
  27.  Baroque or old pitch is 410-415, and French pitch is 390-392.
  28.  
  29. ManualCorrection - Correction in positive or negative cents to be used when
  30.  "calibrate" = "no" to correct for a sound card which cannot be accurately
  31.  automatically calibrated.
  32.  
  33. Smoothing - As described in the .ini file, this is to slow down the tuning
  34.   meter.
  35.  
  36. LowerFreq - The lowest frequency one needs to measure.
  37.  
  38. UpperFreq - The highest frequency one needs to measure.
  39.  
  40. GrayScale - "Yes" for monochrome or grayscale displays, "No" for color.
  41.  
  42. RECORDING FUNCTION: (registered version only)
  43.  
  44. To record, press the button for note, spectrum, or oscilloscope then press
  45.  record (the arrow button on the far left).   When you are done hit the
  46.  ring (circular) button in the middle and change the name from noname.
  47.  if you wish.  Hit enter and it will be saved to your Mustune folder.
  48.  The extension .ptc, .spc, or .osc will be added to designate that it is
  49.  a "pitch", "spectrum", or "oscilloscope" recording.   In this file all
  50.  results are saved with precise timing and complete information.  You can
  51.  view the results with any text editor including Notepad.  A graphing
  52.  program will give you a picture of the results. The oscilloscope function
  53.  is useful for checking to see if the sound is  recorded correctly without
  54.  overflow (too much amplitude or volume). From this picture you may also
  55.  visually estimate fundamental tone as the inverted period of the waveform.
  56.  One can review all these saved files by starting the program from the DOS
  57.  prompt using appropriate filename as a parameter in command line. For
  58.  example:
  59.     mustune noname.spc
  60.     mustune noname.ptc 
  61.     mustune noname.osc 
  62. To restore the displays correctly the program must be run with the same
  63.  mustune.ini file as when the displays were saved. 
  64.  
  65. The format of the spectrum file (.spc) to adds data in dB (The loudest peak
  66. is 0dB) 
  67.  
  68. The highest notes are displayed on the stave using octave shift sign. 
  69.  
  70. About temperaments
  71.  
  72. First we take StandardPitch from ini-file that is the frequency of A4 in
  73. Herz (default is 440.0) and construct equal temperament scale using simple
  74. formula f=StandardPitch * 2^(d/12). Here d - is distance in semitones,
  75. negative for lower notes. For example for the middle octave we obtain:
  76. ...
  77. G  = 440.00*2^(-2/12)=392.00
  78. G# = 440.00*2^(-1/12)=415.30
  79. A  = 440.00
  80. A# = 440.00*2^(1/12)=466.16
  81. B  = 440.00*2^(2/12)=493.88
  82. ...
  83.  
  84. Now we take user defined (or predefined) temperament and apply it to our
  85. scale. UserScale is 12 values showing the shift in cents that should be
  86. applied to every note in octave. Cent is 1/100 of semitone so the shift
  87. should be calculated using the following formula fnew=fold*2^(c/1200).
  88.  
  89. For example we want to apply Pythagorean scale:
  90.  
  91. -6,8,-2,-12,2,-8,6,-4,10,0,-10,4
  92.  
  93. Now we need to choose to what starting note this modulation should be
  94. applied that is defined by ModulatedPitch. All predefined temperaments
  95. are calculated for ModulatedPitch C. Now let we want to apply this
  96. temperament to D (ModulatedPitch = D). It may be donein the following
  97. way (by cyclically shifting the table for UserScale)
  98.  
  99. C   C#  D   D#  E   F   F#  G   G#  A   A#  B
  100.         -6  8   -2  -12 2   -8  6   -4  10  0
  101. -10 4
  102.  
  103. so the new table will be:
  104. -10,4,-6,8,-2,-12,2,-8,6,-4,10,0
  105.  
  106. However there is a problem in this new table: if applied it will shift
  107. our StandardPitch on -4 cents. It is not what we want. To avoid this
  108. undesirable shift we define ZeroPitch. Usually and by default it is the
  109. same note as standard pitch A.
  110.  
  111. To preserve our ZeroPitch umodulated we must add +4 to every value in our
  112. table to obtain:
  113.  
  114. -6,8,-2,12,2,-8,6,-4,10,0,14,4
  115.  
  116. Now we calculate the new scale
  117. ...
  118. G  = 392.00*2^(-4/1200)= 391.10
  119. G# = 415.30*2^(10/1200)= 417.71
  120. A  = 440.00
  121. A# = 466.16*2^(14/1200)= 469.96
  122. B  = 493.88*2^(4/1200) = 495.02
  123. ...
  124.  
  125. We may also apply Stretching to our new temperament for more pleasant sound.
  126. Below is three tables for equal temperament and different levels of stretching.
  127.  
  128. Stretching = 0 (default, no stretching)
  129.  
  130.  │ C     C#    D     D#    E     F     F#    G     G#    A     A#    B    
  131. ─┼────────────────────────────────────────────────────────────────────────
  132. 0│ 16.35 17.32 18.35 19.45 20.60 21.83 23.12 24.50 25.96 27.50 29.14 30.87
  133. 1│ 32.70 34.65 36.71 38.89 41.20 43.65 46.25 49.00 51.91 55.00 58.27 61.74
  134. 2│ 65.41 69.30 73.42 77.78 82.41 87.31 92.50 98.00 103.8 110.0 116.5 123.5
  135. 3│ 130.8 138.6 146.8 155.6 164.8 174.6 185.0 196.0 207.7 220.0 233.1 246.9
  136. 4│ 261.6 277.2 293.7 311.1 329.6 349.2 370.0 392.0 415.3 440.0 466.2 493.9
  137. 5│ 523.3 554.4 587.3 622.3 659.3 698.5 740.0 784.0 830.6 880.0 932.3 987.8
  138. 6│  1047  1109  1175  1245  1319  1397  1480  1568  1661  1760  1865  1976
  139. 7│  2093  2217  2349  2489  2637  2794  2960  3136  3322  3520  3729  3951
  140. 8│  4186  4435  4699  4978  5274  5588  5920  6272  6645  7040  7459  7902
  141.  
  142.  
  143. Stretching = 1
  144.  
  145.  │ C     C#    D     D#    E     F     F#    G     G#    A     A#    B    
  146. ─┼────────────────────────────────────────────────────────────────────────
  147. 0│ 16.29 17.26 18.29 19.39 20.55 21.77 23.07 24.45 25.91 27.46 29.10 30.83
  148. 1│ 32.67 34.62 36.68 38.87 41.18 43.63 46.23 48.99 51.90 54.99 58.26 61.73
  149. 2│ 65.41 69.30 73.42 77.79 82.41 87.31 92.51 98.01 103.8 110.0 116.6 123.5
  150. 3│ 130.8 138.6 146.8 155.6 164.8 174.6 185.0 196.0 207.6 220.0 233.1 246.9
  151. 4│ 261.6 277.2 293.6 311.1 329.6 349.2 370.0 392.0 415.3 440.0 466.2 493.9
  152. 5│ 523.3 554.4 587.4 622.4 659.4 698.7 740.3 784.4 831.1 880.7 933.2 988.8
  153. 6│  1048  1110  1176  1247  1321  1400  1484  1572  1666  1766  1872  1984
  154. 7│  2102  2228  2362  2503  2654  2813  2982  3161  3351  3553  3767  3994
  155. 8│  4235  4490  4762  5050  5355  5680  6024  6390  6778  7190  7628  8093
  156.  
  157. Stretching = 2
  158.  
  159.  │ C     C#    D     D#    E     F     F#    G     G#    A     A#    B    
  160. ─┼────────────────────────────────────────────────────────────────────────
  161. 0│ 16.22 17.20 18.23 19.33 20.49 21.72 23.02 24.40 25.86 27.41 29.05 30.79
  162. 1│ 32.63 34.58 36.64 38.83 41.15 43.60 46.20 48.96 51.88 54.97 58.24 61.71
  163. 2│ 65.39 69.28 73.41 77.78 82.40 87.31 92.50 98.00 103.8 110.0 116.5 123.5
  164. 3│ 130.8 138.6 146.8 155.6 164.8 174.6 185.0 196.0 207.6 220.0 233.1 246.9
  165. 4│ 261.6 277.2 293.6 311.1 329.6 349.2 370.0 392.0 415.3 440.1 466.3 494.0
  166. 5│ 523.4 554.6 587.7 622.7 659.8 699.1 740.8 785.0 831.9 881.6 934.2 990.0
  167. 6│  1049  1112  1179  1249  1324  1403  1487  1577  1671  1772  1878  1991
  168. 7│  2111  2239  2374  2517  2669  2831  3002  3185  3378  3583  3802  4033
  169. 8│  4280  4541  4819  5115  5429  5763  6119  6497  6899  7326  7782  8266
  170.  
  171.  
  172. Stretching = 3
  173.  
  174.  │ C     C#    D     D#    E     F     F#    G     G#    A     A#    B    
  175. ─┼────────────────────────────────────────────────────────────────────────
  176. 0│ 16.15 17.13 18.17 19.26 20.43 21.66 22.96 24.34 25.80 27.35 28.99 30.73
  177. 1│ 32.57 34.53 36.59 38.78 41.10 43.55 46.16 48.91 51.83 54.92 58.20 61.67
  178. 2│ 65.35 69.24 73.37 77.74 82.37 87.27 92.46 97.97 103.8 110.0 116.5 123.5
  179. 3│ 130.8 138.6 146.8 155.6 164.8 174.6 185.0 196.0 207.7 220.0 233.1 247.0
  180. 4│ 261.7 277.2 293.7 311.2 329.7 349.4 370.2 392.2 415.6 440.3 466.5 494.3
  181. 5│ 523.8 555.0 588.1 623.2 660.4 699.9 741.7 786.0 833.0 882.8 935.6 991.7
  182. 6│  1051  1114  1181  1252  1327  1407  1492  1581  1677  1778  1886  2000
  183. 7│  2121  2249  2386  2531  2685  2849  3023  3209  3405  3615  3837  4074
  184. 8│  4326  4594  4879  5183  5507  5852  6219  6611  7028  7474  7949  8456
  185.  
  186.  
  187.