home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 5 / DATAFILE_PDCD5.iso / utilities / s1 / sysbeep / !SysBeep / !Help < prev    next >
Encoding:
Text File  |  1991-10-15  |  13.1 KB  |  205 lines
  1.  
  2.  
  3.      System Beep Help File.
  4.      ======================
  5.  
  6.     SysBeep was written by P.R.Banks for the Arc++ (A Division of The Desk
  7.   Top Project) programmers group. Arc++ consists of :-
  8.  
  9.                   Philip R. Banks,
  10.                   Friso Dijstelbergen,
  11.                   Gavin Flower,
  12.                   Jim Moriarty,
  13.                   Brian Mudge,
  14.                   Julian Wright.
  15.  
  16.    We are a New Zealand programming team and can be contacted at :-
  17.  
  18.            The Desk Top Project Ltd,
  19.             PO. Box 9421,
  20.             Te Aro,
  21.             Wellington,
  22.             New Zealand.
  23.  
  24.     SysBeep is *not* PD but rather shareware. Accordingly you may copy this
  25.   application for distribution purposes providing all files in this sub-
  26.   directory are copied unchanged. If you decide to keep this application
  27.   a fee of ten dollars ($NZ) sent to the above address is required. If you 
  28.   send a disk with the fee and a self addressed and stamped envelope we will
  29.   send back the documentation files on the DataVox Modules that are the power
  30.   house behind this application. Recieving these documentation files gives 
  31.   you the right to use the Datavox Modules for *private* use. We do not give
  32.   permision for any code/files in this application to be used in *any* 
  33.   distributed form without our written consent.
  34.      SysBeep is very simple to use. Double click on its icon,as usual, to
  35.   install it on the icon bar. Clicking on the icon with select will open a 
  36.   window that displays information about the current beep. Here you can 
  37.   change the beeps data-type (By clicking on the three data-type icons) ,its
  38.   pitch (by the up and down arrows),play the beep (by clicking on the 
  39.   vibrating speaker icon with select),stop a beep (by clicking on the
  40.   vibrating speaker icon with adjust),determine whether the fixed pitch or
  41.   the normal system pitch is used (by clicking on the fixed pitch icon.) &
  42.   reverse the direction of play of the beep. You can also change the system
  43.   volume by dragging on the Red Bar in the right corner. Reducing this bar
  44.   to 50% of its full size reduces the system volume to 50% of full volume.
  45.   Clicking on the double arrows adds/subtracts 2048 from the pitch,the thick
  46.   single arrow adds/subtracts 128 and the thin arrow adds/subtracts 1.
  47.   Clicking with adjust on these arrows causes them to do the opposite of what
  48.   they normally do. Clicking on the icon on the iconbar with adjust will halt
  49.   the beep if it is playing. You can also turn the internal speakers on/off
  50.   as well by clicking on the icon marked `Speaker(s)'.
  51.      Clicking menu summons a menu looking like this :-
  52.  
  53.      +-------------+
  54.      | System Beep |
  55.      +-------------+
  56.      | Info     -» |
  57.      | Claim Beep  |
  58.      | Save     -» |
  59.      | Quit        |
  60.      +-------------+
  61.  
  62.      'Info' :- Almost Bog standard window telling you about this application.
  63.      'Claim Beep' :- This reclaims sound channel 1 if another application
  64.        grabs it. Armadeus or STracker are prone to this. No longer does it
  65.        reset the System Speed or buffer size. DataVox has been updated to
  66.        cope with changing system speeds so this is unecessary.
  67.      'Save' :- This leads to a standard save dialog box. To learn how to use 
  68.        it read your User guide....
  69.      'Quit' :- This shuts the application down. It returns the beep channel 
  70.        back to the voice it claimed it from if it can or it will leave the
  71.        beep running. It will ask which action you wish to perform.
  72.                   
  73.       The modules that Sysbeep is the interface for have built into them
  74.    system speed independence. This means when the sample rate of the sound
  75.    system changes it adjusts itself to ensure that the sound is played at
  76.    the correct pitch. However if you turn the fixed pitching off and the
  77.    system speed changes while it is off then the module will *not* adjust
  78.    to cope. As far as I am aware DataVox (the module suite behind Sysbeep)
  79.    is the first ever sound player to do this on the Arc.
  80.       It must be noted that due to constraints on the multi-tasking use of
  81.    the sound system and the fact that SysBeep needs a particular sound
  82.    channel that SysBeep can only ever have one copy of itself active at a
  83.    time. Also if another application using the DataVox module has claimed
  84.    the needed channel SysBeep will refuse to install itself. Unfortunately
  85.    this is a little messy at the moment because the sound system on the
  86.    Arc does not yet have a consistant system for accessing itself in a
  87.    multi-tasking manner. Hopefully this will be fixed by Acorn soon...
  88.       To load a file simply drag it onto the applications icon or window and 
  89.    it will be loaded. Of course if the file is a sysbeep file double clicking
  90.    on it will load it. SysBeep will load Armadeus sound samples (not songs) 
  91.    and try to play them at their proper speed. I have not tested the 
  92.    alogorithm for the loading of Armadeus Samples with sample rates higher 
  93.    than 22KHz. If you hit a problem with the loading of an Armadeus file then
  94.    send me the file at one of the above address and I will try to correct 
  95.    the fault for you. SysBeep will also load DSEdit raw sound files but makes
  96.    no guess to the correct playback speed. And that is the lot. This 
  97.    application was written so that I could drive my family nuts with unusual 
  98.    beeps (Which I collect). Hope you like it.
  99.      For the more advanced users SysBeep can be set to load a file other
  100.    than its default file by simply setting the system variable
  101.    `SysBeep$Default' to hold the *full* pathname of the file. Then at 
  102.    startup SysBeep will load that file for you if you have not started it
  103.    by double clicling on one of its files... Also for those who need it
  104.    interactive help has been provided. Simply run the !Help application
  105.    on Application disk 1 and enjoy!
  106.      If you have any queries or bug reports I can be contacted at the
  107.    address above or by emailing to 'banksie@st1.vuw.ac.nz' (This email 
  108.    address is valid until 31-Dec-1991). Also any queries to the rest of our 
  109.    group can be directed to this email address.
  110.  
  111.   +-------+-----------------------------------------------------------------+
  112.   |Version| Comments                                                        |
  113.   +-------+-----------------------------------------------------------------+
  114.   | 1.00  | First front end for the Data Vox Module Pair. Simply allowed the|
  115.   |       |   user to control the data type & pitching of the system beep.  |
  116.   |       |   Also allowed playing of the beep. (02-Mar-1991)               |
  117.   | 1.01  | Added the save & load code for all files. This then allows you  |
  118.   |       | to create SysBeep files from scratch by loading em with a drag  |
  119.   |       |   and saving them as normal. (08-Mar-1991)                      |
  120.   | 1.02  | Tidied up internal code and added the Claim Beep option. Now    |
  121.   |       |   lets you reclaim the beep channel if it has been reassigned.  |
  122.   |       |   (05-Apr-1991)                                                 |
  123.   | 1.03  | Added the code for interactive Help via the !Help application.  |
  124.   |       |   (06-Apr-1991)                                                 |
  125.   | 1.04  | Corrected an internal error or two and improved the window      |
  126.   |       |   handleing slightly. (03-May-1991)                             |
  127.   | 1.05  | Corrected an error in the loading of files that caused the      |
  128.   |       |   program to error... (04-May-1991)                             |
  129.   | 1.06  | Tidied up the handling of Loading of files to prevent unwanted  |
  130.   |       |   static/noise due to differing data types. (05-May-1991)       |
  131.   | 1.07  | Corrected wimp key handling error. (06-May-1991)                |
  132.   | 1.08  | Added memory checking code as well as extensions to the Help    |
  133.   |       |   system. (18-May-1991)                                         |
  134.   | 1.09  | Added the code to load and use DSEdit and Armadeus sound sample |
  135.   |       |  files. Only raw sound DSEdit files are supported. (19-May-1991)|
  136.   | 1.10  | Added the Stop beep and shifting icon features. Now the user can|
  137.   |       |   stop a beep playing and they get a graphical indication that a|
  138.   |       |   beep is playing. (08-Jun-1991)                                |
  139.   | 1.11  | `Templated' the help window to save on application space. Did a |
  140.   |       |   little bit of code tidying towards this end. (15-Jun-1991)    |
  141.   | 1.12  | Added the 'leave beep' code to SysBeep allowing a beep to be    |
  142.   |       |   set-up and the application killed with the beep still resident|
  143.   |       |   . (06-Jul-1991)                                               |
  144.   | 1.13  | Added the extra code to shade the pitching icons when fixed     |
  145.   |       |   pitching is turned off. Also added extra startup code to      |
  146.   |       |   recognise an already existing beep present in memory. (06-Jul-|
  147.   |       |   1991)                                                         |
  148.   | 1.14  | Extended the Claim Beep menu option to reset the sound system   |
  149.   |       |   back to its defaults. (07-Jul-1991)                           |
  150.   | 1.15  | Added the Volume Bar slider to allow the setting of the system  |
  151.   |       |   volume. (13-Jul-1991)                                         |
  152.   | 1.16  | Made the Volume Bar truely linear for a more natural setting    |
  153.   |       |   action (ie. Bar at 50% of length means 50% volume. Instead of |
  154.   |       |   a logarithmic scale.) (15-Jul-1991)                           |
  155.   | 1.17  | Made the Volume bar effect instant changes as it is dragged.    |
  156.   |       |   Pathetic what we do for version numbers isn't it?(15-Jul-1991)|
  157.   | 1.18  | Fixed a Bug in the Volume bar that caused the volume to be set  |
  158.   |       |   to full when you dragged it to minimum! (Ooops!) Now it has a |
  159.   |       |   proper minimum value. (15-Aug-1991)                           |
  160.   | 1.19  | Extended the interactive help for the Volume Bar to be better.  |
  161.   |       |   It now displays over all of the dragable area. (15-Aug-1991)  |
  162.   | 1.20  | Altered the Interactive help system to report the system volume |
  163.   |       |   as a precentage which is easier to read. (18-Aug-1991)        |
  164.   | 1.21  | Extended to handle the extra facilities of DataPlayer v3.08.    |
  165.   |       |   (31-Aug-1991)                                                 |
  166.   | 1.22  | Extended to handle the sound system slightly better. Also it now|
  167.   |       |   nolonger resets the system speed when the beep is re-claimed. |
  168.   |       |   (31-Aug-1991)                                                 |
  169.   | 1.23  | Tidied up the icons and layout of the main window. Now it looks |
  170.   |       |   alot cuter. (Well I think so anyway.) (31-Aug-1991)           |
  171.   | 1.24  | Fixed an error in the file save code. It wasn't quite correctly |
  172.   |       |   reading the desired name out. (1-Sep-1991)                    |
  173.   | 1.25  | Fixed properly the save error and extended the interactive help |
  174.   |       |   to cover the save file dialog box. (1-Sep-1991)               |
  175.   | 1.26  | Fixed an error in key processing. Now the save box does respond |
  176.   |       |   properly to return key presses. (1-Sep-1991)                  |
  177.   | 1.27  | Set up SysBeep so that it can load files other than its default |
  178.   |       |   file by the setting of a system variable. (1-Sep-1991)        |
  179.   | 1.28  | Corrected a minor error in the save dialogs behaviour. Now it   |
  180.   |       |   closes the menu when and how it should. (02-Sep-1991)         |
  181.   | 1.29  | Updated the interface to cope with the multi-tasking features   |
  182.   |       |   of DataVoxPlayer v3.10. (15-Sep-1991)                         |
  183.   | 1.30  | Fixed an interesting omission of the file loading code for when |
  184.   |       |   the application is being summoned to run a file and is not    |
  185.   |       |   already memory resident. I wonder how I forgot that code...   |
  186.   |       |   (15-Sep-1991)                                                 |
  187.   | 1.31  | Fixed an error in the play button icon that had been bothering  |
  188.   |       |   me for days! (15-Sep-1991)                                    |
  189.   | 1.32  | Set SysBeep up to remember the voice it claimed its channel off |
  190.   |       |   across instantations as needed. This means you can run the    |
  191.   |       |   front-end to set-up the beep,quit it leaving the beep active, |
  192.   |       |   and then re-run the application to kill the beep properly     |
  193.   |       |   and it will still return the channel back to the original     |
  194.   |       |   owner. (16-Sep-1991)                                          |
  195.   | 1.33  | Corrected SysBeep to stop it from locking up if someone did     |
  196.   |       |   something nasty to its channel allocation with DataVox. Now it|
  197.   |       |   quits gracefully rather than locking up... (15-Oct-1991)      |
  198.   | 1.34  | Corrected an error with the DragBox code in the Save Dialog     |
  199.   |       |   box. You never would have noticed it unless you use extra     |
  200.   |       |   wide screen modes... (15-Oct-1991)                            |
  201.   +-------+-----------------------------------------------------------------+
  202.  
  203.   If this file flashed by too fast load.... Oh you know 
  204.   what to do. After all if you are using an Arc you must
  205.   have *some* brains.