Revised (shortened) _smfkr11 documentation with additions for _smfkr23.exe
10-31-98    New _smfkr23.exe features are at the end.  DO NOT DISTRIBUTE!!!

*************************************************************************
Older _smfkr11 and all after... (previous text)

Several keys (HotKeys) have been changed, and others added.  Some
of the changes show in the NEW HotKeys Help menu item.  These are as
follows:

E used to be Transpose, and is now Midi Editor Screen.  (E for Edit!)
T used to be PlayList dialog, is now Transpose.         (T for Transpose!)
P used to call Midi Control Panel, is now the PlayList. (P for PlayList!)
S used to change SYSEX output limit, is now Save As...  (S for Save As...)

None of the following HotKeys show up in any Help yet.  This is your only
listing until proper docs are created!!

? You can now enable Drum Notes with the "/?" key on the keyboard.
  This was added so I could see what was being played on midi's with
  multiple Drum Parts (channels).  By default the Drum Part was hidden
  as far a Piano Notes playing or Note Activity on the Editor Screen.
  Normally these just clutter the Piano Note display, but sometimes it
  is useful to see them.  It is a toggle, press again to hide drums.
  You must restart song to see effect of a change or wait til the player
  reaches the point in time where the drum notes are saved for display.

  The program now displays all Drum Parts by analysing the SYSEX messages
  which do this for Roland products.  This also prevents transposing of
  Drum Parts wherever they are.  The Voice Names which are drum 'Kits'
  that show up on channels other than 10 are setup with SYSEX messages.
  Most of the midi's with extra drum parts are Roland's or other
  professional files.  Channel 11 is most often used as 2nd Drum Part,
  but I have files with up to 8 Drum Parts set on different channels!

New HotKey for Midi Control Panel is the F9 function key if needed, but
easiest access is by Left Clicking the Piano Voice Boxes or the Editor
Display Channel Rows.  This opens Midi Control Panel on the desired chan.

New function keys:   (This again, is the only listing of these!!!)

