home *** CD-ROM | disk | FTP | other *** search
/ Programmer 7500 / MAX_PROGRAMMERS.iso / PASCAL / TFREQ11.ZIP / TFREQ.DOC < prev    next >
Encoding:
Text File  |  1992-08-13  |  13.1 KB  |  315 lines
  1.  
  2.  
  3.  
  4.  
  5.        
  6.  
  7.          ▒▒▒▒▒▒▒▒▒▒▄ ▒▒▒▒▒▒▒▒▒▄ ▒▒▒▒▒▒▒▒▒▒▄ ▒▒▒▒▒▒▒▒▒▄ ▒▒▒▒▒▒▒▒▄
  8.      ┌───▒▒█▀▒▒█▀▒▒█  ▒▒█▀▀▀▒▒█  ▒▒█▀▀▀▀▒▒█  ▒▒█▀▀▀▒▒█ ▒▒█▀▀▀▒▒█────┐
  9.      │    ▀▀ ▒▒█  ▀▀  ▒▒█    ▀▀  ▒▒█    ▒▒█  ▒▒█    ▀▀ ▒▒█   ▒▒█    │
  10.      │       ▒▒█      ▒▒▒▒▒▄     ▒▒▒▒▒▒▒▒▒█  ▒▒▒▒▒▄    ▒▒█   ▒▒█    │
  11.      │       ▒▒█      ▒▒█▀▀▀     ▒▒█▀▀▒▒█▀▀  ▒▒█▀▀▀    ▒▒█   ▒▒█    │
  12.      │       ▒▒█      ▒▒█        ▒▒█  ▒▒█    ▒▒█   ▒▒▄ ▒▒█   ▒▒█    │
  13.      │      ▒▒▒▒█    ▒▒▒▒█      ▒▒▒▒█ ▒▒▒▒█ ▒▒▒▒▒▒▒▒▒█ ▒▒▒▒▒▒▒▒█    │
  14.      │       ▀▀▀▀     ▀▀▀▀       ▀▀▀▀  ▀▀▀▀  ▀▀▀▀▀▀▀▀▀  ▀▀▀▒▒█▀▀    │
  15.      │                                                              │
  16.      └──────────────────────────Version 1.1─────────────────────────┘
  17.                                 
  18.                                     The
  19.                            Pascal Sound Procedure
  20.                              Construction Tool
  21.  
  22.                        (C) Copyright 1992 Rand Nowell
  23.                            - RaLin Enterprises -
  24.                        All Rights Reserved World Wide
  25.  
  26.  
  27.                          - PROGRAM DOCUMENTATION -
  28.  
  29.  
  30.                              - Manual Contents -
  31.  
  32.                      Legal Stuff........................i
  33.                      Development........................1
  34.                      Startup............................1
  35.                      Error Checking...................1,2
  36.                      Single Sound.......................1
  37.                      Multiple Sounds..................1,2
  38.                      Build Procedure....................2
  39.                      File Format......................2,3
  40.                      Registration.......................3
  41.                      Author Contact.....................3
  42.                      Support..........................3,4
  43.                      Acknowledgements...................4
  44.  
  45.  
  46.    Copyright:                                               Page i
  47.  
  48.    TFREQ 1.1, the program and documentation,
  49.    is not a Public Domain or Free program. It is the
  50.    Copyrighted (C)1992 work of Rand Nowell dba Ralin Enterprises.
  51.    All rights are reserved. Copying, duplicating, selling or otherwise
  52.    distributing this product except as noted in the Distribution Policy
  53.    below is a violation of Federal Copyright Law.
  54.  
  55.    You are authorized to evaluate the program for a period of two weeks.
  56.    If after two weeks you wish to continue using the program, registration
  57.    is in order. Please see REGCOM.DOC
  58.  
  59.    Distribution:
  60.  
  61.    1. Feel free to distribute the Shareware version of this program as
  62.       often as you like to any interested parties. Distribution to
  63.       Electronic Bullentin Boards is encouraged.
  64.    2. Please do not distribute this program without all the original
  65.       related files such as documentation, readme files, registration
  66.       forms etc.
  67.    3. Please distribute ONLY the original authenticated ZIP format file.
  68.    4. Please obtain our written permission before including the program
  69.       with any "bundled" software packages.
  70.    5. Please do not accept payment for the program; a copying fee of
  71.       $5.00 per diskette may be charged by a non-profit user-group.
  72.    6. Please do not alter the program or documentation in any way.
  73.    7. Individuals, groups, vendors or other software distribution
  74.       companies which market diskettes containg shareware or test-drive
  75.       evaluation programs, for profit, must obtain written permission
  76.       from RaLin Enterprises prior to distribution.
  77.  
  78.     DISTRIBUTION of the REGISTERED version of this program is in
  79.     violation of the license agreement and copyright law.
  80.  
  81.     ************************* DISCLAIMER *****************************
  82.  
  83.     This program is supplied "as is" without warrenty of any kind. The
  84.     entire risk of using, and results from the use of, is assumed by you
  85.     the user.  You assume all costs of repair, servicing and corrections
  86.     stemming from the use of this program.
  87.     Rand Nowell and/or RaLin Enterprises, or any other associated
  88.     company of the program author will not be held liable for any
  89.     damages from the use of this program. No warrenties are expressed or
  90.     implied.
  91.     ********************************************************************
  92.     To the original licensee of the REGISTERD version of The Program
  93.     RaLin Enterprises DOES warrant that the program disk(s) on which the
  94.     program is recorded, be free from defects in material and
  95.     workmanship under normal use and service for a period of (90) ninety
  96.     days from date of delivery as evidenced by your receipt. Our entire
  97.     liability and your exclusive remedy shall be replacement of the
  98.     deffective disk not meeting the standards of this limited warranty.
  99.     And in no case shall exceed the cost of reimbursment of monies paid for
  100.     program registration.
  101.  
  102.   
  103. TFREQ.DOC           Pascal Sound Procedure Construction Tool        Page   1
  104.  
  105. DEVELOPMENT
  106.  
  107. TFREQ was developed to eliminate the hassle of having to write your sound
  108. procedures in the Pascal program, then compile and run before hearing how
  109. they sound.  With TFREQ you can select the frequencies and delays, listen to
  110. it, and if you like it....write it to disk as a source file to load into
  111. your Pascal program.
  112.  
  113. This version of TFREQ will only generate Pascal code, it probably won't
  114. surprise you to know that TFREQ was written in Pascal with TP 6.0.
  115.  
  116. This version still has a few rough edges in it, but the program is being
  117. further developed even as you read this.
  118.  
  119. Very little error checking is incorporated into Ver 1.1, and that something
  120. that is being remedied currently. People who register this program will
  121. probably find many improvements in the version they receive.
  122.  
  123. Areas where lack of error checking may provide tense moments, will be
  124. covered in the manual sections where they are appropriate. Please be sure to
  125. read the WHATSUP.DOC for explanation of whats comming, or planned in the
  126. next release(s).
  127.  
  128. STARTUP
  129.  
  130. When you first start TFREQ you are presented with a Copyright Notice and
  131. program name header. If the version is registered, the User Name and
  132. Registration Number is displayed, else an UNREGISTERED notice shows.
  133.  
  134. Your Menu choices are: <S>ingle  <M>ultiple   <B>uild   <Q>uit
  135. Press the first letter of the choice you want.
  136.  
  137. SINGLE
  138.  
  139.  This section allows you to enter a freq and the delay factor. TFREQ will
  140.  then play the sound for the time specified. There is no function to write
  141.  this to a file, it is simply there to allow you to hear what a certian
  142.  frequency sounds like. After each sound is played, pressing ENTER will
  143.  return you to the Main Menu. A fix is in now to allow you to continously
  144.  play a freq until you are *ready* to return to the Main screen.
  145.  
  146.  MULTIPLE
  147.  
  148.  The menu here presents: <U>p the Scale  <D>own The Scale  <R>eturn
  149.  
  150.  <U> will let you enter a starting and ending frequency, and the delay.
  151.  It will then play it for you. After its been played the specs will be shown
  152.  and you will be promted for the choice of writing to file or Exiting.
  153.  NOTE: The beginning freq MUST be LOWER than the ending freq.
  154.  
  155.  If you choose to write this procedure to a file, you will be prompted for a
  156.  'Procedure' name. You may use up to 15 characters. You can type a longer
  157.  name but TFREQ will only use the first 15. The program will then create a
  158.  file using the first 8 charecters of your procedure name, with an extension
  159.  
  160.   Program Documentation - "Sorry", No Music.....
  161.  
  162.  
  163. TFREQ.DOC           Pascal Sound Procedure Construction Tool        Page  2
  164.  
  165.  of .SRC the file will be stored in the current directory.
  166.  
  167.  <ERROR> There is NO error checking for an invalid or blank entry at the
  168.  procedure name entry. If you press ENTER with no name specified, the
  169.  program will ABORT with a RUN TIME ERROR message. This is being corrected
  170.  for the next version.
  171.  
  172.  <D> This works the same as the Up the Scale function except it is formatted
  173.  to play freqs DOWN the scale. The beginning freq MUST be HIGHER than the
  174.  ending freq.
  175.  
  176.  <R> Returns you to the Main screen.
  177.  
  178.  BUILD
  179.  
  180.  In this area you can build the sound you want. You are allowed to enter up
  181.  to 10 frequencies, each with its own delay. You are prompted for each
  182.  frequency and delay in order.
  183.  
  184.  To stop entering freqs before you reach the 10 freq limit, simply enter a 0
  185.  for the frequency (THATS A ZERO!). The sounds will then be played for you.
  186.  After the sounds have played you will have the option to:
  187.  <M>odify  <W>rite  <E>xit
  188.  
  189.  <M>odify: To modify a frequency you will be prompted for the number of the
  190.  freq to modify. These numbers are listed next to the freqs and delays. Then
  191.  you will be asked for the new freq and delay. Once you have entered the new
  192.  values TFREQ will replay and redisplay the sound procedure. You will then
  193.  again be presented with the options to Modify/Write/Exit.
  194.  
  195.  As of yet there is there is no option to just replay the procedure, but
  196.  that is comming. Likewise you cannot ADD to the procedure, that too is
  197.  comming. It is also planned to allow more than 10 values, for those really
  198.  wild sounds.
  199.  
  200.  If you fill in all 10 frequencies, the program goes into auto mode and
  201.  plays them as soon as you have entered the last delay value.
  202.  
  203.  There is no checking for invalid or blank values as of yet. But if you do
  204.  NOT enter a value (just press enter) the cursor will move to the left of
  205.  the screen and wait for a value. Basically this just messes up the display.
  206.  
  207.  Writing the procedure is the same as that for the Up and Down scale
  208.  procedures.
  209.  
  210.  FILE FORMAT
  211.  
  212.  As mentioned earlier, when you enter a Procedure Name, TFREQ takes the
  213.  first 8 characters of that name, adds an extension of .SRC to it and saves
  214.  your procedure under that name. If the file already exists it will be
  215.  overwritten.
  216.  If you give your procedure the name of Space_Man_Landing then the resulting
  217.  filename will be SPACE_MA.SRC Using your favorite editor or the editor in
  218.  the Turbo Pascal IDE you can read this Sound Procedure source file into you
  219.  program....and KNOW how it will sound when the program runs.
  220.  
  221.   Program Documentation - "Sorry", No Music.....
  222.  
  223.  
  224. TFREQ.DOC           Pascal Sound Procedure Construction Tool        Page  3
  225.  
  226.    The SRC file produced uses standard Pascal procedure format.
  227.  
  228.    procedure <Procedure_Name>;
  229.    Var <variables needed>;
  230.    begin
  231.    .
  232.    .
  233.    end; {Procedure_Name}
  234.  
  235.   The procedure is not indented.... that is being modified, indentation
  236.   is a much neater approach.
  237.  
  238.  NOTE: The little tune that plays when you EXIT TFREQ was designed and
  239.  written to source with this version of TFREQ. And it worked perfectly the
  240.  first time. One thing to be careful of: Check your spelling of the
  241.  procedure name, and make sure you use the same spelling when you CALL the
  242.  Sound Procedure.
  243.  
  244.  THATS IT!
  245.  
  246.  You should have no problems running TFREQ right away. Its really a simple
  247.  program. Appearence wise its much simpler than many of my programs, but
  248.  turned out to be one of the worst for headaches!! <grin>
  249.  
  250.  REGISTRATION
  251.  
  252.  Please view/print REGCOM.DOC for  an explanation of the Registration Plans
  253.  and what you get when you register. A comments form is attached for you to
  254.  submit Greetings, Complaints, Congratulations, Suggestions, Problems,
  255.  Invitation To Your Party,  or whatever.
  256.  
  257.  
  258.  AUTHOR CONTACT
  259.  
  260.         I can be reached by several means.
  261.  
  262.         Phone: (510) 651-0253 Ask for Rand
  263.           If you get my wife, or the answering machine, please leave your
  264.           name, number, and a brief description of the problem, and I will
  265.           get back to you ASAP! (See SUPPORT below)
  266.  
  267.         Net Mail:        1:215/777  or 1:161/42  Rand Nowell
  268.         Compuserve ID:   76124,761 (Checked 1-2 times a month, minimum)
  269.         Genie ID:        R.NOWELL  (Checked 1-2 times a month, minimum)
  270.         FIDO Net:        Shareware conference:  Rand Nowell
  271.         Mail:            Rand Nowell
  272.                          RaLin Enterprises
  273.                          49728 Sundale Dr.
  274.                          Fremont, Ca. 94538
  275.  
  276.  
  277.    SUPPORT:
  278.          Registered users receive full unlimited support, if I have to call
  279.          you back, it will be on my dime!
  280.  
  281.   Program Documentation - "Sorry", No Music.....
  282.  
  283.  
  284. TFREQ.DOC           Pascal Sound Procedure Construction Tool        Page  4
  285.  
  286.          Unregistered users will receive help, but if I have to call, expect
  287.          a collect one.
  288.  
  289.    See the REGCOM.DOC file for our Registration plans.
  290.  
  291.    If you have any comments (good or bad) or suggestions, please use the
  292.    Comments/Suggestions form attached to the Registration.
  293.  
  294.    Thank You!
  295.  
  296.  
  297.  
  298. ACKNOWLEDGEMENTS:
  299.  
  300.    TFREQ11 was written with Turbo Pascal
  301.    version 6.0, a product of Borland International.
  302.    A GREAT programming language!
  303.    Thanks Borland, for a job well done.
  304.  
  305.  
  306.    To those of you who Register, Thanks for helping support the
  307.    SHAREWARE CONCEPT! Registering this and other products, give the
  308.    authors incentive to continue enhancements and to develop new products
  309.    for your use.
  310.    Program Documentation - "Sorry", No Music.....
  311.  
  312.  
  313.                              ■───END OF FILE───■
  314.  
  315.