home *** CD-ROM | disk | FTP | other *** search
/ Sound Sensations! / sound_sensations.iso / midifile / d4man102 / d4man.doc < prev    next >
Text File  |  1992-06-13  |  46KB  |  859 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  as D4man  utilizes the  MPU's
  184.              UART, or "dumb" mode,
  185.  
  186.                   OR
  187.  
  188.              A  Yamaha C1  MIDI interface  (connected to  first IN  port and
  189.              first OUT port only),
  190.  
  191.           -  CGA or better video card and monitor,  
  192.  
  193.           -  An optional Microsoft, Logitech, Genius, or compatible mouse or
  194.              trackball with its software driver installed.
  195.  
  196.  
  197.       You  should  have  at  least 256k  of  RAM  available  to  run  D4man.
  198.       Shelling to DOS from inside the program may require even  more memory.
  199.       The DOS CHKDSK.COM  program displays the number of  free bytes in your
  200.       machine, as does DOS 5.0's  MEM.EXE command.  For more  information on
  201.       determining available memory, please consult your DOS manual.  
  202.  
  203.       Most IBM PC-compatible  video cards  are supported  - D4man  currently
  204.       operates in 80-column, color text mode.  
  205.  
  206.       D4man will  run  with  or  without  a  mouse  and/or  MIDI  interface.
  207.       Without a MIDI interface,  don't expect to hear  any sound except  the
  208.       hi-tech  BEEP!  of  the  PC  speaker.    When  no  MIDI  interface  is
  209.       installed, it is best to setup D4man with the MIDI  interface disabled
  210.       (see D4man  Setup section),  or  to invoke  D4man with  the "no  midi"
  211.       command line switch set.
  212.  
  213.  
  214.       INSTALLING AND RUNNING D4man
  215.       ----------------------------
  216.       D4man's installation  is simple.  First  back-up your  copy to another
  217.       floppy disk, then just  copy the D4MAN.EXE and other files to the disk
  218.       and  directory you would like D4man to run from.   Then change to that
  219.       disk/directory (or  include its  directory specification  in your  DOS
  220.       PATH statement) and start  D4man.  The first time you start D4man, you
  221.       may have to specify one or more of the D4man command switches:
  222.  
  223.           -base=AAAh    Set  I/O base  address if  using  MPU-401 compatible
  224.                         interface.   AAA specifies  the hexadecimal I/O base
  225.                         address of the MPU card installed in your system.  
  226.  
  227.           -c=XX         Set  MIDI channel.    D4man automatically  sets  its
  228.                         internal MIDI channel  to the value specified  by XX
  229.                         (acceptable values: 1  through 16).  Note  that once
  230.                         D4man is running, you can also set  the MIDI channel
  231.                         via pull-down menu or D4man Setup Screen.  
  232.  
  233.           -c1           Executing on a  Yamaha C1 computer.   "C1 mode"  may
  234.                         also be configured from the D4man Setup window.  
  235.  
  236.           -n            No MIDI interface.   Setting this switch  allows you
  237.                         to run D4man,  edit all D4 parameters locally on the
  238.                         PC, and store files to disk  without actually having
  239.                         a MIDI  interface physically residing in  the system
  240.                         or a D4 attached.  
  241.        
  242.           -q=FFFF       Quickload.     D4man  will  automatically  load  the
  243.                         filename specified by  FFFF, transmit it to  your D4
  244.                         via MIDI,  then immediately exit.   Quickloading  is
  245.                         handy  for loading banks from the DOS prompt or from
  246.                         within batch files and is especially  useful in live
  247.                         performance applications  as  it  acts like  a  MIDI
  248.                         "data disk".  
  249.  
  250.  
  251.       Here's a  few examples of switch usage (by the way, instead of using a
  252.       '-' at the  beginning of a switch,  you can alternately use  a forward
  253.       slash character '/'):  
  254.  
  255.             D4man -n                      <Enter>   The  user's  PC  has  no
  256.                                                     MIDI interface. 
  257.  
  258.             D4man -c=13 -c1               <Enter>   The user's D4 is on MIDI
  259.                                                     channel   13   and   the
  260.                                                     computer being used is a
  261.                                                     Yamaha C1.  
  262.  
  263.             D4man -c=8 -q=c:\d4\sys.all   <Enter>   The user is quickloading
  264.                                                     file     SYS.ALL    from
  265.                                                     directory C:\D4  to a D4
  266.                                                     on MIDI channel 8.  
  267.  
  268.             D4man -base=230h              <Enter>   The  user  has  an  MPU-
  269.                                                     compatible   MIDI   card
  270.                                                     installed  at  I/O  base
  271.                                                     address 230h.  
  272.  
  273.       After entering  the command  line, if  the quickload  switch has  been
  274.       set, the  program name,  version  number,  and copyright  notice  will
  275.       appear.   Then the  file will load to  the D4.   Immediately after the
  276.       file has loaded, the program will return to the DOS prompt.  
  277.  
  278.       If  the quickload switch  has NOT  been set  on the command  line, the
  279.       program name,  version number,  copyright notice,  and Zorch  brotherz
  280.       logo will appear.   If you are running an unregistered copy, that fact
  281.       will also  be displayed.   Strike  any key  to continue.   The  screen
  282.       should clear and the main program screen will immediately appear.
  283.  
  284.       If you have D4man's  MIDI Patch Bay feature  enabled (see D4man  Setup
  285.       section),  D4man  will   now  switch  your  Patch  Bay  over  to  your
  286.       predefined setup.   Once in the program,  if it is the first time  you
  287.       have run D4man (or  no D4man.CFG file exists in the same  directory as
  288.       D4MAN.EXE) the program  will prompt you  with the  Setup Window.   Set
  289.       D4man's  parameters to match  your system  (see D4man  Setup section),
  290.       and press <Esc> to return to D4man's main screen.  
  291.  
  292.       Also, if D4MAN.INI  exists in the  D4man directory  (and it  should!),
  293.       D4man will  load in the default  drumsets and setup.  By  the way, the
  294.       file  D4MAN.INI may  be  modified to  your  own tastes  (See D4MAN.INI
  295.       Section).  
  296.  
  297.  
  298.       USING THE INTERACTIVE MENU SYSTEM
  299.       ---------------------------------
  300.       D4man implements an interactive pull-down menu  system similar to many
  301.       of  today's commercial  products.   The  menu  system makes  the tasks
  302.       associated with the D4man program  simpler and more intuitive.   Menus
  303.       may be operated  by either a mouse  or the computer's keyboard.   Hot-
  304.       keys are  implemented that allow the  user to  execute D4man functions
  305.       via single keystrokes (typically function keys).  
  306.  
  307.       To  select  a  menu  via  mouse,  position  the  mouse cursor  (a  red
  308.       rectangle) on the top menu bar  and hold down a mouse button.  If  the
  309.       cursor  is on one of  the top line menu  fields, a pull-down menu will
  310.       appear and  remain until  all mouse  buttons have been  released.   To
  311.       select a pull-down  menu item, while pressing the mouse button, "drag"
  312.       the  mouse cursor  over the  pull-down fields.   As  the cursor passes
  313.       over each  field,  it highlights  that  particular field.   To  run  a
  314.       routine associated  with a field, release  the mouse  button(s) as the
  315.       mouse cursor selects the field.   If you don't want to run any of  the
  316.       routines on that  pull-down menu, merely move the mouse cursor outside
  317.       of the pull-down menu and release the mouse button(s).
  318.  
  319.       Various pop-up  windows  will allow  selection via  single and  double
  320.       clicks.   Just place  the mouse  cursor over  the  selected field  and
  321.       click once  or twice.  When  in Full-Screen Edit Mode,  parameters are
  322.       highlighted by mouse  clicking, and selected for edit by mouse double-
  323.       clicking.
  324.  
  325.       To select a menu via keyboard, hold  down the <Alt> key and  press the
  326.       highlighted (black)  letter of the top line menu  topic you would like
  327.       to pull-down.  Once the pull-down menu appears,  the menu's fields may
  328.       be highlighted by  using the keyboard's cursor keys, <Home>, and <End>
  329.       keys.   To run  a routine  from the  pull-down, highlight  the desired
  330.       field and  press the <Enter>  key.  To  abort a pull-down menu,  press
  331.       <Esc>.
  332.  
  333.       Notice that many  of the functions  displayed in  the pull-down  menus
  334.       have a function or  control key "hot key" associated with them.  These
  335.       designated "hot keys"  allow the user  to execute  functions with  one
  336.       keystroke.   For  example,  to quit  the  D4man program,  press <F10>.
  337.       Adios.
  338.  
  339.  
  340.       BROWSING THE MAIN (OR "CURRENT DRUMSET") DISPLAY
  341.       ------------------------------------------------
  342.       Users  may  browse  around  the  main  screen  and  edit  the  various
  343.       parameters of  the currently  selected drumset.   Supporting  both the
  344.       mouse  and the keyboard, D4man provides multiple methods for operating
  345.       the display.  
  346.  
  347.       There  are several ways  to select  a parameter.   A parameter  may be
  348.       selected by  moving the  blue bar  cursor via  the computer's  cursor,
  349.       <Home>,  and <End> keys until the desired field is highlighted.  Mouse
  350.       users, on the other  hand, may  merely click on  the desired field  to
  351.       highlight it.  
  352.  
  353.       Once highlighted, a  parameter may be  selected for  edit by  pressing
  354.       <Enter> (mouse  users may double-click on  the parameter  field).  The
  355.       blue cursor will change to red -  this indicates that you are  editing
  356.       the  current  parameter.   To  change  the  parameter  value, use  the
  357.       up/down cursor keys to increment/decrement  the value.  To  change the
  358.       value  in larger  increments,  use the  PgUp/PgDn  keys.   Maximum and
  359.       minimum values  may  be set  by pressing  the <Home>  and <End>  keys,
  360.       respectively.  Once you have  completed setting a parameter,  you have
  361.       a choice of  saving the current value, or cancelling and returning the
  362.       value to its  original value (setting before you  edited it).  To save
  363.       the edited value, press <Enter>, to cancel press <Esc>.  
  364.  
  365.       Mouse users may  select a parameter for editing by double-clicking the
  366.       desired parameter's field.   Once the cursor  turns red, a mouse  user
  367.       may edit the  selected parameter using  the keyboard  as described  in
  368.       the above paragraph.   Mouse users  also have the  added advantage  of
  369.       incrementing and  decrementing the  selected parameter  by pressing  a
  370.       mouse  button  and  moving the  mouse  in  the vertical  axis.   While
  371.       pressing  the left button, the parameter is incremented or decremented
  372.       by 1;  while pressing the right  button, the  parameter is incremented
  373.       or decremented  by larger increments  (the larger increment's size  is
  374.       dependent on the parameter).   To save the edited  value, double-click
  375.       the mouse or press <Enter>.  To cancel, press <Esc>.  
  376.  
  377.       A  D4 drumset  is assigned  across  a 60-note  window.   Because D4man
  378.       displays only  18 note assignments  at a time,  there are two ways  to
  379.       pan up  and down the 60-note  D4 window.   One way is  via the cursor,
  380.       <Home>, <End>, <PgUp>, and  <PgDn> keys,  the other is  via mouse.   A
  381.       mouse click on  the top and bottom  keys of the keyboard  display will
  382.       pan you up or down a page, respectively.  
  383.  
  384.       Also, the D4  sounds may be triggered  from the computer  keyboard, as
  385.       well as  via mouse.   Keyboard  keys '1'  through '0'  (left to  right
  386.       across the  keyboard)  will trigger  the  drums  assigned to  your  D4
  387.       triggers 1 through 10, while the '-' key  will trigger drum trigger 11
  388.       and the '=' key will trigger drum trigger  12.  Mouse users may  press
  389.       click on  the displayed keyboard to  test sound  assignments.  Holding
  390.       the button  down will continually trigger the D4  note selected on the
  391.       D4man display.  
  392.  
  393.       Experiment in  the drumset display -  there are  lots of thrill-packed
  394.       features.  You can't  hurt anything if you don't write to disk  or D4,
  395.       so practice freely.  
  396.  
  397.       Now let's  go over  the various  pull-down menus  that are  accessible
  398.       from the top line menu.
  399.  
  400.  
  401.       FILE Menu
  402.       ---------
  403.       The File  menu allows  the user to  load various  types of files  from
  404.       disk,  save data  to disk  files, configure  D4man, shell  to DOS, and
  405.       quit the program.
  406.  
  407.       FILE - Load  (F1)
  408.       -----------------
  409.       The File  Load function allows  the user to  load data files into  the
  410.       computer's memory.   Once Load is selected via  mouse, <Enter> key, or
  411.       the <F1> key,  a directory window pops up  allowing the user to select
  412.       a  specific file to load.  (Note that you may scroll to the top of the
  413.       directory window and  change disks and  directories freely.)   A  file
  414.       may be selected via double  mouse click, clicking the LOAD button,  or
  415.       by pressing the Enter key.  To exit  the Load function without loading
  416.       a file, press the <Esc> key or click on the CANCEL button.
  417.  
  418.       After selecting a file  to load, D4man will display the file  name and
  419.       file type,  then ask you if  you would  like to load the  file.  Mouse
  420.       users  should click on  LOAD to  load the  file, CANCEL to  cancel the
  421.       load.   Keyboard users should  press the <L>  or <Enter> key to  load,
  422.       the <C> or <Esc> key to cancel the load.  
  423.  
  424.       FILE - Save  (F2)
  425.       -----------------
  426.       The  File  Save   function  allows  the  user  to  store  specific  D4
  427.       information to the  computer's disk  as a  MIDIEX format  file.   When
  428.       prompted  for  a  file name,  the  user  must  enter  a filename  that
  429.       conforms to DOS  conventions.  During  entry, the user  may edit  that
  430.       name  via the  cursor,  <Ins>, <Del>,  backspace, <Home>,  <End>,  and
  431.       alphanumeric keys.   To exit the  File Save  function without  storing
  432.       the bank  to disk,  either click  on the  CANCEL button  or press  the
  433.       <Esc> key.  
  434.  
  435.       Once the  output filename has been  specified, D4man  prompts the user
  436.       for the type of file to save.  The user has 4 options:  
  437.  
  438.           -  Single Drumset (Current).   Save the currently selected drumset
  439.              as the specified filename.  
  440.  
  441.           -  Program Change Map.  Save the current Program Change Map as the
  442.              specified filename.  
  443.  
  444.           -  Trigger  Setup.   Save  the current  setup  for all  12 trigger
  445.              inputs as the specified filename.  
  446.  
  447.           -  System  All.  Save the state of  the entire D4 as the specified
  448.              filename.   This is the  same format as the  D4's built-in MIDI
  449.              "System (All)" function.  
  450.  
  451.       The mouse user selects  one of the file  types by double-clicking  the
  452.       appropriate field,  or by highlighting the  field and  clicking on the
  453.       SAVE button.  The  keyboard user  selects a file  type via the  cursor
  454.       keys and presses the <Enter> or <S> key.  
  455.  
  456.       Please note that the unregistered  version of D4man does  not actually
  457.       store the files to disk.  
  458.  
  459.       FILE - Setup D4man  (Ctrl-F1)
  460.       -----------------------------
  461.       The Setup D4man  function is used to  configure your copy of  D4man to
  462.       match  your system.   Parameters set  in the Setup  window take effect
  463.       immediately after  exiting Setup  and also become  default values each
  464.       time you start D4man.  
  465.  
  466.       Once  the  Setup   window  pops  up,  keyboard  users   may  highlight
  467.       parameters via the cursor keys.  Once highlighted,  a parameter may be
  468.       selected for  edit  by pressing  the <Enter>  key.   Mouse  users  may
  469.       highlight a  parameter by  clicking  on it,  then select  for edit  by
  470.       double-clicking on it.   Once selected,  the parameter  may be  edited
  471.       via the cursor, <Home>,  <End>, <PgUp>, and <PgDn> keys.  To  exit the
  472.       edit,  press <Enter>  again  to  save the  value,  or press  <Esc>  to
  473.       restore the  value to  its state  before you  began editing  it.   The
  474.       Setup  window is  exited via the  <Esc> key  or a  mouse click  on the
  475.       "window close" icon  (a small yellow  square) in  the upper  left-hand
  476.       corner of the Setup window.  
  477.  
  478.       Setup allows the user to set the following parameters:
  479.  
  480.           MIDI Port          -  Enable/Disable   D4man's  use  of  the  MIDI
  481.                                 port, and  if enabled,  select  the type  of
  482.                                 MIDI  interface  installed in  your  system.
  483.                                 Set  to  "Not  Installed"  if  you  have  no
  484.                                 actual MIDI interface installed.  
  485.  
  486.           MIDI Channel       -  If MIDI  Port is enabled,  then this is  the
  487.                                 MIDI  channel   that  D4man   will  use   to
  488.                                 communicate  with your  D4.    Your D4  must
  489.                                 also  be  set to  this  channel  or  set  to
  490.                                 "omni" mode for successful communication.  
  491.  
  492.           File Path          -  This  is the  disk and  directory where  you
  493.                                 usually keep  your  D4  data files.    D4man
  494.                                 will automatically change to  this path when
  495.                                 the program is first invoked. 
  496.  
  497.           Mouse Resolution   -  This  is the mickey resolution  of the mouse
  498.                                 while  modifying  a selected  parameter  via
  499.                                 mouse.    The  higher  the  resolution,  the
  500.                                 further you will  have to move the mouse  in
  501.                                 order to modify that selected parameter.  
  502.  
  503.           Patch Bay Support  -  Enable/Disable   D4man's  MIDI   Patch   Bay
  504.                                 support.  When enabled, your  patch bay will
  505.                                 be  sent  a  predefined  message at  program
  506.                                 startup,  and another  predefined message at
  507.                                 program exit.  
  508.  
  509.           Patch Bay Channel  -  If MIDI Patch  Bay is enabled, then this  is
  510.                                 the  MIDI  channel that  D4man  will use  to
  511.                                 communicate with your Patch Bay.  
  512.  
  513.           Patch Bay Entry    -  If MIDI  Patch Bay is  enabled, this is  the
  514.                                 byte value transmitted  to it when  D4man is
  515.                                 first invoked.  
  516.  
  517.           Patch Bay Exit     -  If MIDI  Patch Bay is  enabled, this is  the
  518.                                 byte  value transmitted to it  when D4man is
  519.                                 exited.  
  520.  
  521.  
  522.       Exiting  the  Setup  function  will  store  your  configuration  to  a
  523.       D4MAN.CFG  file.   Once  a  D4MAN.CFG file  has  been created,  it  is
  524.       automatically loaded each time D4man  is started - that way you  don't
  525.       have to  specify  your command  line  switch(es)  every time  you  run
  526.       D4man.   You may  also change  D4man's setup  in any  session via  the
  527.       Setup function under the Files Menu  (see D4man Setup section).   Note
  528.       that  even once  a  D4MAN.CFG file  has  been created,  you  may still
  529.       override your default setup by using command line switches.
  530.  
  531.       FILE - Dos Shell
  532.       ----------------
  533.       The DOS  Shell function  temporarily suspends execution  of the  D4man
  534.       program and allows command  entry from the DOS prompt.  When  ready to
  535.       return to D4man, enter "exit" at the DOS prompt.
  536.  
  537.       FILE - Quit  (F10)
  538.       ------------------
  539.       The Quit function causes the D4man program to  terminate and return to
  540.       DOS.  When Quit  is selected, D4man will pop-up and indicate  which of
  541.       the 6 banks have been saved to disk  and which haven't.  You are given
  542.       a  choice whether  to  Cancel  (go back  to  D4man) or  to  Exit (exit
  543.       program and return to DOS).
  544.  
  545.  
  546.       EDIT Menu
  547.       ---------
  548.       The Edit Menu allows the user to modify the  Footswitch Setup, Program
  549.       Change  Map,  Trigger  Setup, current  Drumset  Name, and  the current
  550.       drumset's Root Note.  
  551.  
  552.       EDIT - Footswitch Setup  (F3)
  553.       -----------------------------
  554.       The Footswitch Setup function enables  the user to set  the Footswitch
  555.       Mode (as  either Hi-Hat or Drumset  Advance mode),  and the Footswitch
  556.       Close and Footswitch Open note  assignments.  The footswitch  setup is
  557.       shared amongst  all 21 loaded drumsets.   Please  note that Footswitch
  558.       Close  and Footswitch  Open  note assignments  are  only valid  if the
  559.       Footswitch Mode is currently set  to "Hi-Hat."  Exit from this  pop-up
  560.       is performed by pressing the <Esc> key, or  by clicking on the "close"
  561.       icon in  the top left corner  of the pop-up  window.  Mouse users  may
  562.       optionally double-click their way out of the pop-up.  
  563.  
  564.       EDIT - Program Change Map  (F4)
  565.       -------------------------------
  566.       The  Program  Change Map  function  allows  modification of  the  D4's
  567.       program  change  assignments.     Each  MIDI  program   change  number
  568.       (numbered 0 through  127) is assigned to  one of the D4's  21 drumsets
  569.       (numbered 0 through 20).  Each assignment pair  is displayed in column
  570.       order  with  the program  change number  on the  lefthand side  of the
  571.       colon, and the drumset assignment on the righthand side of the  colon.
  572.       Exit from this  pop-up is performed by  pressing the <Esc> key,  or by
  573.       clicking on the  "close" icon  in the top  left corner  of the  pop-up
  574.       window.  Mouse  users may also double-click their  way out of the pop-
  575.       up window.  
  576.  
  577.       Be  aware that  program  change  numbers vary  amongst  manufacturers.
  578.       Some  manufacturers'  MIDI  devices  may   implement  program  numbers
  579.       starting with  1 instead  of 0.   You  may adjust for  this by  either
  580.       modifying the  D4 program change map,  or changing the setting  of the
  581.       MIDI device that  is transmitting the  program change  message to  the
  582.       D4.   For example, if  you are running a  sequencer that automatically
  583.       sets the program number  of the D4 before starting  the sequence, just
  584.       adjust the program number setting in your sequencer.  
  585.  
  586.       EDIT - Trigger Setup  (F5)
  587.       --------------------------
  588.       The Trigger Setup pop-up window is used  to set the parameters of  the
  589.       D4's 12  trigger inputs.  These  trigger parameters  include MIDI Note
  590.       Assignment, Gain, Velocity Curve, Cross-talk, Decay,  and Noise Floor.
  591.       Each parameter  may be selected  and modified in  a manner similar  to
  592.       the D4man main screen.  
  593.  
  594.       Please  be aware  of the  fact  that when  a trigger's  velocity curve
  595.       parameter  is set to  0, the trigger  is effectively  disabled and may
  596.       not  be assigned to a  MIDI note.  Also  note that the Note Assignment
  597.       in the Trigger  Setup is  actually relative to  the Root  Note of  the
  598.       currently  selected drumset.   As  you select  different drumsets that
  599.       have different  Root Notes, you will  notice that  the Trigger Setup's
  600.       MIDI  Note Assignments change  along with them.   This is  not a D4man
  601.       anomoly - it concurs with the D4's design.  
  602.  
  603.       Exit from this  pop-up is performed by  pressing the <Esc> key,  or by
  604.       clicking  on the "close"  icon in  the top  left corner of  the pop-up
  605.       window.  
  606.  
  607.       EDIT - Drumset Name  (F6)
  608.       -------------------------
  609.       The  Drumset Name function  allows the  user to  edit the name  of the
  610.       currently  selected drumset.    Once this  function is  selected,  the
  611.       drumset  name field  on the  bottom lefthand  corner of  the screen is
  612.       highlighted and D4man allows  the user to edit the  current voice name
  613.       via  the   cursor,  backspace,  <Ins>,   <Del>,  <Home>,  <End>,   and
  614.       alphanumeric  keys.   A  shortcut to  this  function exists  for mouse
  615.       users - instead of  having to  select <F7>, a  mouse user may  double-
  616.       click on the drumset  name field in the bottom lefthand corner  of the
  617.       screen.  
  618.  
  619.       EDIT - Drumset Root Note  (F7)
  620.       ------------------------------
  621.       This  function  sets the  Root Note  for  the current  drumset.   Each
  622.       drumset maintains  its own root note, ranging  from MIDI note #0 (note
  623.       C-2) to  #67 (note G3).   Use the cursor,  <PgUp>, and <PgDn> keys  to
  624.       increment  and decrement  the root  note.   Exit  from this  pop-up is
  625.       performed by  pressing the  <Esc> key.   (Mouse  users may  optionally
  626.       exit by double-clicking either mouse button).  
  627.  
  628.       Mouse  users may also select the root note for edit by double-clicking
  629.       on the  topmost displayed note number  in the  current drumset window.
  630.       The  effect of this  shortcut will  be the  same as pressing  the <F8>
  631.       key.  Then to set the Root Note  via mouse, hold the left mouse button
  632.       down and  move the mouse in the vertical axis.  For larger steps, push
  633.       the right button instead of the left one.  
  634.  
  635.  
  636.       MIDI Menu
  637.       ---------
  638.       The MIDI menu  allows the user to  reset the MIDI interface,  transmit
  639.       data to the D4,  and receive data from  the D4.  D4man's MIDI  channel
  640.       is set via D4man's Setup Screen (See FILE - Setup D4man section).  
  641.  
  642.       MIDI - Reset MIDI Interface
  643.       ---------------------------
  644.       The  Reset MIDI  Interface  function resets  and initializes  the MIDI
  645.       interface to the  proper mode of operation.   This function should not
  646.       be  required  unless some  external  event  on  the  MIDI bus  (beyond
  647.       D4man's control)  hangs up the  MIDI interface.   For example,  a user
  648.       might shell to DOS and run an  ill-behaved MIDI program.  Upon  return
  649.       to D4man,  the MIDI interface is locked-up.   In such a case, the user
  650.       may reset the MIDI interface via the Reset MIDI function.
  651.  
  652.       MIDI - Read D4 Drumset  (F8)
  653.       ----------------------------
  654.       This function reads a  D4 drumset via MIDI and stores  the information
  655.       in the currently-selected  D4man drumset.  After selecting the Read D4
  656.       Drumset  function, the  user  must specify  the  D4 drumset  number to
  657.       read.  Then,  once the  user indicates that  it's OK  to transfer  the
  658.       drumset information, the transfer is automatic.  
  659.  
  660.       This function reads  data to the D4man  current drumset, but does  not
  661.       store the information to  disk - if  you desire to save  this data  to
  662.       disk, it must be saved afterwards via the File Save function.   If you
  663.       have problems  transferring data  from the  D4 to  the computer,  make
  664.       sure the D4man MIDI  channel matches the unit's  MIDI channel and  the
  665.       unit's MIDI In and MIDI Out cables are connected properly.  
  666.  
  667.       MIDI - Read D4 All  (Ctrl-F8)
  668.       -----------------------------
  669.       This function reads all D4 data that is included  in a D4 System (All)
  670.       dump.   This  data includes  all  12  trigger setups,  program  change
  671.       table, all 21  internal drumsets,  footswitch setup,  and system  data
  672.       such as MIDI channel, omni on/off, and currently selected drumset.  
  673.  
  674.       This function  reads the D4,  but does  not store  the information  to
  675.       disk  - if  you desire to  save this  data to  disk, it must  be saved
  676.       afterwards  via  the  File  Save  function.    If  you  have  problems
  677.       transferring data  from the  D4 to the  computer, make sure  the D4man
  678.       MIDI channel matches  the unit's MIDI  channel and the unit's  MIDI In
  679.       and MIDI Out cables are connected properly.  
  680.  
  681.       MIDI - Write D4 Drumset  (F9)
  682.       -----------------------------
  683.       This  function  writes  the information  from  the  currently-selected
  684.       D4man  drumset to  a specified  internal drumset  on the D4  via MIDI.
  685.       The term  "internal drumset" refers to  a drumset  location, 0 through
  686.       20.  The  storage is similar  to storing a drumset  from the  D4 front
  687.       panel  -  once stored,  the  D4 "remembers"  the  drumset even  if you
  688.       select another drumset number.   Remember that you can  always restore
  689.       the factory drumsets via the D4 front panel.  
  690.  
  691.       If you have  problems transferring data  from the computer to  the D4,
  692.       make sure the D4man MIDI  channel matches the unit's MIDI  channel and
  693.       the  unit's MIDI In and cable is  properly connected to the computer's
  694.       MIDI Out.  
  695.  
  696.       MIDI - Write D4 All  (Ctrl-F9)
  697.       ------------------------------
  698.       This function  writes all  D4 data  that is  included in  a D4  System
  699.       (All) dump.  This data includes  all 12 trigger setups, program change
  700.       table, all  21 internal drumsets,  footswitch setup,  and system  data
  701.       such as MIDI channel, omni on/off, and currently selected drumset.  
  702.  
  703.       If  you have problems transferring  data from the  computer to the D4,
  704.       make  sure the D4man MIDI channel matches  the unit's MIDI channel and
  705.       the unit's MIDI In  and cable is properly connected to  the computer's
  706.       MIDI Out.  
  707.  
  708.  
  709.       ZORCH Menu
  710.       ----------
  711.       The Zorch menu  displays information about  the program  itself.   The
  712.       unregistered version of D4man displays information  on how to register
  713.       your copy of the program.  
  714.  
  715.  
  716.       QUITTING D4man
  717.       --------------
  718.       To quit the  D4man program, select the  Quit function under the  Files
  719.       menu,  or type <F10>  from the keyboard.   D4man will  ask you whether
  720.       you would  like to  exit  the program,  or cancel  and return  to  the
  721.       program.   Press <X>  to exit, <C> to  cancel.  Mouse  users may press
  722.       the mouse on  either the EXIT or CANCEL buttons. If you decide to exit
  723.       the program, you will be  automatically returned to the  DOS directory
  724.       that you entered D4man from.  
  725.  
  726.  
  727.       MIDI PATCH BAY SUPPORT
  728.       ----------------------
  729.       D4man provides support  to MIDI Patch Bays  that are MIDI-controllable
  730.       via MIDI  "Program  Change" messages.    D4man  does this  by  sending
  731.       specific program change numbers  to your MIDI patch bay  on your patch
  732.       bay's  MIDI channel.   A program change  number must  be specified for
  733.       entry into  the D4man program, and another must  be specified for exit
  734.       from  D4man.  The "entry"  value will set your patch  bay so that your
  735.       D4 Midi In and Midi Out  ports will be routed to  your computer's MIDI
  736.       interface.    The "exit"  value  will return  your patch  bay  to your
  737.       default  setting.   Also,  you  must  specify  your  patch bay's  MIDI
  738.       channel (this should be a different channel than your D4 is on!).
  739.  
  740.       "Entry"  and "Exit"  patch  numbers, and  patch  bay MIDI  channel are
  741.       application-specific and  vary  from  user  to  user.    In  order  to
  742.       configure D4man  for your patch bay  setup, enter  D4man Setup, enable
  743.       patch bay support,  set the MIDI channel  of your patch bay,  and then
  744.       set the "entry" and "exit" values for your specific system.
  745.  
  746.  
  747.       FILE FORMATS
  748.       ------------
  749.       Four different file formats are  supported by D4man at this time,  all
  750.       of which contain one or more consecutive MIDIEX message(s).  The  file
  751.       formats are  identical to those output by the D4 when manually running
  752.       a  Sysex Backup from the  D4's fifth MIDI page.   This means that data
  753.       dumped directly to disk from the  D4 may also be loaded  by D4man, and
  754.       vice-versa.  Here are the 4 supported formats:  
  755.  
  756.           Single Drumset     -  Same format  as D4's  "Edit Buffer"  format.
  757.                                 Data  includes   drumset  name,   footswitch
  758.                                 closing  and  holding  notes,  trigger  note
  759.                                 assignments,  and volume, pan, output, bank,
  760.                                 voice,  tune, and  group assign information.
  761.  
  762.  
  763.           Program Change Map -  Same format as D4's  "Program Table" format.
  764.                                 Data   includes   all  128   Program  Change
  765.                                 assignments.  
  766.  
  767.           Trigger Setup      -  Same format as D4's "Trigger Setup"  format.
  768.                                 Data  includes gain,  velocity curve, cross-
  769.                                 talk, noise  floor, and  decay settings  for
  770.                                 all 12 trigger inputs. 
  771.  
  772.           System (All)       -  Same format as D4's  "System (All)"  format.
  773.                                 Data   includes   25   consecutive    MIDIEX
  774.                                 messages:      the  Program   Change  Table,
  775.                                 Trigger   Setup,  Edit   Buffer,  21  Single
  776.                                 Drumsets, and the System Info message.  
  777.  
  778.  
  779.       MIDIEX format files  may be used with other popular shareware programs
  780.       such as SYSX.EXE (any version)  or MIDIEX.EXE (we suggest  version 1.9
  781.       or  later),  or  with   commercial  products  such  as  the   Cakewalk
  782.       sequencer.   When a MIDIEX  file is loaded  by the D4man program,  the
  783.       MIDI channel  embedded  in the  MIDIEX  file  is replaced  by  D4man's
  784.       current MIDI  channel  setting.   In  the  same manner,  MIDIEX  files
  785.       stored  by D4man will  have the same  MIDI channel  as D4man's current
  786.       setting.  
  787.  
  788.  
  789.       D4MAN.INI File
  790.       --------------
  791.       The  D4MAN.INI  file  contains  D4  information  that will  be  loaded
  792.       automatically  every  time  you   start  D4man.    Included   in  this
  793.       information is  data  for all  21  drumsets,  the trigger  setup,  the
  794.       program change  map setup,  the footswitch  setup, and  all D4  system
  795.       parameters.  
  796.  
  797.       The D4MAN.INI  file is actually  a MIDIEX file  in the same format  as
  798.       the D4's  "System (All)" format (also  same as  D4man's "System (All)"
  799.       format).   Therefore, you may replace  D4MAN.INI with your own file by
  800.       just renaming  and copying  your file  to the  same disk  directory as
  801.       D4MAN.EXE  and D4MAN.CFG.   Just be sure that  the file  is the proper
  802.       format!  We  recommend that you keep a  copy of the original D4MAN.INI
  803.       as  a safety  precaution.   The  original  D4MAN.INI file  matches the
  804.       actual Alesis factory configuration.  
  805.  
  806.  
  807.       HOT KEY REFERENCE
  808.       -----------------
  809.  
  810.              F1  = Load File
  811.         Ctrl-F1  = Setup D4man
  812.              F2  = Save File
  813.              F3  = Footswitch Setup
  814.              F4  = Program Change Map
  815.              F5  = Trigger Setup
  816.              F6  = Drumset Name
  817.              F7  = Drumset Root Note
  818.              F8  = Read D4 Drumset
  819.         Ctrl-F8  = Read D4 All
  820.              F9  = Write D4 Drumset
  821.         Ctrl-F9  = Write D4 All
  822.             F10  = Quit Program
  823.  
  824.  
  825.       FUTURE UPGRADES
  826.       ---------------
  827.       Key Midiator interface support.
  828.  
  829.  
  830.       MORE INFO
  831.       ---------
  832.       A great  deal of  time and  effort went  into  developing and  testing
  833.       D4man.    If you  experience  problems  with  D4man,  please note  the
  834.       symptoms and contact us.   We'll do our best to rectify the situation.
  835.       If you have  any comments, questions,  or suggestions  about D4man  or
  836.       other  Zorch brotherz  products,  we will  be  glad to  receive and/or
  837.       answer them.  We may be contacted by mail at:
  838.  
  839.           Bret Costin
  840.           c/o Zorch brotherz software
  841.           3475 Rolling Trail
  842.           Palm Harbor, FL  34684
  843.  
  844.       or leave us a message at one of these Bulletin Board Systems:
  845.  
  846.           -  The  Gulf  Coast MIDI  Users'  Group  BBS  (Sponsored by  Zorch
  847.              brotherz software), (813) 789-5880 (To: Bret Costin),
  848.  
  849.           -  Compuserve Mail [70474,3534] (To: Bret Costin),
  850.  
  851.           -  The MIDILINK Musicians' Network,  (708) 949-MIDI, Main Board or
  852.              IBM Conference, (To: Bret Costin).
  853.  
  854.  
  855.       The Gulf  Coast MIDI Users' Group  BBS is sponsored by  Zorch brotherz
  856.       software  and  is loaded  with additional  Zorch  products  and public
  857.       domain demos,  patches, samples, and  sequences, as well as  messaging
  858.       to MIDILINK, the premiere Musician's Network.  
  859.