home *** CD-ROM | disk | FTP | other *** search
/ Bila Vrana / BILA_VRANA.iso / 031A / MELODY26.ZIP / MELODY26.EXE / DRVSPKR.DOC < prev    next >
Text File  |  1996-01-09  |  48KB  |  1,580 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.                                 SPEAKER DEVICE DRIVER
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.                                      DRVSPKR.SYS
  29.  
  30.  
  31.  
  32.  
  33.                                     User's Guide
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.                             Version of November 13, 1986
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.                                        Preface
  59.  
  60.  
  61.  
  62.                     The loudspeaker provided on an IBM PC, XT and AT
  63.                computer is capable of a variety of audible outputs in
  64.                addition to the normal "beep".  However, there is
  65.                little or no supporting software provided in MS/DOS to
  66.                allow a program to make use of this capability.
  67.  
  68.                     In addition, the normal "beep" is a completely
  69.                processor-intensive operation, resulting in very er-
  70.                ratic operation of programs which occasionally have to
  71.                do a beep.  An example is DBASE III, which beeps at the
  72.                end of an input field.  Normally, such a beep ties up
  73.                the processor, such that it can do nothing else during
  74.                that time.  If several beeps have been queued, the wait
  75.                for all of these to finish can be quite an annoyance.
  76.  
  77.                     This document describes the Speaker Device Driver,
  78.                which provides a solution to these problems.
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.                              Table of Contents
  86.  
  87.  
  88.             1.  INTRODUCTION...................................1
  89.              1.1  The ShareWare Concept........................1
  90.               1.1.1  What You Can Do...........................1
  91.               1.1.2  What You Cannot Do........................2
  92.               1.1.3  What You Should Do........................2
  93.  
  94.             2.  INSTALLING THE SPEAKER DEVICE DRIVER...........4
  95.              2.1  Installing the Driver File...................4
  96.              2.2  Modifying Your CONFIG.SYS File...............4
  97.  
  98.             3.  FACILITIES OF THE SPEAKER DEVICE DRIVER........6
  99.              3.1  Checking Out Your Beep.......................6
  100.              3.2  Interrupt-Driven Operation...................7
  101.              3.3  Multiple Beep Suppression....................7
  102.              3.4  Non-Processor-Speed Dependent................8
  103.              3.5  Making A Beep................................8
  104.              3.6  Changing the Sound of Your Beep..............9
  105.              3.7  Producing a Sequence of Tones................9
  106.              3.8  Buffered Tone Generation....................10
  107.              3.9  A New Device................................10
  108.  
  109.             4.  SPEAKER DEVICE DRIVER COMMANDS................11
  110.              4.1  The Basics..................................11
  111.              4.2  Commands Available..........................12
  112.               4.2.1  F - Frequency............................12
  113.               4.2.2  G - Gap..................................12
  114.               4.2.3  D - Duration of Each Tone................13
  115.               4.2.4  T - Tempo................................13
  116.               4.2.5  P - Pause................................14
  117.               4.2.6  R - Resume...............................14
  118.               4.2.7  B - Begin Recording......................15
  119.               4.2.8  E - End Recording........................15
  120.               4.2.9  Unrecognized Commands....................15
  121.               4.2.10  Controlling the Volume..................15
  122.               4.2.11  Chords..................................16
  123.  
  124.             5.  HOW TO CONFIGURE YOUR BEEP....................17
  125.              5.1  Several More Example Beeps..................17
  126.  
  127.             6.  SENDING COMMANDS TO THE DRIVER................19
  128.              6.1  From A Program..............................19
  129.              6.2  From the Console Keyboard...................19
  130.              6.3  From a File.................................20
  131.               6.3.1  Sending Other Sequences..................21
  132.              6.4  Testing Your Beep...........................21
  133.  
  134.             7.  ABOUT THE AUTHOR..............................23
  135.  
  136.  
  137.  
  138.                                                                           i
  139.  
  140.  
  141.  
  142.  
  143.  
  144.  
  145.           Speaker Device Driver User's Guide
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.           1.  INTRODUCTION
  153.  
  154.  
  155.                The loudspeaker provided on an IBM  PC,  XT  and  AT
  156.           computer  is  capable  of a variety of audible outputs in
  157.           addition to the normal "beep".  However,  there is little
  158.           or  no  supporting software provided in MS/DOS to allow a
  159.           program to make use of this capability.
  160.  
  161.                In addition,  the  normal  "beep"  is  a  completely
  162.           processor-intensive operation,  resulting in very erratic
  163.           operation of programs which occasionally  have  to  do  a
  164.           beep.  An example is DBASE III, which beeps at the end of
  165.           an  input  field.    Normally,  such  a  beep ties up the
  166.           processor,  such that it can do nothing else during  that
  167.           time.    If several beeps have been queued,  the wait for
  168.           all of these to finish can be quite an annoyance.    This
  169.           is  even  more  of  a problem when you are are on-line to
  170.           some other computer.  The beeps that you receive normally
  171.           tie up your communications software,  slowing  down  your
  172.           communications and in extreme cases causing data loss due
  173.           to buffer overrun.
  174.  
  175.                This  document  describes the Speaker Device Driver,
  176.           which provides a solution to these problems.
  177.  
  178.  
  179.           1.1  The ShareWare Concept
  180.  
  181.  
  182.                The "ShareWare" concept is basically  an  experiment
  183.           in  the  marketing and distribution of software.   It at-
  184.           tempts to cut down on distribution and marketing expenses
  185.           so that quality software can be made widely available  at
  186.           the  lowest  possible price.   This concept also makes it
  187.           possible for users to try the software before they decide
  188.           to keep (and, hopefully, pay) for it.  This is very handy
  189.           in a world full of competing packages!
  190.  
  191.  
  192.           1.1.1  What You Can Do
  193.  
  194.  
  195.  
  196.  
  197.           Rev. November 13, 1986 23:38:47                               -1-
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.           Speaker Device Driver User's Guide
  206.  
  207.  
  208.  
  209.  
  210.                This software is being placed into the public domain
  211.           as "ShareWare".   This means that you are  encouraged  to
  212.           copy  this  software  and  give it to your friends and/or
  213.           business associates.  You may also use it in a commercial
  214.           environment.  However,  you may not sell the software for
  215.           more  than  the cost of the diskette and a small handling
  216.           charge.   If you paid more than five or ten  dollars  for
  217.           the  diskette  with  this  software on it,  you have been
  218.           cheated!   Please advise the program's author (my address
  219.           appears  at  the  end  of this document) of the price you
  220.           paid, when, and from whom you purchased it.
  221.  
  222.                If you distribute a copy of this software to  anyone
  223.           else, you must distribute it complete and unchanged.  You
  224.           must not change the program,  the user's guide, or any of
  225.           the other files on the diskette.   (You are permitted  to
  226.           add additional files on the diskette if you like, as long
  227.           as  you  clearly  identify yourself in the files you add,
  228.           along with the date you add those files to the diskette).
  229.  
  230.                You will find,  especially if you have a hard  disk,
  231.           that this is a product you will use literally every day.
  232.  
  233.  
  234.           1.1.2  What You Cannot Do
  235.  
  236.  
  237.                As  just mentioned,  you cannot modify or delete any
  238.           of the files you find on the diskette  when  you  give  a
  239.           copy of it to anyone else.  If you base a product on this
  240.           one,  which you intend to sell for profit,  you must make
  241.           arrangements for such