home *** CD-ROM | disk | FTP | other *** search
/ Chip: Special Sound & MIDI / Chip-Special_Sound-und-Midi-auf-dem-PC.bin / dostools / toptune / toptune.doc < prev    next >
Text File  |  1992-04-21  |  10KB  |  249 lines
  1.  
  2.  
  3.                     TopTune
  4.  
  5.         The instrument editor for AdLib and compatibles
  6.  
  7.             A K.ids G.et B.its! Production
  8.                  Version 1.92
  9.                 First  Release
  10.  
  11.              (C) 1992 by K.G.B., Wild West Germany
  12.            Concept & coding & documentation by VAN BETHOVEN
  13.         With special thanks to RAMses for help in various cases
  14.  
  15.  
  16.  
  17.      About TopTune:
  18.      ──────────────
  19.  
  20.      TopTune was designed for use with Visual Composer from AdLib
  21.      Inc. I don't know any other similar composing software for
  22.      the AdLib soundcard so I can't tell you whether TopTune will
  23.      help you when not using Visual Composer. If you know Visual
  24.      Composer but use some other software you consider to be
  25.      better, then please contact me (VAN BETHOVEN, member of
  26.      K.ids G.et B.its! and programmer of TopTune - address some
  27.      lines below).
  28.  
  29.      It took quite a while to make TopTune look like that what you
  30.      can see now. AdLib's Programmer's Manual is extremely bad and
  31.      incomplete. Although TopTune was mainly coded by me, the
  32.      technical know-how of AdLib programming is an accomplishment
  33.      of the whole K.G.B. crew.
  34.  
  35.      TopTune is freeware. If you have problems with TopTune or if
  36.      you want us to implement some enhancements and release a new
  37.      version or FOR ANY OTHER REASON, feel free to contact us
  38.      whenever you want.
  39.  
  40.                     K.G.B.
  41.                  Postfach 1236
  42.                  W7408 Kusterdingen 1
  43.                     Germany
  44.  
  45.      Note: We are NOT liable for any inconveniences caused by this
  46.            software. Use TopTune at your own risk (as we do) !
  47.  
  48.  
  49.  
  50.      Short introduction
  51.  
  52.      In general:
  53.  
  54.      TopTune provides a super-modern and highly convenient
  55.      pseudo-GUI (why "pseudo"? Freaks knowing the abbreviation
  56.      GUI should know !). You will get most satisfaction by using
  57.      a mouse. Originally, I programmed TopTune for my own needs,
  58.      that's one reason why there's no OnLine-Help option (the
  59.      other one is that I am a bit lazy). But I can assure you
  60.      won't need OnLine-Help. If you know AdLib's Instrument Maker
  61.      you will easily get used to TopTune - and as TopTune is
  62.      superior you'll soon appreciate its enhancements. If you
  63.      don't know AdLib's Instrument Maker, read the following
  64.      paragraphs. Even Power-Users will find valuable information
  65.      about TopTune's special features - at least they should read
  66.      the Miscellaneous part.
  67.  
  68. ********************************************************************************
  69.  
  70.  
  71.      HOW TO USE TopTune
  72.  
  73.      The operators:
  74.      ──────────────
  75.  
  76.      Modify or create an instrument by changing the values of the
  77.      carrier and the modulator (the operators). Using a keyboard
  78.      you can switch between Carrier and Modulator by pressing the
  79.      TAB key. Press the Up or Down arrow to select the parameter
  80.      you want to change. Increase the value of the selected
  81.      parameter by pressing the right arrow or decrease it by
  82.      pressing the left one. Flags can be toggled with the
  83.      spacebar or the ENTER key. One special parameter called
  84.      Output Level can be adjusted by pressing the + or - key (have
  85.      a guess which key will do what). Mouse users simply click on
  86.      the arrows, the + or - symbol. I think it's so easy that it
  87.      doesn't need any further explanation. Clicking with the
  88.      right mouse button forces TopTune to execute most options
  89.      with double-speed.
  90.  
  91.  
  92.      Windows and options:
  93.      ────────────────────
  94.      Open a window by pressing ESC or by clicking on its name.
  95.      Close a window by pressing ESC again or by clicking outside
  96.      the window. Press the up or down key to select an option and
  97.      confirm with ENTER.
  98.  
  99.  
  100.      FILE options:
  101.      ─────────────
  102.      NEW loads the default instrument of the selected type.
  103.  
  104.      RESTORE restores the instrument loaded. Use RESTORE to undo
  105.      everything you changed on the instrument.
  106.  
  107.      LOAD loads an instrument of the selected type from a
  108.      bankfile. Use the arrow keys, PageUp, PageDown, Home or End
  109.      or click on one of the four blue arrows to choose an
  110.      instrument. You may also hit the first letter of the
  111.      instrument on the keyboard to activate a quick search.
  112.      Confirm by pressing ENTER or by double-clicking on the
  113.      instrument name. This option can also be called with the
  114.      F3 key.
  115.  
  116.      SAVE writes the instrument back to the bankfile. Note: If
  117.      you need instruments to be saved in a different format,
  118.      contact us and provide a detailed description of what you
  119.      desire. This option can also be called with the F4 key.
  120.  
  121.      SAVE AS adds the instruments to the bankfile. The user may
  122.      either specify a new name or overwrite an existing
  123.      instrument. You may check what instruments already exist.
  124.      All of them are displayed in the box. Flip through pages by
  125.      processing as explained in option LOAD. Nevertheless you
  126.      will be asked to confirm again when overwriting an
  127.      instrument. The bankfile will eventually be expanded (see
  128.      DELETE for details). Press the TAB key to toggle between
  129.      boxes or simply click at them.
  130.  
  131.      DELETE erases an instrument of the selected type from a
  132.      bankfile. Note: the size of the bankfile will not change.
  133.      The next instrument being saved will use any free space
  134.      within the bankfile before expanding it. See LOAD for
  135.      details about selecting an instrument. This option can also
  136.      be called with the F5 key.
  137.  
  138.      SELECT BANKFILE lets you choose the bankfile to load or
  139.      delete instruments from, to save or add new instruments to.
  140.      Bankfiles must have the extension BNK. The way of selecting
  141.      a bankfile corresponds to choosing an instrument described in
  142.      option LOAD. To change to a different drive click on its
  143.      letter or press the TAB key to enable drive select by
  144.      keyboard. Doing this lets you choose the new drive with the
  145.      left and right arrow key, ENTER to confirm. Press TAB again
  146.      to switch back to the name box.
  147.  
  148.      LOAD INS FILE has been provided to load files created with
  149.      AdLib's Instrument Maker. The way of selecting an INS file
  150.      corresponds to choosing an instrument described in option
  151.      LOAD. See SELECT BANKFILE to learn about changing drives.
  152.      The extension of a valid INS file must be INS. These files
  153.      always use full sine waves (Type 0). The INS file standard
  154.      is far inferior to bankfiles and obsolete.
  155.  
  156.  
  157.      VOICE Options:
  158.      ──────────────
  159.      AdLib compatible soundcards support two different types of
  160.      instruments: single operator instruments (percussive voices
  161.      like SNARE DRUM, TOM TOM, TOP CYMBAL and HIHAT) and double
  162.      operator instruments (MELODIC and BASE DRUM voices). The
  163.      latter type allows an alternative method of sound generating:
  164.      Additive Synthesis. Vice versa: Additive Synthesis only works
  165.      on melodic and base drum voices.
  166.  
  167.      As well as in Visual Composer the pitch of percussive
  168.      instruments - except the base drum and the tom tom - is
  169.      fixed (I had to do some special tricks to realize that).
  170.  
  171.      A mark at the right end shows that the corresponding option
  172.      is active.
  173.  
  174.      Select the type of instrument you want to edit.
  175.      IMPORTANT: When loading or deleting from a bankfile, only
  176.      instruments matching the currently selected instrument type
  177.      are listed.
  178.  
  179.      THE "PIANO":
  180.      ────────────
  181.      Play the piano by using your keyboard (1st octave from Z to ,
  182.      halftones from s to j - 2nd octave from q to i plus major
  183.      third to p; halftones from 2 to 0). The key you press is
  184.      shown on the piano. Clicking with the mouse button is
  185.      possible as well. Press F1 to transpose the piano one octave
  186.      down or F2 to do the opposite. Using a mouse, simply click on
  187.      the arrows displayed at both ends of the piano.
  188.  
  189.  
  190.      QUITTING
  191.  
  192.      Click on Quit or press ALT-Q or the F10 key to exit.
  193.  
  194. ********************************************************************************
  195.  
  196.      MISCELLANEOUS
  197.  
  198.      Messages shown in read boxes are error messages. They
  199.      announce that an option failed to succeed.
  200.  
  201.      Visual Composer uses a very stupid quicksort method. When
  202.      adding a number to an instrument name, it is sometimes wise
  203.      to insert a zero as first digit (like BELL03). Else the
  204.      instruments will be listed in a weird manner.
  205.  
  206.      The window labeled ? is not only for information. Selecting
  207.      it also reinits the AdLib chip.
  208.  
  209.      Command line parameters:
  210.      /nomouse        deactivate the mouse
  211.      /mouse         if TopTune can detect a proper mouse
  212.                 driver, mouse support is enabled
  213.      Unless you want to change this option you need the parameter
  214.      only once.
  215.  
  216.      TOPTUNE.CFG - the TopTune configuration file
  217.  
  218.      TopTune saves four things in this file:
  219.      A note whether mouse support is disabled or enabled, the path
  220.      of the bankfile you used last and the directory of this
  221.      bankfile as well as the directory where your INS files are
  222.      stored.
  223.      TopTune won't make your computer explode when the CFG-file
  224.      misses, so don't worry. Note: If you change bankfiles or
  225.      directories, they will only be saved to TOPTUNE.CFG if they
  226.      are on the drive you started TopTune from (if you know about
  227.      programming, you know why).
  228.  
  229.      Requirements:
  230.      - DOS Versions 3.3 or above
  231.      - about 100k free memory
  232.      - a 100% compatible Video Graphics Array (VGA) with 128k min.
  233.      - AdLib or compatible soundcard at 388h
  234.      - a Microsoft, Mouse Systems or Logitech compatible mouse
  235.        (optional but highly recommended)
  236.      - be sure to set FILES=20 or above
  237.  
  238.      Limits:
  239.      - the size of the bankfile must not exceed 50,000 bytes,
  240.        that means not more than 1111 instruments per bankfile
  241.        (should be enough, eh ?)
  242.      - I assume that when you load an instrument you want to save
  243.        it after modifying. For this, TopTune will refuse to load
  244.        read-only bankfiles or read-only INS files.
  245.  
  246. *******************************************************************************
  247.  
  248.              CDV - Software * Ettlingerstr. 5 * 7500 Karlsruhe 1
  249.