Fingering Diagram Builder, version 0.82

Half-holes on the Fingering Diagram Builder aren’t a new feature, but I get lots of questions about how to do them, so here are some instructions I can refer people to.

Easiest way

If you’re making diagrams for flute, (French) clarinet, (German) bassoon, or recorder, and you don’t need anything especially complicated, you can open the “Keywork details” menu and click the option to turn “Half-holes” to “Upper,” “Lower,” or “Off.” For flute the options are a little different, to allow for half-holing in four directions.

Once your desired half-holes are enabled, you can hover your mouse over the keys (or look for the grey outlines on a touchscreen device) to see them. Click/tap on the desired half of the hole to “close” it, or again to re-open it. The “open” ones will not appear in your downloaded image.

	clarinet	bassoon	recorder
upper
lower

	flute
Lengthwise upper
Lengthwise lower
Widthwise proximal
Widthwise distal

More complicated but flexible way

If you need to turn on only certain half-holes, or mix upper with lower, etc., you will have to roll up your sleeves a bit more. Open the “Keywork details” menu and look for the top-level “Half-holes” heading. Organized beneath this you will see all the available half-holes, organized into groups like “Lower half holes.” I suggest adjusting the settings as follows:

• “Half-holes” = Always
• Each subgroup containing a desired half-hole, such as “Lower half holes” = Always
• Each desired individual half-hole = “As needed”
• Each undesired individual half-hole = “Never”

That will make the desired half-holes visible when you “close” them, and invisible otherwise.

In the following example, I have set the clarinet’s left hand first finger upper hole and the left hand third finger lower hole as described.

If you anticipate using a certain half-hole configuration frequently, you can save it for future use. Set the half-holes (and other keywork) up how you want it, open the “Keywork details” menu, and look near the bottom of it for the “Custom key sets” submenu. Open that, type a name for your current set of keys, and click/tap “Add.”

Enjoy!

The most recent release of the Fingering Diagram Builder introduces some “shortcut” controls that make it easy to turn certain keys on and off. For example, with a quick check/un-check of a box you can turn on clarinet half-holes or some non-standard keys.

Or, as always, there’s a dropdown list of “key sets” (which I referred to as “presets” in previous FDB versions) to turn on and off the right keys for a complete instrument variant.

“Bass clarinet, pro,” for example, turns on (among other things) the right thumb keys down to low C found on many professional bass clarinets. “Standard Boehm” turns them off.

All of these menu controls work by changing the behavior of the keys present in the instrument diagram. The behavior of each key, or group of keys, can be set to “Always,” “Never,” or “As needed.”

If you have a specific set of keys in mind, you can set the behavior of each key directly. Let’s say I have a fancy new oboe with a left-hand “long” C-sharp key and a left thumb low B key, and I want to make a fingering chart to map out some of the new fingering possibilities. (There’s currently an easy check-box for the left C-sharp, but we’ll ignore that for now to explore the hands-on method.)

I’ll start with the thumb B key. If I open the “Keywork details” section of the menu, and then the “More keywork details” section, I see a long list, partially pictured here.

The last key in the picture is the key I want to use in my fingering chart. Before we go on, notice that its name is aligned all the way to the left, meaning that it is a stand-alone key, not part of a group of keys. A little above it you can see the name “Thumb octave keys,” with four keys below it and indented. “Thumb octave keys” is a group, and the keys listed below it (“First octave key,” etc.) are in that group.

Okay. “Left thumb low B” is currently set to “Never,” which is pretty self-explanatory: the key simply never appears in the diagram.

Setting it to “Always” is also clear enough: the key will be visible all the time, pressed or not. If I set it to “Always” and don’t press any of the oboe keys, here’s what the diagram looks like:

Visible in this image are the six “main” keys, with a little horizontal line visually separating the left hand from the right hand, plus the thumb low B key. All of these are now set to “Always.” The other keys—the octave keys, the little finger keys, etc., are not visible. This particular layout is probably not what I want. Some people like every available key (including the octave keys, etc.) to be visible in every image, but I prefer and recommend showing only the most relevant ones for the particular fingering. The left low B will only be relevant for a specific note or two.

So let’s set that key to “as needed” instead. Since this key isn’t part of a larger group, its “as needed” behavior is easy to understand. When it’s pressed, it appears in the image. When it’s not, it doesn’t. I will still be able to see where the key is while I’m using the FDB, because it will appear in gray outline when I hover over the diagram with my mouse or trackpad, or appear constantly if I’m using a touch device, but it won’t be part of the downloaded image.

If I set it to “As needed” and hover my mouse pointer over the diagram in the FDB, I see this, with the left low B present:

And if I download the image, I see this:

Now let’s turn to the left C-sharp key. Since it is part of a group (“Left little finger keys”) its behavior is a little more complex. Here’s what the group’s behavior settings look like for the “Conservatory” key set:

Several of the keys are set to “Always,” and several are set to “Never.” But the group itself is set to “As needed.” Here’s how that works: if none of those keys is pressed, the FDB determines the group is not “needed,” so none of the keys are visible. But if any of the “Always” keys is pressed, the FDB considers the group needed and makes it visible, including all the “Always” keys within it. (The “Never” keys are still not visible.) So, for example, if I press the “Left E-flat,” I get this:

Only the left E-flat is pressed, but the other keys in the group appear too, to give a little visual context.

So, to make the left C-sharp available, I will set it to “Always.” But when an oboe has a left C-sharp, the left F-key usually gets moved over a little and has a little different shape. So I’m also going to set “Left F” to “Never,” and “Left F (with low C-sharp),” a key designed for this situation, to “Always.” Now I have this (low C-sharp in red, altered left F in yellow):

By setting the behavior of individual keys, you can do just about any combination of keys you can think of. And you can use the “Custom key sets” menu to save your settings for future use.

This system also makes it relatively easy for me to add obscure or unusual keys to the diagrams, and keep them hidden except when people need them for specific purposes. So, if there are keys you would like to have in your images, and you didn’t find them in the “More keywork details” list, let me know and I’ll consider adding them in future versions. It’s extra-helpful if you can send good photos.

Enjoy!