summaryrefslogtreecommitdiff
path: root/macros/musixtex/doc/musixdoc/extensions.tex
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2023-10-09 03:05:28 +0000
committerNorbert Preining <norbert@preining.info>2023-10-09 03:05:28 +0000
commit55c62aa6d5cc8ce94c28ac255b66a13ccd2375b2 (patch)
tree1b5eb4f2e66d4ee007cac50ea4d0f34c11cda50f /macros/musixtex/doc/musixdoc/extensions.tex
parent9f6bac4b7884af8d5a457275e30fc5e253ff9de8 (diff)
CTAN sync 202310090305
Diffstat (limited to 'macros/musixtex/doc/musixdoc/extensions.tex')
-rw-r--r--macros/musixtex/doc/musixdoc/extensions.tex85
1 files changed, 85 insertions, 0 deletions
diff --git a/macros/musixtex/doc/musixdoc/extensions.tex b/macros/musixtex/doc/musixdoc/extensions.tex
index d2bdd3d75a..c11c389efa 100644
--- a/macros/musixtex/doc/musixdoc/extensions.tex
+++ b/macros/musixtex/doc/musixdoc/extensions.tex
@@ -1689,6 +1689,91 @@ These are generated by, respectively,
\end{tabular}
\end{list}
+ \section{musixmtab}\index{tablature}\index{musixmtab@{\tt musixmtab.tex}}\label{mtab}
+
+Modern instrumentalists of string instruments (guitar, banjo, mandolin, etc.)
+use a hybrid form of tablature in which notes have (downward) stems and beams attached.%
+\footnote{It seems this ``modern'' form of tablature was introduced by Pete Seeger in his 5-string banjo
+instruction book, first published in 1948.}
+The \verb\musixmtab\\index{musixmtab} package combines traditional Gelten-style tablature notation
+already in \musixtex\ with the stems and beams of standard music notation.
+It is assumed that there is at most one beam (beam number $0$) and that all stems are downward.
+
+In the following commands,
+\{$s$\} is a string number (counting from the top) and \{$n$\} is a numerical note (i.e., fret number).
+
+\begin{center}
+\begin{tabular}{ll}
+\keyindex{uh}\{$s$\}\{$n$\} & a half note (boxed, to differentiate from a quarter note)\\
+\keyindex{zuh}\{$s$\}\{$n$\} & a non-spacing stemless half note\\
+\keyindex{uq}\{$s$\}\{$n$\} & a quarter note (with a centered stem)\\
+\keyindex{uc}\{$s$\}\{$n$\} & an eighth note (with a flag)\\
+\keyindex{ucc}\{$s$\}\{$n$\} & a sixteenth note (with a double flag)\\
+\keyindex{zu}\{$s$\}\{$n$\} & a non-spacing stemless quarter, eighth or sixteenth note\\
+\keyindex{uib}\{$s$\}\{$l$\} & initiate a single beam; $s$ is the starting string and $l$ is the slope\\
+\keyindex{uibb}\{$s$\}\{$l$\} & initiate a double beam; $s$ is the starting string and $l$ is the slope\\
+\keyindex{ub}\{$s$\}\{$n$\} & a beamed note\\
+\keyindex{unbb} & increase the beam multiplicity to 2\\
+\keyindex{utbb} & decrease the beam mutiplicity to 1 after the following note\\
+\keyindex{utb} & terminate the beam after the following note\\
+\keyindex{utq}\{$s$\}\{$n$\} & terminate the beam after this note\\
+
+\end{tabular}
+\end{center}
+Conventional \musixtex\ commands such as \verb|pt| and \verb|arpeggio| may be used but arguments must reference \musixtex\ note
+designations rather than string numbers.
+
+Here is an example, {\it Cripple Creek}, for 5-string banjo in standard G tuning, clawhammer style:
+
+\begin{music}
+\parindent=2ex
+\input musixmtab
+\setclefsymbol1\tabclef\setsize1{\largevalue}\setsign10
+\setname1{\tabstringfnt\baselineskip=1.2\internote%
+\vbox{\hbox{D}\hbox{B}\hbox{G}\hbox{D}\hbox{\ g}}}
+\generalmeter{\meterfrac24}
+\startbarno1
+\nobarnumbers
+\nostartrule
+\startpiece\addspace\afterruleskip
+\notes\uibb40\ub12\lcn{10}{\it SL}\ub15\zu15\zu20\ub30\utq50\en
+\notes\uibb40\ub10\ccn{10}{\it T}\ub20\ub10\utq50\en
+\bar%2
+\Notes\uib24\ub21\utq12\en
+\Notes\uib40\ub10\en
+\notes\unbb\zu10\zu20\ub30\utq50\en
+\bar%3
+\notes\uibb40\ub12\lcn{10}{\it SL}\ub15\zu15\zu20\ub30\utq50\en
+\notes\uibb40\ub10\ccn{10}{\it T}\ub20\ub10\utq50\en
+\bar%4
+\notes\uibb2{-2}\ub21\utbb\ccn9{\it P}\ub20\en
+\Notes\utq32\en
+\Notes\uib40\ub30\en
+\notes\unbb\zu10\zu20\ub30\utq50\en
+\setrightrepeat
+\alaligne
+\zleftrepeat
+\notes\uibb40\ub32\lcn{9}{\it SL}\ub34\zu10\zu20\ub34\utq50\en
+\notes\uibb3{-1}\ub32\utbb\ccn9{\it P}\ub30\utq42\en
+\bar
+\notes\uibb40\ub32\lcn9{\it SL}\ub34\zu10\zu20\ub34\utq50\en
+\Notes\uib40\ub40\en
+\notes\unbb\zu10\zu20\ub30\utq50\en
+\bar
+\notes\uibb40\ub32\lcn9{\it SL}\ub34\zu10\zu20\ub34\utq50\en
+\notes\uibb4{-1}\ub32\ccn9{\it P}\ub30\ub42\ccn9{\it P}\utq40\en
+\bar
+\notes\uibb40\ub40\ccn9{\it H}\ub42\zu10\zu20\ub30\utq50\en
+\Notes\uib40\ub30\en
+\Notes\unbb\zu10\zu20\ub30\utq50\en
+\zrightrepeat
+\qspace
+\NOtes\arpeggio05\zuh10\zuh20\zuh30\zuh40\uh50\en
+\Endpiece
+
+\end{music}
+
+
\section{musixper}\label{perc}
Provides special symbols intended for percussion parts. Included are a