Dancing Dots
Where Music Meets Technology for the blind
imagecorner
Dancing Dots serves blind musicians and their educators through technology and training

Guidelines for Preparing Lime Files for GOODFEEL

Basic Tips

Expressions and Annotations
Annotations must be added properly. They must be attached to the proper note, the appropriate boxes must be checked and a font must be selected. This information is contained in this document and in the Lime User's Manual

Voices
When preparing Lime files for translation by GOODFEEL, please put all voices together in the same song but as separate voices. GOODFEEL will give you the option to braille only the ones you want. Also, give each part/voice a descriptive and appropriate name so that GOODFEEL can figure out what to do with it. Labeling the parts in a keyboard piece as "Right Hand" and "Left Hand", for example, can help GOODFEEL decide which way to braille the intervals.

Voice Names
Please use formal instrument names in your voice names.

If you must use abbreviations, please specify at least the first 4 letters of the real word.

Use "A", "B", etc. for multi-voice parts. For example, Piano RH A, Piano RH B.

Helpful Reading

Also be sure to read What Every Lime User Should Know in the LIME User's Manual.

Order Form

When sending a Lime file to Dancing Dots for translation, be sure to complete and send the order form. If you need copies of this form, feel free to contact Dancing Dots.

How Lime Works

Apart from any fonts Lime may use for standard text, it employs two special fonts (Marl and Tufa) for musical symbols. In Lime, any data other than the musical notes themselves are called annotations. There are three kinds of annotations: text, lines, and curves. Each annotation is associated with a single note and is considered to be "attached" to that note. While a note may have more than one annotation associated with it, any given annotation can only be attached to one note. When a note is deleted or moved, its annotations are deleted or moved with it. One exception to this, discussed below, occurs when moving notes whose annotations have been "locked."

Each annotation can have a number of options selected with it. These options include (but are not limited to): Horizontal Lock, Vertical Lock, Leave Space, Boxed, Hidden, and Centered. Some brief explanations follow, but, for complete information, see the Lime User's Manual.

Horizontal Lock
Measures the annotation's x-coordinate position from the left margin of the page rather than from the notehead of its associated note. Fixes the horizontal position of the annotation with relationship to the left margin rather than allowing it to move horizontally with its associated note.

Vertical Lock
Measures the annotation's y-coordinate position from the center line of the staff of its note rather than from the notehead of its associated note. Fixes the vertical position of the annotation rather than allowing it to move vertically with its associated note.

Leave Space

Spaces notes farther apart, if necessary, to allow room for lyrics.

Boxed
Draws a rectangular box around a text annotation.

Hidden
Suppresses the printing out of an annotation. The annotation will still be displayed on the computer screen and be interpreted by Lime.

Centered
Centers a text annotation horizontally rather than left-justifying it.

Fixing Misplaced Annotations

Due to a peculiarity of LIME, please don't fix an annotation which is associated with a wrong note by cutting and pasting the annotation. This could produce an annotation which can't be seen.

Pickup Measures

For proper braille, be sure to explicitly number the first bar line as number 0 if the piece begins with a pickup.

Translating Lime to GOODFEEL

For specifically musical information, such as notes, bars, rhythms, key signatures, time signatures, and so on, there is no problem translating from Lime to GOODFEEL. The challenge for GOODFEEL comes in determining what to do with text and graphics which are not, strictly speaking, part of the music itself.

Specific Details for Interpreting Annotations

The following descriptions give details about how the annotations in Lime are translated by GOODFEEL.

Don't combine annotations that refer to different musical attributes. For example, don't have annotations like "p unison". Make them two separate annotations.

Tempo (metronome marking only)

The first character must be a note character in Marl font. These characters are:

'q' = whole note

'w' = half note

'e' = quarter note

'r' = eighth note

't' = sixteenth note

'y' = thirty-second note

After the note there may be an optional dot or double-dot. Character in Marl font:

'[' = single dot

']' = double dot

This character must be followed by an equal sign and a number indicating the metronomic rate. If you prefer, you may insert blank spaces before and after the equal sign, but no other text is permissible in this entry. A tempo indication such as "Allegro" must be made as a separate annotation (see below). A metronome marking must be attached to the first note in the new tempo. If you have constructed the tempo annotation correctly, Lime will display the word "Tempo" in the annotation window when the tempo annotation is selected. Otherwise, Lime (and Goodfeel) will not recognize the annotation as a metronome marking.

