Table of Contents:
Installation
Introduction
Getting started
Editing .HDS song files
Midi channels
Fretboard map
Hammered dulcimer map
General performance tips
Checking timing and tempo performance
How to convert an .HDS file to a .mid file
Midi instrument choice
Contact and program history
This is a Visual Basic program. Visual Basic programs require that certain files be present in the user's Windows\System directory for them to run properly. These are called 'Run Time' files. In most cases, these files are already present on the user's system, and so no further action is necessary. In a very few cases, however, some users may find that they cannot run this program on their system, and may receive one of various error messages if they try to do so. This is caused by the fact that either these files are *not* present on their system, or, the files are there, but the version #'s are old. This can be solved by downloading and installing the latest 'Run Time' files from Microsoft (currently at Service Pack 5), at: http://www.microsoft.com/downloads/release.asp?releaseid=28337. It's not a large download.
This program does several things:
This program was inspired by HDMapper (link above), written by Pete Royston & Carl Hungerford
This program includes example code found at http://www.codeguru.com/vb/gen/vb_multimedia/article.php/c1095/
Differences between this program and HDMapper:
Most selections that you make, are saved to a file named Application.ini so that they are restored when you next run the program.
When you run the program, you first have to click the 'Sound' menu, then 'Select ports', and open the midi port(s). Most users will want to pick the 'Midi Out w/mouse...' option. The other options are for advanced users. Anytime that you want the program to release the ports to another application, pick the 'All ports close' option.
When you play notes, if you don't hear anything, double click the small speaker icon in your system tray, which opens up Volume control, and make sure that the Midi isn't muted.
These use the same syntax as HDMapper:
At the top of the .hds file, is the [Song] header section, which looks like this:
[Song]
Name=Oh Susanna
Beats Per Measure=4 (incorrectly listed as 'Beats per Min' in HDMapper's docs).
Single Beat Note=4
Pace=120 (this specifies the tempo, that is, how many of the 'Single Beat Notes' would be played per minute).
After the [Song] section, is the [Notes] section. In the [Notes] section, the syntax is [Duration] [Note] [# or b] [+ or -] [Bridge #]:
Starting with MidiMapper version 5.0, the PolyDur extension was added. This gives the ability to make more flexible .hds song files. Here are what you can add:
Here is the order that must be followed for repeat sections:
[Repeat Xx]
...
[Ending 1]
...
[Repeat End]
[Ending 2] (The last alternate ending can be either before or after the [Repeat End] line)
...etc.
For an example of how these are entered, see the included song 'Bridge Over Troubled Water.hds'.
How to make a song repeat and fade at the end of the song: See Both Sides Now.hds and Windy.hds for examples of how to do this.
The PolyDur enhancement makes it possible to enter most, if not all, western music exactly as it appears in the original score. Bridge over Troubled Water, Desperado, and most of the other included samples were entered exactly from the original composer's scores.
Starting w/version 6.0, a new function was added which makes it really easy to edit PolyDur syntax files. Click the 'Edit Polydur song' under the 'Edit' menu to access this. Using this function, I created Joni Mitchell's song 'Both Sides Now' in about an hour, and included it in the package as 'Both Sides Now.hds'. This screen allows editing of songs with 2 to 12 note polyphony.
Polydur format songs can use up to 16 voices, each sent to a separate midi channel; a different instrument can be assigned to each. To set the instrument, velocity on and off for each channel, click the channel settings frame with the left or right mouse button. The default is that if you left-click, the channel # will decrease, right will increase, but you can swap this behavior by changing the 'ChannelClickIncrease' setting in Application.ini. Close the program first before editing Application.ini, then start the program again to use the new setting.
To change the instrument #, velocity on and off, type in the number and press enter, or use the up-down arrows, or click the frame to change to a different channel.
When clicking the piano keyboard with the mouse or playing an .hds song, the Note ON velocity is multiplied by the current, or default Dynamic before playing each note (Dynamics can also be coded to change while a song is playing, see how to do this in the previous section). You can change the default Dynamic from the 'Sound' menu. When you select that, you'll see something like this:
The image shows that my default dynamic is Mezzo-forte. The multipliers on the right are defined in Application.ini. These are configurable by first closing the program, then opening Application.ini in Notepad and changing them:
The default settings are Note ON velocity of 90 for all channels, and Mezzo-forte as the default dynamic, in keeping with the convention that, if no Dynamic is specified in sheet music, that Mezzo-forte should be used. Here are the default multipliers in Application.ini:
DynFactorPP=0.53
DynFactorP=.7
DynFactorMP=.85
DynFactorMF=1
DynFactorF=1.13
DynFactorFF=1.28
If you have small speakers, those might create too harsh a sound. If so, you can reduce them, or set them all equal to 1 (which would apply no factor at all), or reduce the Note ON velocity settings. After changing and saving Application.ini, restart the program to use the new values.
Some feel that this method of changing the dynamic by varying the Note ON velocity, works best for percussive instruments, such as piano and guitar, but that entering channel volume or expression changes instead, using raw midi commands (see #17 above), works better for wind or other instruments. Experiment to see what you like best.
If the stereo balance, volume, or other music qualities don't sound right, try 'Reset midi controllers' from the 'Sound' menu to reset them to defaults. If instruments don't sound correct, try 'Send GM reset' which resets the instrument #'s to the General Midi specifications. The instruments might have changed if you played a .mid file in another program, then came back and tried to play a song in MidiMapper.
Flanging occurs when 2 or more voices (channels), playing the same instrument, play the same note and same octave simultaneously. You should avoid this generally, because it sometimes results in a muted sound, caused by the harmonics of the notes overriding or cancelling each other.
Let's say that you want to mute the high voice because you want to play that part on your violin instead, as the song plays. There is a function in Windows that allows you to route each of the 16 channels to either your soundcard, an external instrument, or to 'None'. This function is called 'Midi Mapper', which is the same name as this program but that's just a coincidence. To access this function, click 'Start', 'Settings', 'Control panel', 'Multimedia'. Then, click the 'Midi' tab, then select 'Custom configuration', then 'Configure'. Once you have made your changes, then, in this program, MidiMapper, click the 'Sound' menu, then 'Select midi ports', then change the output to Windows' 'Midi Mapper' driver to hear the results.
If you just want to mute one channel temporarily, it might be easier just to enter a channel volume of 0 in the .hds file for that channel. To do that for channel 1, would be '[Midi &hB0 7 0]'.
This is usually only a problem for older sound cards. From Creative Labs:
"MIDI devices use a system of Channel Priorities 1 through to 16 with the Percussion Channel 10 getting the highest. The channels with the higher priority may cause the channels with lower priority to drop notes if the polyphony that is supported by the midi module is exceeded. Therefore, it is recommended to allocate the solo instruments to the lower channels and strings and piano to the higher channels."
If you have a problem with clipped/dropped notes, you might be able to solve it by adjusting the Note OFF/ON delay, which is an option under the 'Sound' menu. See more about this here.
Version 3.0 adds a guitar fretboard. You can also make other fretboards, for instance, for banjo, mandolin, and mountain dulcimer, or similar non-fretted instruments like violins. I've only created the guitar fretboard because I don't play those others. I'd like to add those others to the package, so, if you make one, please send it to me, and I'll put it in the package along with credit information. It's easier than it looks, by the way:
To make a new fretboard map:
Shortcuts:
Once you've defined the first Top= position for a string, you can of course copy that to all the other notes for that string and just change the Left= and Key= for each.
Once you've defined the notes for one string, you can probably copy the whole block to the next string and just change the Top= and Key= for each note, etc.
It only took me about 45 minutes to make the Guitar fretboard map.
See the HDMapper documentation for more about making .dlc files, because .frt files use the same syntax.
If you maximize the window to at least 1024x768, you can load a hammered dulcimer image map, similar to HDMapper. The fretboard map will disappear to make room. Making a hammered dulcimer map is similar to the docs in HDMapper and the fretboard instructions above. Additionally, just as for the fretboard, you can right click on the image to get cursor coordinates to make it easier to add notes to the .dlc file. The hammered dulcimer image shouldn't exceed 518 pixels in width and 367 pixels in height.
Program Issue: This program doesn't correctly determine, for a given note, whether the left or right hammer should be used. If you want to see the correct hammer choices when playing .hds files, use HDMapper. The main benefit of loading the hammered dulcimer in *this* program, is that you can more easily make a new .dlc file using the right-click function mentioned above. If you have an idea about how I can add an algorithm so that my program can make the correct hammer choices for notes, let me know.
For slow computers especially, the most precise note timing can be accomplished by unchecking the 'Highlight each note as it plays' and 'Show animation' checkboxes. Also, just like any other media player, you may notice a pause if another program in the background causes a 'system' event, like checking mail, instant messages, and calendar programs. So, it's best to keep those to a minimum.
If you select 'Calculate lag statistics' under the 'Performance' menu, then, after each time you play a Polydur .HDS song, a small window will appear that will tell you 'Actual song time', 'Predicted time' and some lag statistics. The first figure will probably always be a few seconds longer than the second, because it also includes the extra time caused by sending several extra messages to the midi device, which I was unable to estimate and add to the 2nd figure. The other statistics measure the approximate time, in milliseconds, from when one note for a finger/hammer starts to end til just after the next has started to play.
If you want to reduce lag, you should close other programs that are running; however, you may instead want to increase lag. To do this, and understand why you might want to increase it, click the 'Note OFF/ON delay' option under the 'Sound' menu. Lately, I've been setting the Note OFF delay to 0 when playing .hds songs in MidiMapper (which already induces a small amount of lag anyway), but setting it to 1 when recording to a .mid file in silent mode (which otherwise induces no lag). You also might find that you can create a 'gospel' feel to a song by adding some lag. Experiment with this to see what you like.
The longest lag that was detected and the line in the listbox that caused it, and the average for all notes, is displayed.
Consider that, if the song tempo is 120 quarter notes per minute, then each whole note takes 2 seconds, each 1/32 note around 62 milliseconds, and each 1/64th note around 31, etc. So, lags below that are probably undetectable.
After you're satisfied with the timing, you might want to de-select this option because using it also adds a small amount of lag.
There is a new 'Save as .mid file' option under the 'File' menu to do this. Previously, you had to install a midi loopback device driver and use an external sequencer, but not any longer. Just click the option and follow the prompts. If you'd like to edit the newly made .mid file further, including adding more tracks, changing tempo, or adding notes or information, I've also written a midi sequencer/recorder available here: members.fortunecity.com/whb11/Midi/MyMidiSequencer.htm Important: Version 1.6 of my sequencer has some important fixes, so if you have an earlier version, you should upgrade. On that page also is a really nice audio player to test your new .mid files, and play any other audio files also.
Key sig changes in the .hds song, entered like '[Key sig=G]', Time sig changes, entered like '[Time 4/4]', and score marker notes, entered like '[Score marker A]', are saved to Track 1 of the .mid file.
For the most accurate note timing, also follow the recommendations starting under 'Performance tips' above before recording.
Note: I acquired the internal .mid recording module from another company and it has a couple anomalies:
What's happening in both cases is that the module is locking the files and not releasing them until you exit, but, as I don't have the source code for the module, I can't change that. But, it's a minor inconvenience.
If you need further help, ask me.
You can select your choice of instruments, however, the instrument selection and sound quality is up to your soundcard. These are the General Midi specifications which nearly all devices use, but consult your device's user manual to make sure:
| PIANO | CHROMATIC PERCUSSION |
| 1 Acoustic Grand | 9 Celesta |
| 2 Bright Acoustic | 10 Glockenspiel |
| 3 Electric Grand | 11 Music Box |
| 4 Honky-Tonk | 12 Vibraphone |
| 5 Electric Piano 1 | 13 Marimba |
| 6 Electric Piano 2 | 14 Xylophone |
| 7 Harpsichord | 15 Tubular Bells |
| 8 Clavinet | 16 Dulcimer |
| ORGAN | GUITAR |
| 17 Drawbar Organ | 25 Nylon String Guitar |
| 18 Percussive Organ | 26 Steel String Guitar |
| 19 Rock Organ | 27 Electric Jazz Guitar |
| 20 Church Organ | 28 Electric Clean Guitar |
| 21 Reed Organ | 29 Electric Muted Guitar |
| 22 Accordian | 30 Overdriven Guitar |
| 23 Harmonica | 31 Distortion Guitar |
| 24 Tango Accordian | 32 Guitar Harmonics |
| BASS | SOLO STRINGS |
| 33 Acoustic Bass | 41 Violin |
| 34 Electric Bass(finger) | 42 Viola |
| 35 Electric Bass(pick) | 43 Cello |
| 36 Fretless Bass | 44 Contrabass |
| 37 Slap Bass 1 | 45 Tremolo Strings |
| 38 Slap Bass 2 | 46 Pizzicato Strings |
| 39 Synth Bass 1 | 47 Orchestral Strings |
| 40 Synth Bass 2 | 48 Timpani |
| ENSEMBLE | BRASS |
| 49 String Ensemble 1 | 57 Trumpet |
| 50 String Ensemble 2 | 58 Trombone |
| 51 SynthStrings 1 | 59 Tuba |
| 52 SynthStrings 2 | 60 Muted Trumpet |
| 53 Choir Aahs | 61 French Horn |
| 54 Voice Oohs | 62 Brass Section |
| 55 Synth Voice | 63 SynthBrass 1 |
| 56 Orchestra Hit | 64 SynthBrass 2 |
| REED | PIPE |
| 65 Soprano Sax | 73 Piccolo |
| 66 Alto Sax | 74 Flute |
| 67 Tenor Sax | 75 Recorder |
| 68 Baritone Sax | 76 Pan Flute |
| 69 Oboe | 77 Blown Bottle |
| 70 English Horn | 78 Skakuhachi |
| 71 Bassoon | 79 Whistle |
| 72 Clarinet | 80 Ocarina |
| SYNTH LEAD | SYNTH PAD |
| 81 Lead 1 (square) | 89 Pad 1 (new age) |
| 82 Lead 2 (sawtooth) | 90 Pad 2 (warm) |
| 83 Lead 3 (calliope) | 91 Pad 3 (polysynth) |
| 84 Lead 4 (chiff) | 92 Pad 4 (choir) |
| 85 Lead 5 (charang) | 93 Pad 5 (bowed) |
| 86 Lead 6 (voice) | 94 Pad 6 (metallic) |
| 87 Lead 7 (fifths) | 95 Pad 7 (halo) |
| 88 Lead 8 (bass+lead) | 96 Pad 8 (sweep) |
| SYNTH EFFECTS | ETHNIC |
| 97 FX 1 (rain) | 105 Sitar |
| 98 FX 2 (soundtrack) | 106 Banjo |
| 99 FX 3 (crystal) | 107 Shamisen |
| 100 FX 4 (atmosphere) | 108 Koto |
| 101 FX 5 (brightness) | 109 Kalimba |
| 102 FX 6 (goblins) | 110 Bagpipe |
| 103 FX 7 (echoes) | 111 Fiddle |
| 104 FX 8 (sci-fi) | 112 Shanai |
| PERCUSSIVE | SOUND EFFECTS |
| 113 Tinkle Bell | 121 Guitar Fret Noise |
| 114 Agogo | 122 Breath Noise |
| 115 Steel Drums | 123 Seashore |
| 116 Woodblock | 124 Bird Tweet |
| 117 Taiko Drum | 125 Telephone Ring |
| 118 Melodic Tom | 126 Helicopter |
| 119 Synth Drum | 127 Applause |
| 120 Reverse Cymbal | 128 Gunshot |
Send feedback to: baldwinwh (at) netscape (dot) net
thanks
Web site: http://members.fortunecity.com/whb11/Midi/MyMidiPlayer.htm
You should check the website periodically for new versions and also new .hds songs.
Credit: Inspiration, and the .dlc, .hds, and .bmp files from HDMapper.