home *** CD-ROM | disk | FTP | other *** search
/ Mega A/V / mega_av.zip / mega_av / SOUNDUTL / MODCODE.ZIP / MOD-OBJ.DOC < prev    next >
Text File  |  1992-04-17  |  10KB  |  258 lines
  1. ** THIS VERSION has been made available to people on Greyhawk BBS
  2. ** Please DO_NOT distribute this version.  Although I have tested it
  3. ** well there are bound to be a few bugettes, so I'm giving you lot the 
  4. ** chance to play with an early release!  You can still use this version
  5. ** in your programs though - see the license stuff in section 6ish.
  6. ** Don't report bugs to the board - I won't get to log on for quite a
  7. ** while.
  8.  
  9.      MODOBJ **********                                 (C) Mark J Cox
  10.      MODOBJ ***                                                  1992
  11.      MODOBJ *****
  12.      MODOBJ ****************                             Version 0.03
  13.  
  14.      Module playing OBJect file
  15.  
  16.  
  17.      I. QUICK START
  18.      ─────────────────────────────────────────────────────────
  19.     
  20.      The two included programs, TCMOD and TPMOD were created using
  21.      the unregistered version of MOD-OBJ under Turbo C v2.00 and
  22.      Turbo Pascal v6.0 respectively.   Look at the source code to see
  23.      how they work.
  24.  
  25.  
  26.      1. INTRODUCTION
  27.      ─────────────────────────────────────────────────────────
  28.  
  29.      The object file that is part of this package allows programmers
  30.      to add music and sound effects simply and easily to their programs.
  31.  
  32.      Music and sound effects can be played through a large number of
  33.      sound devices, including the PC Speaker, the Soundblaster and
  34.      various Covox devices.  
  35.  
  36.      Music plays in the background and there are a a huge number of
  37.      ready-made music modules available on the Amiga and the PC (*).
  38.  
  39.      Music modules are standard Amiga Noisetracker/ Startrekker/
  40.      Soundtracker/ Protracker modules.   A music module is made up of
  41.      up to 31 sampled instruments (instruments can also be things like
  42.      speech samples or effects).   Up to four of these instruments can
  43.      be played at once and are mixed to form the final sound output.  The
  44.      mixing is controlled from a music track,  which can playback notes
  45.      in sequence and perform numerous effects.
  46.  
  47.      The MODPLAY program (currently MPLAY219B) is a stand-alone player
  48.      for these modules on a PC.  It has graphical support, a real
  49.      spectrum analyser and much more. (And its freeware by Mark Cox)
  50.  
  51.      The MODEDIT program (currently MODED200) is a module creator/editor
  52.      and the documentation with Modedit explains in more detail the 
  53.      structure of the amiga modules. (also freeware by Norman Lin)
  54.  
  55.      Please note that not all Music modules can be treated as 'Public
  56.      Domain'.  Each module has a section that lists the names of all the
  57.      instruments and sometimes this includes a message from the author. 
  58.      Use MODEDIT/MODPLAY to view the messages (or use a file viewer on the
  59.      MOD file).  If a module has a message giving the module author, you
  60.      are advised to contact them before using their module for ANYTHING.
  61.  
  62.      You can obtain modules from many Bulletin Boards,  Internet sites or from
  63.      friends Amiga's.  Modules usually come archived in LZH form, these can be 
  64.      unpacked with the excellent LHA program.  
  65.  
  66.  
  67.  
  68.      2. SUPPORTED PROGRAMS
  69.      ─────────────────────────────────────────────────────────
  70.  
  71.      The OBJ file has been tested with the following software
  72.  
  73.      Turbo C v2.0    
  74.      Turbo Pascal v6.0
  75.  
  76.      but should work with most other C and Pascal compilers.
  77.      It will soon also support
  78.  
  79.      PowerBasic (formally Turbo Basic)
  80.  
  81.  
  82.      3. FEATURES
  83.      ─────────────────────────────────────────────────────────
  84.  
  85.         o Does not affect the clock, disk acesses or anything else
  86.  
  87.     o Allows samples to be played on a special '5th track' allowing
  88.       sound effects to be put over the top of the music.  
  89.       (registered version only)
  90.  
  91.         o Plays all Protracker 31 instrument module files. (Modules that
  92.           have 15 instruments can be converted using a program such as 
  93.       MODEDIT by Norman Lin.  It will also handle most Soundtracker/
  94.       Noisetracker and Startrekker (4 channel) modules, including ones
  95.       that have samples greater than 64k each in them.
  96.  
  97.         o Runs completely in the background, letting your program 
  98.           carry on as normal.
  99.  
  100.     o Plays through a wide range of output devices, including the
  101.           PC Speaker and Soundblaster
  102.  
  103.     o No royalties to pay for including it in your program (See
  104.       License agreement for details).
  105.  
  106.     o Module mixing speed can be altered to account for different
  107.           speed computers
  108.  
  109.  
  110.      4.  TECHNICAL
  111.      ─────────────────────────────────────────────────────────
  112.  
  113.      Technical details can be found in the technical documentation
  114.      TECH.DOC
  115.  
  116.  
  117.      5.  SHAREWARE
  118.      ─────────────────────────────────────────────────────────
  119.  
  120.      MODOBJ is shareware.  If you intend to use it in anything other
  121.      than public domain programs you should register it.  Registration
  122.      entitles you to the latest version of MOD-OBJ as well as the
  123.      ability to play sound samples over the top of the module and other
  124.      useful functions.  See the sections on registering and the license
  125.      agreement.
  126.  
  127.  
  128.  
  129.      6.  LICENCE AGREEMENT
  130.      ─────────────────────────────────────────────────────────
  131.  
  132.     Use of Mod-obj in a Personal or Public Domain Program
  133.     ──────────────────────────────────────────────────────
  134.  
  135.     The unregistered version of MODOBJ may be used in any public domain
  136.     programs (these are programs for which no fee is charged by the
  137.         author)  provided that this document is distributed with the programs
  138.         and that the author (Mark J Cox) receives credits within the program
  139.         and documentation.
  140.     You are strongly urged to register to get the extra routines 
  141.     provided by the registered version however.  
  142.  
  143.     The registered version of MODOBJ may be used in your public domain
  144.         programs freely without the need to include this document as long
  145.         as the author (Mark J Cox) recieves credits within the program and
  146.         documentation.
  147.  
  148.     Use of MODOBJ in Shareware Programs
  149.     ──────────────────────────────────────────────────────
  150.  
  151.     The unregistered version of MODOBJ may not be used in any Shareware
  152.     (fee charged for the software) programs.  
  153.  
  154.     Registering your version of MODOBJ will entitle you to include 
  155.     MODOBJ in your shareware programs as long as the author (Mark J Cox)
  156.         receives credits both within the program and the documentation.
  157.  
  158.  
  159.     Use of MODOBJ in Commercial Programs
  160.     ──────────────────────────────────────────────────────
  161.  
  162.     The unregistered version of MODOBJ may not be used in any commercial
  163.     programs.  
  164.  
  165.     The registered version may be used where agreed in writing
  166.     by the author.  (This will not involve royalty payments, just a 
  167.     one-off fee;  contact the author).
  168.  
  169.  
  170.      7.  COPYRIGHT/LICENCE AGREEMENT
  171.      ──────────────────────────────────────────────────────
  172.  
  173.      The files MOD-OBJ.DOC, TECH.DOC, MOD-OBJ.OBJ  are copyrighted by 
  174.      Mark J Cox.  You are free to distribute the unregistered version
  175.      of the MOD-OBJ package as you wish provided no profit is made from
  176.      the distribution.
  177.  
  178.      The copyright owner hereby licenses you to use this software
  179.      as stated in section 6 of this document.
  180.  
  181.      ║ NEITHER THE MODOBJ PROGRAM OR DOCUMENTATION MAY BE ALTERED         ║
  182.      ║ IN ANY WAY, OR REVERSE-ENGINEERED BY DISASSEMBLY OR OTHER METHOD.  ║
  183.  
  184.      There is no warranty of any kind, and the copyright owner is not liable
  185.      for damages of any kind.  By using this software, you agree to 
  186.      all the above terms.
  187.     
  188.      The software and documentation are
  189.      Copyright (C) 1992 by Mark J Cox
  190.  
  191.     Mark J Cox
  192.     29 Lundie Close
  193.     Stenson Fields
  194.     Derby DE2 3AN.
  195.  
  196.  
  197.  
  198.      8.  ELECTRONIC MAIL
  199.      ──────────────────────────────────────────────────────
  200.  
  201.      You can contact me via electronic mail
  202.  
  203.     m.j.h.cox@bradford.ac.uk        (probably until 1995)
  204.  
  205.      If that fails, as a last resort try
  206.  
  207.        bc732@cleveland.freenet.edu
  208.  
  209.      An excellent dial-up BBS in the UK (Derby) is
  210.  
  211.     Kingdom of Greyhawk,  +44 332 756414  (0332 756414 UK)
  212.     its got loads of stuff on it, and in the past was voted top
  213.       UK BBS.  Friendly sysop Alan Coates is waiting for your 
  214.     call (300-14k4) - mention you heard about it from Mark Cox! 
  215.  
  216.      You can check to see if I'm still registered by calling Bradford's
  217.      Information Server;  telnet to
  218.  
  219.     info.bradford.ac.uk
  220.  
  221.      And log in as user "info"
  222.  
  223.  
  224.      8.  REGISTRATION
  225.      ──────────────────────────────────────────────────────
  226.  
  227.      To register your version of MODOBJ, send a cheque or postal
  228.      order payable to "Mark Cox" to the address is section 6
  229.  
  230.      Registration includes a diskette containing some more sample
  231.      programs, and a registered version of MODOBJ with the extra
  232.      facilities listed in this document.  Please state if you want
  233.      5.25" diskette instead of usual 3.5"
  234.  
  235.  
  236.      Cheque in UK currency (Sterling):        
  237.         15 pounds
  238.  
  239.      Cheque in US dollars:     
  240.         30 US dollars
  241.  
  242.      Outside UK (other currency):
  243.         17 pounds * Current Exchange rate + 10% for fluctuations
  244.         If unsure, contact me for an estimate.
  245.  
  246.  
  247.      Coming soon:
  248.  
  249.     Power Basic version (maybe, I'm having problems allocating more
  250.                              than 31K at a time)
  251.  
  252.     Soundblaster Pro support (at the moment works - but in mono)
  253.     Adlib Gold support
  254.         Pro Audio Spectrum support
  255.  
  256.     If you have programming details for the above cards (or any other
  257.         new cards) let me know - Its worth a free registration to the first!
  258.