Tempo (text specification only)

This indicates tempo, usually at the start of a piece, and must not include a metronome marking. The metronome marking must be entered as a separate annotation (see above). To be recognized as a tempo expression, the text must be in a non-music font, vertically locked, and situated above the staff. It must not be boxed or italicized. The annotation must be attached to the first note in the new tempo. In addition it must fall into one of the following categories:

1. a standard tempo word like "allegro" or if you are running the software yourself, it can be an entry in the [Tempo Expressions] section of the GF.INI file.

2. include the word tempo anywhere in the text

3. include "Tempo:" in the text ( GOODFEEL will remove "tempo:" )

Breath Mark

The text must consist of the comma (',') character only. It must be in a non-music font and be located above its note or staff. The annotation can be attached either to the note before or to the note after the horizontal location of the breath mark.

Dynamic

In Lime, a dynamic is a single symbol character in the Marl font. The dynamic characters, in Marl, are:

'z' = pppp
'x' = ppp
'c' = pp
'v' = p
'b' = mp
'n' = mf
'm' = f
',' = ff
'.' = fff
'/' = ffff

The annotation must consist of only one character, the dynamic character, or it will not be recognized as a dynamic by Lime or Goodfeel. If you have constructed the dynamic annotation correctly, Lime will display the word "Dynamic" in the annotation window when the dynamic annotation is selected. A dynamic marking must be attached to the first note in the new dynamic.

Pedal

A pedal indication must consist of a single character in Marl font:

'-' = pedal down
'=' = pedal up

The pedal annotation must be located below its note or staff and must be attached to the note where the "pedal up" or "pedal down" occurs.

Repeat Symbol

A repeat symbol must consist of a single character in Marl font:

'#' or '$' = cross sign
'%' = segno sign

The annotation must be attached to the note which corresponds to the repeat indication. For the forward and backward repeat types which are represented as two dots to the left or right of a bar line, choose the appropriate bar line type in Lime.

Repeat Text

Some repeats are marked by text rather than symbols. Repeat text must be in a non-music font, must not be boxed, and must be attached to the note at the point where the repeat text applies. The only repeat texts recognized are:

D.C. al Coda
D.S. al Coda
Fine
The numbers 1 to 9 followed by a period (e.g. 1. or 5.)

Arpeggio

The text must consist of a single character in Tufa font. In Tufa, the arpeggio character is 's'. The annotation must be attached to one of the notes in the chord which receives the arpeggio. Lime cannot distinguish the direction of an arpeggio.

Mordent

The text must consist of a single character in Marl font. There are four possibilities:

'&' = up and short
'*' = up and long
'(' = down and short
')' = down and long

The annotation must be attached to the note which receives the mordent.

Trill

The text must begin with the trill character, which is the character '8' in Marl font. Next, there can be an optional accidental (in Marl font), then 0 or more spaces, then 0 or more trill continuation characters (either '&' or '*' in Marl font). Alternatively, the accidental, if any, can be specified as a separate text annotation, consisting of a single accidental character in Marl font, provided that both annotations relating to the trill are attached to the same note. In Marl, the accidental characters are as follows:

'a' = double flat
's' = flat
'd' = natural
'f' = sharp
'g' = double sharp

The annotation(s) must be attached to the note which receives the trill.

Turn

The text must consist of a single character in Marl font. In Marl, the turn character is '!'. The turn can take an optional upper accidental and an optional lower accidental. The optional upper accidental must be a single accidental character in Marl font, located above the turn symbol, while the optional lower accidental must be a single accidental character in Marl font, located below the turn symbol. In all, then, there can be three separate annotations related to the turn, and all annotations must be attached to the note which receives the turn.

Title

The title of a Lime piece is simply a text annotation, like any other text annotation. Normally, the title of the piece is attached to the first note of the first voice. For Goodfeel translation, the title must be in non-music font, above its staff, centered, and horizontally and vertically locked. The "Leave Space" and "Boxed" options should not be used.

Copyright

For the purposes of Goodfeel translation, there is only one copyright text for a piece. The copyright annotation must be in a non-music font and must contain the word "Copyright" somewhere within the text. The "Boxed" and "Leave Space" options should not be used. Normally, the copyright annotation is attached to the first note of the piece.

Composer

