home *** CD-ROM | disk | FTP | other *** search
/ Audio 4.94 - Over 11,000 Files / audio-11000.iso / msdos / midi / d4man104 / d4man.doc < prev    next >
Encoding:
Text File  |  1992-09-13  |  45.1 KB  |  863 lines

  1.       Welcome  Alesis  D4  Enthusiasts!    Thank   you  for  downloading  or
  2.       requesting  the unregistered  version  of  D4man, developed  by  Zorch
  3.       brotherz software.  
  4.  
  5.       This package should contain the following files:
  6.  
  7.           D4man.EXE     - Alesis D4 Manager program, unregistered version.
  8.  
  9.           D4man.ICO     - Microsoft Windows icon for D4man.  
  10.  
  11.           D4man.INI     - Default startup D4 data file.
  12.  
  13.           D4man.DOC     - This file, manual and documentation text.
  14.  
  15.           D4man.LOG     - D4man's update history log.
  16.  
  17.           ORDER.FRM     - Order  form  for  registering your  copy.   Please
  18.                           include the completed order form with your order.
  19.  
  20.           ALLSYS.SYX    - Sample D4 "System (All)" file in MIDIEX format. 
  21.  
  22.           DRUMST??.SYX  - Sample  D4  "Single  Drumset"  file(s)  in  MIDIEX
  23.                           format.  
  24.  
  25.           TRIGGERS.SYX  - Sample  D4  "12  Trigger  Setup"  file  in  MIDIEX
  26.                           format.  
  27.  
  28.           PROGMAP.SYX   - Sample  D4  "Program Change  Map"  file in  MIDIEX
  29.                           format.  
  30.  
  31.  
  32.       INTRODUCTION
  33.       ------------
  34.       The  Alesis D4 Drum Module is the latest in the line of popular Alesis
  35.       drum machines.  It offers  over 500 sounds in  the space of a  single-
  36.       height  19"  rack-mount  unit,  with  an  incredibly  low  price  tag.
  37.       Although its  number of  sounds and  its size  are advantageous,  they
  38.       present a problem as  far as  managing and configuring  the unit -  so
  39.       many options,  but only  one two-line LCD  to program  it with!   With
  40.       this in  mind, Zorch  brotherz software  has developed  D4man, the  D4
  41.       Manager program that runs on your  IBM PC or compatible, allowing  you
  42.       to edit all D4  parameters while taking advantage  of the PC's  screen
  43.       and disk storage capabilities.  
  44.  
  45.       We are  now  making the  D4man program  available  to  D4 users  at  a
  46.       reasonably-priced shareware registration fee (please  see order form).
  47.       This one-time fee will also include free tech  support and upgrades as
  48.       required.  Upgrades  will be made  available to  registered users  for
  49.       the cost of shipping and handling.  
  50.  
  51.  
  52.       And now a commercial from our sponsor:
  53.  
  54.       *********************************************************************
  55.  
  56.       This  manual  and the  software  it  pertains  to  are distributed  as
  57.       shareware,  (C) Copyright  1992,  by  Bret Costin  and  Zorch brotherz
  58.       software.  The  unregistered version of  this material  may be  copied
  59.       and distributed freely, provided the following conditions are met:
  60.  
  61.           -  Any copying or distribution must be done free-of-charge.
  62.  
  63.           -  The D4man program, this  manual, and any data or  utility files
  64.              included  in  this package  must  be  distributed together  and
  65.              unaltered.
  66.  
  67.           -  If you do decide to  keep a copy of this material  for your own
  68.              use, please register your  copy so that we can keep  you posted
  69.              on  upgrades.   Your  registration and  money  will help  us to
  70.              continue  supporting our  products and  make them  available to
  71.              users at a reasonable price.  
  72.  
  73.       If you find D4man useful, please distribute it  to your favorite local
  74.       MIDI and/or Music BBS.  As with  any software package, the more  users
  75.       there are,  the better environment  for exchanging configurations  and
  76.       ideas!  
  77.  
  78.       Thank you in advance for supporting the shareware concept.  
  79.  
  80.       *********************************************************************
  81.  
  82.  
  83.       HOW TO REGISTER
  84.       ---------------
  85.       It's easy to  register D4man,  and there are  several benefits if  you
  86.       do.    Just  fill  out  the  order  form  that came  zipped  with  the
  87.       unregistered version of D4man (file  name is ORDER.FRM), complete  the
  88.       form, and send with  check or money order to the address in ORDER.FRM.
  89.       (It is  important that you fill out the  form so that we may note your
  90.       address,  configuration,  media preference,  etc. for  future upgrades
  91.       and technical support.)   Also,  be sure to  make the  check or  money
  92.       order out  to Bret  Costin.   Finally,  once you  become a  registered
  93.       user, you  have access  to the  D4man Registered  Users'  Area of  our
  94.       support  Bulletin Board  System.   This  allows  you to  download your
  95.       registered  version immediately (well,  ok, allow  at least  24 hours)
  96.       after  your  order  form  and  payment arrive!    Whether  or  not you
  97.       download the registered version from  the BBS, please allow  two weeks
  98.       for your D4man disk  to arrive in the  mail.  Future upgrades will  be
  99.       available  via  the BBS  and  by  mail.    Upgrades by  mail  will  be
  100.       available for a shipping/handling  charge of $5.00 (USA)  per upgrade.
  101.       This rate may  increase as the price of US Mail service increases.  In
  102.       addition, if you live  outside of the USA, there may be  an additional
  103.       shipping charge.  
  104.  
  105.       Well,  now that we've  got the obligatory text  out of  the way, let's
  106.       roll up  our sleeves (some musician's still  prefer them) and get down
  107.       to business!
  108.  
  109.  
  110.       WHAT D4man CAN DO (AND CAN'T DO)
  111.       --------------------------------
  112.       The D4man program is currently  a D4 Librarian and Editor that  allows
  113.       an  Alesis  D4  user  to   configure  the  D4  and   store/recall  its
  114.       configurations from  disk.  D4man, in quick summary, allows a user to:
  115.  
  116.           -  Define individual drumsets and modify all drumset parameters.  
  117.  
  118.           -  Setup all parameters associated with each trigger input.  
  119.  
  120.           -  Audition individual  sounds  or entire  drumsets  via  computer
  121.              keyboard and mouse.  
  122.  
  123.           -  Setup  an  entire  D4  "system"  configuration,  including  all
  124.              drumsets,  triggers, program  change  table, footswitch  modes,
  125.              etc.
  126.  
  127.           -  Modify the 128 Program Change Table locations.  
  128.  
  129.           -  Store  and retrieve all data to/from disk media, using a widely
  130.              accepted  and  supported  (by  both  commercial  and  shareware
  131.              programs) file format, MIDIEX (a.k.a., Sysex, System Exclusive,
  132.              or Cakewalk System Exclusive).  
  133.  
  134.           -  Operate the D4 via a programmable MIDI Patch Bay.  
  135.  
  136.       The D4man program is available  in two versions, the  "registered" and
  137.       the "unregistered" version.   Both operate in the same fashion with  a
  138.       few exceptions:
  139.  
  140.           -  The  unregistered version displays  an invocation  message that
  141.              informs the user that the program is unregistered.  
  142.  
  143.           -  The unregistered  version's Zorch pull-down menu  displays "How
  144.              To Register" information.  
  145.  
  146.           -  The  unregistered version does not  allow data to  be stored to
  147.              disk.   It does allow data to be  loaded from disk.  Samples of
  148.              all file formats are provided so that you may operate D4man and
  149.              test file compatibility with other products.  
  150.  
  151.           -  The unregistered  version displays  an exit message  that gives
  152.              information regarding registration. 
  153.  
  154.       The unregistered version  contains no hidden  "time bombs".   It  does
  155.       not automatically exit after a  given session time, nor does it  self-
  156.       destruct  after a  given  time period.   If  either  occurs with  your
  157.       version, please note your setup and notify Zorch brotherz software.  
  158.  
  159.       This  software  has  been  tested  on  several  different  brands  and
  160.       configurations of  computers and MIDI interfaces.   If  D4man does not
  161.       operate correctly on  your machine, notify  us and we will  attempt to
  162.       remedy the situation.  Also, if there's  a feature you'd like to  see,
  163.       we're open  to suggestions  - many  of the  powerful  features of  our
  164.       Zorch brotherz software  products are the result of  registered users'
  165.       and unregistered evaluators' suggestions.  
  166.  
  167.  
  168.       HARDWARE REQUIREMENTS
  169.       ---------------------
  170.       To take advantage of all  D4man program features, you should have  the
  171.       following hardware:
  172.  
  173.           -  Alesis D4, with internal software revision 1.02 or later,
  174.  
  175.           -  IBM  PC  or compatible  computer (this  includes the  Yamaha C1
  176.              Music Computer), with at least 512k of RAM, 
  177.  
  178.           -  DOS 2.0 (MS-DOS 3.31 or later preferred) operating system, 
  179.  
  180.           -  A  MIDI  interface  that  is Roland  MPU-401  compatible  (this
  181.              includes  Voyetra's,  Music  Quest's,  and  CMS  lines  of  MPU
  182.              compatibles, as well as  Micro Channel Architecture versions of
  183.              the MPU).  IRQ is not critical,
  184.  
  185.                   OR
  186.  
  187.              A  Yamaha C1  MIDI interface  (connected to  first IN  port and
  188.              first OUT port only),
  189.  
  190.                   OR
  191.  
  192.              A Sound Blaster with MIDI interface, (you'll need to set-up its
  193.              address via the D4man Setup function),
  194.  
  195.           -  CGA or better video card and monitor,  
  196.  
  197.           -  An optional Microsoft, Logitech, Genius, or compatible mouse or
  198.              trackball with its software driver installed.
  199.  
  200.  
  201.       You  should have  at  least  256k  of  RAM  available  to  run  D4man.
  202.       Shelling to DOS from inside the program may  require even more memory.
  203.       The DOS CHKDSK.COM program displays  the number of free bytes in  your
  204.       machine, as  does DOS 5.0's MEM.EXE command.   For more information on
  205.       determining available memory, please consult your DOS manual.  
  206.  
  207.       Most IBM  PC-compatible video  cards are  supported -  D4man currently
  208.       operates in 80-column, color text mode.  
  209.  
  210.       D4man will  run  with  or  without  a  mouse  and/or  MIDI  interface.
  211.       Without  a MIDI interface, don't  expect to hear  any sound except the
  212.       hi-tech  BEEP!  of  the  PC  speaker.    When  no  MIDI  interface  is
  213.       installed, it is best to setup D4man with  the MIDI interface disabled
  214.       (see  D4man  Setup section),  or to  invoke D4man  with the  "no midi"
  215.       command line switch set.
  216.  
  217.  
  218.       INSTALLING AND RUNNING D4man
  219.       ----------------------------
  220.       D4man's installation  is simple.  First  back-up your  copy to another
  221.       floppy disk, then just  copy the D4MAN.EXE and other files to the disk
  222.       and  directory you would like D4man to run from.   Then change to that
  223.       disk/directory (or  include its  directory specification  in your  DOS
  224.       PATH statement) and start  D4man.  The first time you start D4man, you
  225.       may have to specify one or more of the D4man command switches:
  226.  
  227.           -base=AAAh    Set  I/O base  address if  using  MPU-401 compatible
  228.                         interface.   AAA specifies  the hexadecimal I/O base
  229.                         address of the MPU card installed in your system.  
  230.  
  231.           -c=XX         Set  MIDI channel.    D4man automatically  sets  its
  232.                         internal MIDI channel  to the value specified  by XX
  233.                         (acceptable values: 1  through 16).  Note  that once
  234.                         D4man is running, you can also set  the MIDI channel
  235.                         via pull-down menu or D4man Setup Screen.  
  236.  
  237.           -c1           Executing on a  Yamaha C1 computer.   "C1 mode"  may
  238.                         also be configured from the D4man Setup window.  
  239.  
  240.           -n            No MIDI interface.   Setting this switch  allows you
  241.                         to run D4man,  edit all D4 parameters locally on the
  242.                         PC, and store files to disk  without actually having
  243.                         a MIDI  interface physically residing in  the system
  244.                         or a D4 attached.  
  245.        
  246.           -q=FFFF       Quickload.     D4man  will  automatically  load  the
  247.                         filename specified by  FFFF, transmit it to  your D4
  248.                         via MIDI,  then immediately exit.   Quickloading  is
  249.                         handy  for loading banks from the DOS prompt or from
  250.                         within batch files and is especially  useful in live
  251.                         performance applications  as  it  acts like  a  MIDI
  252.                         "data disk".  
  253.  
  254.  
  255.       Here's a  few examples of switch usage (by the way, instead of using a
  256.       '-' at the  beginning of a switch,  you can alternately use  a forward
  257.       slash character '/'):  
  258.  
  259.             D4man -n                      <Enter>   The  user's  PC  has  no
  260.                                                     MIDI interface.  
  261.  
  262.             D4man -c=13 -c1               <Enter>   The user's D4 is on MIDI
  263.                                                     channel   13   and   the
  264.                                                     computer being used is a
  265.                                                     Yamaha C1.  
  266.  
  267.             D4man -c=8 -q=c:\d4\sys.all   <Enter>   The user is quickloading
  268.                                                     file     SYS.ALL    from
  269.                                                     directory C:\D4  to a D4
  270.                                                     on MIDI channel 8.  
  271.  
  272.             D4man -base=230h              <Enter>   The  user  has  an  MPU-
  273.                                                     compatible   MIDI   card
  274.                                                     installed  at  I/O  base
  275.                                                     address 230h.  
  276.  
  277.       After entering  the command  line, if  the quickload  switch has  been
  278.       set, the  program name,  version  number,  and copyright  notice  will
  279.       appear.   Then the  file will load to  the D4.   Immediately after the
  280.       file has loaded, the program will return to the DOS prompt.  
  281.  
  282.       If  the quickload switch  has NOT  been set  on the command  line, the
  283.       program name,  version number,  copyright notice,  and Zorch  brotherz
  284.       logo will appear.   If you are running an unregistered copy, that fact
  285.       will also  be displayed.   Strike  any key  to continue.   The  screen
  286.       should clear and the main program screen will immediately appear.
  287.  
  288.       If you have D4man's  MIDI Patch Bay feature  enabled (see D4man  Setup
  289.       section),  D4man  will   now  switch  your  Patch  Bay  over  to  your
  290.       predefined setup.   Once in the program,  if it is the first time  you
  291.       have run D4man (or  no D4man.CFG file exists in the same  directory as
  292.       D4MAN.EXE) the program  will prompt you  with the  Setup Window.   Set
  293.       D4man's  parameters to match  your system  (see D4man  Setup section),
  294.       and press <Esc> to return to D4man's main screen.  
  295.  
  296.       Also, if D4MAN.INI  exists in the  D4man directory  (and it  should!),
  297.       D4man will  load in the default  drumsets and setup.  By  the way, the
  298.       file  D4MAN.INI may  be  modified to  your  own tastes  (See D4MAN.INI
  299.       Section).  
  300.  
  301.  
  302.       USING THE INTERACTIVE MENU SYSTEM
  303.       ---------------------------------
  304.       D4man implements an interactive pull-down menu  system similar to many
  305.       of  today's commercial  products.   The  menu  system makes  the tasks
  306.       associated with the D4man program  simpler and more intuitive.   Menus
  307.       may be operated  by either a mouse  or the computer's keyboard.   Hot-
  308.       keys are  implemented that allow the  user to  execute D4man functions
  309.       via single keystrokes (typically function keys).  
  310.  
  311.       To  select  a  menu  via  mouse,  position  the  mouse cursor  (a  red
  312.       rectangle) on the top menu bar  and hold down a mouse button.  If  the
  313.       cursor  is on one of  the top line menu  fields, a pull-down menu will
  314.       appear and  remain until  all mouse  buttons have been  released.   To
  315.       select a pull-down  menu item, while pressing the mouse button, "drag"
  316.       the  mouse cursor  over the  pull-down fields.   As  the cursor passes
  317.       over each  field,  it highlights  that  particular field.   To  run  a
  318.       routine associated  with a field, release  the mouse  button(s) as the
  319.       mouse cursor selects the field.   If you don't want to run any of  the
  320.       routines on that  pull-down menu, merely move the mouse cursor outside
  321.       of the pull-down menu and release the mouse button(s).
  322.  
  323.       Various pop-up  windows  will allow  selection via  single and  double
  324.       clicks.   Just place  the mouse  cursor over  the  selected field  and
  325.       click once  or twice.  When  in Full-Screen Edit Mode,  parameters are
  326.       highlighted by mouse  clicking, and selected for edit by mouse double-
  327.       clicking.
  328.  
  329.       To select a menu via keyboard, hold  down the <Alt> key and  press the
  330.       highlighted (black)  letter of the top line menu  topic you would like
  331.       to pull-down.  Once the pull-down menu appears,  the menu's fields may
  332.       be highlighted by  using the keyboard's cursor keys, <Home>, and <End>
  333.       keys.   To run  a routine  from the  pull-down, highlight  the desired
  334.       field and  press the <Enter>  key.  To  abort a pull-down menu,  press
  335.       <Esc>.
  336.  
  337.       Notice that many  of the functions  displayed in  the pull-down  menus
  338.       have a function or  control key "hot key" associated with them.  These
  339.       designated "hot keys"  allow the user  to execute  functions with  one
  340.       keystroke.   For  example,  to quit  the  D4man program,  press <F10>.
  341.       Adios.
  342.  
  343.  
  344.       BROWSING THE MAIN (OR "CURRENT DRUMSET") DISPLAY
  345.       ------------------------------------------------
  346.       Users  may  browse  around  the  main  screen  and  edit  the  various
  347.       parameters of  the currently  selected drumset.   Supporting  both the
  348.       mouse  and the keyboard, D4man provides multiple methods for operating
  349.       the display.  
  350.  
  351.       There  are several ways  to select  a parameter.   A parameter  may be
  352.       selected by  moving the  blue bar  cursor via  the computer's  cursor,
  353.       <Home>,  and <End> keys until the desired field is highlighted.  Mouse
  354.       users, on the other  hand, may  merely click on  the desired field  to
  355.       highlight it.  
  356.  
  357.       Once highlighted, a  parameter may be  selected for  edit by  pressing
  358.       <Enter> (mouse  users may double-click on  the parameter  field).  The
  359.       blue cursor will change to red -  this indicates that you are  editing
  360.       the  current  parameter.   To  change  the  parameter  value, use  the
  361.       up/down cursor keys to increment/decrement  the value.  To  change the
  362.       value  in larger  increments,  use the  PgUp/PgDn  keys.   Maximum and
  363.       minimum values  may  be set  by pressing  the <Home>  and <End>  keys,
  364.       respectively.  Once you have  completed setting a parameter,  you have
  365.       a choice of  saving the current value, or cancelling and returning the
  366.       value to its  original value (setting before you  edited it).  To save
  367.       the edited value, press <Enter>, to cancel press <Esc>.  
  368.  
  369.       Mouse users may  select a parameter for editing by double-clicking the
  370.       desired parameter's field.   Once the cursor  turns red, a mouse  user
  371.       may edit the  selected parameter using  the keyboard  as described  in
  372.       the above paragraph.   Mouse users  also have the  added advantage  of
  373.       incrementing and  decrementing the  selected parameter  by pressing  a
  374.       mouse  button  and  moving the  mouse  in  the vertical  axis.   While
  375.       pressing  the left button, the parameter is incremented or decremented
  376.       by 1;  while pressing the right  button, the  parameter is incremented
  377.       or decremented  by larger increments  (the larger increment's size  is
  378.       dependent on the parameter).   To save the edited  value, double-click
  379.       the mouse or press <Enter>.  To cancel, press <Esc>.  
  380.  
  381.       A  D4 drumset  is assigned  across  a 60-note  window.   Because D4man
  382.       displays only  18 note assignments  at a time,  there are two ways  to
  383.       pan up  and down the 60-note  D4 window.   One way is  via the cursor,
  384.       <Home>, <End>, <PgUp>, and  <PgDn> keys,  the other is  via mouse.   A
  385.       mouse click on  the top and bottom  keys of the keyboard  display will
  386.       pan you up or down a page, respectively.  
  387.  
  388.       Also, the D4  sounds may be triggered  from the computer  keyboard, as
  389.       well as  via mouse.   Keyboard  keys '1'  through '0'  (left to  right
  390.       across the  keyboard)  will trigger  the  drums  assigned to  your  D4
  391.       triggers 1 through 10, while the '-' key  will trigger drum trigger 11
  392.       and the '=' key will trigger drum trigger  12.  Mouse users may  press
  393.       click on  the displayed keyboard to  test sound  assignments.  Holding
  394.       the button  down will continually trigger the D4  note selected on the
  395.       D4man display.  
  396.  
  397.       Experiment in  the drumset display -  there are  lots of thrill-packed
  398.       features.  You can't  hurt anything if you don't write to disk  or D4,
  399.       so practice freely.  
  400.  
  401.       Now let's  go over  the various  pull-down menus  that are  accessible
  402.       from the top line menu.
  403.  
  404.  
  405.       FILE Menu
  406.       ---------
  407.       The File  menu allows  the user to  load various  types of files  from
  408.       disk,  save data  to disk  files, configure  D4man, shell  to DOS, and
  409.       quit the program.
  410.  
  411.       FILE - Load  (F1)
  412.       -----------------
  413.       The File  Load function allows  the user to  load data files into  the
  414.       computer's memory.   Once Load is selected via  mouse, <Enter> key, or
  415.       the <F1> key,  a directory window pops up  allowing the user to select
  416.       a  specific file to load.  (Note that you may scroll to the top of the
  417.       directory window and  change disks and  directories freely.)   A  file
  418.       may be selected via double  mouse click, clicking the LOAD button,  or
  419.       by pressing the Enter key.  To exit  the Load function without loading
  420.       a file, press the <Esc> key or click on the CANCEL button.
  421.  
  422.       After selecting a file  to load, D4man will display the file  name and
  423.       file type,  then ask you if  you would  like to load the  file.  Mouse
  424.       users  should click on  LOAD to  load the  file, CANCEL to  cancel the
  425.       load.   Keyboard users should  press the <L>  or <Enter> key to  load,
  426.       the <C> or <Esc> key to cancel the load.  
  427.  
  428.       FILE - Save  (F2)
  429.       -----------------
  430.       The  File  Save   function  allows  the  user  to  store  specific  D4
  431.       information to the  computer's disk  as a  MIDIEX format  file.   When
  432.       prompted  for  a  file name,  the  user  must  enter  a filename  that
  433.       conforms to DOS  conventions.  During  entry, the user  may edit  that
  434.       name  via the  cursor,  <Ins>, <Del>,  backspace, <Home>,  <End>,  and
  435.       alphanumeric keys.   To exit the  File Save  function without  storing
  436.       the bank  to disk,  either click  on the  CANCEL button  or press  the
  437.       <Esc> key.  
  438.  
  439.       Once the  output filename has been  specified, D4man  prompts the user
  440.       for the type of file to save.  The user has 4 options:  
  441.  
  442.           -  Single Drumset (Current).   Save the currently selected drumset
  443.              as the specified filename.  
  444.  
  445.           -  Program Change Map.  Save the current Program Change Map as the
  446.              specified filename.  
  447.  
  448.           -  Trigger  Setup.   Save  the current  setup  for all  12 trigger
  449.              inputs as the specified filename.  
  450.  
  451.           -  System  All.  Save the state of  the entire D4 as the specified
  452.              filename.   This is the  same format as the  D4's built-in MIDI
  453.              "System (All)" function.  
  454.  
  455.       The mouse user selects  one of the file  types by double-clicking  the
  456.       appropriate field,  or by highlighting the  field and  clicking on the
  457.       SAVE button.  The  keyboard user  selects a file  type via the  cursor
  458.       keys and presses the <Enter> or <S> key.  
  459.  
  460.       Please note that the unregistered  version of D4man does  not actually
  461.       store the files to disk.  
  462.  
  463.       FILE - Setup D4man  (Ctrl-F1)
  464.       -----------------------------
  465.       The Setup D4man  function is used to  configure your copy of  D4man to
  466.       match  your system.   Parameters set  in the Setup  window take effect
  467.       immediately after  exiting Setup  and also become  default values each
  468.       time you start D4man.  
  469.  
  470.       Once  the  Setup   window  pops  up,  keyboard  users   may  highlight
  471.       parameters via the cursor keys.  Once highlighted,  a parameter may be
  472.       selected for  edit  by pressing  the <Enter>  key.   Mouse  users  may
  473.       highlight a  parameter by  clicking  on it,  then select  for edit  by
  474.       double-clicking on it.   Once selected,  the parameter  may be  edited
  475.       via the cursor, <Home>,  <End>, <PgUp>, and <PgDn> keys.  To  exit the
  476.       edit,  press <Enter>  again  to  save the  value,  or press  <Esc>  to
  477.       restore the  value to  its state  before you  began editing  it.   The
  478.       Setup  window is  exited via the  <Esc> key  or a  mouse click  on the
  479.       "window close" icon  (a small yellow  square) in  the upper  left-hand
  480.       corner of the Setup window.  
  481.  
  482.       Setup allows the user to set the following parameters:
  483.  
  484.           MIDI Port          -  Enable/Disable   D4man's  use  of  the  MIDI
  485.                                 port, and  if enabled,  select  the type  of
  486.                                 MIDI  interface  installed in  your  system.
  487.                                 Set  to  "Not  Installed"  if  you  have  no
  488.                                 actual MIDI interface installed.  
  489.  
  490.           MIDI Channel       -  If MIDI  Port is enabled,  then this is  the
  491.                                 MIDI  channel   that  D4man   will  use   to
  492.                                 communicate  with your  D4.    Your D4  must
  493.                                 also  be  set to  this  channel  or  set  to
  494.                                 "omni" mode for successful communication.  
  495.  
  496.           File Path          -  This  is the  disk and  directory where  you
  497.                                 usually keep  your  D4  data files.    D4man
  498.                                 will automatically change to  this path when
  499.                                 the program is first invoked. 
  500.  
  501.           Mouse Resolution   -  This  is the mickey resolution  of the mouse
  502.                                 while  modifying  a selected  parameter  via
  503.                                 mouse.    The  higher  the  resolution,  the
  504.                                 further you will  have to move the mouse  in
  505.                                 order to modify that selected parameter.  
  506.  
  507.           Patch Bay Support  -  Enable/Disable   D4man's  MIDI   Patch   Bay
  508.                                 support.  When enabled, your  patch bay will
  509.                                 be  sent  a  predefined  message at  program
  510.                                 startup,  and another  predefined message at
  511.                                 program exit.  
  512.  
  513.           Patch Bay Channel  -  If MIDI Patch  Bay is enabled, then this  is
  514.                                 the  MIDI  channel that  D4man  will use  to
  515.                                 communicate with your Patch Bay.  
  516.  
  517.           Patch Bay Entry    -  If MIDI  Patch Bay is  enabled, this is  the
  518.                                 byte value transmitted  to it when  D4man is
  519.                                 first invoked.  
  520.  
  521.           Patch Bay Exit     -  If MIDI  Patch Bay is  enabled, this is  the
  522.                                 byte  value transmitted to it  when D4man is
  523.                                 exited.  
  524.  
  525.  
  526.       Exiting  the  Setup  function  will  store  your  configuration  to  a
  527.       D4MAN.CFG  file.   Once  a  D4MAN.CFG file  has  been created,  it  is
  528.       automatically loaded each time D4man  is started - that way you  don't
  529.       have to  specify  your command  line  switch(es)  every time  you  run
  530.       D4man.   You may  also change  D4man's setup  in any  session via  the
  531.       Setup function under the Files Menu  (see D4man Setup section).   Note
  532.       that  even once  a  D4MAN.CFG file  has  been created,  you  may still
  533.       override your default setup by using command line switches.
  534.  
  535.       FILE - Dos Shell
  536.       ----------------
  537.       The DOS  Shell function  temporarily suspends execution  of the  D4man
  538.       program and allows command  entry from the DOS prompt.  When  ready to
  539.       return to D4man, enter "exit" at the DOS prompt.
  540.  
  541.       FILE - Quit  (F10)
  542.       ------------------
  543.       The Quit function causes the D4man program to  terminate and return to
  544.       DOS.  When Quit  is selected, D4man will pop-up and indicate  which of
  545.       the 6 banks have been saved to disk  and which haven't.  You are given
  546.       a  choice whether  to  Cancel  (go back  to  D4man) or  to  Exit (exit
  547.       program and return to DOS).
  548.  
  549.  
  550.       EDIT Menu
  551.       ---------
  552.       The Edit Menu allows the user to modify the  Footswitch Setup, Program
  553.       Change  Map,  Trigger  Setup, current  Drumset  Name, and  the current
  554.       drumset's Root Note.  
  555.  
  556.       EDIT - Footswitch Setup  (F3)
  557.       -----------------------------
  558.       The Footswitch Setup function enables  the user to set  the Footswitch
  559.       Mode (as  either Hi-Hat or Drumset  Advance mode),  and the Footswitch
  560.       Close and Footswitch Open note  assignments.  The footswitch  setup is
  561.       shared amongst  all 21 loaded drumsets.   Please  note that Footswitch
  562.       Close  and Footswitch  Open  note assignments  are  only valid  if the
  563.       Footswitch Mode is currently set  to "Hi-Hat."  Exit from this  pop-up
  564.       is performed by pressing the <Esc> key, or  by clicking on the "close"
  565.       icon in  the top left corner  of the pop-up  window.  Mouse users  may
  566.       optionally double-click their way out of the pop-up.  
  567.  
  568.       EDIT - Program Change Map  (F4)
  569.       -------------------------------
  570.       The  Program  Change Map  function  allows  modification of  the  D4's
  571.       program  change  assignments.     Each  MIDI  program   change  number
  572.       (numbered 0 through  127) is assigned to  one of the D4's  21 drumsets
  573.       (numbered 0 through 20).  Each assignment pair  is displayed in column
  574.       order  with  the program  change number  on the  lefthand side  of the
  575.       colon, and the drumset assignment on the righthand side of the  colon.
  576.       Exit from this  pop-up is performed by  pressing the <Esc> key,  or by
  577.       clicking on the  "close" icon  in the top  left corner  of the  pop-up
  578.       window.  Mouse  users may also double-click their  way out of the pop-
  579.       up window.  
  580.  
  581.       Be  aware that  program  change  numbers vary  amongst  manufacturers.
  582.       Some  manufacturers'  MIDI  devices  may   implement  program  numbers
  583.       starting with  1 instead  of 0.   You  may adjust for  this by  either
  584.       modifying the  D4 program change map,  or changing the setting  of the
  585.       MIDI device that  is transmitting the  program change  message to  the
  586.       D4.   For example, if  you are running a  sequencer that automatically
  587.       sets the program number  of the D4 before starting  the sequence, just
  588.       adjust the program number setting in your sequencer.  
  589.  
  590.       EDIT - Trigger Setup  (F5)
  591.       --------------------------
  592.       The Trigger Setup pop-up window is used  to set the parameters of  the
  593.       D4's 12  trigger inputs.  These  trigger parameters  include MIDI Note
  594.       Assignment, Gain, Velocity Curve, Cross-talk, Decay,  and Noise Floor.
  595.       Each parameter  may be selected  and modified in  a manner similar  to
  596.       the D4man main screen.  
  597.  
  598.       Please  be aware  of the  fact  that when  a trigger's  velocity curve
  599.       parameter  is set to  0, the trigger  is effectively  disabled and may
  600.       not  be assigned to a  MIDI note.  Also  note that the Note Assignment
  601.       in the Trigger  Setup is  actually relative to  the Root  Note of  the
  602.       currently  selected drumset.   As  you select  different drumsets that
  603.       have different  Root Notes, you will  notice that  the Trigger Setup's
  604.       MIDI  Note Assignments change  along with them.   This is  not a D4man
  605.       anomoly - it concurs with the D4's design.  
  606.  
  607.       Exit from this  pop-up is performed by  pressing the <Esc> key,  or by
  608.       clicking  on the "close"  icon in  the top  left corner of  the pop-up
  609.       window.  
  610.  
  611.       EDIT - Drumset Name  (F6)
  612.       -------------------------
  613.       The  Drumset Name function  allows the  user to  edit the name  of the
  614.       currently  selected drumset.    Once this  function is  selected,  the
  615.       drumset  name field  on the  bottom lefthand  corner of  the screen is
  616.       highlighted and D4man allows  the user to edit the  current voice name
  617.       via  the   cursor,  backspace,  <Ins>,   <Del>,  <Home>,  <End>,   and
  618.       alphanumeric  keys.   A  shortcut to  this  function exists  for mouse
  619.       users - instead of  having to  select <F7>, a  mouse user may  double-
  620.       click on the drumset  name field in the bottom lefthand corner  of the
  621.       screen.  
  622.  
  623.       EDIT - Drumset Root Note  (F7)
  624.       ------------------------------
  625.       This  function  sets the  Root Note  for  the current  drumset.   Each
  626.       drumset maintains  its own root note, ranging  from MIDI note #0 (note
  627.       C-2) to  #67 (note G3).   Use the cursor,  <PgUp>, and <PgDn> keys  to
  628.       increment  and decrement  the root  note.   Exit  from this  pop-up is
  629.       performed by  pressing the  <Esc> key.   (Mouse  users may  optionally
  630.       exit by double-clicking either mouse button).  
  631.  
  632.       Mouse  users may also select the root note for edit by double-clicking
  633.       on the  topmost displayed note number  in the  current drumset window.
  634.       The  effect of this  shortcut will  be the  same as pressing  the <F8>
  635.       key.  Then to set the Root Note  via mouse, hold the left mouse button
  636.       down and  move the mouse in the vertical axis.  For larger steps, push
  637.       the right button instead of the left one.  
  638.  
  639.  
  640.       MIDI Menu
  641.       ---------
  642.       The MIDI menu  allows the user to  reset the MIDI interface,  transmit
  643.       data to the D4,  and receive data from  the D4.  D4man's MIDI  channel
  644.       is set via D4man's Setup Screen (See FILE - Setup D4man section).  
  645.  
  646.       MIDI - Reset MIDI Interface
  647.       ---------------------------
  648.       The  Reset MIDI  Interface  function resets  and initializes  the MIDI
  649.       interface to the  proper mode of operation.   This function should not
  650.       be  required  unless some  external  event  on  the  MIDI bus  (beyond
  651.       D4man's control)  hangs up the  MIDI interface.   For example,  a user
  652.       might shell to DOS and run an  ill-behaved MIDI program.  Upon  return
  653.       to D4man,  the MIDI interface is locked-up.   In such a case, the user
  654.       may reset the MIDI interface via the Reset MIDI function.
  655.  
  656.       MIDI - Read D4 Drumset  (F8)
  657.       ----------------------------
  658.       This function reads a  D4 drumset via MIDI and stores  the information
  659.       in the currently-selected  D4man drumset.  After selecting the Read D4
  660.       Drumset  function, the  user  must specify  the  D4 drumset  number to
  661.       read.  Then,  once the  user indicates that  it's OK  to transfer  the
  662.       drumset information, the transfer is automatic.  
  663.  
  664.       This function reads  data to the D4man  current drumset, but does  not
  665.       store the information to  disk - if  you desire to save  this data  to
  666.       disk, it must be saved afterwards via the File Save function.   If you
  667.       have problems  transferring data  from the  D4 to  the computer,  make
  668.       sure the D4man MIDI  channel matches the unit's  MIDI channel and  the
  669.       unit's MIDI In and MIDI Out cables are connected properly.  
  670.  
  671.       MIDI - Read D4 All  (Ctrl-F8)
  672.       -----------------------------
  673.       This function reads all D4 data that is included  in a D4 System (All)
  674.       dump.   This  data includes  all  12  trigger setups,  program  change
  675.       table, all 21  internal drumsets,  footswitch setup,  and system  data
  676.       such as MIDI channel, omni on/off, and currently selected drumset.  
  677.  
  678.       This function  reads the D4,  but does  not store  the information  to
  679.       disk  - if  you desire to  save this  data to  disk, it must  be saved
  680.       afterwards  via  the  File  Save  function.    If  you  have  problems
  681.       transferring data  from the  D4 to the  computer, make sure  the D4man
  682.       MIDI channel matches  the unit's MIDI  channel and the unit's  MIDI In
  683.       and MIDI Out cables are connected properly.  
  684.  
  685.       MIDI - Write D4 Drumset  (F9)
  686.       -----------------------------
  687.       This  function  writes  the information  from  the  currently-selected
  688.       D4man  drumset to  a specified  internal drumset  on the D4  via MIDI.
  689.       The term  "internal drumset" refers to  a drumset  location, 0 through
  690.       20.  The  storage is similar  to storing a drumset  from the  D4 front
  691.       panel  -  once stored,  the  D4 "remembers"  the  drumset even  if you
  692.       select another drumset number.   Remember that you can  always restore
  693.       the factory drumsets via the D4 front panel.  
  694.  
  695.       If you have  problems transferring data  from the computer to  the D4,
  696.       make sure the D4man MIDI  channel matches the unit's MIDI  channel and
  697.       the  unit's MIDI In and cable is  properly connected to the computer's
  698.       MIDI Out.  
  699.  
  700.       MIDI - Write D4 All  (Ctrl-F9)
  701.       ------------------------------
  702.       This function  writes all  D4 data  that is  included in  a D4  System
  703.       (All) dump.  This data includes  all 12 trigger setups, program change
  704.       table, all  21 internal drumsets,  footswitch setup,  and system  data
  705.       such as MIDI channel, omni on/off, and currently selected drumset.  
  706.  
  707.       If  you have problems transferring  data from the  computer to the D4,
  708.       make  sure the D4man MIDI channel matches  the unit's MIDI channel and
  709.       the unit's MIDI In  and cable is properly connected to  the computer's
  710.       MIDI Out.  
  711.  
  712.  
  713.       ZORCH Menu
  714.       ----------
  715.       The Zorch menu  displays information about  the program  itself.   The
  716.       unregistered version of D4man displays information  on how to register
  717.       your copy of the program.  
  718.  
  719.  
  720.       QUITTING D4man
  721.       --------------
  722.       To quit the  D4man program, select the  Quit function under the  Files
  723.       menu,  or type <F10>  from the keyboard.   D4man will  ask you whether
  724.       you would  like to  exit  the program,  or cancel  and return  to  the
  725.       program.   Press <X>  to exit, <C> to  cancel.  Mouse  users may press
  726.       the mouse on  either the EXIT or CANCEL buttons. If you decide to exit
  727.       the program, you will be  automatically returned to the  DOS directory
  728.       that you entered D4man from.  
  729.  
  730.  
  731.       MIDI PATCH BAY SUPPORT
  732.       ----------------------
  733.       D4man provides support  to MIDI Patch Bays  that are MIDI-controllable
  734.       via MIDI  "Program  Change" messages.    D4man  does this  by  sending
  735.       specific program change numbers  to your MIDI patch bay  on your patch
  736.       bay's  MIDI channel.   A program change  number must  be specified for
  737.       entry into  the D4man program, and another must  be specified for exit
  738.       from  D4man.  The "entry"  value will set your patch  bay so that your
  739.       D4 Midi In and Midi Out  ports will be routed to  your computer's MIDI
  740.       interface.    The "exit"  value  will return  your patch  bay  to your
  741.       default  setting.   Also,  you  must  specify  your  patch bay's  MIDI
  742.       channel (this should be a different channel than your D4 is on!).
  743.  
  744.       "Entry"  and "Exit"  patch  numbers, and  patch  bay MIDI  channel are
  745.       application-specific and  vary  from  user  to  user.    In  order  to
  746.       configure D4man  for your patch bay  setup, enter  D4man Setup, enable
  747.       patch bay support,  set the MIDI channel  of your patch bay,  and then
  748.       set the "entry" and "exit" values for your specific system.
  749.  
  750.  
  751.       FILE FORMATS
  752.       ------------
  753.       Four different file formats are  supported by D4man at this time,  all
  754.       of which contain one or more consecutive MIDIEX message(s).  The  file
  755.       formats are  identical to those output by the D4 when manually running
  756.       a  Sysex Backup from the  D4's fifth MIDI page.   This means that data
  757.       dumped directly to disk from the  D4 may also be loaded  by D4man, and
  758.       vice-versa.  Here are the 4 supported formats:  
  759.  
  760.           Single Drumset     -  Same format  as D4's  "Edit Buffer"  format.
  761.                                 Data  includes   drumset  name,   footswitch
  762.                                 closing  and  holding  notes,  trigger  note
  763.                                 assignments,  and volume, pan, output, bank,
  764.                                 voice,  tune, and  group assign information.
  765.  
  766.  
  767.           Program Change Map -  Same format as D4's  "Program Table" format.
  768.                                 Data   includes   all  128   Program  Change
  769.                                 assignments.  
  770.  
  771.           Trigger Setup      -  Same format as D4's "Trigger Setup"  format.
  772.                                 Data  includes gain,  velocity curve, cross-
  773.                                 talk, noise  floor, and  decay settings  for
  774.                                 all 12 trigger inputs. 
  775.  
  776.           System (All)       -  Same format as D4's  "System (All)"  format.
  777.                                 Data   includes   25   consecutive    MIDIEX
  778.                                 messages:      the  Program   Change  Table,
  779.                                 Trigger   Setup,  Edit   Buffer,  21  Single
  780.                                 Drumsets, and the System Info message.  
  781.  
  782.  
  783.       MIDIEX format files  may be used with other popular shareware programs
  784.       such as SYSX.EXE (any version)  or MIDIEX.EXE (we suggest  version 1.9
  785.       or  later),  or  with   commercial  products  such  as  the   Cakewalk
  786.       sequencer.   When a MIDIEX  file is loaded  by the D4man program,  the
  787.       MIDI channel  embedded  in the  MIDIEX  file  is replaced  by  D4man's
  788.       current MIDI  channel  setting.   In  the  same manner,  MIDIEX  files
  789.       stored  by D4man will  have the same  MIDI channel  as D4man's current
  790.       setting.  
  791.  
  792.  
  793.       D4MAN.INI File
  794.       --------------
  795.       The  D4MAN.INI  file  contains  D4  information  that will  be  loaded
  796.       automatically  every  time  you   start  D4man.    Included   in  this
  797.       information is  data  for all  21  drumsets,  the trigger  setup,  the
  798.       program change  map setup,  the footswitch  setup, and  all D4  system
  799.       parameters.  
  800.  
  801.       The D4MAN.INI  file is actually  a MIDIEX file  in the same format  as
  802.       the D4's  "System (All)" format (also  same as  D4man's "System (All)"
  803.       format).   Therefore, you may replace  D4MAN.INI with your own file by
  804.       just renaming  and copying  your file  to the  same disk  directory as
  805.       D4MAN.EXE  and D4MAN.CFG.   Just be sure that  the file  is the proper
  806.       format!  We  recommend that you keep a  copy of the original D4MAN.INI
  807.       as  a safety  precaution.   The  original  D4MAN.INI file  matches the
  808.       actual Alesis factory configuration.  
  809.  
  810.  
  811.       HOT KEY REFERENCE
  812.       -----------------
  813.  
  814.              F1  = Load File
  815.         Ctrl-F1  = Setup D4man
  816.              F2  = Save File
  817.              F3  = Footswitch Setup
  818.              F4  = Program Change Map
  819.              F5  = Trigger Setup
  820.              F6  = Drumset Name
  821.              F7  = Drumset Root Note
  822.              F8  = Read D4 Drumset
  823.         Ctrl-F8  = Read D4 All
  824.              F9  = Write D4 Drumset
  825.         Ctrl-F9  = Write D4 All
  826.             F10  = Quit Program
  827.  
  828.  
  829.       FUTURE UPGRADES
  830.       ---------------
  831.       Key Midiator interface support.
  832.  
  833.  
  834.       MORE INFO
  835.       ---------
  836.       A great  deal of  time and  effort went  into  developing and  testing
  837.       D4man.    If you  experience  problems  with  D4man,  please note  the
  838.       symptoms and contact us.   We'll do our best to rectify the situation.
  839.       If you have  any comments, questions,  or suggestions  about D4man  or
  840.       other  Zorch brotherz  products,  we will  be  glad to  receive and/or
  841.       answer them.  We may be contacted by mail at:
  842.  
  843.           Bret Costin
  844.           c/o Zorch brotherz software
  845.           3475 Rolling Trail
  846.           Palm Harbor, FL  34684
  847.  
  848.       or leave us a message at one of these Bulletin Board Systems:
  849.  
  850.           -  The  Gulf  Coast MIDI  Users'  Group  BBS  (Sponsored by  Zorch
  851.              brotherz software), (813) 789-5880 (To: Bret Costin),
  852.  
  853.           -  Compuserve Mail [70474,3534] (To: Bret Costin),
  854.  
  855.           -  The MIDILINK Musicians' Network,  (708) 949-MIDI, Main Board or
  856.              IBM Conference, (To: Bret Costin).
  857.  
  858.  
  859.       The Gulf  Coast MIDI Users' Group  BBS is sponsored by  Zorch brotherz
  860.       software  and  is loaded  with additional  Zorch  products  and public
  861.       domain demos,  patches, samples, and  sequences, as well as  messaging
  862.       to MIDILINK, the premiere Musician's Network.  
  863.