home *** CD-ROM | disk | FTP | other *** search
/ Sound Sensations! / sound_sensations.iso / miscprog / pmusic11 / update.txt < prev   
Text File  |  1989-07-01  |  8KB  |  160 lines
  1. The following enhancements have been made to the Polyphonic Music package 
  2. version 1.0:
  3.  
  4. Playing routines:
  5.  
  6. Version:      Date:        Description:
  7. --------    ---------      ------------                             
  8.  1.01        6/15/89         Relative tempo change implemented. Starting tempo
  9.                                 is modified in the text file by the 'T'
  10.                                 command:
  11.  
  12.                                 Syntax:
  13.  
  14.                                  Tn  -- Changes starting tempo value:
  15.                                         where n = a number between 1 and
  16.                                         8191. n consists of a sum of numbers:
  17.                                         
  18.                                         n = REFVAL + CHANGEVAL
  19.  
  20.                                         REFVAL = 0 or 4096 only.
  21.                                         CHANGEVAL = 1 to 4095 inclusive.
  22.  
  23.                                 How it works:
  24.  
  25.                                  To add an absolute value to current tempo,
  26.                                         call Tn with n = 4096 + amount you
  27.                                         want to add (amount is CHANGEVAL).
  28.                                  To subtract an absolute value from current 
  29.                                         tempo, call Tn with n = 0 + amount 
  30.                                         you want to subtract (amount is 
  31.                                         CHANGEVAL).
  32.  
  33.                              I know this causes crude coding, but it works
  34.                              well! A MakePoly update for Tn and T-n (Tempo 
  35.                              Add and Subtract) is in the works.
  36.  
  37.  1.02        6/15/89         Tempo value now entered in maximal range.
  38.                              The second parameter to playpoly can now have
  39.                              a value in the range of 1 (way too fast) to
  40.                              65535 (or maxint) (way too slow). This addition
  41.                              allows faster computers to use the play 
  42.                              routines with no problem. When using the poly()
  43.                              routine from inside C programs, the first value
  44.                              of the array (whether a command or not) is
  45.                              assumed as a tempo. DO NOT OR (|) the TEMPO value
  46.                              (previously defined in POLY.H) with your tempo! 
  47.                              This will create a tempo which is too long! 
  48.                              Notice the change in POLY.H (and the chord 
  49.                              arrays in POLYCHRD.H). TEMPO define is now 
  50.                              TCHANGE and this command only changes the 
  51.                              starting tempo as decribed above. Note: you must 
  52.                              OR (|) the value of n described above with 
  53.                              TCHANGE (in C programs) to change tempo 
  54.                              effectively. When using the playpoly()/looppoly() 
  55.                              functions the second parameter sent can have 
  56.                              the value 1-65535 described above. You only
  57.                              need to alter your programs if using the poly()
  58.                              function.
  59.  
  60.  1.10        6/19/89         Eureka! This is, what I believe to be, a major
  61.                   breakthrough in the three voice world!
  62.                   
  63.                   By re-vamping the play routine, voice 1 has
  64.                              been diminished in strength greatly. Its volume
  65.                              difference above the other two voices is now
  66.                              only slight, if detectable.
  67.                              
  68.                              The sound quality also turned out incredibly
  69.                              better, as there is minimal "sqwak" (peculiar 
  70.                              beeps, buzzes, and hums). The previous imple-
  71.                              mentation used the assembly code written by
  72.                              Steve Muenter for a BASIC TRI() function.
  73.                              The playing routines of Polyphonic Music 1.0
  74.                              (as well as VMUSIC, I believe) used this code
  75.                              almost verbatim. Unfortunately his code 
  76.                              (usually) produces a high pitched tone during
  77.                              playing. This can be distracting, as it 
  78.                              diminishes the music quality signifigantly.
  79.                              This version's (1.10) technique seems to
  80.                              have only a dull hum sound every once in a
  81.                              while and few (if any) beeps or high pitched
  82.                              tones in the background. See for yourself!
  83.                              (Compare the sound quality of the old routines
  84.                              - in PlayPoly 1.0 or VMUSIC - to the new one
  85.                              by playing the PACHCAN.SNG. You'll notice the
  86.                              difference).
  87.                              
  88.                              With the improved sound and voice volume
  89.                              qualities, these play routines have gained a
  90.                              greater capability for good use in the PC world.
  91.                              
  92.                              Note: Tried four voices. The noise level 
  93.                              increased signifigantly (so much it distracts!).
  94.                              I have discovered how to possibly allow for up
  95.                              to five voices (if I was using a 386 machine
  96.                              I could do this without noise!). I may implement 
  97.                              it, attempting to obtain minimal noise, although
  98.                              updating the MakePoly routine for 4 or more
  99.                              voices may not appear so quickly!
  100.                              
  101. MakePoly:
  102.  
  103. Version:      Date:        Description:
  104. --------    ---------      ------------
  105.  1.01         6/14/89         An allowance has been made for RELATIVE
  106.                   change of tempo (see Playing routines update 
  107.                   1.01 above). No specific interpretation 
  108.                   (i.e. T-n) of the text music file has been 
  109.                   implemented yet; only the crude implementation 
  110.                   described above.
  111.                   
  112.  1.02        6/15/89         To add compatability with the VMUSIC software,
  113.                   MakePoly now allows comments to be delimited
  114.                   by the '!' character. MakePoly interprets this
  115.                   character in an identical fashion as the '*'
  116.                   character. Unlike VMUSIC however, the beginning
  117.                   and ending comment delimiters need not be
  118.                   on the SAME line. Comments can go on for several
  119.                   lines. Note: You must use the same closing
  120.                   character as the opening one for comments, i.e.
  121.                   the comment '* voice 1: !' is invalid because
  122.                   the '!' is not recognized as the close of a '*'
  123.                   comment.
  124.                   
  125.                   Example:
  126.                   
  127.                   v1o3 eefg bcdef a2g2
  128.                   * 
  129.                   then it repeats
  130.                   *
  131.                   v1o3 eefg bcdef a2g2
  132.                   
  133.  1.03         6/16/89         Again to add compatability with VMUSIC, MakePoly
  134.                   now supports the printable comment feature which
  135.                   prints the text delimited by '$' characters to
  136.                   screen while compiling to a ".ply" file. Again,
  137.                   unlike VMUSIC, the starting and ending '$' need
  138.                   not be on the SAME line (but MakePoly will still
  139.                   print a line feed at the start of a printable
  140.                   comment if they are).
  141.                   
  142.                   To further compatability with BASIC (the 
  143.                   language which MakePoly's commands were derived
  144.                   from), the '?' character also will delimit
  145.                   printable comments. Since, in BASIC, the '?'
  146.                   represents "print", it is suggested to use
  147.                   the '?' character in the music text file 
  148.                   for clarity.
  149.                   
  150.                   Example:
  151.                   
  152.                   v1o3 aagg fefe a2a2
  153.                   $
  154.                       Line One: la la so so fa mi fa mi la.. la..
  155.                   $
  156.                   v1o5 ccdd eeff g2g2
  157.                   ?
  158.                       Line Two: do do re re mi mi fa fa so.. so..
  159.                   ?
  160.