diff options
Diffstat (limited to 'macros/latex/contrib/recorder-fingering/recorder-fingering.tex')
-rw-r--r-- | macros/latex/contrib/recorder-fingering/recorder-fingering.tex | 37 |
1 files changed, 23 insertions, 14 deletions
diff --git a/macros/latex/contrib/recorder-fingering/recorder-fingering.tex b/macros/latex/contrib/recorder-fingering/recorder-fingering.tex index 9dc25632aa..63f77e30f2 100644 --- a/macros/latex/contrib/recorder-fingering/recorder-fingering.tex +++ b/macros/latex/contrib/recorder-fingering/recorder-fingering.tex @@ -31,7 +31,7 @@ \DefineShortVerb{\|} \title{The \texttt{recorder-fingering} package} \author{Alan Munn\\amunn@msu.edu} -\date{Version 1.3b\\October 17, 2023} +\date{Version 1.4\\February 2, 2025} \lstset{% basicstyle=\ttfamily\small, @@ -52,7 +52,6 @@ \renewcommand{\abstractname}{\sffamily Abstract} - \begin{document} \maketitle \thispagestyle{empty} @@ -101,6 +100,7 @@ trilldir = <L/R/LR> & trill arrows uniformly to the Left or Right, or top 3 hole Lpointer = <left trill pointer> & changes the left pointer for trills\\ Rpointer = <right trill pointer> & changes the right pointer for trills\\ trill = \{<list of holes>\} & add a trill marker at each hole position in the list (local use only)\\ +revdouble & reverse the orientation of the double holes to show a player’s perspective\\ \bottomrule \end{tabularx} \caption{Display options} @@ -114,15 +114,17 @@ The trill arrow direction can be specified using the |trilldir| parameter. Setti The |Lpointer| and |Rpointer| parameters set the left and right trill pointers. The default values are |Lpointer={$\rightarrow$}| and |Rpointer={$\leftarrow$}|. +The |revdouble| parameter reverses the orientation of the double holes to make them appear from a player’s perspective rather than looking at the recorder from the front (the default). This parameter really only makes sense to be used globally, although it can also be used locally if needed. + You can set the parameters individually for any particular display command, but most likely you'll want global settings. To set the parameters globally use the command |\fingeringSetup| e.g. |\fingeringSetup{width=12pt,thumboffset=false}| makes all diagrams use an inline thumb hole and 12pt width. \begin{table}[htpb] \centering -\begin{tabular}{TTT} -\bs Alto\{c\} & \bs Soprano[width=10pt,thumboffset=false]\{f\} & \bs Alto[trill=3]\{C\}\\ +\begin{tabular}{TTTT} +\bs Alto\{c\} & \bs Soprano[width=10pt,thumboffset=false]\{f\} & \bs Alto[trill=3]\{C\} & \bs Alto[revdouble]{G}\\ \\ -\Alto{c} & \Soprano[width=10pt,thumboffset=false]{f} & \Alto[trill=3]{C} +\Alto{c} & \Soprano[width=10pt,thumboffset=false]{f} & \Alto[trill=3]{C} & \Alto[revdouble]{G} \end{tabular} \caption{Example fingering commands} \end{table} @@ -139,10 +141,11 @@ Fingerings are specified using an 8 (and possibly 9) element comma separated lis \begin{tabularx}{.8\textwidth}{t{r}X} \toprule 0 & open hole\\ -1 & closed hole (positions 0-6); or single closed hole (recorder positions 6,7)\\ +1 & closed hole (positions 0-5); or single closed hole (recorder positions 6,7)\\ 2 & double closed hole (recorder positions 6,7 only)\\ t & half hole (thumb)\\ -h & half hole (positions 1-6)\\ +h & half hole (positions 1-5)\\ +o & optionally closed (positions 0-5) represented as an open hole with a dot\\ \bottomrule \end{tabularx} \caption{Hole states} @@ -211,7 +214,8 @@ Here are some examples of how to add new fingerings and trills. \AddFingerings{F}{ altD = {1,0,1,1,1,1,0,0}, altE = {1,0,1,1,0,0,0,0}, -altAb = {t,1,1,1,1,1,1,0} +altAb = {t,1,1,1,1,1,1,0}, +altG# = {0,o,1,1,1,1,2,0} } \AddTrills{F}{ BbA = {{0,1,1,1,1,1,0,0},{5}}, @@ -225,16 +229,19 @@ C#D ={{1,1,1,0,1,1,1,0},{4,5}} \AddFingerings{F}{ altD = {1,0,1,1,1,1,0,0}, altE = {1,0,1,1,0,0,0,0}, -altAb = {t,1,1,1,1,1,1,0} +altAb = {t,1,1,1,1,1,1,0}, +altG# = {0,o,1,1,1,1,2,0} } \Alto{altD}\quad \Alto{altE}\quad -\Alto{altAb} +\Alto{altAb}\quad +\Alto{altG#} \end{lstlisting} \Alto{altD}\quad \Alto{altE}\quad -\Alto{altAb} +\Alto{altAb}\quad +\Alto{altG#} \begin{lstlisting} \AddTrills{F}{ @@ -256,15 +263,17 @@ C#D ={{1,1,1,0,1,1,1,0},{4,5}} \Ctrill{ef#}\quad \Ctrill{gab} \end{lstlisting} -\Soprano{alte}\quad +\Soprano[revdouble]{alte}\quad \Ctrill{ef#}\quad \Ctrill{gab} \clearpage \section{Version History} -Version 0.5 of this package (the initial version) was in response to a \href{https://tex.stackexchange.com/q/674847/2693}{TeX.se question} and used a substantially different set of user commands. The current version (1.x) is more flexible and has a more useable user interface. Version 1.1 added support for trill annotation, and added a separation between the left and right hand holes. Version 1.2 added support for the tin whistle. Version 1.3 added dedicated trill fingering commands. Bug reports and feature requests are welcome at the \href{https://github.com/amunn/recorder-fingering/issues}{GitHub bug tracker}. +Version 0.5 of this package (the initial version) was in response to a \href{https://tex.stackexchange.com/q/674847/2693}{TeX.se question} and used a substantially different set of user commands. The current version (1.x) is more flexible and has a more useable user interface. Version 1.1 added support for trill annotation, and added a separation between the left and right hand holes. Version 1.2 added support for the tin whistle. Version 1.3 added dedicated trill fingering commands. Version 1.4 added a new hole state |o| to denote a closed if required hole (following the practice in the Moeck fingering charts). It also fixed some typos in the built-in fingerings, and bug with options for trill commands and added a parameter to change the orientation of the double holes. Bug reports and feature requests are welcome at the \href{https://github.com/amunn/recorder-fingering/issues}{GitHub bug tracker}. \section{Acknowledgements} -This is my first attempt to write a package using |expl3|. Thanks to Jonathan P. Spratte for suggesting how to split fingering vectors and the various LaTeX development team members (David Carlisle, Ulrike Fischer, Phelype Olenik and Joseph Wright) who have answered random |expl3| questions in the TeX.se chat. Thanks to Bob Tennent, whose suggestions resulted in version 1.1. Thanks also to all the TeX.se users who have both asked and answered questions on the site. Your questions encourage new packages like this one and your answers help make the code better. Thanks to Charles-Albert Lehalle for the suggestion to add the tin whistle. +This is my first attempt to write a package using |expl3|. Thanks to Jonathan P. Spratte for suggesting how to split fingering vectors and the various LaTeX development team members (David Carlisle, Ulrike Fischer, Phelype Olenik and Joseph Wright) who have answered random |expl3| questions in the TeX.se chat. Thanks to Bob Tennent, whose suggestions resulted in version 1.1. Thanks also to all the TeX.se users who have both asked and answered questions on the site. Your questions encourage new packages like this one and your answers help make the code better. Thanks to Charles-Albert Lehalle for the suggestion to add the tin whistle. Thanks to GitHub user |voh9eepah| for the suggestions that led to version 1.4. +voh9eepah + \section{Sources} The core fingerings for recorders are taken from \textcite{Wollitz1981}. The core fingerings for the tin whistle are taken from \textcite{GreyLarsenWhistleFingerings}. The sample recorder trill fingerings are from \textcite{BlockisRecorderFingerings}. |