Re: Defining custom fretboards

[Carl Sorensen]

On 4/21/15 6:48 PM, "James" <address@hidden> wrote:

>Thanks, Carl. This does what I'm looking for. Is this in the
>documentation? I couldn't (and still can't) find it.

I think it's in the documentation, but maybe you can find a way to express
it more clearly.  The places I found it are listed below.

Thanks,

Carl



Notation Reference 2.4.1 Predefined fret diagrams.

"Fret diagrams can be added to the fret diagram table. To add a diagram,
you must specify the hash table for the diagram, the chord for the
diagram, the tuning to be used, and a definition for the diagram.
Normally, the hash table will be default-fret-table. The diagram
definition can be either a fret-diagram-terse definition string or a
fret-diagram-verbose marking list."

Notation Reference 2.4.1 Fret diagram markups.

"Fret diagrams can be added to music as a markup to the desired note. The
markup contains information about the desired fret diagram. There are
three different fret-diagram markup interfaces: standard, terse, and
verbose. The three interfaces produce equivalent markups, but have varying
amounts of information in the markup string. Details about the syntax of
the different markup strings used to define fret diagrams are found at
Instrument Specific Markup "

Notation Reference A.11.5 Instrument Specific Markup.

"\fret-diagram-verbose marking-list (pair)Make a fret diagram containing
the symbols indicated in marking-list.
For example,

\markup \fret-diagram-verbose
  #'((mute 6) (mute 5) (open 4)
     (place-fret 3 2) (place-fret 2 3) (place-fret 1 2))


produces a standard D chord diagram without fingering indications.
Possible elements in marking-list:
(mute string-number)Place a small Œx¹ at the top of string string-number.
(open string-number)Place a small Œo¹ at the top of string string-number.
(barre start-string end-string fret-number)Place a barre indicator (much
like a tie) from string start-string to string end-string at fret
fret-number.
(capo fret-number)Place a capo indicator (a large solid bar) across the
entire fretboard at fret location fret-number. Also, set fret fret-number
to be the lowest fret on the fret diagram.
(place-fret string-number fret-number [finger-value] [color-modifier]
[color] ['parenthesized['default-paren-color]]) Place a fret playing
indication on string string-number at fret fret-numberwith an optional
fingering label finger-value, an optional color modifier color-modifier,
an optional colorcolor, an optional parenthesis 'parenthesized and an
optional paranthesis color 'default-paren-color. By default, the fret
playing indicator is a solid dot. This can be globally changed by setting
the value of the variable dot-color or for a single dot by setting the
value of color. The dot can be parenthesized by adding 'parenthesized. By
default the color for the parenthesis is taken from the dot. Adding
'default-paren-color will take the parenthesis-color from the global
dot-color, as a fall-back black will be used. Setting color-modifier to
inverted inverts the dot color for a specific fingering. The values for
string-number, fret-number, and the optional finger should be entered
first in that order. The order of the other optional arguments does not
matter. If the finger part of the place-fret element is present,
finger-value will be displayed according to the setting of the variable
finger-code. There is no limit to the number of fret indications per
string.
Used properties:

* thickness (0.5)
* fret-diagram-details
* size (1.0)
* align-dir (-0.4)
"

Also, NR 2.4.1 Fret diagram markups

The fret-diagram-verbose markup string is in the format of a Scheme list.
Each element of the list indicates an item to be placed on the fret
diagram.

<<
    \new ChordNames {
      \chordmode {
        c1 d:m
      }
    }
  \new Staff {
    \clef "treble_8"
    <c e g c' e'>1^\markup {
      \fret-diagram-verbose #'(
        (mute 6)
        (place-fret 5 3)
        (place-fret 4 2)
        (open 3)
        (place-fret 2 1)
        (open 1)
      )
    }
    <d a d' f'>1^\markup {
      \fret-diagram-verbose #'(
        (mute 6)
        (mute 5)
        (open 4)
        (place-fret 3 2)
        (place-fret 2 3)
        (place-fret 1 1)
      )
    }
  }
>>
 "