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