home *** CD-ROM | disk | FTP | other *** search
/ Over Load / MAXIWIN7.ISO / programs / display / readme.txt < prev    next >
Encoding:
Text File  |  1995-06-06  |  5.3 KB  |  137 lines
  1. ┌──────────────────────┐
  2. │  XSB16 Library  1.0  │
  3. └──────────────────────┘
  4.  
  5. This library lets you record and playback sounds using your SB16.
  6. The included library uses LARGE memory model, with Borland 3.1 DOS
  7. compiler.
  8.  
  9.  
  10. Two Sound Blaster 16 access modes are implemented:
  11.  
  12.     - STANDARD mode: play OR record.
  13.  
  14.     - CONCURRENT mode: play AND record simultaneously.
  15.  
  16.  
  17. To use the STANDARD mode, use the xsnd_???(), xsnd16_???() or
  18. xsnd8_???() functions.  This function set offers to the programmer a
  19. high level interface to audio playback or recording, but allows him to
  20. directly access the DMA buffers and SB interrupt. So you can perform
  21. playback or recording eficiently, in your favourite way, without any low
  22. level programming at all.  It's actually powerfull and easy to use!
  23. This functions program directly the SB16, and do not use any of the
  24. CreativeLabs drivers. Nevertheless, no automatic hardware detection is
  25. implemented. You MUST have the BLASTER environment string correctly
  26. set!!
  27.  
  28.  
  29. To use the CONCURRENT mode, use the sb16io_???() funcion set. This
  30. allows you to simultaneously perform recording and playback with your
  31. Sound Blaster 16 audio card!!!!. Make sure that the BLASTER environment
  32. string is correctly set. This mode only works if the 16 bit DMA channel
  33. works fine in your computer (the <H> field of your BLASTER environment
  34. string should be 5, 6 or 7). In this mode, your Sound Blaster 16 will be
  35. able to record 8 bit samples and, at the same time, playback 16 bit
  36. samples. Or the inverse, record 16 bit samples and playback 8 bit
  37. samples. All the operations use DMA transfers, and the user has direct
  38. access to DMA buffers and to Sound Blaster interrupt service function.
  39.  
  40.  
  41.  
  42. ┌───────────────────────────┐
  43. │  Shareware restrictions   │
  44. └───────────────────────────┘
  45.  
  46. This shareware library has the following working restrictions:
  47.  
  48.     - No documentation is included. Just some sample C programs where
  49.       you can see some of the functionality.
  50.  
  51.     - It will use 7500 Hz sampling rate, no matter the value
  52.       you try to program. SB16 produces a backgroud hiss noise
  53.       in your speakers at such a low sampling rate.
  54.  
  55.     - In CONCURRENT mode, it will use a block size of 4096 samples, no
  56.       matter the value you try to program. This block size is the basic
  57.       chunk that the library records/plays. It is actually quite a large
  58.       value, and you will get a long delay between record/playback,
  59.       specially at 7500 Hz  :^)
  60.  
  61.     - In CONCURRENT mode, from time to time the library will return a
  62.       registration audio message instead of the actually recorded
  63.       signal (it's me saying 'register!').
  64.  
  65.  
  66.  
  67. ┌─────────────────┐
  68. │   Registering   │
  69. └─────────────────┘
  70.  
  71. To register, send me 30$ (US DOLARS) or 3000ptas. (SPAIN) using the
  72. included registration form (file REGISTER.TXT). If you register, you
  73. will get:
  74.  
  75.     - Full source code for the library, without any of the restrictions
  76.       present in the shareware version. It uses Borland C 3.1, but is
  77.       structured in such a way to allow easy porting to other compilers,
  78.       as Microsoft C. The source files include also modules for DMA
  79.       programming, DMA buffer allocation and management, interrupt
  80.       management, I/O ports management and Sound Blaster family DSP
  81.       programming. All this modules are self-contained and completely
  82.       reusable for your own applications.
  83.  
  84.     - Source code and documentation for the included MIX.EXE program,
  85.       with support also for SB and SBPro. The included MIX.EXE program
  86.       lets you save to file and restore your SB16 mixer easily. You can
  87.       keep all your preferred mixer configuration in files, and load
  88.       them when you need and in a fast way.
  89.  
  90.     - Full documentation (specify english or spanish).
  91.  
  92.     - Three weeks technical support (starting at the first consult)
  93.       if you have Internet or FidoNet network access, or two months
  94.       if you only have snail-mail :-)
  95.  
  96.     - If you have Internet access, you'll also get freely all the updates,
  97.       bug fixes and new releases of the complete library. Otherwise, you
  98.       will only get one update by air-mail, when I'll consider that it
  99.       worths.
  100.  
  101.  
  102.  
  103. ┌─────────────┐
  104. │  File list  │
  105. └─────────────┘
  106.  
  107. readme.txt ...... This file.
  108. register.txt .... Registration form.
  109. xsb16l.lib ...... The large model library. Restricted shareware version.
  110. mix.exe ......... A program to control the SB16 mixer.
  111.  
  112. include\tdef.h ... Header file. Type definitions.
  113. include\sb16io.h . Headir file. Use this for concurrent play&record.
  114. include\xsnd.h ... Header file. Use this for normal sb16 interface.
  115.  
  116. samples\caution.txt .. Read before running the sample programs.
  117. samples\*.c .......... Source code for some sample programs.
  118. samples\*.exe ........ Compiled sample programs, using a non-restricted
  119.                         complete library, not the shareware one.
  120.  
  121. NOTE: when using PKUNZIP to unpack this files, be sure to extract
  122. files using -d option to get files in their correct directory!
  123.  
  124. .................................................................
  125.  
  126. For any question or request, please contact the author:
  127.  
  128.           Borja Etxebarria
  129.           Tomas Olabarri 9-5B
  130.           48930  Getxo  - Bizkaia
  131.  
  132.           e-mail: borja@bips.bi.ehu.es
  133.                   jtbecgob@bi.ehu.es
  134.           Fidonet: 2:344/3.64  
  135.  
  136.  
  137.