home *** CD-ROM | disk | FTP | other *** search
/ Large Pack of OldSkool DOS MOD Trackers / liqdt127.zip / LIQ.DOC < prev    next >
Text File  |  1997-01-11  |  24KB  |  457 lines

  1.  
  2.   ─────═══════════════════════════════════════════════════════════════╕
  3.  
  4.    Fast_Introduction:
  5.  
  6.    Simply run LIQ WASTETIM (or any MOD/S3M/LIQ name).
  7.    The program will autodetect your SB1,2,Pro,16 or PAS16 card, and will
  8.    start playing. Use <LEFT-CTRL> and <LEFT-SHIFT> to scroll the screen.
  9.    Use <TAB> for 80x50 mode switching.
  10.    Have fun.
  11.  
  12.  ╘══════════════════════════════════════════════════════════════──────
  13.  
  14.  
  15.  
  16.   THE   █     ▀█▀ █▀▀▀█  █   █ ▀█▀ █▀▀▀▄   ───────────────────────────────
  17.         █      █  █   █  █   █  █  █   █    ────────────────────────────────
  18.         █▄▄▄█ ▄█▄ █▄▄▄▀▄ █▄▄▄█ ▄█▄ █▄▄▄▀   ───────────────────────────────
  19.  
  20.     ────────────────────────    ▀▀█▀▀ █▀▀▀▄ █▀▀▀█ █▀▀▀▀ █  ▄▀ █▀▀▀▀ █▀▀▀▄
  21.       ────────────────────────    █   █▄▄▄▀ █▀▀▀█ █     █▄█   █▀▀▀▀ █▄▄▄▀
  22.     ────────────────────────      █   █   █ █   █ █▄▄▄▄ █  ▀▄ █▄▄▄▄ █   █
  23.    ─────────────────────────────────────────────────────────────────────────
  24.  
  25.  
  26.                                    v1.27 
  27.  
  28.                 Professional Soundtracks Development System
  29.                   All Rights Reserved - Nir Oren 1993-1997
  30.  
  31.                   ** Running Under Tran's Dos Extender **
  32.  
  33.                           ╒════════════════════╗
  34.                           │    Introduction    ║
  35.                           └────────────────────╜
  36.  
  37.      The  Liquid  Tracker is a program  capable of playing and composing
  38.      digitized  modules,  with  the ability to  play  up to 64 different
  39.      samples  simultaneously, with variable  pitch, volume, pan position
  40.      and effect, at different time intervals. Since I assume you already
  41.      know  what  Tracker is, I'll just  suggest you play around with the
  42.      program. There is an online hypertext help, that supplies all there
  43.      is to know in order to  work with the  program.  Press F1 to pop up
  44.      the help from the program.
  45.  
  46.  
  47.                             ╒════════════════╗
  48.                             │    Features    ║
  49.                             └────────────────╜
  50.  
  51.   ■ Sound Routines
  52.   ────────────────
  53.  
  54.      ■ Multichannel, up to 64 channels
  55.      ■ Utilizes extended memory for samples and patterns, also without
  56.        EMS driver.
  57.      ■ True 16 bit/Stereo samples support
  58.      ■ 32bit-PCM-Interpolation to preserve the original sample's waveform
  59.      ■ Unlimited sample size (a must for 16bit samples)
  60.      ■ Up to 100 samples
  61.      ■ 16 bit mixing even with 8 bit samples
  62.      ■ 64 positions full individual channels panning
  63.      ■ Dolby (tm) Surround sound, can be set, if desired, only to a
  64.        specific channel(s)
  65.      ■ 9 Full Octaves
  66.      ■ Support for MOD/S3M/LIQ file formats, thus giving compatibility
  67.        with thousands of high quality modules from the Amiga and PC.
  68.      ■ Supports all S3M, LIQ and MOD various panning commands
  69.      ■ Saves in LIQ or S3M format
  70.      ■ Very fast, 32 bit code optimized mixing routines
  71.      ■ High sound quality, even when playing maximum of 64 channels
  72.      ■ 16 bit fraction frequency precision
  73.      ■ 16 bit volume precision
  74.      ■ Dynamic alterable mixing frequency (ALT F3,F4)
  75.        (Usefull for slow machines)
  76.      ■ Support for the following sound devices: Sound Blaster v1.5 - 2.0,
  77.        Sound Blaster Pro, Sound Blaster 16, Pro Audio Spectrum 16,
  78.        Pro Audio Spectrum and output to file
  79.      ■ Full ProTracker effects supported [except SetFilter/FunkIt]
  80.      ■ Implementation for some of the ScreamTracker ]I[ and ProTracker
  81.        playing bugs, so modules are likely to be played accurate even when
  82.        they were written relying on these programs' bugs, and should have
  83.        played wrong.
  84.  
  85.  
  86.   ■ User Interface
  87.   ────────────────
  88.  
  89.      ■ Very convenient pull-down menus interface
  90.      ■ Many features turn the tracker into a complete playing environment.
  91.        These include an internal file manager, enhanced Info Screen and more.
  92.      ■ Complete SuperVGA text-modes support, up to 9 full tracks on screen
  93.        using 132 column screen modes, yet still allow editing in the
  94.        eye-convenient 80x25 and 80x50 screen modes
  95.      ■ More tracks on screen (up to 31) can be viewed using fields folding.
  96.      ■ Full screen usually dedicated to a single purpose at a time - main
  97.        menu, file manager, patterns, samples, info screen & more, unlike
  98.        some trackers that squeeze too much editing features to one screen
  99.        decreasing characters size and ease-of-use.
  100.      ■ Context-sensitive Online Help Hypertext
  101.      ■ C00l scroller in the InfoScreen!
  102.      ■ 32bit code, loading the program into Extended Memory
  103.      ■ Fast program loaded. This means you can execute LIQ.EXE without
  104.        any significant delay, without any "DOS/4GW" or similar HD swapping.
  105.        Good when executing from other programs.
  106.      ■ A genuine *DOS* program, take advantage of all your system resources
  107.        for the only important purpose - the music! Once you'll learn how to
  108.        operate this tool, you will create music so fast and so professional,
  109.        in a manner you've never thought possible!
  110.  
  111.  
  112.                             ╒════════════════╗
  113.                             │  Requirements  ║
  114.                             └────────────────╜
  115.  
  116.      Minimal
  117.      ───────
  118.      ■ 386sx/16
  119.      ■ EGA display (CGA/MDA will work, but awful)
  120.      ■ Sound Blaster 1.00 card
  121.      ■ 350K XMS/EMS/int15h
  122.      ■ 450K conventional memory
  123.  
  124.  
  125.      Recommended
  126.      ───────────
  127.      ■ At least 486/33 to handle multichannel modules with intermediate pans
  128.      ■ SuperVGA with extended text modes, to allow huge pattern display
  129.      ■ Sound Blaster 16 or Pro Audio Spectrum 16 for 16bit/stereo/44khz sound
  130.      ■ 4 Megs free extended memory so huge modules will fit in.
  131.      ■ Prefer to work with HIMEM.SYS rather than other EMMs.
  132.      ■ The right mood ;-)
  133.  
  134.                    ╒═══════════════════════════════╗
  135.                    │     Command line options      ║
  136.                    └───────────────────────────────╜
  137.  
  138.    Usage:  LIQ [switches] [filename[.ext]] [switches]
  139.  
  140.    /?    - Quick summery on command line options
  141.  * /O?   - Set output device to:  1=SB1  2=SB2 3=SBPro 4=SB16 8=File 9=PAS16
  142.  * /B??? - specifies sound card address
  143.  * /I?   - specifies IRQ
  144.  * /D?   - specifies DMA
  145.    /F??  - specifies mix frequency (Khz)
  146. ** /L    - Don't loop module
  147.            Usable for player's SHELL such as ModMan, will cause
  148.            exiting to Dos when module reaches last pattern
  149. ** /E    - Quit Liquid upon pressing ESC
  150.            Also usable for player's SHELL. It will cause Liquid
  151.            to exit to Dos when pressing ESC at Info Screen, instead
  152.            of going to main menu
  153.    /M    - Force mono mode
  154.    /8    - Force 8bit mode
  155.  
  156.    /R    - Reliable Mode, meaning:
  157.            1) Plays a bit faster, and ALOT faster under EMS mode
  158.               (this is not triggered on by default, because it takes
  159.               some more memory and also causes a delayed response when
  160.               entering notes in the pattern editor).
  161.            2) Remains stayble under programs that reprogram the timer,
  162.               like Dos's EDIT, QBASIC and GWBASIC
  163.            3) Switches to 'Violent' mode, if another program resets
  164.               the sound card in Dos Shell (thus halting Liquid's playing
  165.               task), it will re-initialize the sound card and restart
  166.               playing from the same position it has been stopped.
  167.  
  168.    /S    - Activate Demo Mode
  169.  
  170.  * If one of the parameters marked with an asterisk is not specified on the
  171.    command line and "AutoDetect" in the Setup is set to ON, Liquid will use
  172.    it's internal autodetection routine to find the missing parameters.
  173. ** Features marked with an two asterisks involves auto exiting to Dos, and
  174.    will be discarded if the Pattern or Samples Editor is accessed, to
  175.    avoid loss of data.
  176.  
  177.  ! The command line switches force overriding both the setup and
  178.    the autodetection (which is invoked on every execution) results.
  179.  
  180.  
  181.                              ╒════════════════╕
  182.                              │   L E G A L    │
  183.                              ╘════════════════╛
  184.  
  185.       The  Liquid  Tracker program and  documentation  are copyright (c)
  186.       1993-1996   by   Nir  Oren,  and   all  rights  are  reserved.  No
  187.       modifications   may   be   made  on   the   program  nor  on  it's
  188.       documentation,  except  for  the  author;  and  in  no  event such
  189.       modified   version   may  be  distributed.   The  program  may  be
  190.       distributed  only  as a whole, with  all the files included in the
  191.       original  archive.  No  BBS ad's may  be  added  to the LIQxxx.ZIP
  192.       archive.  You can use the  Liquid Tracker (disribution version) in
  193.       your  program if you include the whole Liquid Tracker archive with
  194.       it.  No reverse-engineering, debugging or and kind of sourcing may
  195.       be  done  on the program, except for  the  author; No money may be
  196.       charged  for the Liquid Tracker program, except for the author and
  197.       the  case of sharewares or CD-ROM distributor, as long as there is
  198.       no  special fee for the Liquid Tracker  itself and as long as this
  199.       is  not  the  commercial  version  of  Liquid  Tracker. The author
  200.       reserve  the  right  to make any  change  in  the program updates,
  201.       including  the  changing, adding or  removal  of certion features.
  202.       There  is no warranty, and the author is not liable for any damage
  203.       caused  (although highly unlikely) by the  use or the improper use
  204.       of this program; use at your own risk.
  205.  
  206.  
  207.       All  the  trademarks  in this  document  are  registered by their
  208.       respective owners.
  209.  
  210.  
  211.                          ┌══════════════════════╗
  212.                          │   P E R S O N A L    ║
  213.                          └──────────────────────╜
  214.  
  215.      So  what do we got here? Another module tracker. I know, this could
  216.      have been much better, and will. I have started this project in the
  217.      early days, when the most advanced trackers for the time being were
  218.      ScreamTracker  2  & Komposer669. The  first version was released in
  219.      September  '93.  Since then,  many  trackers (dis)appeared, notably
  220.      FastTracker1,   MultiTracker,  ScreamTracker  3  and  FastTracker2.
  221.      Module  players?  more  than the water  drops  in  sea (We need one
  222.      module  player for every 50 users now don't we). However, this is a
  223.      Tracker,  not a player (as one can figure). And a good one, I hope.
  224.      Lots of TOTALLY AMAZING, useful and essential ideas are on the way.
  225.  
  226.      Also  as a module player, it  acts perfectly, loading all data into
  227.      extended memory, plays modules pretty accurate, providing very good
  228.      sound  quality, and nice InfoScreen. I  think we have an issue here
  229.      of using LIQUID as a S3M/MOD player on a daily basis (use it, I do!
  230.      ;-)
  231.  
  232.      In  addition,  if  you think that  the  Liquid  Tracker has a great
  233.      interface  and  it  is usable for  you,  then  register it! Tracker
  234.      programming  is  probably  the  most  non-profitable  application a
  235.      programmer  can  write,  compares to the  work  invested  on it. It
  236.      sometimes  takes years to develop  (because it's complex routines),
  237.      it's market is generally low, (Because it meant for musicians only.
  238.      try   comparing  the  amount  of   "tracking  programs"  users,  to
  239.      "communication  programs"  users, for example)  so it's probably an
  240.      addiction  writing such program. (But  hey, real computerized music
  241.      composers  know, that nothing compares  to the Tracker's concept in
  242.      making music)
  243.  
  244.  
  245.  
  246.    Special thanx must go to my beta team which is
  247.    ───────────────────────────────────────────────
  248.    Adi Sapir [DoC], Hay Shalom [Dr.Music], Yossi Zinger [Quadri]
  249.    Adi Berger [EagleBerger], Motti Koskas [F-16], Guy Nir [Mr.B]
  250.    Lior Elkotser (thanks for the Tseng!)
  251.    and... Moti Radomski [Chompi]
  252.  
  253.  
  254.    Greeting goes out to all those who MADE/MAKE the PC sound scene
  255.    ──────────────────────────────────────────────────────────────────────
  256.    Sami Tammilehto (for ST/FC/DIGIPLAY/EMS/16CHN), Otto Chrons (DMP/16bit),
  257.    Thomas Pytel (8CHN Tracker/GUS), Mark J Cox (StereoCovox/Modplay),
  258.    David López & Angel Trigo (SBPro), Fredrik Huss & Mognus Hogdakl (FT[2])
  259.    Joshua C. Jensen (GUS)
  260.  
  261.    Keep up with the good work!
  262.  
  263.  
  264.  
  265.                         ╒═════════════════════════╗
  266.                         │  Technical Information  ║
  267.                         └─────────────────────────╜
  268.  
  269.    DIGITAL SOUND MIXING CONCEPT
  270.  
  271.    16 BITS sound
  272.  
  273.    Many people wonder "what is the real difference between 8 bit and
  274.    16 bits sound  ? Is it  worth buying  a 16 bit  sound card ?" the
  275.    answer is simple. 16 bits sound gives you the benefit of a better
  276.    amplitude precision.  This becomes  more noticeable as the number
  277.    of playing  channels  increases  (Naturally,  more  channels will
  278.    cause each channel  to play  softly,  but this  can be  perfectly
  279.    resolved by  post-amplifying   the  output   sound) and  is  less
  280.    noticeable when less channels are playing. With 16 bit sound, you
  281.    can hear clearly  the minor  details of the sound,  too,  whereas
  282.    with 8 bit  these   will  get   distorted  (try  listening  to  a
  283.    multichannel module starting  from a  low volume  and you  should
  284.    clearly hear the difference,  or better,  if you are able to find
  285.    SUB.LIQ by Adi  Sapir,  test this one).  As for the profitability
  286.    from buying 16 bit  card:  nowadays 16bit cards' prices are quite
  287.    low (the SB16/PAS16 are  really cheap in their basic version; the
  288.    PAS16 BASIC is significantly cheap;  70$ in Israel (probably half
  289.    the price in  USA (=35$))) So,  if  you have a good amplifier and
  290.    hi-fi system,  get a 16bit card right away (and if you don't have
  291.    good hi-fi, then buy one; if you don't want to spend any money on
  292.    a good  amplifier,  what  the  heck  are you  doing here  reading
  293.    Tracker documentations, anyway?!)
  294.  
  295.    The Mixing Frequency  (= sampling rate)
  296.  
  297.    That is the  speed at  which the sound is mixed,  which means how
  298.    many times per  seconds the  sound is  updated (ex. 44.1Khz means
  299.    sound is updates 45158 times per second). This also refers to the
  300.    maximum frequency the  player will  allow a  sample to  play with
  301.    full representation of  all the bytes in the sample.  The higher,
  302.    the better  the  sound  will  get,  and more  CPU time  the sound
  303.    routines require to mix the channels.
  304.  
  305.    Now one can ask...
  306.  
  307.    Why not produce a card with 32 bit sound support? why not produce
  308.    a  card  with 88 Khz sound  support  (for example)? The answer to
  309.    that  question  is  that  the human  ears  can't  get more than a
  310.    certain  frequency  and amplitude  resolution and thus increasing
  311.    those  values  is  absolutely redundant.  Now,  since the highest
  312.    sound frequency that can be heard by human ear is 22 Khz (and one
  313.    with  very good hearing; the avarage is something around 16 Khz),
  314.    and  since  there's a physical  rule  regarding digitized samples
  315.    saying  that in order to get  certain sound frequency, you should
  316.    record  and play it in double  frequency, the standard quality in
  317.    studio recordings (also in CDs) became 44 Khz. (thanks to Guy Nir
  318.    for  the  above information). Anyway, even  33  Khz sound with 12
  319.    bits  sound  is  enough for avarage  human  hearing. I would have
  320.    stated  even  lower frequency, but  the sound filters existing on
  321.    many  16 bit sound cards (notably  the SB16 with it's CODEC chip)
  322.    require about 33 Khz to get the maximum quality possible.
  323.  
  324.  
  325.    ■ 16 BIT cards with built-in memory vs. software mixing routines
  326.    -----------------------------------------------------------------
  327.  
  328.    Performing the  channels-mixing   by  software  is  a  relatively
  329.    complicated process and  not easy  to program.  In  addition,  it
  330.    takes some   CPU   time,   depending   on   the  sound   routines
  331.    optimization, channels number,  mixing  frequency,  pan positions
  332.    and more...   Those  facts   (mostly  the   first  one) make  the
  333.    development of   high-quality* 'multi-tracks' sound   software  a
  334.    property of few "addicted" programmers and groups (this number is
  335.    however increaseing day  by day,  due to sources releases by some
  336.    of the programmers  despair  from creating their software).    In
  337.    the year 1992 Advanced Gravis started their revolution with their
  338.    UltraSound card which  is basically  an enhanced  version of  the
  339.    "Paula" Chip on the Amiga. It does the mixing by hardware, and no
  340.    CPU time  is   involved.   Of  course,   this   method  has  it's
  341.    disadvantage: the  output  sound cannot  be post- processed! This
  342.    means that you  cannot mix specific channel with a special method
  343.    (like "robotize" for example), or any sort of digital effects (of
  344.    course, you  can  always  wait  until  the  hardware  manufacture
  345.    develops a new hardware with "effects" but this always costs more
  346.    and it does not upgrade as fast as software which does the same).
  347.  
  348.  
  349.  * High-quality means that  the playing  routines will support 16bit
  350.    sound and 16bit  cards as well as support >4 channels (this needs
  351.    highly optimized sound routines), and support XMS or EMS.  A nice
  352.    bonus would be  if the  routines fully support   panning,  16bit,
  353.    over 64K samples and various sound devices.
  354.  
  355.  
  356.        ╒══════════════════════════════════════════════════════════════╕
  357.        │    Software Mixing vs. Hardware Mixing Comparison Table      │
  358.        ╘══════════════════════════════════════════════════════════════╛
  359.  
  360.                      REALTIME SOFTWARE MIXING        HARDWARE MIXING
  361.  
  362.                      (SB16, SBPro, SB1,2, PAS,      (Gravis Ultrasound,
  363.                      Windows Sound System, DAC,     Soundblaster AWE32)
  364.                      GUS/AWE in their software
  365.                      mixing mode (which is not
  366.                      widely supported by prog-
  367.                      rams), Pc-Speaker)
  368.  
  369.   CPU TIME USED      Alot. Very dependant on the    Minimal.
  370.                      optimization of the software,  The Mixing itself does
  371.                      vary from one to another.      not require any CPU
  372.                      when a 486DX33 machine is      time. This is actually
  373.                      dedicated to sound calc.       the biggest advantage
  374.                      you can use more than 32       of the GUS/AWE, less
  375.                      tracks playing at 33Khz,       important if you don't
  376.                      16Bit, Stereo and still have   plan on playing games,
  377.                      lots of CPU time available.    and you only want
  378.                      on a 386SX/33, you can mix     to play music.
  379.                      about 9 channels with BEST
  380.                      QUALITY - and still have CPU
  381.                      time (even up to 13 channels
  382.                      but with no CPU time left,
  383.                      just remember to run LIQ -R)
  384.  
  385.   SOUND QUALITY      Excellent on 16 Bit! Very      Excellent (GUS quality
  386.                      good at 8 Bit, depends in      goes down with more than
  387.                      the software and the sound     16 channels). Also it
  388.                      filters on specific cards.     depends on the hardware
  389.                      Since sound can be post-       sound filters on the
  390.                      processed the quality can      specific sound card.
  391.                      be improved by software        usually cannot be improved
  392.                      based digital filters in       by new releases of various
  393.                      new versions of various        software.
  394.                      software.
  395.  
  396.         SUPPORT      Supported by most of the       Supported by most of
  397.                      players/trackers available.    the NEW players/trackers
  398.                      Not widely supported by        available.
  399.           games      games; Companies prefer        Supported by new games.
  400.                      to use the FM. see next        Foreseen to be a standard
  401.                      section.                       in games since it doesn't
  402.                                                     take CPU time and deliver
  403.                                                     great quality.
  404.  
  405.     PROGRAMMING      Depend on the sophistica-      Relatively easy.
  406.                      tion level of the software;
  407.                      full panning? fast routines?
  408.                      16bit? stereo? software
  409.                      amplifying? various output
  410.                      devices? relatively complicated.
  411.  
  412.          MEMORY      Latest programs can utilize    You have to pay extra
  413.                      all available memory which     cost for on-card memory
  414.                      means that if you have 32MEG   chips. Vary from 256K
  415.                      board memory you can dedicate  to 8 MEGA (some old cards
  416.                      it all to samples! memory is   support up to 2 MEGA)
  417.                      shared which means less cost.
  418.  
  419.          MIXING      DIGITAL.                       ANALOG.
  420.  
  421.     RECOMMENDED      This section has been added only recently. Since today's
  422.                      CPUs are running faster every day, and 586's running at
  423.                      200 Mhz became not such a rare thing, it is safer to
  424.                      say that a program can do all the mixing using the
  425.                      CPU, yet still have a lot of remaining time for
  426.                      the foreground application (if any), and enough CPU
  427.                      time to performe echoes, filters, interpolation, and
  428.                      anything needed. So sound cards like the GUS and AWE
  429.                      are redundant, to my opinion (as long as there are good
  430.                      sound routines available to perform the mixing,
  431.                      like Liquid's ;-)
  432.  
  433.  
  434.  
  435.  ╓───────────────────────────────= CONTACTS =───────────────────────────────╖
  436.  ║                                                                          ║
  437.  ║  New versions of Liquid can be obtained FREELY from                      ║
  438.  ║                                                                          ║
  439.  ║  Anesthesia (A) BBS   - (972)-7-9971505 - 28k - 24 Hrs  Log name: LIQUID ║
  440.  ║                         (972)-7-9954490 - 14k - 24 Hrs  Password: LIQUID ║                             ║
  441.  ║                                                                _______   ║
  442.  ║                                                               \     \_\  ║
  443.  ║                                                               / \_______\║
  444.  ║   You can cont(r)act the author by:    │      SnailMail:  ||__\   __/ |  ║
  445.  ║                                        │                 (°°_________/   ║
  446.  ║ FidoNET: 97:200/215, 2:403/442         │   Nir Oren                      ║
  447.  ║ -------------------------------------  │   P.O. box 8180                 ║
  448.  ║ InterNET: nir.oren@tbu.excellnet.co.il │   Petah Tikva 49181             ║
  449.  ║                                        │   Israel  <reply guaranteed!>   ║
  450.  ║                                        │   (The SNAIL is (C) !!! ;-)     ║
  451.  ╙──────────────────────────────────────────────────────────────────────────╜
  452.  
  453.              or      al, al                ;  Are we at null?
  454.              jnz     Fast_Introduction
  455.  
  456.                         * * *   End if LIQ.DOC   * * *
  457.