home *** CD-ROM | disk | FTP | other *** search
/ Power-Programmierung / CD1.mdf / pascal / library / dos / nicol / sti_song / sti_song.txt < prev   
Encoding:
Text File  |  2002-07-14  |  9.4 KB  |  466 lines
  1.  
  2.  
  3.  
  4.         
  5.         
  6.         
  7.         
  8.         
  9.         
  10.         
  11.         
  12.         
  13.         
  14.         
  15.         
  16.                                      MUSIC SYSTEM 1.0
  17.         
  18.                                For Turbo Pascal Version 5.0
  19.         
  20.         
  21.         
  22.         
  23.         
  24.         
  25.         
  26.         
  27.         
  28.         
  29.         
  30.         
  31.                                   Copyright 1990, 1991 By
  32.         
  33.                              Software Technology International
  34.         
  35.                                     All Rights Reserved
  36.         
  37.         
  38.         
  39.         
  40.         
  41.         
  42.         
  43.         
  44.         
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.                                           NOTICE
  68.                                           ------
  69.                   
  70.         
  71.         
  72.                      All parts of this manual and the accompanying  soft-
  73.                   ware  are  copyrighted material. You, as  a  registered 
  74.                   user, are granted permission to make as many copies  of 
  75.                   the  software, or manual, as you wish, as long as  they 
  76.                   are for your personal use. You may not copy this  soft-
  77.                   ware,  or  manual,  in any form  whatsoever  for  usage 
  78.                   outside of your personal use. This includes, but is not 
  79.                   limited  to, duplication of the disk, the files on  the 
  80.                   disk or the manual, by manual or electronic means.
  81.         
  82.         
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.                                             -1-
  134.                                      TABLE OF CONTENTS
  135.                                      -----------------
  136.         
  137.                   
  138.                    Subject                                     Page
  139.                    -----------------------------------------------------
  140.         
  141.                    GENERAL DESCRIPTION ......................   3  
  142.                      Introduction ...........................   3  
  143.                      The software ...........................   3  
  144.                                                              
  145.                    THE SOFTWARE IN DETAIL ...................   4  
  146.                      Functions and Procedures ...............   4  
  147.                      Usage Pointers .........................   5  
  148.                                                              
  149.                    INDEX ....................................   6     
  150.         
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.                                             -2-
  201.                                     GENERAL DESCRIPTION
  202.                                     -------------------
  203.                   Introduction
  204.                   ------------
  205.                   
  206.                      Welcome to Version 1.0 of Software Technology Inter-
  207.                   nationals'  Music System. This group of functions  will 
  208.                   enable  your  Turbo Pascal Version 5.0 to  emulate  the 
  209.                   play  functions found in BASIC, WITHOUT a sound  board. 
  210.                   These functions were written to be flexible, as fast as 
  211.                   possible, and as easy to use as possible. We hope  they 
  212.                   live up to your expectations. Please feel free to write 
  213.                   to  us  anytime  with bug reports  or  suggestions  for 
  214.                   future  versions.  If you are a registered  user,  this 
  215.                   will entitle you to a free upgrade.
  216.                      Remember  that  this  software  is  copyrighted,  so 
  217.                   please don't copy and distribute it, this is a  federal 
  218.                   offense. 
  219.         
  220.                   The Software
  221.                   ------------
  222.                   
  223.                      This  system  is made up of 2 procedures  that  will 
  224.                   enable you to play music through your PC's speaker. The 
  225.                   music  format  is basically the same as  that  provided 
  226.                   with BASIC, with a few differences. The system DOES NOT 
  227.                   need  a sound board, and this is where  the  limitation 
  228.                   arise.  The  system does not allow buffered  music,  or 
  229.                   various  instruments, or multiple channels,  hence  the 
  230.                   music  sounds a little tinny. However, the system  pro-
  231.                   vides the notes A-G, with sharp etc, over 7 octaves. It 
  232.                   also allows various notes lengths etc, so it IS useful. 
  233.                   We hope you enjoy the software.
  234.         
  235.         
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.         
  267.                                             -3-
  268.                                   THE SOFTWARE IN DETAIL
  269.                                   ----------------------
  270.         
  271.                   
  272.                   The Procedures
  273.                   --------------
  274.                   
  275.                   STI_Play_Initialise;
  276.         
  277.                      This  procedure initialises the music system. It  is 
  278.                   not  necessary  to call this procedure,  though  it  IS 
  279.                   recommended  to  do  so before playing  each  piece  of 
  280.                   music.
  281.                   
  282.                   STI_PlayString(ThePlayString : string);
  283.         
  284.                      This  is  the procedure that plays  the  music.  The 
  285.                   parameter THEPLAYSTRING contains the music to play,  in 
  286.                   the  format outlined below. This must be less than  255 
  287.                   character long.
  288.         
  289.                      The format characters accepted by this procedure are 
  290.                   as follows.
  291.         
  292.                   A-G      These are the music notes. If followed by
  293.                            a # or + then the note is sharp. If followed
  294.                            by a -, the note is flat.
  295.                   
  296.                   <        Move down one octave.
  297.                   >        Move up one octave.  
  298.                   .        Extend the note by 1.5.
  299.                   MN       Normal note duration.
  300.                   MS       Staccato note duration. 
  301.                   ML       Legato note duration.
  302.                   Ln       Set the length of the note where 
  303.                                n = 1  :  whole note.
  304.                                   .
  305.                                   .
  306.                                n = 64 :  1/64 of a note.
  307.                   Pn       Set the pause length. Uses the same values as
  308.                            for note length. 
  309.                   Tn       Sets the Tempo where n = notes/minute and 
  310.                            n = 32-255. The default is 120 notes/minute.
  311.                   On       Sets the octave number, with n = 0-6.
  312.                   Nn       Play note number n where n = 0-84.
  313.         
  314.                      As  mentioned earlier, there is no music  buffering, 
  315.                   and  no instrument selection. So the system  will  stop 
  316.                   waiting for the music to finish.
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.                                       
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.                                             -4-
  333.                                       USAGE POINTERS
  334.                                       --------------
  335.         
  336.                      This system is very easy to use, so there should  be 
  337.                   few problems. Just remember that the music string  must 
  338.                   be  less than 255 characters long, and that the  system 
  339.                   is not EXACTLY the same as the BASIC system.
  340.         
  341.                      Other than that, everything should work smoothly.
  342.         
  343.         
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.                                             -5-
  400.                                            INDEX
  401.                                            -----
  402.         
  403.                     Topic                                     Page Number
  404.                   -------------------------------------------------------
  405.         
  406.                  Contents....................................     3
  407.                  Copying.....................................     2
  408.                  Copyright...................................     2
  409.         
  410.                  Descriptions................................     5
  411.                  Detailed Description........................     4
  412.         
  413.                  General Description.........................     4
  414.         
  415.                  Introduction................................     4
  416.         
  417.                  Limitations.................................     4
  418.         
  419.                  Music Format................................     5
  420.         
  421.                  Procedures..................................     5
  422.         
  423.                  STI_PlayString..............................     5
  424.                  STI_Play_Initialise.........................     5
  425.         
  426.                  Usage.......................................     6
  427.                  Users.......................................     2
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.                                             -6-