home *** CD-ROM | disk | FTP | other *** search
/ Groovy Bytes: Behind the Moon / groovybytes.iso / GROOVY / SND_TOOL / STARP201.ZIP / STARPLAY.DOC < prev    next >
Encoding:
Text File  |  1995-02-12  |  12.1 KB  |  275 lines
  1. █▓▒░        ▓░███       █████████▀▀▀▀▀ █ ▀▀▀▀▀▀▀ █████   ▀   ▀▀▀▀▀▀ ▀▀▀▀▀▀▀▀▒▓█
  2. █▒░      ▓▒░▒  █▓▒░ ░▒▓██▓▓█         ██ ██     ███   ███                    ░▒█
  3. █░     █▓▓▒▒             █▒▒█      ▒▒▓   ██   ███   ███                      ░█
  4. █    ▓███████████       ░░▒▒░░    ░▒█    ██▓█  ▓████▓      P L A Y E R        █
  5. █              ████     █░░▒▒   ░███▀▀▀   ▓███ ▓▓██ █▓▓                       █
  6. █  ░░▒▒▓▓██░░▒▒▓█████  ██▓▓░▒  ▒▓██      ░▒▓█   ▓▓██  ▒▒█                     █
  7. █ ░▒▓████░░▒▒▒▒▓▓██   ██▓▓▒▒░░  ▒▓██    ░▒▓█    ▒▒▓▓█  ▒░█░█                  █
  8. █  ░                            ░▒▓███        ░▒▒▓▓█     ░█░░▒▒▓            
  9. █▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄ ▄ ▄▄ ▄▄    ▄    ▄                ▒░▓█▓█▓▒▒░ ▄█ ▄ ▄▄█
  10.  
  11.                    version 2.01
  12.               released 12th feb 1995
  13.  
  14.            1oo% assembly coding by jedi / oxygen
  15.  
  16.                                   
  17.  ------------------------------- -------- ----- - -
  18.                 welcome to starplayer
  19.               - - ----- ------- ----------------------------------
  20.  
  21.  welcome to another release of starplayer. for those who dont already know,
  22.  starplayer is a protected mode s3m/mod player for the PC which allows up to 8
  23.  modules to be loaded into extended ram simultaneously. when loaded they can
  24.  be swapped by the use of several hot-keys from within a DOS shell, completely
  25.  transparent to the foreground program. at the moment starplayer only supports
  26.  the gravis ultrasound soundcard, but plans exist for soundblaster support
  27.  in the future...maybe :-)
  28.  
  29.  major new features/bug fixes in this version include -
  30.      - the use of DMA to transfer samples to GUS DRAM.
  31.        this dramatically speeds up loading and switching between modules.
  32.        for fastest transfer you should set your GUS playback DMA channel
  33.        to a 16-bit one, ie. DMA 4 to 7. this is approximately twice as
  34.        fast as an 8-bit channel. if you find any problems with this
  35.        feature please contact me with details.
  36.      - support for 16 channel .mod files (created by MTM2MOD.EXE)
  37.      - fixed a serious bug in loading default channel pan settings.
  38.        people who complained that certain modules would only play through
  39.        one speaker should find this problem fixed.
  40.  
  41.  please see STARPLAY.REV for a complete revision list.
  42.  
  43.  plans for future releases of starplayer include -
  44.      - the ability to LOAD modules from within a DOS shell.
  45.        this should eliminate the need to return from the shell to change
  46.        modules in memory.
  47.      - a much friendlier user interface with such boring things as VU bars
  48.        and module selection menus.
  49.      - support for soundblaster cards...
  50.      - maybe starplayer for os/2 if a new hard-drive magically appears on
  51.        my doorstep... :-)
  52.  
  53.  as usual i am very interested in hearing about bugs and your ideas about
  54.  possible fixes. my e-mail address changed recently so all mail should now be
  55.  sent to:
  56.          jedi@tartarus.uwa.edu.au
  57.  
  58.  cheers...
  59.          jedi / oxygen
  60.  
  61.  ------------------------------ -------- ----- - -
  62.                 instructions
  63.               - - ----- ------- ----------------------------------
  64.  
  65.  starplayer should be loaded from dos. the command line format is:
  66.  
  67.     starplay [filespec]
  68.  
  69.  gus address, irq, etc is determined from the ULTRASND= environment variable.
  70.  starplayer will abort to dos if an ultrasound cannot be found with these
  71.  specs (or if you have no gus!!)
  72.  
  73.  when you enter the module player, there is a command line interface (cli)
  74.  which allows you to enter commands. these commands are as follows:
  75.  
  76.     l [filespec] - load module(s) "filespec" into memory
  77.                the palette is faded while loading. starplayer will
  78.                attempt to load all modiles matching the filespec
  79.                into free slots. if no extension is given starplayer
  80.                will also search for '.s3m' and '.mod' files which
  81.                match the given filespec.
  82.  
  83.     p #          - play module number '#' (or F1-8 with scroll-lock)
  84.                palette is faded while loading samples onto device
  85.                ram. this gives a visual indication as to when the
  86.                foreground task is being temporarily halted.
  87.  
  88.     v #          - view the sample list of module number '#'
  89.                this will list all sample names and their length,
  90.                loop start and end points.
  91.  
  92.     s            - stop module. (or F9 with scroll-lock)
  93.                this will stop playing the current module.
  94.  
  95.     r            - release most recently loaded module.
  96.                this removes the last loaded module (highest slot
  97.                position) from ram freeing the system and device ram
  98.                allocated to it.
  99.  
  100.     i #          - give information on module '#'
  101.                this lists various information on a module such as
  102.                its title and number of patterns and samples.
  103.  
  104.     i            - summarise modules in memory
  105.                this lists the titles of all modules in memory and
  106.                their slot number as well as 'sflag' which indicates
  107.                whether module is loaded into device ram.
  108.  
  109.     f            - free samples for last module from device ram
  110.                freeing device ram will enable a larger module to be
  111.                loaded into device ram. this is done automatically if
  112.                there is not enough device ram available when an
  113.                unloaded module is played.
  114.  
  115.     d            - shell to dos (use EXIT to return)
  116.                one of the most powerful features of starplayer is the
  117.                ability to shell to dos with 8 modules loaded into
  118.                extended ram and switch between them using hotkeys
  119.                with only minimal conventional ram overhead. the
  120.                hotkeys are only active when the scroll-lock key is on.
  121.                this enables the f-keys to still be used normally when
  122.                scroll-lock is off. the keys are listed below.
  123.  
  124.     q            - quit starplayer.
  125.  
  126.  in addition to these, the following keys are active in the player, and during
  127.  a dos shell, when the scroll lock key is activated.
  128.  
  129.     f1-f8     - play songs 1-8
  130.             palette is faded while loading samples onto device ram.
  131.     f9        - stop playing
  132.     f11       - decrease pattern
  133.     f12       - increase pattern
  134.     alt-f11   - dec. volume
  135.     alt-f12   - inc. volume
  136.  
  137.  note that when in a DOS shell, all extended memory remains allocated and is
  138.  hence unavailable for other programs. also to prevent a system crash do not
  139.  attempt to load multiple copies of starplayer or load any other protected
  140.  mode program whilst starplayer is in memory...
  141.  
  142.  ------------------------------- -------- ----- - -
  143.                  disclaimer
  144.               - - ----- ------- ----------------------------------
  145.  
  146.  this program is written entirely in pmode assembler without a debugger so
  147.  don't blame us for whatever happens! we know of quite a few bugs which can
  148.  make your computer lock up, reset, fall back to dos, or play modules
  149.  incorrectly. if you find any specific bugs, PLEASE TAKE YOUR TIME TO NOTIFY
  150.  THE AUTHOR! bugs cannot be eradicated if we dont know about them!
  151.  
  152.  this program and associated files are freeware. as such, no money may be
  153.  charged for it, nor may it be distributed in a commercial venture. there is
  154.  no warranty or claim of fitness or reliability. the programs are distributed
  155.  AS IS, and as such neither the authors, those who have associations with the
  156.  demo group known as "oxygen", nor any data retrieval network or system from
  157.  which this was collected shall be held liable for any loss of data, down
  158.  time, loss of revenue or profit or any other direct or indirect damage or
  159.  claims caused by this program.
  160.  
  161.  in plain english, if it crashes your system, or causes you physical,
  162.  psychological or emotional torment, or causes your cat to go off its food,
  163.  tough! :-)
  164.  
  165.  ------------------------------ -------- ----- - -
  166.                   oxygen's members
  167.               - - ----- ------- ----------------------------------
  168.  
  169.  handle     main tasks           age     machine
  170.  -----------------------------------------------------------------------------
  171.  jedi       coder,musician        18     486dx33 vlb, 8mb ram, 1mb GUS, SB 1.5
  172.  kitsune    musician,graphician   17     a500, 1mb ram, wb2
  173.  statix     coder,miscellaneous   16     386dx40, 4mb ram, 1mb GUS, SB 2.2
  174.  mantissa   coder                 20     486dx266, pci, 16mb ram, 1mb GUS
  175.  trash      musician              19     486dx33, 8mb ram, 1mb GUS, tb multisnd
  176.  
  177.  ------------------------------ -------- ----- - -
  178.                    major releases
  179.               - - ----- ------- ----------------------------------
  180.  
  181.  dos (electronic programmers tar):
  182.  
  183.  product      talent       description
  184.  ------------------------------------------------------------------------->
  185.  cyanide.zip  kt/jd/stx/xc Cyanide Demo for the PC - won the 1994 C-Party
  186.  cyndptch.zip stx          Cyanide Patch for Lame Sound Cards (SB et al)
  187.  starp100.zip jd/stx       Starplayer - Best S3M player for the GUS yet.
  188.  startro.zip  jd/kt/stx    BBS Loader for Star BBS
  189.  tedium.zip   jd/kt/stx    An intro about its title - tedium.
  190.  starp200.zip jd           Starplayer - MOD file support, 100% click free
  191.  starp201.zip jd           Starplayer - DMA to dump samples, pan bug fix
  192.  
  193.  amiga (the glorified doorstop):
  194.  
  195.  product      talent      description
  196.  ------------------------------------------------------------------------->
  197.  oxg-ultm.dms kt          ultimate music disk...
  198.  oxg-cyrx.dms kt          Cyarax music disk....
  199.  drw_slrv.dms kt          SleepRaving music disk...
  200.  oxg-eoke.dms kt          eOKIZEN music disk...
  201.  oxg-????.dms kt          a million other bloody music disks...
  202.  
  203.  other interesting releases:
  204.  
  205.  product      talent      description
  206.  ------------------------------------------------------------------------->
  207.  r-delivr.zip jd          Deliverance. 2nd Placed Rookie Entry in Music
  208.               Contest ][.
  209.  
  210.  ** kitsune also releases lots of music, way too many to list here.
  211.  
  212.  ------------------------------ -------- ----- - -
  213.                  distro/support bbs
  214.               - - ----- ------- ----------------------------------
  215.  
  216.  australia
  217.  --------------------------------------------------------------------------
  218.  absolute zero      +61-9-246-11o7    whq        statix
  219.   dmp, inertia player, galaxy, midas, klf..
  220.  mindflux           +61-2-416-2513    ehq        force format
  221.   trilogy nswhq, reality whq, heretics sozhq, dissonance distro..
  222.  
  223.  usa
  224.  --------------------------------------------------------------------------
  225.  cyberoptica        +1-6o2-814-81oo   eushq      cerulean
  226.   identity senior staff, ace, broken, arctic, obv/2 beta
  227.  realm of insanity  +1-2o3-568-15o2   nushq      god speed
  228.   relic, iridium, dark us, klf, union member, nation member..
  229.  borderline reality +1-414-656-o2o5   usdist     berky
  230.   bc/itc/gcn/grind/rgs nets, tons of affils.
  231.  --------------------------------------------------------------------------
  232.  
  233.  speak to statix if you'd like to join in.
  234.  
  235.  ------------------------------ -------- ----- - -
  236.                how to speak to oxygen
  237.               - - ----- ------- ----------------------------------
  238.  
  239.  if you have access to the internet, a good place to start would be to mail
  240.  one of us:
  241.  
  242.      jedi                    jedi@tartarus.uwa.edu.au
  243.      statix                  kimba@it.com.au
  244.      mantissa                sjm@it.com.au
  245.      kitsune                 ua.gro.ygolohcysp.esrever@enustik
  246.      trash                   jlchong@tartarus.uwa.edu.au
  247.  
  248.  sometimes if you are lucky you might find one of us in IRC channels #coders
  249.  or #trax...
  250.  
  251.  if you have a pen, you can stick your ideas on a page destined for
  252.  
  253.      jedi/oxygen                     statix/oxygen
  254.      scott mcnab                     kim davies
  255.      5 honeydew close                19 kincraig way
  256.      maida vale wa 6057              duncraig wa 6023
  257.      australia                       australia
  258.  
  259.      kitsune/oxygen                  mantissa/oxygen
  260.      simon bennett                   simon mackinlay
  261.      596 light street                the coca cola kid
  262.      dianella wa 6062                miles road
  263.      australia                       kewdale wa, australia (honest ;)
  264.  
  265.  once we get bloodnet working, that would be a good place too :-)
  266.  
  267.  send your postcards, cash, cheques, gold bars, diamonds, family heirlooms etc
  268.  to these addresses :)
  269.  
  270.               see you in the next oxygen release!
  271.  
  272.  ---------------------------------------------------------- -------- ----- - -
  273.                  o x y g e n
  274.  - - ----- ------- -----------------------------------------------------------
  275.