home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Spezial / SPEZIAL2_97.zip / SPEZIAL2_97.iso / ANWEND / MULTIMED / MIDIDB12 / mididb.doc < prev    next >
Text File  |  1997-09-13  |  29KB  |  711 lines
  1. MIDI DB 1.0 User Guide
  2. (C)1997 Cornel Huth
  3.  
  4. ---------------------------------------------------------------------
  5. Overview
  6. ---------------------------------------------------------------------
  7.  
  8. MIDI DB is a MIDI player and database for MPU-401 devices.  Features
  9. include the ability to modify patches used on a per-track basis, and
  10. support for up to four devices which may be used simultaneously.  In
  11. short, the Ultimate MIDI Player for OS/2.
  12.  
  13.  
  14. This User Guide steps you through installation and basic use, covering
  15. the following:
  16.  
  17.   I. Basic Setup
  18.      A. Stage 1
  19.      B. State 2
  20.  
  21.  II. Basic Use
  22.      A. Introduction to MIDI DB Panels
  23.      B. Add, Update and Play from the Database Panel
  24.      C. Play from the Main Panel
  25.  
  26. III. Advanced Use
  27.      A. Modify Track Playback
  28.      B. Assign MIDI Port to Device
  29.      C. Switches
  30.      D. Error codes
  31.  
  32.  IV. Tips and Q & A, including how to order
  33.  
  34.  
  35. To make use of this guide, load it into any standard text editor and
  36. search on words, error codes, etc., as needed.  It's best to read it
  37. all the way through at least once before using MIDI DB, and before
  38. requesting support.  See the README file for new information.
  39.  
  40. ---------------------------------------------------------------------
  41. Basic Setup
  42. ---------------------------------------------------------------------
  43.  
  44. Stage 1:
  45.  
  46.  1. Unzip the package to any empty directory
  47.  
  48.  2. Copy PARADISE.SYS to your boot drive's root directory
  49.  
  50.  3. Edit config.sys by adding the following line:
  51.  
  52.         DEVICE=PARADISE.SYS
  53.  
  54.  4. Move mididb.exe to a directory in PATH
  55.  
  56.  5. Create a program object for mididb.exe (optional)
  57.  
  58.  6. Create a directory for your MIDI DB files
  59.  
  60.  7. If you are using Warp 3 and your clock01.sys driver is smaller
  61.     than 3800 bytes, or if the paradise driver does not install, do
  62.     the following:
  63.  
  64.     A.  Rename your current clock01.sys to clock01.org
  65.     B.  Copy clock01.sys included with MIDI DB to your boot's root
  66.  
  67.     This should not be necessary on Warp 4 GA since it ships with
  68.     the same clock01.sys as provided with MIDI DB.  Note: your current
  69.     clock01.sys may be in a directory other than root.  If you have
  70.     any trouble installing, contact support for dealing with specific
  71.     problems.
  72.  
  73.  7. Reboot
  74.  
  75.     If you do not do all steps in stage 1 you most likely will get error 110
  76.     when you attempt to run MIDI DB.
  77.  
  78.  
  79. Stage 2:
  80.  
  81.  1. Start mididb.exe
  82.  
  83.  2. Enter the path to the directory you created above for both index
  84.     and data files:  include the drive and full pathname, for example:
  85.  
  86.         e:/mdb/
  87.  
  88.  3. For each MPU-401 device you have, enter its name and base port,
  89.     for example:
  90.  
  91.         DB50XG  330
  92.  
  93.     The base port address is hex, and must be above 100 for it to be
  94.     used.
  95.  
  96.  4. Press Done.
  97.  
  98.  5. The main MIDI DB panel appears, with a message box asking if you
  99.     want to create the database files since they were not found.
  100.     Select Yes.
  101.  
  102.  6  Another message box pops up asking if want to reset all MPU devices
  103.     to UART mode -- select Yes unless you have a reason not to.
  104.  
  105.  7.  At this point MIDI DB is ready to use once you read the
  106.      following documentation.
  107.  
  108.  
  109.  
  110. ---------------------------------------------------------------------
  111. Basic Use
  112. ---------------------------------------------------------------------
  113.  
  114. Introduction to MIDI DB Panels
  115. ------------------------------
  116.  
  117. The Main Panel ("MIDI DB" titlebar text) is typically used to
  118. control play of songs stored in the database.
  119.  
  120. The Database Panel (MIDI DB Database) is used to add to and update the
  121. database.  You may also play from here.
  122.  
  123. The Selection Panel (MIDI DB Selection) is used to create filters on
  124. which the Main Panel uses to select which songs in the database are
  125. to be played.
  126.  
  127. The Main and Database panels also have dialog windows which are used
  128. to perform specific tasks:
  129.  
  130. The Configuration Panel lets you locate the MIDI DB data files and
  131. configure MIDI DB to your MIDI playback devices.
  132.  
  133. The About Panel tells you the version of MIDI DB running.
  134.  
  135. From the Database Panel you have Song Lyrics and Notes dialogs, which
  136. let you paste in lyrics or notes, and additional dialogs for the
  137. advanced user which are used to:
  138.  
  139.  - modify which instruments are to be used (Track Mapper)
  140.  - select to which device output is sent (Port->Dev Mapper)
  141.  - view system exclusive messages (SysEx View)
  142.  
  143. You may also export to disk any SMF in the database.
  144.  
  145.  
  146.  
  147. Add, Update and Play From the Database Panel
  148. --------------------------------------------
  149.  
  150.  1. Press DATABASE in the To Window box of the Main Panel:  this
  151.     brings up the MIDI DB Database window.
  152.  
  153.  2. Press CLEAR in the Song Detail box.
  154.  
  155.  3. Enter a song title for an SMF you want to add in the TITLE entry
  156.     field, for example:
  157.  
  158.         Test Song
  159.  
  160.  4. Press ADD THIS in the Song Detail box.
  161.  
  162.  5. Press the ADD NEW button in the SMF Control box to bring up a
  163.     standard File Open dialog.
  164.  
  165.  6. Select any valid SMF, for example testsong.mid (included), to
  166.     have it parsed and stored into the database -- the original SMF
  167.     is no longer needed and may be archived away; all further song
  168.     play is done from the compressed image of the SMF stored in the
  169.     database.
  170.  
  171.  7. Press PLAY to audition the SMF -- during play you may update the
  172.     Song Detail info by returning to TITLE and other song fields to
  173.     enter more information about the song (press UPDATE to make the
  174.     change).
  175.  
  176.     NOTE:  See Q & A #1, in the Q & A section at the end, for the
  177.     reason the song ends when it does.
  178.  
  179.  8. If the SMF is not what you want, press DELETE SMF in the Database
  180.     Control box -- go to step 5, above, to select another SMF for this
  181.     song entry.
  182.  
  183.  9. If the SMF is wanted you may proceed and add more songs/SMFs in
  184.     a similar manner (go to step 2).
  185.  
  186.     NOTE: If you find an SMF unsuitable but have already made a Song
  187.     entry for it, simply overwrite the current Song Detail info with a
  188.     new song, press UPDATE, and go to step 5.
  189.  
  190. 10. Any field that is displayed in green is a field that may be edited/
  191.     updated with valid data, as shown below:
  192.  
  193.      Title/Artist/Album:  each up to 62 characters (case insensitive)
  194.                    Year:  1776 and later
  195.           Category/Xtra:  each up to 12 characters
  196.                  Prefer:  number of your preferred SMF (none,1-6)
  197.  
  198.      And in the SMF Detail box (each SMF has its own grade, play mode):
  199.  
  200.                   Grade:  A to Z
  201.               Play Mode:  GM, GS, or XG (or none)
  202.  
  203. 11. Any field named in red (Title, Artist, Album, Year, Category, Xtra,
  204.     and Grade) may be used as an orderBy key -- for example:
  205.  
  206.        title
  207.        title+year
  208.        year+title
  209.        grade+year+title+...  (any combination is allowed)
  210.  
  211.     are each a valid "Order By" key expression.  To enter: press the
  212.     NEW ORDER button in the Database Control box, enter the Order By
  213.     key expression, then press the TAB key (a reindex takes place
  214.     immediately after you press TAB if you entered a valid Order By
  215.     expression, and does nothing except delete the current index if
  216.     invalid).
  217.  
  218.     For now, enter
  219.  
  220.        title
  221.  
  222.     (press NEW ORDER, enter title, then press TAB key)
  223.  
  224.     From here on, the order used will be by song title, whenever key
  225.     access is used by MIDI DB.
  226.  
  227.     Before moving on, add a few more songs and SMFs to the database
  228.     (go to step 2).  Up to 6 SMFs may be added per song (try it).  Of
  229.     course it's expected that the SMFs are simply different versions
  230.     of the -same- song, not different songs.
  231.  
  232.     To use no index (and to delete any existing one), clear out the
  233.     OrderBy entry field (remove all characters and spaces) and press
  234.     TAB.
  235.  
  236.  
  237.  
  238. Play From the Main Panel
  239. ------------------------
  240.  
  241.  1.  Go to the Selection Panel by pushing the SELECTION button on the
  242.      main panel.  At the Selection Panel, push the KEY button in the
  243.      Current Order box.  Press SET.
  244.  
  245.  2.  Press PLAY.  Any song matching the selection criteria in the
  246.      Selection Panel is played.  Since no selection criteria has been
  247.      specified yet, all songs in the database are played, one after
  248.      the other, in the current order (title), automatically.
  249.  
  250.      NOTE: If no song has yet been played and you press PLAY and
  251.      error 10505 pops up:  Press STOP, then NEXT, then PLAY.  This
  252.      typically won't happen.
  253.  
  254.  3.  To stop play press STOP.
  255.  
  256.  4.  When not playing you may use NEXT to locate to the next song
  257.      (go to step 2, above) or control-NEXT to locate to the previous
  258.      song.
  259.  
  260.      NOTE: You must use the -left- Control key, or either SHIFT key.
  261.  
  262.  5.  To play in reverse order use control-PLAY.
  263.  
  264.  6.  In some cases it may be necessary to reset the UARTs even after
  265.      MIDI DB has started (some other software may have changed the
  266.      device since started), so press the RESET MPU button if MIDI DB
  267.      appears to not work.  Normally the Paradise driver detects and
  268.      corrects this automatically.
  269.  
  270.  7.  In some cases it may be necessary to reset the clock source after
  271.      play has started.  This is especially needed if you start up a
  272.      DOS or Windows program, some of which will alter the clock used
  273.      by MIDI DB.  Press the RESET TIMER button to restore proper tempo.
  274.  
  275.      You can tell you need to push Reset Timer when the tempo slows
  276.      down dramatically.
  277.  
  278.      NOTE: Some DOS and Windows programs will not start up unless they
  279.      can access the clock.  If this happens you will need to STOP
  280.      MIDI DB playback (just press STOP); once the DOS/Windows program
  281.      has finished loading you can restart play.
  282.  
  283.      Note: The "clock source" is not a clock per se, but the device
  284.      (called a timer) that MIDI DB uses to play notes in perfect time.
  285.  
  286.  8.  Check REPEAT if you want to continually play the current selection.
  287.  
  288.  9.  Play selection is based on the criteria you specify in the
  289.      Selection panel, and only if the filters are active (Filter check
  290.      boxes checked)  -- see the Tips section, below, for more.  By
  291.      default no filters are active, hence all songs will play.
  292.  
  293.      Be sure to check the OrderBy mode in the Selection Panel.  The
  294.      index is used only if it is in Key or Flagged modes.
  295.  
  296.  
  297.  
  298. ---------------------------------------------------------------------
  299. Advanced Use
  300. ---------------------------------------------------------------------
  301.  
  302. Modify Track Playback
  303. ---------------------
  304.  
  305.  1.  Select a Song by using the Song controls in the Database Control
  306.      box.  To find a particular song in key order (Order By must have
  307.      a valid expression in it), press CLEAR, then enter the first couple
  308.      of letters of the song's title you want to find into the Title
  309.      field and press FIND; the nearest match is shown and made ready.
  310.  
  311.      NOTE:  The song currently playing from the Main Panel is not affected
  312.      by the actions you do in the Database Panel.
  313.  
  314.  2.  Press TRACK MAPPER.
  315.  
  316.  3.  You can alter the following fields, for any or all tracks:
  317.  
  318.         MIDI port:  1 to 16, 0 to disable track (see Port->Dev Mapper)
  319.        Track Name:  use any text, up to 16 characters
  320.       MSB/LSB/Pgm:  change as needed  (MSB/LSB=0 to 127, Pgm=1 to 128)
  321.      Velocity Pct:  100% is unity, 50% is half, 200% is twice as much
  322.        Volume Pct:  100% is unity, 50% is half, 200% is twice as much
  323.  
  324.      A changed field is shown in green.  To return to the original value
  325.      press the left Control key while clicking on the field (color
  326.      returns to yellow).  Track name, however, keeps whatever you have
  327.      changed it to (the original value is not kept).
  328.  
  329.      MSB/LSB must be 0 for GM.  LSB must be 0 for GS.  MSB must be 0
  330.      for XG (in most cases).  Consult your MIDI device's specifications
  331.      for selecting banks (GS or XG hardware only).  Bank LSB/MSB start
  332.      at 0 and go to 127.
  333.  
  334.      In order to use GS banks (variations) the PLAY MODE in the Database SMF
  335.      Detail box must be GS; in order to use XG banks PLAY MODE must be XG.
  336.  
  337.      Pgm is the program (often called patch) which stands for a particular
  338.      instrument to play.  The first Pgm is numbered 1 and the last is 128.
  339.      See PGM.ZIP for a list of standard GM, GS, and XG programs.  GM
  340.      programs are always at bank MSB=LSB=0.  Drums will often not have a
  341.      program, but will use 0.  0 is the standard drum kit, as is 1.
  342.  
  343.      Velocity and Volume may be adjust from 1 to 200%.  MIDI DB
  344.      internally limits these values to 127.  Refer to the average and
  345.      maximum values to determine a good setting for Pct.
  346.  
  347.      NOTE that 100% is unity, or -no change-.
  348.  
  349.  4.  Press Done to accept the changes made, or Cancel to forget them.
  350.  
  351.      The changes take affect the next play.
  352.  
  353.  
  354.  
  355. Assign Port to Device
  356. ---------------------
  357.  
  358.  1.  Select any song (see Modify Track Playback, step 1).
  359.  
  360.  2.  Press PORT > DEV MAPPER.
  361.  
  362.  3.  For each unique port number in the TRACK MAPPER a port number
  363.      device is available to be modified.  Typically most SMFs only use
  364.      one port, port 1, but some do make use of more.  You can also make
  365.      use of more very easily (see Modifiy Track Playback), and so can
  366.      direct certain tracks to different hardware devices easily, too.
  367.  
  368.      If you have only one device (as set in the Configuration Panel)
  369.      then there is nothing to be done here; press Cancel.
  370.  
  371.  4.  To redirect a port (MIDI port, not to be confused with base port)
  372.      spin the button until the device name you want to send that port's
  373.      data to is shown.  By default the first device is used for all.
  374.  
  375.  5.  Press Done to accept the changes, or Cancel otherwise.
  376.  
  377.      The changes take affect the next play.
  378.  
  379.  
  380.  
  381. Switches
  382. --------
  383.  
  384. The following switches may be used on the command line.  None are
  385. typically needed.
  386.  
  387.    -config   Start up configuration dialog
  388.    -noreset  Do not prompt for "Reset All MPU UARTs?"
  389.  
  390.    -nobeep   Disable beeps
  391.    -min      Start up minimized
  392.  
  393.    -nosp     Do not save new window positions
  394.    -nolp     Do not load old window positions
  395.  
  396.    -w:n      n=MPU device timeout value (def=10000, max=65535)
  397.    -mad:n    n=maximum autoplay wait-for-stop delay (def=50, 1=93ms)
  398.  
  399.    -dupd:n   n=main panel display update period (def=124, 100 to 500ms)
  400.    -dclr:n   n=main panel display text color (def=5, -2 to 15)
  401.    -dpri:n   n=priority of main panel display (def=2, 1 to 4)
  402.    -dfast    disables main panel song name update during searches
  403.  
  404.    -ini:a    a=pathname to ini file, form D:/PATH/ININAME (no extension)
  405.                (default is drv:/directory/mididb.ini of mididb.exe)
  406.  
  407.    -chk:n    database report (records=songs in DBF, memo=SMFs in DBT)
  408.              n=1 check header
  409.               =2 check header and records
  410.               =3 check header and records (index order)
  411.               =4 check header and records and memo
  412.               =5 check header and records and memo (index order)
  413.  
  414.              chk: output goes to file mididb.chk, in the same path
  415.                   of mididb.exe
  416.  
  417.              The database report is run at program start, before anything
  418.              else is available.  It may take a while to complete if the
  419.              database is large.  n=4+ also tallies total SMF bytes.
  420.  
  421.              Song data is, from left to right:
  422.  
  423.              Record number, Highest Grade, Preferred SMF, Last SMF Played,
  424.              Lyric/Note Flags (Y/O indicate present), Song Title, Artist,
  425.              Album, Year, Category, and Xtra
  426.  
  427.              SMF data is, from left to right:
  428.  
  429.              SMF Slot, Memo Number, Flagged flag, Grade, Internal Mode,
  430.              SWAG mode, Play mode, Format (0,1), Tracks, PPQN, Run time,
  431.              Size, Times Played, Last Play Date, Date Loaded, Port Map.
  432.              Data for headings "T" and "S" are not used (always ".").
  433.  
  434.  
  435. Error Codes
  436. -----------
  437.  
  438. The following error codes are used by the Paradise driver (9000 to
  439. 9099) and MIDI DB (9100+).  OS/2 error codes (2 to 999) and Database
  440. error codes (8192 to 8999) can be found in the Bullet manual, at the
  441. MIDI DB home site at http://www.40th.com., or BBS.
  442.  
  443.  EPS_DEVICE_STILL_BUSY    9001            EPS_BUFFER_ACTIVE      9018
  444.  EPS_ALREADY_INITED       9002            EPS_BUFFER_NOT_ACTIVE  9019
  445.  EPS_NOT_INITED           9003            EPS_ALREADY_REG_CLOCK  9020
  446.  EPS_INVALID_DEVID        9004            EPS_NULL_HANDLER_PTR   9021
  447.  EPS_INVALID_PORTID       9005            EPS_8254_IN_USE        9022
  448.  EPS_BUSY_DEVID           9006            EPS_8254_NOT_OWNER     9023
  449.  EPS_MPU_TIMED_OUT_DRR    9007            EPS_IRQ_IN_USE         9024
  450.  EPS_MPU_TIMED_OUT_RESET  9008            EPS_IRQ_NOT_AVAIL      9025
  451.  EPS_MPU_TIMED_OUT_RESET2 9009            EPS_IRQ_NOT_OWNER      9026
  452.  EPS_FULL_PORTID_MAPPER   9010            EPS_KEYBOARD_ACTIVE    9027
  453.  WPS_NULL_DEVID           9011            EPS_DSP_TIMED_OUT_DW   9050
  454.  WPS_NULL_PORTID          9012            EPS_DSP_TIMED_OUT_DR   9051
  455.  EPS_BAD_DATASIZE         9013            EPS_DSP_RESET_FAILED   9052
  456.  EPS_NO_CLOCK             9014            EPS_MIXER_BAD_PORT     9053
  457.  EPS_NULL_IREGXPTR        9015            EPS_INVALID_IRQ        9055
  458.  EPS_NULL_OREGXPTR        9016            EPS_INVALID_DMA        9056
  459.  EPS_CTXHOOK_FAILED       9017            EPS_UNKNOWN_MIXER      9057
  460.  
  461.  EPS_PACK_CORRUPT_DATA    9101            EPS_SMF_INVALID        9121
  462.  EPS_PACK_READ_OVERRUN    9102            EPS_SMF_EOF            9122
  463.  EPS_PACK_WRITE_OVERRUN   9103            EPS_SMF_SYSEX_BAD      9123
  464.  EPS_PACK_STACK_OVERFLOW  9104            EPS_SMF_RS_BAD         9124
  465.  EPS_PACK_STACK_UNDERFLOW 9105            EPS_SMF_BOGUS          9125
  466.  EPS_PACK_UNEXPECTED_SIZE 9106
  467.  
  468.  WPS_MP_WAS_PLAYING       9151            EPS_XGDSP_BAD_PORT     9253
  469.  
  470.  IX3_NO_KEYEXPR           10501           SMF_FILTERED_OUT       10504
  471.  IX3_BAD_KEYEXPR          10502           SMF_NO_CURRENT_DATA    10505
  472.  SMF_DOES_NOT_EXIST       10503           SMF_ALREADY_PLAYING    10506
  473.  
  474. It's unlikely that you'll see many of these, but if you do see one it
  475. is useful when you are reporting problems.
  476.  
  477. Error 110 probably means that you have not installed paradise.sys
  478. correctly.
  479.  
  480. Error 10505 may occur if you press PLAY in the Main Panel but have not
  481. yet loaded anything.  Press NEXT first.
  482.  
  483. Error EPS_8254_IN_USE 9022 is a clock01.sys return code (original rc
  484. from clock01.sys is 99) meaning that some other program is using the
  485. clock/timer device that MIDI DB wants to use.  Find and close the
  486. offending app (probably a DOS or Windows app, or RTMIDI/timer0.sys).
  487. There's only one 8254 device available and only one can use it any
  488. one time.  MIDI DB attempts to use it only when play starts, and then
  489. releases it as soon as play stops.
  490.  
  491. If you have a database index error (8501 to 8599) you may want to push
  492. the NEW ORDER button in the Database Panel and force a reindex by
  493. editing the Order-By expression and pressing the TAB.
  494.  
  495. There is currently a maximum database size of 580MB, or about 15,000
  496. songs (song data is stored compressed in the database).  This may be
  497. expanded in the future to 2GB if there's a need. (It's a software
  498. change, with no other changes being needed.)  You may have any number
  499. of databases, each up to 580MB (easily selected between using the
  500. -ini: switch).
  501.  
  502.  
  503. ---------------------------------------------------------------------
  504. Tips and Q & A
  505. ---------------------------------------------------------------------
  506.  
  507. ----
  508. Tips
  509. ----
  510.  
  511. Make periodic backups of the mididb.dbf and mididb.dbt files.  Run
  512. using the -chk: switch (see Switches, above) to validate the database
  513. before saving/archiving the backup.  To backup:  exit MIDI DB and
  514. use the xcopy command to copy them to an archive location, or use
  515. pkzip and zip them up for storage elsewhere.
  516.  
  517. When adding to the database you may find it easiest to move all *.mid
  518. files to a common directory, and to add SMFs from there.  This is not
  519. recommened for FAT formatted drives with more than 400 files, in which
  520. case separate directories should be used (FAT is slow in large
  521. directories).
  522.  
  523. When entering song information for entries which are currently unknown
  524. you may want to put in your best guess.  For example, if you don't know
  525. the album name you may prefer to put in the artist name rather than
  526. leaving it blank.  For the year enter an approximate year.  This makes
  527. it more usable when that field is used as part of the OrderBy key or
  528. when using the field as a selection filter.
  529.  
  530. If a Song has no current lyrics (no number in the lyrics box) MIDI DB
  531. will add lyrics of an SMF that is a valid soft-karaoke format file.
  532.  
  533. To remove a Note or Lyric, delete all text in the MLE and press Done.
  534.  
  535. If you have more than one SMF for a song enter the preferred one in
  536. the Database panel's Prefer field, otherwise the first is played (if
  537. no selection filters are used).
  538.  
  539. You can flag a SMF which marks that SMF for later selection matching
  540. in the Selection Panel when Order is set to Flagged.  Check the "Clear
  541. Flag" button to have MIDI DB clear the flag after play.  You can also
  542. manually UN-flag an SMF by pressing the small Flag button in the lower-
  543. left of the Database Panel.
  544.  
  545. After changing the selection filters press SET for them to take effect.
  546. Also, check either or both Song Filter and SMF Filter buttons if you
  547. want their respective filters to be used.  This applies after pressing
  548. CLEAR, too.
  549.  
  550. A wildcard can be used in text fields in the Selection Panel.  For
  551. example, using
  552.  
  553.    fr*
  554.  
  555. in the Title field would match all songs that start with fr.  You
  556. can also use *xYz* to match text within a field, not just at the start.
  557.  
  558. The Current Index is modified in the Database Panel only but is used
  559. by the Main Panel during play if the Selection Panel is set to either
  560. Key or Flagged.  Random plays songs in random order and Sequence plays
  561. songs in the order they were added to the database.  Key or flagged
  562. order requires an index, so be sure one is in use (use New Order
  563. button in Database Panel).
  564.  
  565. Leave a Selection Filter field blank to not consider it in the
  566. selection process.
  567.  
  568. Dates are entered as YYYYMMDD (19970716 for 16-July-1997).
  569.  
  570. If ever you start MIDI DB but don't see it on screen, you may want to
  571. close it (from the task list), and restart using the -nolp switch.
  572.  
  573. If MIDI DB seems to be hopelessly confused about the meaning of its
  574. existence, delete its .ini file and restart, which also generates
  575. a reindex (as always, when you start MIDI DB).
  576.  
  577. If you have a selection filter active and no more matches (or any)
  578. occur, the song position pointer is at the last song (or first if
  579. you pressed Ctrl-NEXT/PLAY).  If you now press PLAY (after the
  580. No Match status is displayed) that last (or first) song is played
  581. regardless of whether it matches the selection criteria or not.
  582. You may press NEXT to restart the selection processes.
  583.  
  584. The internal play mode (GM, GS, XG, etc.) of the SMF is not used if
  585. the Play Mode field in the SMF Detail box is not blank.  Instead,
  586. whatever is in the Play Mode field is used.
  587.  
  588. The MIDI Master Volume Sysex is removed and is not sent to the device.
  589.  
  590. All SMF changes are stored with the SMF in the database, and are used
  591. again, the next time the SMF is played, until you change them again.
  592. This applies to all modifications made to the SMF (Port, MSB/LSB, Pgm,
  593. Velocity/Volume change, Port->Dev, and Play Mode (GM, GS, XG)).
  594.  
  595. If a database error occurs during Selection, go to the Database panel
  596. (if not already) and select the song that generated the error.  Press
  597. Song NEXT/PREV a couple of times, returning to the song after that.
  598. Then press UPDATE.  This should correct the error automatically.
  599.  
  600. The configuration data is used only at startup.  To correctly apply
  601. the changes made you must exit and restart MIDI DB.
  602.  
  603.  
  604. -----
  605. Q & A
  606. -----
  607.  
  608. 1. Why doesn't any song play longer than its first minute?
  609. A. This is an evaluation version, and must be registered for full-
  610.    length song play.  You can register today and have MIDI DB
  611.    playing full-length in less than 24 hours (restrictions may apply).
  612.    See _order.frm or _order.bmt for how to order.
  613.  
  614. 2. Why doesn't MIDI DB work with my GUS or Soundblaster SB16/AWE32/64?
  615. A. MIDI DB uses its own MPU-401 device driver which does not support
  616.    those two cards.  Supported devices include just about all other
  617.    "wavetable MIDI" device that are MPU-401 compatible devices (not
  618.    just MPU-401 interfaces).  MIDI DB does not use MMPM/2, and works
  619.    even without MMPM/2 installed.  You can add a daughterboard to your
  620.    Soundblaster to get MPU-401 compatibility.
  621.  
  622. 3. Why does the 8x9x Net box in the Database Panel show a number other
  623.    than 0?
  624. A. This value is the net number of note ons and note offs for the track
  625.    with the largest deviation from 0.  If this is anything but 0 the
  626.    SMF is flawed, and could result in "hanging" notes sounding.
  627.  
  628. 4. What's the Mode box in the Database Panel?
  629. A. Int mode is the detected play mode internal to the SMF (GM/GS/XG,
  630.    or none).  SWAG is the likely mode for the SMF.  Play mode is the
  631.    mode you specified, or by default the internal mode (or if no
  632.    internal mode, then the SWAG mode).  Many GS files have been
  633.    corrupted with a GM reset, and so Int mode will show GM while SWAG
  634.    will show GS.  You should change these to Play mode of GS.  You can
  635.    also check the TRACK MAPPER and Sysex View for more information to
  636.    better determine what play mode should be used.
  637.  
  638. 5. Can I play a file from the command line?
  639. A. MIDI DB only plays files stored in its database.  Data is stored in
  640.    compressed form, in one single database.  For a command line version,
  641.    tMidi (last version 2.99) can be used.  You can find this at most
  642.    OS/2 sites.
  643.  
  644. 6. Is there a Win32 version planned?
  645. A. If you would like a MIDI player than works in Windows, you may find
  646.    MidiBase to meet your requirements: http://home.pi.net/~dnote/software/,
  647.    for now.  If not, wait a while...
  648.  
  649. 7. What kind of support is available to those just evaluating MIDI DB?
  650. A. Basic installation -- enough to get the driver(s) installed, but no
  651.    technical support is available except to those that have registered.
  652.  
  653. 8. How long is a registration good for?
  654. A. Support is available for the product for 1 year from the date of
  655.    purchase.  After 1 year, free support for the product expires, but
  656.    you may, of course, continue to use the version you have.  Free
  657.    in-version (1.x) updates are available from the web or BBS free of
  658.    charge.
  659.  
  660.    Each registration is valid for use on one computer only.  If you
  661.    have more than one computer on which you have put MIDI DB, you need
  662.    to buy a separate copy for each.
  663.  
  664.  
  665. 9. Why doesn't any song play longer than its first minute?
  666. A. See #1, above.
  667.  
  668.  
  669. ---------------------------------------------------------------------
  670. License Agreement
  671. ---------------------------------------------------------------------
  672.  
  673.  Before using this software you must agree to the following:
  674.  
  675.     1. You are required to have one MIDI DB license per computer that
  676.        has MIDI DB installed.
  677.  
  678.     2. MIDI DB is owned by the author, Cornel Huth, and is protected by
  679.        United States copyright laws and international treaty provisions.  
  680.        You are not permitted to make copies of this software except for 
  681.        archival purposes. 
  682.  
  683.     3. You may not rent or lease MIDI DB. You may not transfer this
  684.        license without the written permission of the author.  If this 
  685.        software is an update or upgrade, you may not sell or give away 
  686.        previous versions. 
  687.  
  688.     4. You may not reverse engineer, decompile, or disassemble this
  689.        software if the intent or result is to alter the software. 
  690.  
  691.     5. There are no expressed or implied warranties with this software.
  692.  
  693.     6. All liabilities in the use of this software rest with the user.
  694.  
  695.     7. U.S. Government Restricted Rights.  This software is provided
  696.        with restricted rights.  Use, duplication, or disclosure by the 
  697.        Government is subject to restrictions as set forth in 
  698.        subparagraph (c)(1)(ii) of the Rights in Technical Data and 
  699.        Computer Software clause at 52.227-7013. The software is 
  700.        owned by Cornel Huth/6402 Ingram Rd/San Antonio Texas 
  701.        78238/USA.  This agreement is governed by the laws of the 
  702.        Great State of Texas, the United States of America, and all other 
  703.        countries of Earth. 
  704.   
  705.  Any questions concerning this License Agreement should be directed
  706.  to Product Support.
  707.  
  708.  Failure to comply with any part of this License Agreement may result
  709.  in license revocation.
  710. <end>
  711.