
        MUSIC-X MIDI-CONVERTER special for NON General MIDI keyboards:
        Assembly version 2.0  14 July 1993  by C.Soeters with DEVPAC3.
        ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

 Note:
 ~~~~~
 This version of MIDIConvert needs Kickstart 2.0 or higher and the
 reqtools.library for the requesters. In this archive are available:

    s (dir)
      Music-X_Conv2.cfg       ; Default configuration-file (PSS79x)
    libs (dir)
      reqtools.library        ; Copy this library to your sys:libs
 GM-DRUM.TXT                  ; General MIDI Drummap reference doc
 GM-PRG_1.TXT                 ; General MIDI Program reference doc1
 GM-PRG_2.TXT                 ; General MIDI Program reference doc2
 MIDIConvert.TXT              ; The doc. you are reading now
 MIDIConvert20                ; The binary MIDIConvert V2.0 file


 General:
 ~~~~~~~~
 The conversion utility delivered with the package MUSIC-X V1.0-V1.1
 will convert Standard MIDI files to Performance files and back. But
 if these Standard MIDI files (.mid) contain percussion tracks, it
 is an awfull job to convert them for use with your NON-General-MIDI
 keyboard (selecting and changing the data), it costs a lot of time!
 Mostly the sequences / tracks for midichannel 10 or 16 are used for
 percussion/drum patterns.  With Music-X you can take a quick look at
 the performance file, checking which midichannels are used for per-
 cussion/drum data. After that this program can convert your tracks
 for use with your keyboard. In this version it's also possible to
 convert the programchange-events.  So all you have to do now is to
 read this doc.file carefully and check your synth's manual, to make
 a configurationfile (see below) for the best conversion capabilities.

 The config.file:
 ~~~~~~~~~~~~~~~~
 Before starting this program, you have to make your own configuration
 file which MUST be placed in the s: drawer of your booting device.
 The default configuration-file MUST be named:  Music-X_conv2.cfg and
 you can make more than one config.file, which may have an own name,
 but with an .cfg extension;  The above mentioned name is the default,
 which will be loaded automatically at initial start of this program.

 This configuration-file consists of several parameters / tables which
 will be used to convert the programchange-events and percussion-data
 of the Music-X tracks. For General-MIDI the key-values for the drummap
 are normally 27-87 (dec.), but values from 0-127 can be used and for
 the programchange table, values of the instruments are 01-128 decimal.
 Take a look in your Keyboard-manual for the values needed for this!
 An example configuration-file is available, there is a lot of infor-
 mation stored in remarks, see below. Comment-lines must start with a
 '*'=asterix. The example configuration-file is made for the YAMAHA
 PSS keyboards: PSS790 & PSS795 and with a little modification, it can
 be used for the PSS480, 580 and 780 as well.


 EXAMPLE CONFIGURATION-FILE  s:Music-X_conv2.cfg
 ~~~~~~~~~~~~~~~~~~~~~~~~~~
 * Music-X MIDI converter V2 config. 07-1993
 * >> GENERAL MIDI to YAMAHA PSS 79x <<
 * COMMENT-lines must start with an asterix!
 * 1-st para: default inputpath files-requester
 RAM:
 * 2-nd para: default outputpath files-requester
 RAM:
 * 3-th para: default files extension mask
 (#?.Seq|#?.Perf)
 * 4-th para: extra extention patched files
 pch
 * 5-th para: midichannel-flags  (0=off  1=on)
 *<---drummap----><programchanges>
 *         1111111         1111111
 *12345678901234561234567890123456
  00000000010000011111111110111110
 * 6-th para: PERCUSSION-conversiontable (00-127)
 * number separation by commas
 * 00-09 PERCUSSION KEY VALUE
 00,00,00,00,00,00,00,00,00,00
 * 10-19
 00,00,00,00,00,00,00,00,00,00
 * 20-29
 00,00,00,00,00,00,00,46,36,79
 * 30-39
 79,72,58,72,55,45,44,71,49,54
 * 40-49
 52,48,57,48,80,50,59,50,53,60
 * 50-59
 53,62,63,62,71,61,55,60,36,63
 * 60-69
 68,67,66,65,64,69,70,75,74,56
 * 70-79
 71,78,78,56,56,72,73,72,76,77
 * 80-89
 37,39,56,39,71,72,37,39,00,00
 * 90-99
 00,00,00,00,00,00,00,00,00,00
 * 100-109
 00,00,00,00,00,00,00,00,00,00
 * 110-119
 00,00,00,00,00,00,00,00,00,00
 * 120-127 LAST PERCUSSION KEYS
 00,00,00,00,00,00,00,00
 * 7-th para: MIDI-PROGRAM conversiontable (01-128)
 * Number separation by commas.
 * 01-10 MIDI-PROGRAMS NUMBERS
 04,04,04,26,06,55,05,31,07,33
 * 11-20
 25,08,09,60,08,09,02,28,29,03
 * 21-30
 50,32,23,102,73,34,13,69,71,70
 * 31-40
 14,122,39,15,80,81,40,40,59,87
 * 41-50
 68,11,12,36,11,66,38,67,42,42
 * 51-60
 52,110,97,95,96,91,16,17,85,45
 * 61-70
 18,93,01,83,102,19,103,103,22,88
 * 71-80
 22,20,104,21,89,48,113,112,92,89
 * 81-90
 100,109,114,61,118,96,122,39,65,08
 * 91-100
 96,65,110,60,09,08,33,96,33,96
 * 101-110
 96,96,96,65,37,35,37,74,35,22
 * 111-120
 11,35,25,67,10,67,67,67,67,67
 * 121-128 LAST MIDI-PROGRAM NUMBERS
 100,100,100,100,100,126,127,100
 * 8-th para: RESERVED

 --------------------------------------------------------------------


 Working with 'MIDI-Convert2.0':  (Short explanation)
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

-- GET (configuration file) gadget:
 When the program is started initially, the default configuration-
 file will be loaded automatically (s:Music-X_convert2.cfg). This
 may be your own config.file. There may be more config.files with
 their own names (the extension must be .cfg) which you can choose
 from. By pressing the 'GET' configurationfile gadget, a requester
 will appear showing the available config.files.  Select a config-
 file (the selected file will be highlighted) and press OK, or after
 doubleclicking the file, it will be loaded and the program will be
 set accordingly. If an error occurs when loading the file, you will
 be notified by a requester.

-- Drummap- and Programchange gadgets:
 With these gadgets you can enable or disable conversion of both
 Drummap and Program changes. (Default: both enabled, which causes
 the program to convert both, percussion-data in the selected
 Drummap midichannel(s) and Programchange-events in the selected
 Programchange midichannel(s)).

-- Drummap- and Programchange- midichannel gadgets:
 Here you can enable or disable Drummap- and Programchange midi-
 channels separately in which the program will search for the
 events to convert (default set by config.file param. 5).
 Normally for Drummap the midichannels 10 and/or 16 are used.
 The program converts only the PITCH-value in the chosen drummap
 midi-channel(s) from Music-X sequences (.Seq) or performances
 (.Perf), although this extension is not relevant the file struc-
 ture is. The Drummap pitch value will be taken from the selected
 config.file (param. 6) which is the drummap conversiontable of
 your synth. For Programchange the events will only be converted
 in the selected programchange midichannels (Default also set by
 config.file param. 5) but can be changed manually by pressing
 these switches. The Program change events will be converted in
 conformity with the config.file conversion table (param. 7).

-- SELECT gadget:
 Pressing 'SELECT' a file requester will appear, showing the files
 which match the default inputpath and mask. Modify the path if you
 wish to choose different from the default (The default input-path
 is set in the config.file param. 1). You may also change the mask
 (wildcards) and/or selecting 'ALL'. (The default mask is set in the
 config.file param. 3). The selected files will be shown highlighted.
 If you want to select manually then the SHIFT-key can be used for
 multiple file-selection. When ready selecting the file(s), press
 the OK gadget in the file requester to end the file-selection.
 The requester will then disappear.

-- GET (output path) gadget:
 Pressing 'GET' will cause the output-path requester to pop up.
 Modify the output-path if you want it different from the default,
 (The default output-path is set in the config.file param. 2) to
 notify the program where you wish to store the converted files.
 After that you can select OK in this requester. If all the needed
 conditions to convert are met, the gadget 'CONVERT' will be blank
 (enabled) and thus available to select.

-- CONVERT gadget:
 Pressing 'CONVERT' will start the conversion of the selected files.
 The progress can be followed in the Output Window.  The number of
 patches are showed for drummap and programchanges.  If there is
 nothing to patch, nothing will be written! The program checks if
 the selected files are of the correct type 'MSCX' (for Music-X)
 by reading the file header.  If they are not, they will not beeing
 converted. Further, you can continue converting, by selecting again
 files (see SELECT) or 'quitting' by pressing the close-gadget of the
 MIDI-converter window or selecting 'Quit' from the 'project' menu.


-- The 'project'-menu:
   ~~~~~~~~~~~~~~~~~~~

        1.  About        'Some programmers INFO'

        2.  Delete       'Delete files'

        3.  Quit         'End of session'


-- Music-X notes:
   ~~~~~~~~~~~~~~
 MUSIC-X uses all the memory that it can get:  This can give some
 trouble, when other programs are started and Music-X is already
 active!  Possible solutions are: Start the other programs first or
 modify the icon TOOL-TYPE 'BUFFER' of the Music-X icon. Change the
 value xxxx of BUFFER=xxxxK to correct the size of memory used by
 Music-X.  After that start Music-X again. (xxxx is dependent of the
 size of your available memory and what you will give to Music-X).
 If you want to use both: MIDI-Convert and Music-X, select 'SUSPEND'
 in the SEQUENCER-page of MUSIC-X, Now you can convert without
 troubles, when ready: Go back to Music-X and select 'RESUME'.


                                           C. Soeters  &  W. Schaaij

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~


AmiMusicians:  THERE IS NO COPYRIGHT AT ALL, USE IT WITH PLEASURE!
~~~~~~~~~~~~~        SO, CALL IT 'PLEASUREWARE' IF YOU WANT.

As long as nothing would be changed, you may use it for free!  BUT:
If you like it, please send me some of your (GM) MIDIsongs .mid / .perf

Send it to: STARLIGHT-BBS  Den Helder, Holland (+31)2230 16836
                           Baudrate 2400-14k4
Postal:     Send your midi-disk(s) and / or bug-report to (See below).

100% Assembly version 2.0 written by Cees Soeters, Den Helder (Holland)
Using Devpac3, gadtools.library and reqtools.library for the G.U.I.

We have plans to start a MIDI-USERS GROUP with BBS-base!

Program ideas, docs, support and testing by  Willem Schaaij.
Who wrote the first Basic-compiled evaluation versions (till v1.25).


16 July 1993.
                                      W. Schaaij
                                      Praamstraat 36
                                      NL-1784NG   Den Helder
                                      Holland.