Composer annotations may be entered by associating the text with the first note of the piece, checking the Horizontal and Vertical Locks and by putting "Composer:" somewhere in the text. There may be several of these annotations.

Description

Description annotations may be entered by associating the text with the first note of the piece, checking the Horizontal and Vertical Locks and by putting "Desc:" somewhere in the text. There may be several of these annotations.

Publisher

Publisher annotations may be entered by associating the text with the note of the piece, checking the Horizontal and Vertical Locks and by putting "Publisher:" somewhere in the text. There may be several of these annotations.

Expression

Goodfeel defines six different types of expressions in the GF.INI file, which may be modified by the user. A text annotation will be recognized as an expression of a particular type if it matches exactly the text given in the corresponding section of the GF.INI file: [Articulation Expressions], [Bowing Expressions], [Breath Expressions], [Pause Expressions], [Tempo Expressions], or [Volume Expressions]. In addition, the text must not be specified in the [Ignored Text] section of GF.INI, or it will be ignored and thus will not generate a Goodfeel expression. To be a valid expression, the text annotation must also be in a non-music font, must not be boxed, and must either be in italic or be located above its note or staff. If the annotation itself is valid, but has no matching text anywhere in the GF.INI file, an expression will still be generated, but of type "UNKNOWN". The expression annotation must be attached to the note to which the expression applies.

Marker

A rehearsal marker is any text that is boxed. The annotation must be attached to the note at the rehearsal marker location.

Lyric

Lyric text must be in a non-music font, vertically locked, centered, and located below its staff. It must not be boxed or italicized. "Leave Space" should not be used. The lyric must be attached to the note on which it is to be sung.

Cue Point

To be interpreted as a cue point, a text annotation must be hidden and located below its staff or note. It must not be centered, boxed, or italicized. The annotation must be attached to the note to which the cue point applies.

All Remaining Text

All other text not included in any description above will be treated as miscellaneous text.

Graphic Crescendo and Graphic Decrescendo

For complete graphic crescendo and decrescendo information, the Lime piece must have been saved with the Graphics Save option. Note: The Graphics Save option is not available to Macintosh users. When sending Lime files to Dancing Dots, Mac users should be sure to mark the "From Mac" box on the information form to be sent to Dancing Dots with the file to be translated. This form is located at the back of this document. Please contact Dancing Dots, if necessary, for additional copies of this form. The Graphics Save option is accessed in Lime version 4.00 and later by holding down the Shift key while pulling down the File menu. The text of the "Save" menu item will be changed to "Graphics Save", and the text of the "Save As" menu item will be changed to "Graphics Save As". Although a Lime piece saved using Graphics Save will require approximately 4 to 8 times the file size, the additional information is needed for proper translation to the Goodfeel format. For crescendo and decrescendo, the annotation is of type "line", and the style "Hairpin" must be chosen from the Style menu. The annotation must be attached to the note at the beginning of the crescendo or decrescendo. Note: if Graphics Save is not used, Goodfeel will be able to identify only the beginning, but not the end, of the crescendo or decrescendo.

Grace Notes

Goodfeel is able to recognize grace notes as represented by Lime. The grace note length, however, is considered "long" by default. To obtain a "short" grace note, attach a line annotation to the grace note in Lime. To look proper (but not required for Goodfeel), the line should pass through both the flag and stem of the grace note and have an upward slant.

Voice Names

While Goodfeel defines both a "part name" and an "instrument name" for each voice, Lime defines only a "voice name." As a default, the Lime to Goodfeel translator provides the same voice name for the part name and the instrument name. As an extension of Lime, exclusively for the purposes of Goodfeel, it is possible to specify both the part name and the instrument name in Lime's "voice name" field. For Lime's voice name, first specify the part name, then insert the '\' (backslash) character as a delimiter, and then specify the instrument name. Although it will look strange while using Lime, the Lime to Goodfeel translator will know what to do with it. Note: Lime's entire voice name field is limited to 16 characters (including the backslash character, if it is used).

Bar Numbers

If there are no bar numbers in the print, there are certain braille bar numbering rules which should be adhered to by numbering bars as follows:

  • If there is a pickup, the first bar should be numbered 0!
  • Measures which are inside endings should have unique bar numbers. For example if ending 1 has bar numbers 10 & 11, ending 2 would have bar numbers starting at 12.

Copyright 2002, 2005 Dancing Dots