home *** CD-ROM | disk | FTP | other *** search
/ Power CD-ROM!! 7 / POWERCD7.ISO / sndtools / dafort20 / dafort.doc < prev    next >
Text File  |  1994-01-05  |  21KB  |  501 lines
  1.            /----------\
  2.           |    TAG     |  Presents
  3.           |  SOFTWARE  |     . . . . Digital Audio Fortune 2.0
  4.            \----------/
  5.  
  6.      Digital Audio Fortune 2.0 is a fortune cookie program with a
  7.      twist.  Unlike most fortune cookie programs that print cute
  8.      messages or a quote, Digital Audio Fortune 2.0 plays a
  9.      randomly selected digital audio file from a user's defined
  10.      list. 
  11.  
  12.      DAFORT plays .VOC, .WAV, .SND, .AU, .DAS, and raw sound
  13.      files.  It will actually allow you to play any file.
  14.      However, remember that the principle of Garbage In Garbage
  15.      Out applies.  Playing non-sound files can be hard on the
  16.      ears.  For the Sound Blaster, DAFORT 2.0 uses a Double
  17.      Buffered Direct Memory Access (DMA) technique that allows it
  18.      to play very large digital audio files.  For the AdLib,
  19.      Disney Sound Source, and the PC Speaker, DAFORT 2.0 uses a
  20.      Double Buffered background playing technique that again
  21.      allows it to play very large digital audio files. 
  22.  
  23.      Digital Audio Fortune 2.0 requires an IBM PC or compatible, a
  24.      Sound Blaster, AdLib Personal Computer Music System, Disney
  25.      Sound Source or 100% compatibles, and only 256K of available
  26.      RAM. 
  27.      
  28.      Digital Audio Fortune 2.0 is distributed as Shareware: if you
  29.      like the program, please become a registered user.  See the
  30.      heading "Registration Benefits" at the end of this file for
  31.      more information.  Print the file REGISTER.DOC for ordering
  32.      information.  Distribution of this shareware program is
  33.      encouraged.
  34.  
  35.      The Digital Audio Fortune 2.0 source code, object code,
  36.      executables and manuals on paper or on disk, are COPYRIGHT
  37.      (c) 1993 by Carole & Allen Grider. 
  38.  
  39.      DISCLAIMER
  40.  
  41.      This program is provided "AS IS" and it is WITHOUT warranty
  42.      of any kind that it will work correctly in any or all
  43.      situations. No liability shall be assumed for direct or
  44.      consequential damage caused by the use of this software.
  45.      The only claim TAG SOFTWARE makes is that there are no
  46.      intentional bugs or fatal errors in any original copy of
  47.      the program that you receive directly from TAG SOFTWARE. 
  48.  
  49.      MANIFEST
  50.      
  51.          DAFORT.DOC . . . . Text, Documentation (This file)
  52.          DAFORT.EXE . . . . Digital Audio Fortune executable
  53.      DAFORT.RC  . . . . Example Sound File List
  54.          README.DOC . . . . Text, Last minute information
  55.          REGISTER.DOC . . . Text, Registration order form
  56.          DAFALARM.DOC . . . How to use DAFORT with Telemate 4.0
  57.          TMALARM.BAT  . . . Telemate external alarm example .BAT file
  58.          ALARM_0.RC . . . . Sounds list for TMALARM.BAT Transfer success
  59.          ALARM_1.RC . . . . Sounds list for TMALARM.BAT Transfer failure
  60.          ALARM_2.RC . . . . Sounds list for TMALARM.BAT Connected to BBS
  61.          ALARM_3.RC . . . . Sounds list for TMALARM.BAT Script Alarm
  62.          ALARM_4.RC . . . . Sounds list for TMALARM.BAT Warning
  63.      CATALOG.DOC  . . . Text, Catalog of TAG SOFTWARE Products
  64.      BING.DAS . . . . . Digital Sound, Monty Python
  65.      BUGSBUNY.VOC . . . Digital Sound, Bugs Bunny "What's up doc"
  66.      KLAXON1.WAV  . . . Digital Sound, Ships klaxon
  67.      ILLBEBAK.SND . . . Digital Sound, Terminator 2 "I'll be back"
  68.  
  69.      DISTRIBUTION
  70.      
  71.      Distribution of this program is encouraged as long as the
  72.      following Shareware principles are observed:
  73.  
  74.           All of the above-mentioned 17 files should be
  75.           included in the distributed disk and should not be
  76.           altered in any way. TAG SOFTWARE authorizes the
  77.           distribution ONLY of the 17 above-mentioned files.
  78.      
  79.      If archiving this program for BBS use or library use,
  80.      please include all files and use the name: DAFORT20, ( e.g.:
  81.      DAFORT20.ARC or DAFORT20.ZIP ).  This will provide
  82.      consistency for future updates. 
  83.  
  84.      Note for Disk and Rack Vendors: Please contact TAG SOFTWARE
  85.      for the latest version of this and all our programs.  Disk
  86.      and Rack Vendors are allowed to include their own
  87.      installation package.  Also contact us if you require
  88.      customization.  We will consider non-exclusive registration
  89.      handling agreements. 
  90.  
  91.      Rack Vendors: Please contact TAG SOFTWARE regarding discounts
  92.      to your customers for registering our shareware.  We will
  93.      consider discounting some or all of the rack price from our
  94.      registration fee, if we receive some kind of proof-of-purchase. 
  95.  
  96.      SYSTEM REQUIREMENTS AND OPTIONS
  97.      
  98.      COMPUTERS:   IBM/PC/XT/AT or compatibles.  256K free memory.
  99.      SOUND CARD:  Sound Blaster, AdLib Personal Computer Music
  100.                   System, Disney Sound Source, or 100% Compatibles.
  101.      
  102.      OPERATION
  103.  
  104.      Digital Audio Fortune is invoked from the MSDOS command line
  105.      or batch file:
  106.  
  107.          DAFORT [ -sN ] [ -a ] [ -d ] [ -p ] sound_list_file
  108.  
  109.      Options:
  110.  
  111.          -sN   Play at speed N, overrides speed in .SND, .VOC,
  112.                .WAV, .AU  or sets speed for raw sound files.  If
  113.                speed is not specified, DAFORT plays raw files at
  114.                8000 samples per second.  N can range from 2000 to
  115.                44100 depending on the range supported by your device.
  116.  
  117.          -a    Play sound files on a Sound Blaster in AdLib FM
  118.                mode.  May be required on some Sound Blaster clones.
  119.  
  120.          -d    Play sound on a Disney Sound Source connected to
  121.                your parallel port (LPT1).
  122.  
  123.          -p    Play sound files on your PC Speaker.
  124.  
  125.      sound_file_list  is the pathname to a file containing a list
  126.                    of pathnames for DAFORT to randomly select from.
  127.  
  128.      DAFORT 2.0 should auto-detect both the Sound Blaster and AdLib
  129.      sound cards.  The Sound Source cannot be detected.  You must
  130.      use the -d option to play on this device.  If DAFORT 2.0 does
  131.      not detect a sound card, it attempts to play the sound file
  132.      on the PC Speaker.  See the NOTES ON SOUND CARDS section
  133.      below.
  134.  
  135.      Examples:
  136.  
  137.          DAFORT DAFORT.RC
  138.  
  139.      Plays a sound file randomly selected from the list of sound
  140.      files given in DAFORT.RC.  Plays any raw sound files selected
  141.      at 8000 samples per second. 
  142.  
  143.          DAFORT -s11111 DAFORT.RC
  144.  
  145.      Plays a sound file randomly selected from the list of sound
  146.      files given in DAFORT.RC.  Plays any raw sound files selected
  147.      at 11111 samples per second.
  148.  
  149.      We like to put DAFORT into our AUTOEXEC.BAT file (at the
  150.      end), so it will play a random file each time we boot the
  151.      computer.  To do this, edit your AUTOEXEC.BAT file.  At the
  152.      end of the file, add:
  153.  
  154.           DAFORT DAFORT.RC
  155.  
  156.      with any options that you desire.  Build the DAFORT.RC file
  157.      (see Sound File List section for format below).  Save both
  158.      files and reboot.  You should hear a random file played.
  159.  
  160.      DAFORT can also be used to play random digital sound files for
  161.      external alarms from the Telemate 4.0 communications program.
  162.      See the file DAFALARM.DOC for more information.
  163.  
  164.      CONFIGURATION
  165.  
  166.      SOUND FILE LIST
  167.  
  168.      The format of the sound file list file required by Digital
  169.      Audio Fortune 2.0 is very simple.  It is just the pathnames to
  170.      the digital audio files, one per line.  This file can be
  171.      built using any ASCII editor (such as edline).  It is
  172.      suggested that you use fully qualified pathnames (that start
  173.      with the disk (e.g. C:) and specify all the directories down
  174.      to the file along with the file name.  Blank lines can be used.
  175.      If anyone really wants it, we can add support for comment lines.
  176.  
  177.      Example: (This is what we currently have set up on our machine.)
  178.  
  179.     C:\SOUNDS\TVMOVIE\CURLEY.VOC
  180.     C:\SOUNDS\TVMOVIE\BONANZA.VOC
  181.     C:\SOUNDS\CARTOONS\FOGHORN.SND
  182.     C:\SOUNDS\CARTOONS\HEYROCKY.WAV
  183.     C:\SOUNDS\TVMOVIE\JUSTFACT.VOC
  184.     C:\SOUNDS\TVMOVIE\SELFDEST.VOC
  185.     C:\SOUNDS\TVMOVIE\STOOGES1.VOC
  186.     C:\SOUNDS\CARTOONS\SUPERMAN.VOC
  187.     C:\SOUNDS\CARTOONS\UNDERDOG.VOC
  188.  
  189.      If Digital Audio Fortune has trouble finding or opening a
  190.      file it will issue an error message and attempt to select
  191.      another one.  After 10 bad attempts, it issues another error
  192.      message and aborts.
  193.  
  194.      Sound Blaster CONFIGURATION
  195.  
  196.      An environment variable can be used to inform DAFORT of the
  197.      information it requires to play sounds on the Sound Blaster.
  198.      This environment variable is set up by newer versions of the
  199.      Sound Blaster's installation program, but older Sound
  200.      Blaster's (and clone's) installation programs do not set up
  201.      this environment variable. 
  202.  
  203.      Digital Audio Fortune can obtain its configuration from the
  204.      environment variable BLASTER.  The format of the information
  205.      in this variable is as follows:
  206.  
  207.          SET BLASTER=Annn In Dn Tn 
  208.  
  209.      Where:
  210.  
  211.          Annn    nnn specifies the I/O Address of your sound card.
  212.  
  213.           Sound Blaster 1.0, 1.5, and 2.0:
  214.           Possible values: 210, 220, 230, 240, 250, 260
  215.          Factory Default: 220 (if not changed via hardware jumper).
  216.  
  217.          Sound Blaster Pro:
  218.           Possible values: 220, 240
  219.          Factory Default: 220 (if not changed via hardware jumper).
  220.  
  221.          Sound Blaster 16:
  222.           Possible values: 220, 240, 260, 280
  223.          Factory Default: 220 (if not changed via hardware jumper).
  224.  
  225.          In      n specifies the IRQ of your sound card.
  226.  
  227.           Sound Blaster 1.0, 1.5, and 2.0:
  228.           Possible values: 2, 3, 5, 7
  229.          Factory Default: 7 (if not changed via hardware jumper).
  230.  
  231.           Sound Blaster Pro
  232.           Possible values: 2, 5, 7, 10
  233.          Factory Default: 7 (if not changed via hardware jumper).
  234.  
  235.           Sound Blaster 16
  236.           Possible values: 2, 5, 7, 10
  237.          Factory Default: 5 (if not changed via hardware jumper).
  238.  
  239.          Dn     n specifies the 8-bit DMA Channel used by your sound card.
  240.  
  241.           Sound Blaster 1.0, 1.5, and 2.0:
  242.           Possible values: 1
  243.          Factory Default: 1 (not changable)
  244.  
  245.           Sound Blaster Pro
  246.           Possible values: 0, 1, 3
  247.          Factory Default: 1
  248.  
  249.           Sound Blaster 16
  250.           Possible values: 0, 1, 3
  251.          Factory Default: 1 (not changable)
  252.  
  253.          Note that DAFORT 2.0 only supports DMA channel 1.
  254.  
  255.      Tn     n specifies the Type of your sound card.
  256.          See NOTES ON SOUND CARDS below for more information.
  257.          Possible values:
  258.              1        Sound Blaster 1.0 or 1.5
  259.              2        Sound Blaster Pro
  260.              3        Sound Blaster 2.0
  261.              6        Sound Blaster 16
  262.                  Currently DAFORT does nothing with this value.
  263.  
  264.      For a Sound Blaster just out of the box (before you muck with
  265.      the jumpers) use:
  266.  
  267.          SET BLASTER=A220 I7 D1 T1
  268.  
  269.      or:
  270.  
  271.          SET BLASTER=A220 I7 D1 T3
  272.  
  273.      For a Sound Blaster 1.5 (what we have) on IRQ 5 (like us, most
  274.      people have a printer on IRQ 7):
  275.  
  276.           SET BLASTER=A220 I5 D1 T1
  277.  
  278.      The Sound Blaster Pro and Sound Blaster 16 supports
  279.      additional DMA Channels.  However, Digital Audio Player does
  280.      not support the additional DMA Channels.  If your card's
  281.      configuration fits the ranges given above, then Digital Audio
  282.      Player 2.0 should work.  If you have problems, please
  283.      contact us.
  284.  
  285.      Digital Audio Fortune 2.0 has the ability to auto-detect the
  286.      Sound Blaster.  But, if it has trouble (please let us know)
  287.      you can set the BLASTER environment variable to get around
  288.      the problem.
  289.  
  290.      AdLib CONFIGURATION
  291.  
  292.      Digital Audio Fortune 2.0 has the ability to auto-detect the
  293.      AdLib Personal Computer Music System sound card.
  294.  
  295.      Disney Sound Source CONFIGURATION
  296.  
  297.      Digital Audio Fortune 2.0 cannot auto-detect the Sound Source.
  298.      You have to inform it that a Sound Source exists on your
  299.      system.  Use the "-d" option to do this.  For example:
  300.  
  301.          DAFORT -D DAFORT.RC
  302.  
  303.      PC Speaker CONFIGURATION
  304.  
  305.      Digital Audio Player 2.0 assumes a IBM PC/XT/AT clone
  306.      speaker.  If you have a Sound Blaster or AdLib sound card you
  307.      can override DAPLAY's autodetection and play sound files on
  308.      the PC Speaker by using the "-p" option.
  309.  
  310.      NOTES ON SOUND FILES
  311.  
  312.      It seems that every sound card manufacturer has developed its
  313.      own digital audio file format.  Creative Labs, being the first
  314.      with the cheapest, has prevailed with their .VOC format.
  315.      This was true until MicroSoft released Windows with the
  316.      Multi-Media Extensions.  The Windows Multi-Media Extensions
  317.      uses the .WAV formatted digital audio files.  Another (older)
  318.      format are the .SND files.  Some seem to be MacBin format
  319.      with the original Data Fork and Information Fork information
  320.      intact.  Others come from older sound packages called SOUNDER
  321.      and SoundTools.  Another source of sound files are Sun/NeXT
  322.      systems with their .AU format.
  323.  
  324.      Currently .VOC files are the most prevalent, with .WAV files
  325.      catching up fast.  .SND files are seen here and there, but
  326.      sometimes contain really unique sounds not seen in .VOC or
  327.      .WAV format.  This is very strange, because it is trivial to
  328.      convert between these various formats.  Digital Audio Fortune
  329.      2.0 should play all .VOC, .WAV, .AU, and most .SND files.
  330.      There are actually several file formats that all use the .SND
  331.      extension.  We currently support two of them.  If you have
  332.      trouble getting a particular file to play properly, please
  333.      send it to us.  We will take a look at it and see if we can
  334.      fix the problem.  Please send us suggestions on other file
  335.      formats you would like to see supported.  Note, it is easier
  336.      for us to support a file format when we have examples. 
  337.  
  338.      Sound files can use up a very large amount of disk space.
  339.      Understand that a high quality 8-bit sound file sampled at
  340.      23kHz uses 23,000 bytes every second.  Things will only get
  341.      worse when the newer sound cards with stereo and higher
  342.      sampling rates prevail in the market.  Imagine a 44kHz stereo
  343.      16-bit sound file.  Only 10 seconds of sound will tie up
  344.      1,760,000 bytes (44,000 * 2 * 2 * 10).  No wonder the
  345.      Multi-Media standard calls for a CD-ROM.
  346.  
  347.      We at TAG SOFTWARE have been working on this problem.  We
  348.      have come up with a compression technique that generally
  349.      achieves better compression than general purpose compressors.
  350.      This technique can be used to lossless and lossy compress
  351.      sound files.  And, these compressed sound files can be
  352.      decompressed and played on-the-fly.  We call this sound file
  353.      type .DAS.  The file BING.DAS is an example of this file
  354.      type.  The original sound file was Mono, 8-bit, 22Khz and was 69999
  355.      bytes long (3.175 seconds).  BING.DAS has been compressed at
  356.      loss level 2 and is only 21920 bytes long.  A compression
  357.      ratio of 68% (3 to 1).  If you are interested in compressing
  358.      your own sound files look for Digital Audio Sound Compressor
  359.      (DASCMP10.ZIP) at your favorite disk vendor, BBS, or rack.
  360.  
  361.      If you have trouble getting good digital audio files, see our
  362.      Digital Audio Collection Series.  We have selected some of
  363.      the best audio files available and can supply them in .VOC or
  364.      .WAV format.
  365.  
  366.      NOTES ON SOUND CARDS
  367.  
  368.      Creative Labs Sound Blaster
  369.  
  370.      Creative Labs has issued several different sound cards - all
  371.      under the name Sound Blaster.  The cards and their differences
  372.      are listed below:
  373.  
  374.            Sound Blaster 1.0 - The original.  Mono FM. Comes with CMS
  375.             chips. 100% AdLib, GameBlaster compatible plus
  376.             mono 8 bit DAC 4kHz-23kHz / ADC 4kHz-12Khz.
  377.  
  378.           Sound Blaster 1.5 - Same as above but they made the CMS
  379.             chips optional (CMS chips are required for
  380.             GameBlaster compatibility).
  381.  
  382.           Sound Blaster 2.0 - Same as above but the CMS support was
  383.             dropped completely (Seems they weren't selling).
  384.  
  385.           Sound Blaster Pro - Same as Sound Blaster 2.0 but adds
  386.                         stereo support.
  387.  
  388.           Sound Blaster 16 - Same as Sound Blaster 2.0 buts adds
  389.                         both stereo and 16-bit support.
  390.  
  391.      Digital Audio Fortune 2.0 should work properly with all three
  392.      types, but currently only supports Mono 8-bit sound files.
  393.      If you have any problems, please let us know. 
  394.  
  395.      Various Sound Blaster clones have been produced with
  396.      different levels of compatibility.  Digital Audio Fortune 2.0
  397.      should work with any Sound Blaster clone with 100% register
  398.      level compatibility.  If you have any problems, please let us
  399.      know.  If you are unable to get DAFORT working with your Sound
  400.      Blaster clone, you can try the AdLib FM option "-a".
  401.  
  402.      AdLib Personal Computer Music System
  403.  
  404.      AdLib produced the first sound card with 9 FM voices.  But it
  405.      has no direct digital audio support.  We have come up with an
  406.      algorithm that allows playing of digital audio sound files on
  407.      the AdLib with surprisingly good results. 
  408.  
  409.      Disney Sound Source
  410.  
  411.      The Disney Sound Source is a parallel port Digital to Analog
  412.      Converter (DAC).  Currently DAFORT only supports this device
  413.      when it is connected to LPT1 (the first parallel port).  The
  414.      sounds that came with ours were really grotty and are not
  415.      representive of the really good digital sound this device can
  416.      produce.
  417.      PC Speaker
  418.  
  419.      The PC's speaker is a truly amazing beast.  Orignally
  420.      designed to only produce beeps and simple tones, it can
  421.      actually perform an amazing range of sounds.  However, one
  422.      has to have a speaker with sufficent volume to be heard.  On
  423.      our 16Mhz machine, the speaker is buried behind a solid front
  424.      and is not loud enough.  Our 25Mhz, on the other hand, the
  425.      speaker's sound is quite acceptable.
  426.      
  427.      DOCUMENTATION AND ACKNOWLEDGEMENTS
  428.  
  429.      If you have a printer, please print out and read this
  430.      documentation file DAFORT.DOC.  We would like to thank the
  431.      many UNIX and DOS fortune cookie programs for this idea.
  432.  
  433.      I would like to thank Bob Chrisp for his information that
  434.      DAFORT worked as an external alarm player for Telemate.
  435.      If anyone knows of a similar way that DAFORT can be used in
  436.      another package, please let us know.  We will give you credit
  437.      here.
  438.  
  439.      FUTURE ENHANCEMENTS
  440.  
  441.      We want to allow a speed override on a per file basis.  We
  442.      have found many sound files with the wrong speed recorded in
  443.      its header.  Besides there are many raw sound files available
  444.      for which our current default is flat wrong.
  445.  
  446.      We would like to add support for stereo sound files.  The
  447.      newer sound cards support stereo, but we need a mixing
  448.      algorithm for playing these files on the older cards.
  449.  
  450.      We would like to add support for 16 bit sound files.  The
  451.      newer cards support this data width, but we need a downsizing
  452.      algorithm for playing these files on the older cards.
  453.  
  454.      We would like to expand the support for the Sound Blaster Pro
  455.      sound card, to include its expanded IRQ's and DMA Channels,
  456.      8 bit stereo, 16 bit mono, etc.
  457.  
  458.      We would like to add support for the Covox Speech Thing and
  459.      clones.  This should be in next release.  We know how to do
  460.      it, but do not have one to test with.  If anyone has one and
  461.      would like to be an alpha tester or if you would sell us one
  462.      cheap, please let us know. 
  463.  
  464.      We would like to add support for other sound cards including
  465.      Pro Audio Spectrum 16, Sound Blaster Pro (stereo), Sound
  466.      Blaster 16, and the MediaVision Ultrasound.  If you have
  467.      programming information on these devices, contact us, maybe
  468.      we can work a deal.
  469.  
  470.      We would like to add support for sound files compressed by
  471.      archivers such as PkZip.  Sound files can absorb huge amounts
  472.      of disk space and text based archivers have a difficult time
  473.      getting good compression of sound files.  However, we all
  474.      like to tweak as much out of our disk as possible.  Plus
  475.      there is the saving in the MSDOS cluster overhead.
  476.  
  477.      REGISTRATION BENEFITS
  478.  
  479.      Digital Audio Fortune 2.0 is distributed as Shareware: if you
  480.      like the program, please become a registered user by sending
  481.      $5 to TAG SOFTWARE.  List or print the file REGISTER.DOC for
  482.      more information.  List or print the file CATALOG.DOC for a
  483.      complete description of all of TAG SOFTWARE's products.
  484.  
  485.      For registering Digital Audio Fortune 2.0:
  486.  
  487.       - You will receive the latest registered version of this
  488.           program. 
  489.  
  490.       - You will receive one FREE disk from our Digital Audio
  491.           Collection Series.  See the file CATALOG.DOC for details as
  492.     to which audio clips are on what disk. 
  493.  
  494.       - Technical Support.  Please write TAG SOFTWARE.  Or you
  495.           can contact us through the Programmer's Corner BBS
  496.     301-596-7692 or 410-995-6873.
  497.  
  498.      As always, we will respond to your suggestions and comments.
  499.      Sometimes we can incorporate your suggestions in the latest
  500.      version of the program that you receive from us. 
  501.