home *** CD-ROM | disk | FTP | other *** search
/ Current Shareware 1994 January / SHAR194.ISO / sounds / liqpl100.zip / LP.DOC < prev    next >
Text File  |  1993-11-01  |  14KB  |  314 lines
  1. Last date of revision: 10/29/93 2:52am (Yeah.. yeah.. the middle of the night)
  2.  
  3.  
  4.         Welcome to the:
  5.  
  6.                 ╓─┐     ╓───┐  ╓──────┐  ╓─┐ ╓─┐  ╓───┐  ╓──────┐
  7.                 ║ │     ╚╗ ╒╛  ║ ╒══╗ │  ║ │ ║ │  ╚╗ ╒╛  ╚╗ ╒═╗ │
  8.                 ║ │      ║ │   ║ │  ║ │  ║ │ ║ │   ║ │    ║ │ ║ │
  9.                 ║ │      ║ │   ║ │  ║ │  ║ │ ║ │   ║ │    ║ │ ║ │
  10.                 ║ └──┐  ╓╜ └┐  ║ └──╜ │  ║ └─╜ │  ╓╜ └┐  ╓╜ └─╜ │
  11.                 ╚════╛  ╚═══╛  ╚══╗ ╒═╛  ╚═════╛  ╚═══╛  ╚══════╛
  12.                                   ╚═╛
  13.               ╓─────┐  ╓─┐     ╓──────┐ ╓─┐   ╓─┐ ╓─────┐  ╓──────┐
  14.               ║ ╒═╗ │  ║ │     ║ ╒══╗ │ ║ │   ║ │ ║ ╒═══╛  ║ ╒══╗ │
  15.               ║ └─╜ │  ║ │     ║ └──╜ │ ║ └───╜ │ ║ └─┐    ║ └──╜ │
  16.               ║ ╒═══╛  ║ │     ║ ╒══╗ │ ╚══╗ ┌──┘ ║ ╒═╛    ║ ╒═╗ ╒╛
  17.               ║ │      ║ └──┐  ║ │  ║ │    ║ │    ║ └───┐  ║ │ ║ └┐
  18.               ╚═╛      ╚════╛  ╚═╛  ╚═╛    ╚═╛    ╚═════╛  ╚═╛ ╚══╛
  19.  
  20.                                   Version 1.00
  21.  
  22.                 (C) Written by Moti Radomski, 1993.
  23.                 (C) Music routines written by Nir Oren, 1992-3.
  24.  
  25.  
  26.         ┌INDEX──────────────────────────────────────────────────────────┐
  27.         │ 1.  Introduction                                              │
  28.         │ 2.  Ok, Ok!  What about this player?                          │
  29.         │ 3.  So... How do I activate the player?                       │
  30.         │ 4.  Keys to use WHILE PLAYING                                 │
  31.         │ 5.  MOD2LIQ - A MOD to LIQ convertor                          │
  32.         │ 6.  Nope, NOT FREEware!  It's POSTware!                       │
  33.         │ 7.  Distribution                                              │
  34.         │ 8.  Some more information about the Liquid writers            │
  35.         │ 9.  Some VERY important ThankYou's                            │
  36.         │ 10. Just a little disclaimer I ripped from another doc... ;-) │
  37.         │ 11. What's next?                                              │
  38.         │ 12. Known bugs                                                │
  39.         │ 13. Some closing words.                                       │
  40.         └───────────────────────────────────────────────────────────────┘
  41.  
  42.  
  43.  
  44.    1. Introduction
  45.    ───────────────────────────────
  46.  
  47.    Welcome  to  the Liquid Player. This player  is  a part of the LIQUID
  48.    programs,  written  by  Nir  Oren  and  Moti  Radomski. The currently
  49.    available  programs are the Liquid Tracker  and the Liquid Player. In
  50.    the  future,  the Liquid Editor will  also be released to the public.
  51.    (More  info.  about the Liquid Editor  will be found later, under the
  52.    "What's next" topic).
  53.  
  54.    Using  the  Liquid  Tracker, you can  create  and edit sound modules.
  55.    These  modules are much like the known MOD files (or STM files if you
  56.    use  the  ScreamTracker  from Sami Tammilehto).   Currently, the only
  57.    player that supports these LIQ files is the Liquid Player.
  58.  
  59.    Some of the Liquid Playing Routines (which are being used by both the
  60.    Liquid Tracker and the Liquid Player) features are:
  61.  
  62.    ■ Supports up to 64 channels played simultaneously!
  63.  
  64.    ■ Up to 64 digitized instruments.
  65.  
  66.    ■ Support for :  - Sound Blaster 1
  67.                     - Sound Blaster 2
  68.                     - Sound Blaster Pro (stereo)
  69.                     - Sound Blaster 16 ASP (stereo)
  70.  
  71.    ■ Uses  80386 instructions, thus increasing playing speed.
  72.  
  73.    ■ Both the Liquid Playing Routines AND the Liquid Player are written
  74.      in PURE ASSEMBLY - that means even more speed!
  75.  
  76.  
  77.    2. Ok, Ok!  What about this player?
  78.    ───────────────────────────────────────
  79.  
  80.    This  version  of the Liquid Player  was created because there was no
  81.    other LIQ player around. This is just a TEXT version, which serves as
  82.    a  very basic player. It still lacks a lot of features. I am planning
  83.    a  full,  graphical player, which will  support  a lot of other sound
  84.    formats  (such  as Amiga MODs,  ScreamTracker's  STMs, Composer's 669
  85.    etc.).  I am working on some 3D  functions, and plan to create a full
  86.    3D  featured player. But this will take some time... (Read more about
  87.    it under the "What's next" topic).
  88.  
  89.    Meanwhile, this text Liquid Player only supports LIQ files, which are
  90.    created  using the Liquid Tracker. You can convert your own MOD files
  91.    into  the  LIQ format using the  Liquid Tracker (For more information
  92.    about that, refer to the Liquid Trackers manual).
  93.  
  94.    The  latest  version of the Liquid  Player and the Liquid Tracker can
  95.    always be found on our Home Board, The Loan Shark BBS, 972-3-9318789.
  96.    You can FReq them using the magic names LIQUID for the Liquid Tracker
  97.    and LIQPLAY for the Liquid Player.
  98.  
  99.  
  100.    3. So... How do I activate the player?
  101.    ──────────────────────────────────────────
  102.  
  103.    Activating  the  Liquid  Player is very  simple.  All commands to the
  104.    Liquid Player are given as command-line parameters:
  105.  
  106.      LP {liq filename} [/Sxx] [/L] [/H] [/?]
  107.  
  108.    Where:
  109.  
  110.         {liq filename}  is the LIQ module you want to play.
  111.                         Wildcards are (currently) not supported.
  112.  
  113.         /Sxx            Defines  sampling rate in KHertz, i.e. /S22 will
  114.                         play at 22Khz. Minimum is 4, Maximum is 41.
  115.  
  116.         /L              Will  cause  the Liquid Player  to only play the
  117.                         LIQ  once, and then return  to DOS. Normally the
  118.                         Liquid  Player  will loop, until  the ESC key is
  119.                         pressed.
  120.                         NOTE: Currently doesn't work.
  121.  
  122.         /H and /?       Gives a help screen.
  123.  
  124.  
  125.      ───══════════════──  N O T E :  ──═══════════════════════════───
  126.      The Liquid Playing Routines have a special detection  algorithm,
  127.      that's  why  there's no  command-line  switches for IRQ/DMA/BASE
  128.      PORT  settings. If the Liquid Player  fails to detect your sound
  129.      card,  please report that to the writers, and we'll take care of
  130.      it.
  131.      ───══════════════════════════════════════════════════════════───
  132.  
  133.  
  134.    4. Keys to use WHILE PLAYING
  135.    ────────────────────────────────
  136.  
  137.          [ESC]    -   Will terminate the player and return to DOS.
  138.                       NOTE: The music will stop, too... ;-)
  139.  
  140.          [1..8]   -   Will toggle channels 1 to 8, respectively.
  141.    Shift [1..8]   -   Will toggle channels 9 to 16, respectively.
  142.  
  143.         Up/Down   -   Will scroll pages.
  144.       PgDn/PgUp   -   Will scroll pages faster.
  145.  
  146.        Home/End   -   First/Last screen.
  147.  
  148.      Right/Left   -   FastForward/FastRewind
  149.  
  150.           +/-     -   Increes/Decrees volume.
  151.  
  152.           S       -   Shell to DOS. Be very carefull using this option.
  153.                       It could be a bit risky...
  154.  
  155.  
  156.    5.  MOD2LIQ - A MOD to LIQ convertor
  157.    ──────────────────────────────────────────
  158.  
  159.    I  am  now working on a MOD loader.  (Hope it'll be there in the next
  160.    version).  Meanwhile, you can listen to your favorite MOD files using
  161.    the  Liquid Player by converting them  into a LIQ module format file.
  162.    You  can  convert  any 31 instrumental  MOD  sound  module into a LIQ
  163.    format using MOD2LIQ.EXE. To convert a MOD, just run MOD2LIQ and give
  164.    it the MOD filename as a command-line parameter. It will do the rest.
  165.  
  166.  
  167.  
  168.    6. Nope, NOT FREEware!  It's POSTware!
  169.    ──────────────────────────────────────────
  170.  
  171.    The Liquid Player is a POSTware program. That means that if you use
  172.    it for more then 10 days, and find it good/bad/nice/interesting you
  173.    have to send me a postcard with your opinion, comments and
  174.    suggestions. Please see that this is one of the very first version of
  175.    the program, I any comment/suggestion/bug report could REALLY help me
  176.    improve it!
  177.  
  178.    ⌠                    ⌠ Home Board: The Loan Shark BBS ■ 972-3-9318789
  179.    │  Moti    Radomski  │             14K 24Hours, Liquid Folder Support
  180.    │  60 Catz St 49374  │ FidoNet   : 2:401/4.4
  181.    │  Petach     Tikva  │          or 2:401/55.3@fidonet.org
  182.    │  I  S  R  A  E  L  │ Internet  : quadri@libra.math.tau.ac.il
  183.    ⌡                    ⌡
  184.  
  185.  
  186.    7. Distribution
  187.    ──────────────────
  188.  
  189.    The Liquid Tracker is uploaded to the following FTPs:
  190.    ftp.uwp.edu
  191.    wuarchive.wustl.edu
  192.    garbo.uwasa.fi
  193.    nic.funet.fi
  194.  
  195.    Some more information about the distribution and the Liquid sites,
  196.    read the file Support.Liq
  197.  
  198.  
  199.  
  200.    8. Some more information about the Liquid writers
  201.    ───────────────────────────────────────────────────
  202.  
  203.    The  Liquid programmers are Moti Radomski and Nir Oren. Moti Radomski
  204.    is  me (I think... that's what everybody else says..;-) and therefore
  205.    will  be  referred as "I" or "ME" from  now  ;-) Nir Oren is 18 years
  206.    old,  and I am 17. Nir has finished his studies, and waiting to serve
  207.    his  country at the I.D.F (Israeli  Defence Force), and I'm currently
  208.    at the 12th grade.
  209.  
  210.    Anyway,  Nir started writing the Liquid Playing Routines a few months
  211.    ago.  He added support for SB, SBPro,  and SB16 and then released the
  212.    first  version of the Liquid Tracker. By that time, I started writing
  213.    this  Liquid Player you are now using. We had some problems combining
  214.    our routines, but (apparently...) we have overcome them.
  215.  
  216.    In my spare time I compose  computerized music,  too.  I have already
  217.    released about 10 MOD files.  The all of them could be  found at most
  218.    of the GOOD Israeli BBS's, and  I'm  also  going to UL them  to  some
  219.    BBS's around the US and Europe.
  220.  
  221.    We  can be contacted via the Liquid Folder (Which is available on any
  222.    Liquid  Support  Site), and also  via Snail-Mail, or regular NetMail.
  223.    (My Fido/InterNet addresses are listed under the last topic).
  224.  
  225.  
  226.    9. Some VERY important ThankYou's :
  227.    ─────────────────────────────────────────────
  228.  
  229.    The writers of the Liquid Tracker and the Liquid Player wishes to
  230.    thank the followings:
  231.  
  232.    ¡!  -  First of all: Sami Tammilehto - our spiritual father.
  233.           Thank you for releasing ScreamTracker and setting the
  234.           standards for all PC musicians / PC music programmers!
  235.    ¡!  -  Eyal Perek - for some  important TIPs which helped us on write
  236.           those programs.
  237.    ¡!  -  Ofer Wald, the SysOp of the Loan Shark BBS - for being the
  238.           distribution site, taking care or our mailpoints etc.
  239.    ¡!  -  Yossi Zinger - For taking care of out InterNet mail, and ULing
  240.           LIQUID to the ftp's.
  241.  
  242.  
  243.    10. Just a little disclaimer I ripped from another doc... ;-)
  244.    ─────────────────────────────────────────────────────────────────
  245.  
  246.    This  product is distributed AS IS. The authors specifically disclaim
  247.    all  warranties ,expressed or implied, including ,but not limited to,
  248.    implied  warranties  of merchantability and  fitness for a particular
  249.    purpose  with  respect to defects  in the diskette and documentation,
  250.    and  program  license  granted  herein,  in  particular,  and without
  251.    limiting  operation  of  the  program  license  with  respect  to any
  252.    particular  application use or purpose. In no event shall the authors
  253.    be  liable  for  any loss of  profit  or  any other commercial damage
  254.    including  but  not limited to  special, incidental, consequential or
  255.    other damages.
  256.  
  257.  
  258.    11. What's next?
  259.    ────────────────
  260.  
  261.    As  stated  before, this version of the  Liquid Player is just a very
  262.    basic one. There are many improvements to be added. Here is a list of
  263.    some of them, sorted by the order of importance:
  264.  
  265.    ■  First of all: File Manager routine.
  266.       Instead of giving a filename on the command-line you'll be able to
  267.       specify wildcards, and get a full list of files.
  268.       Tag/Copy/Delete commands will also be added.
  269.    ■  Support for MOD format
  270.    ■  Full ProTracker's effects support
  271.    ■  Support for STM format
  272.    ■  Support for S3M format (As soon as Tammilehto finally decides what
  273.       the format will be..) ;-)
  274.    ■  SBPRO/SB16 mixer
  275.    ■  Graphical  environment  - by this time  the  Liquid Player will no
  276.       longer  be  a  PostWare, it will  be  a ShareWare, like the Liquid
  277.       Tracker.
  278.    ■  Then will come - The Liquid Editor:
  279.       We (Me and Nir) are planning a full script language, which will be
  280.       a  part  of  the LIQ module. You  will  be able to write some text
  281.       messages, and tell the Liquid Player to display them while playing
  282.       the  LIQ.  There will be a  few  ready-made fonts and effects. You
  283.       will  also  be  able  to give the  player  a  GIF  file and choose
  284.       when/where  to display the graphics. The Liquid Editor will be the
  285.       LIQ  script  editor.  It will edit  the  LIQ  file and insert your
  286.       script  commands.  We are planning a  lot  of other features, like
  287.       Karaoke etc.
  288.       More  information about that will come  in the future (and anyway,
  289.       it'll take some time before we'll even start writing that...).
  290.  
  291.  
  292.    12. Known Bugs
  293.    ───────────────────
  294.  
  295.    ■  The screen scrolling is currently not so smooth... It has
  296.       something to do with the INT8 handler. We'll fix that..
  297.  
  298.  
  299.  
  300.    13. Some closing words
  301.    ──────────────────────────
  302.  
  303.    I  hope  you'll enjoy using the Liquid  Player. If you don't have the
  304.    Liquid  Tracker,  look  for it on the  same  board you DLed this file
  305.    from. You can also DL it from any Liquid distribution site.
  306.    Please take the time to write and send me a postcard/NetMail and tell
  307.    me what do you think about the program.
  308.  
  309.  
  310.    Thank you in advance, and byebye!
  311.  
  312.                                         Moti Radomski
  313.                                         The Liquid Player Author
  314.