F1=My Simple Help          F2=HotKeys Help (Doesn't include all keys yet)
F3=Slowest Tempo (10)      F4=Fastest Tempo (250)  (Home Key=Resume Tempo)
F5=Toggle Automute         F6=Force Automute       ("X" key is same as F5)
F7=Show About Dialog       F8=Alternate for Export Lyrics   (Y is std key)
F9=Call Midi Control Panel (Left-Click Piano or Editor area for channel).

Home Key:    Resume Original Tempo (if changed with F3, F4, or Arrows).
End Key:     Stop Playing and disable CUE and END Points if active.
Arrow Keys:  Up/Down - change the Tempo in steps of Ten (10).
             Left/Right - change the Tempo in single steps.

Page Up:     Open any _00INDEX.TXT file into Notepad from current directory.
Page Down:   Call up Dialog to set END Point (or LOOP End).
             Left-Click BBC display to call up set CUE Point Dialog.

Yes!  You can now change Tempos with the keyboard.  When Tempos occur
in a song, they will override your changes, but if only a starting Tempo
is in the file, then you have free reign!  The keys repeat, so don't hold
them unless you want the repeat action.  As above, L-R Arrows change value
by one, Up-Dn Arrows by ten, "Home" Resumes last real Tempo, and F3/F4 set
the Slowest/Fastest Tempo possible (10/250 BPM).  L-R Clicking the Tempo
display still changes value by one in either direction.

**************************************************************************

After placing this version in "My" directory, for access to all the
regular support files, it can be started as you would any other version.
I wouldn't erase other versions until the program is finished.  There
could be undiscovered bugs and I wouldn't want you to lose that which
works OK.

Once running with your favorite song, you can press the E key for Edit
Screen.  If the song happens to be Karaoke, this still displays below
the Editor area.  Of course if you press the W key for Full Screen Lyrics
display, I have not yet disabled you from doing this, and the effects
will not be what is desired at this point, but no harm will be done.
You can Toggle the E key to switch screen displays as often as you like.

New features for _smfkr11.exe

1. Midi Device Select is in Misc menu now so .ini file doesn't need
   editting to change the device.
2. Program remembers the last file and its directory and plays it
   when started, unless a file is passed to it on its command line.
3. If the item "exitmess=" is added to your .ini file, and is set
   to 1 (one) "exitmess=1", the program will ask if you wish to
   quit whenever an attempt is made via close box, menu item, or
   ESC key.  When set to zero "exitmess=0" this is disabled and you
   have the original quick exit.  Don't include the quotes in the
   .ini file entry!  Nothing in the program writes this value for
   you, you must set the value and save the file ONLY with NOTEPAD!
4. The program tries to remember its window position and size if it
   is not MAXIMIZED (without a sizing border).  This may help those
   who are fighting Win95 task bar and have plenty of room for lyrics
   under the keyboards.  Simply 'moving' the window with its Caption
   Bar will not update the position.  You must use the sizing borders.

New features for _smfkr23.exe  10-31-98

1. Start of a midi and karaoke song title editor.  No editting yet, but
   allows viewing all the text in a midi file.  Only the "Forget Changes"
   button works and is the default (you can press Enter or Space Bar).
   It simply exits the dialog.  To call the dialog for any file loaded
   press the "2" key.  There is a scrollable listbox at the top with
   the text from the file and the track it is found on.  Useful for
   checking copyrights, who might have created the file, song titles
   on other than track one (where they belong), etc.  Later will finish
   and the dialog will be used to enter, edit, or view songtitle info.

2. If you have a song Transposed, and you save that song, the program will
   actually convert the file in memory to the transposed notes and then
   save it!!!  Watch out!!!  The transpose dialog called with the T key
   will now show zero for the transpose, instead of any value you had
   displayed.  This is because the file in memory is now actually transposed.

3. This version includes the ability to convert between the two commercial
   standards for midi karaoke files.  The files do not have to be karaoke,
   and the conversion will still work.  The conversion is between midi
   format 0 and format 1 and visa versa.  Format 0 is a file with only one
   track of data.  This track contains all notes, text, controllers, all
   midi channels, etc.  Format 1 is a multiple track file (much like a
   multi-track tape recorder).  Normally track one has only text, and
   conductor events like tempo and meter changes.  The other tracks are
   usually assigned a different midi channel (part) for each and this
   makes editting a file easier.  In a format 1 karaoke file, the lyrics
   are on their own private track, whereas in a format 0 (one track) they
   are embedded in the one track.  Both karaoke formats are different and
   use different midi text events and control characters.  This program
   version can convert back and forth between the two formats.

   One reason for converting a format 0 midi to a format 1 is so that lyrics
   can be added by any of the popular karaoke programs.  None of them that
   I am aware of will add lyrics to a format 0 file.  It must be a multiple
   track file with the melody on one of the tracks.  This then is a reason
   for converting from format 0 to format 1.  The reason for going the
   other direction (format 1 to format 0) is that many commercial keyboards
   have LCD lyrics displays now, and they seem to only want format 0 karaoke
   files, as does my Roland Arranger.  They will not recognize the lyrics
   in a format 1 file.

   The functions for converting the file in memory are called by pressing
   the "0" (zero) or the "1" (one) key.  Zero will convert from format 1 to
   format 0.  One will convert from format 0 to format 1.  The key label is
   the direction you are going (not coming from).  Of course the file has
   to be in the correct format you are leaving!!  It will not do that which
   is illogical and try to convert a format 0 to a format 0!!

   When it is expanding a format 0 (one track) to format 1 (many tracks),
   it will scan for used midi channels and create tracks as necessary.
   This can be watched in the display below the keyboards as the tracks
   count up.  Note: format 1 files are usually shorter in length (bytes)
   than format 0.  This is because a midi feature can be used which stores
   the data more efficiently and can leave out redundant "status" bytes.
   This feature is called "running status" and the program does implement
   full "running status" on format 1 files.  It does so on format 0 as
   well, but because channels keep changing in the one track, each change
   means a status byte which the format 1 does not require.

Summary:

"0" = convert from format 1 to format 0 (midi or karaoke file)
"1" = convert from format 0 to format 1 type file
"2" = call Song Title editor and midi file text displayer.
      (only useful for viewing currently)
"T" = Transpose.  If a transposed song is SAVED, it WILL BE saved as
      it is transposed and the file in memory will be changed/altered.

PLEASE DO NOT DISTRIBUTE THIS VERSION TO ANYONE, ANYWHERE, ANYTIME!!

THANKS!!

Mark
