LilyPond program-reference: 3.2.41 instrument-specific-markup-interface

### 3.2.41 instrument-specific-markup-interface

Instrument-specific markup (like fret boards or harp pedal diagrams).

#### User settable properties:

> `fret-diagram-details` (list)

>   An alist of detailed grob properties for fret diagrams. Each alist entry consists of a `(property . value)` pair. The properties which can be included in `fret-diagram-details` include the following:

>   - `barre-type` – Type of barre indication used. Choices include `curved`, `straight`, and `none`. Default `curved`.
>   - `capo-thickness` – Thickness of capo indicator, in multiples of fret-space. Default value 0.5.
>   - `dot-color` – Color of dots. Options include `black` and `white`. Default `black`.
>   - `dot-label-font-mag` – Magnification for font used to label fret dots. Default value 1.
>   - `dot-position` – Location of dot in fret space. Default 0.6 for dots without labels, 0.95-`dot-radius` for dots with labels.
>   - `dot-radius` – Radius of dots, in terms of fret spaces. Default value 0.425 for labeled dots, 0.25 for unlabeled dots.
>   - `finger-code` – Code for the type of fingering indication used. Options include `none`, `in-dot`, and `below-string`. Default `none` for markup fret diagrams, `below-string` for `FretBoards` fret diagrams.
>   - `fret-count` – The number of frets. Default 4.
>   - `fret-label-font-mag` – The magnification of the font used to label the lowest fret number. Default 0.5.
>   - `fret-label-vertical-offset` – The offset of the fret label from the center of the fret in direction parallel to strings. Default 0.
>   - `label-dir` – Side to which the fret label is attached. `-1`, `#LEFT`, or `#DOWN` for left or down; `1`, `#RIGHT`, or `#UP` for right or up. Default `#RIGHT`.
>   - `mute-string` – Character string to be used to indicate muted string. Default `"x"`.
>   - `number-type` – Type of numbers to use in fret label. Choices include `roman-lower`, `roman-upper`, and `arabic`. Default `roman-lower`.
>   - `open-string` – Character string to be used to indicate open string. Default `"o"`.
>   - `orientation` – Orientation of fret-diagram. Options include `normal`, `landscape`, and `opposing-landscape`. Default `normal`.
>   - `string-count` – The number of strings. Default 6.
>   - `string-label-font-mag` – The magnification of the font used to label fingerings at the string, rather than in the dot. Default value 0.6 for `normal` orientation, 0.5 for `landscape` and `opposing-landscape`.
>   - `string-thickness-factor` – Factor for changing thickness of each string in the fret diagram. Thickness of string k is given by `thickness` * (1+`string-thickness-factor`) ^ (k-1). Default 0.
>   - `top-fret-thickness` – The thickness of the top fret line, as a multiple of the standard thickness. Default value 3.
>   - `xo-font-magnification` – Magnification used for mute and open string indicators. Default value 0.5.
>   - `xo-padding` – Padding for open and mute indicators from top fret. Default value 0.25.
> `harp-pedal-details` (list)

>   An alist of detailed grob properties for harp pedal diagrams. Each alist entry consists of a `(property . value)` pair. The properties which can be included in harp-pedal-details include the following:

>   - `box-offset` – Vertical shift of the center of flat/sharp pedal boxes above/below the horizontal line. Default value 0.8.
>   - `box-width` – Width of each pedal box. Default value 0.4.
>   - `box-height` – Height of each pedal box. Default value 1.0.
>   - `space-before-divider` – Space between boxes before the first divider (so that the diagram can be made symmetric). Default value 0.8.
>   - `space-after-divider` – Space between boxes after the first divider. Default value 0.8.
>   - `circle-thickness` – Thickness (in unit of the line-thickness) of the ellipse around circled pedals. Default value 0.5.
>   - `circle-x-padding` – Padding in X direction of the ellipse around circled pedals. Default value 0.15.
>   - `circle-y-padding` – Padding in Y direction of the ellipse around circled pedals. Default value 0.2.
> `size` (number)

>   Size of object, relative to standard size.

> `thickness` (number)

>   Line thickness, generally measured in `line-thickness`.

This grob interface is used in the following graphical object(s): TextScript.

#### Internals Reference