\chapter{Extension Library}
All of the following files are invoked by saying \keyindex{input} \ital{filename}.
In some cases,
\verb\musixtex\ must be input \emph{before} the extension,
but most of them are fully compatible with \verb\musixtex.tex\ in that they do not redefine
any existing macros and just provide additional functionality.
In future
versions of \musixtex\ we may very well incorporate many of them directly into
\verb|musixtex.tex|, but for now we leave them separate.
\section{musixadd}\ixtt{musixadd.tex}
Increases the number of instruments, slurs and beams from six to nine.
\section{musixadf}
\input musixadf
This file and the associated fonts (by Hiroaki \textsc{Morimoto})
define some additional and alternative musical accents, as follows.
\begin{description}
\item[small swells, larger sforzatos:]
\ \\\begin{music}
\nostartrule
\startextract
\NOTes
\ccharnote{-8}{\Bslash ulsw}\ulsw l\ql l%
\ccharnote{13}{\Bslash llsw}\llsw f\qu f%
\en\bar
\NOtes
\ccharnote{-8}{\Bslash uSfz}\uSfz l\ql l%
\ccharnote{13}{\Bslash lSfz}\lSfz f\qu f\qsk%
\en
\endextract
\end{music}
\item[breaths:]
\ \\
\begin{music}
\nostartrule
\startextract
\NOTes
\zcharnote{-8}{\Bslash cuBreath}\cuBreath \qu f%
\zcharnote{13}{\Bslash clBreath}\clBreath \qu f%
\en\bar
\NOtes
\ccharnote{-8}{\Bslash zuBreath}\zuBreath \qu f%
\ccharnote{13}{\Bslash zlBreath}\zlBreath \qu f%
\en
\endextract
\end{music}
\item[coda with serifs, upright segno:]
\ \\
\begin{music}
\nostartrule
\startextract
\NOTes
\sk
\ccharnote{-4}{\Bslash scoda}\scoda n\sk\sk%
\ccharnote{-4}{\Bslash upsegno}\upsegno n\sk%
\en
\endextract
\end{music}
\end{description}
The following commands will replace the default specified accents by the new ones
defined in \texttt{musixadf.tex}:
\verb|\replacesforzato|,
\verb|\replacecoda|,
\verb|\replacesegno|.
\section{musixbm}
This file does nothing; it is retained only for compatibility with
\musixtex{} version 1.10 or earlier.
Since version 1.11, \verb|musixtex.tex| itself contains all the functions
of the older \texttt{musixbm}, namely
commands for 128th notes, either with flags or with beams:
\keyindex{ibbbbbu},
\keyindex{ibbbbbl},
\keyindex{nbbbbbu},
\keyindex{nbbbbbl},
\keyindex{tbbbbbu},
\keyindex{tbbbbbl},
\keyindex{Ibbbbbu},
\keyindex{Ibbbbbl},
\keyindex{cccccu},
\keyindex{cccccl},
\keyindex{ccccca},
\keyindex{zcccccu} and
\keyindex{zcccccl}.
\section{musixbbm}\label{musixbbm}
Provides $256$th notes, but only for use within beams, via the commands
\keyindex{ibbbbbbu},
\keyindex{ibbbbbbl},
\keyindex{nbbbbbbu},
\keyindex{nbbbbbbl},
\keyindex{tbbbbbbu},
\keyindex{tbbbbbbl},
\keyindex{Ibbbbbbu} and
\keyindex{Ibbbbbbl}.
By default \texttt{musixbbm} provides six $256$th beams with
reference number $0$ to $5$.
You can specify a larger maximum number
directly with \keyindex{setmaxcclvibeams}\verb|{|$m$\verb|}| within the
range\footnote{This may require e-\TeX.} $7\leq m\leq 100$.
\section{musixcho}\label{song}
Enables certain macros intended for choral music\footnote{Remember
that we now recommend using \texttt{musixlyr} for any except the
simplest lyrics. The extension \texttt{musixcho} is only for those
diehards who choose to ignore this advice}. Provides the following commands:
\keyindex{biglbrace}, \keyindex{bigrbrace}, \keyindex{braceheight},
\keyindex{Dtx} and \keyindex{Drtx} for two-line text, \keyindex{Ttx} and
\keyindex{Trtx} for three-line text, \keyindex{Qtx} and \keyindex{Qrtx} for
four-line text. To eliminate zigzagging lyrics lines, all multiple line texts
are automatically vertically justified with the macro \keyindex{ChroirStrut},
defined as \verb|\vphantom{\^Wgjpqy}|.
The macros \keyindex{tx}\verb|{|$text$\verb|}|,
\keyindex{rtx}\verb|{|$text$\verb|}| cause song text to be left-justified
on the insertion point rather then centered.
\keyindex{hf}\verb|{|$m$\verb|}| sets a text
continuation rule of length $m$ \verb|\noteskip|.
Consult the source file {\tt musixdoc.tex} to see the coding of the following
example:
Empowers \musixtex\ to run files created under
Musi\textbf{c}TeX, the predecessor of \musixtex, such as some of the examples
provided by Daniel {\sc Taupin}. It is not needed for any files created
under \musixtex, and is included mainly for historical completeness.
\section{musixdat}
Enables the command \keyindex{today}, which sets the current date in one of
several possible languages. The language is selected by an optional
preparatory command \verb|\date...|.
The default is \keyindex{dateUSenglish}, but this can changed, either at the
end of \ttxem{musixdat.tex} for a permanant change, or right before issuing
\verb|\today|. Available choices and sample results are summarized below:
\smallskip
\begin{quote}\begin{tabular}{ll}\hline
\verb|\dateUSenglish|&\dateUSenglish\today\\
\verb|\dateaustrian|&\dateaustrian\today\\
\verb|\dateenglish|&\dateenglish\today\\
\verb|\datefrench|&\datefrench\today\\
\verb|\dategerman|&\dategerman\today\\\hline
\end{tabular}\end{quote}
\section{musixdbr}
Enables dashed and dotted bar lines (see Section~\ref{musixdbr}).
\section{musixdia}\label{diam}
Enables notes with diamond-shaped heads as follows:
\begin{itemize}\setlength{\itemsep}{0ex}
\item Solid note heads (\raise.5ex\hbox to .6em{\musixchar37}) are obtained
using the macros
\keyindex{yqu}, \keyindex{yqup},
\keyindex{yqupp}, \keyindex{yql}, \keyindex{yqlp}, \keyindex{yqlpp},
\keyindex{yzq}, \keyindex{yzqp}, \keyindex{yzqpp}, \keyindex{yqb},
\keyindex{ycu}, \keyindex{yccu}, \keyindex{ycccu}, \keyindex{yccccu},
\keyindex{ycl}, \keyindex{yccl}, \keyindex{ycccl}, \keyindex{yccccl},
\keyindex{ycup}, \keyindex{ycupp}, \keyindex{yclp}, \keyindex{yclpp}.
(Think of d{\it y}\kern.5pt amond). A solid diamond with no stem is obtained
with \keyindex{ynq} (spacing) or \keyindex{yznq} (non-spacing).
\item Open note heads (\raise.5ex\hbox to .6em{\musixchar38}) are obtained
using the macros
\keyindex{dqu}, \keyindex{dqup},
\keyindex{dqupp}, \keyindex{dql}, \keyindex{dqlp}, \keyindex{dqlpp},
\keyindex{dzq}, \keyindex{dzqp}, \keyindex{dzqpp}, \keyindex{dqb},
\keyindex{dcu}, \keyindex{dccu}, \keyindex{dcccu}, \keyindex{dccccu},
\keyindex{dcl}, \keyindex{dccl}, \keyindex{dcccl}, \keyindex{dccccl},
\keyindex{dcup}, \keyindex{dcupp}, \keyindex{dclp}, \keyindex{dclpp}.
(Think of {\it d}\kern.5pt iamond).
An open diamond with no stem is obtained
with \keyindex{dnq} (spacing) or \keyindex{dznq} (non-spacing).
\end{itemize}
One use of these note heads is for a string part with \itxem{harmonic notes}.
%(see \ref{othernotes})
% DAS removed description which was misplaced in the samll=notes section 2.18 4/30/06
For example,
Another use is for percussion parts. In fact the file \verb|musixdia.tex|
is automatically loaded if you input {\tt musixper.tex} (see Section~\ref{perc}).
\section{musixec}\label{ecfonts}
This package will replace the \texttt{OT1}-encoded Computer Modern fonts
by \texttt{T1}-encoded EC versions.
Use as follows:
\begin{quote}\begin{verbatim}
\input musixtex
\input musixec
[\input musixsty]
..
\end{verbatim}\end{quote}
For example,
\begin{music}
\input musixec
� � � � � �\\
\end{music}
\noindent may be coded as
\begin{quote}
\begin{verbatim}
\input musixec
� � � � � �\\
\end{verbatim}
\end{quote}
\section{musixeng}
This package is provided for music typesetters who are allergic to the default
rest names, which are
taken from French, German or Italian. It does not provide new features, only
new command names:
\medskip
\begin{quote}\begin{tabular}{ll}\hline
\ital{original}&\ital{alternate}\\\hline
\keyindex{PAUSe}&\keyindex{Qwr}\\
\keyindex{PAuse}&\keyindex{Dwr}\\
\keyindex{liftpause}&\keyindex{liftwr}\\
\keyindex{pausep}&\keyindex{wrp}\\
\keyindex{pause}&\keyindex{wr}\\
\keyindex{lifthpause}&\keyindex{lifthr}\\
\keyindex{hpausep}&\keyindex{hrp}\\
\keyindex{hpause}&\keyindex{hr}\\
\keyindex{qp}&\keyindex{qr}\\
\keyindex{ds}&\keyindex{er}\\
\keyindex{qs}&\keyindex{eer}\\
\keyindex{hs}&\keyindex{eeer}\\
\keyindex{qqs}&\keyindex{eeeer}\\\hline
\end{tabular}\end{quote}
\section{musixext}
This file does nothing; it is retained only for compatibility with
\musixtex{} version 1.17 or earlier.
Since version 1.18, \verb|musixtex.tex| itself contains all the functions
of the older \texttt{musixext}, namely
definitions of
\begin{itemize}
\item
\keyindex{raggedstoppiece}~, which inhibits right-justification of the last
line of a score.
\item
\keyindex{slide}\itbrace{p}\itbrace{x}\itbrace{s}~, which provides a glissando
starting at pitch {\it p} and extending for {\it x} \verb|\internote|s with
slope {\it s} (ranging from $-8$ to $8$).
\end{itemize}
\section{musixf{}l{}l}
\input musixfll
Enables modification of \ixem{ledger lines}. Ledger lines normally exceed the
width of a note head by $25$ percent in each direction. If the space between
notes is insufficient, the ledger lines of
consecutive notes may meet, creating visual ambiguities. Therefore,
\musixtex{} shortens the
ledger lines if notes are set so close together that the ledger lines may
meet. But because \musixtex{} does not know whether consecutive notes need
ledger lines, this automatic shortening may be superfluous. The extension
file \ttxem{musixfll.tex} allows this feature to be switched off and on.
Upon inputting \verb|musixfll.tex|, the automatic shortening of ledger lines
is switched off. From then on, it may be switched on again using
\keyindex{autoledgerlines} and switched off again using
\keyindex{longledgerlines}. Both macros have global effect.
The following example shows that narrowly set scales look better with
\keyindex{autoledgerlines} (the default behavior), whereas single notes
requiring ledger lines look better with \keyindex{longledgerlines}.
\section{musixftab}\label{frenchtab}\index{tablature}\index{musixftab@{\tt musixftab.tex}}
This extension replaces the default (Helvetica) numerals of the tablature commands
of Section~\ref{tablature} with the traditional script letters of French tablature.
These glyphs are generated in \keyindex{tabfnt} by arguments \texttt{0}--\texttt{9}
or by (capital) Latin letters \texttt{A}--\texttt{R} (excluding \texttt{J}).
\clearpage
The example of Section~\ref{tablature} with \texttt{musixftab.tex} is as follows:
\medskip
% \section{Gregorian chant: staffs and clefs}
Gregorian chant is often coded using four line staffs
(see
%sections \ref{gregorian} and
Section~\ref{stafflinenumber}) and using special notes called
\itxem{neumes} (which are described later in this section). It also requires
special clefs. One way to substitute them for the modern ones is for example
with commands like
\noindent which will cause instrument number~$3$ to display the selected gregorian
clef. The standard clefs can be restored for every instrument with
\keyindex{resetclefsymbols}. Note that when using this method you must
specify whether to substitute for the bass or alto clef
symbol (there is no treble clef in gregorian
chant). The reason is that \musixtex\ selects and
raises the F and C clefs differently, according to the arguments of the
\keyindex{setclef} command. Therefore, if one had substituted any F clef
symbol while saying \verb|\setclef1{1000}|, then an F clef would duly appear
on the staff, but it would be set at the position of an alto clef, thus
seriously misleading the musician.
Another method of clef substitution employs \keyindex{setclefsymbol} (see
Section~ \ref{treblelowoct}), which substitutes the clef given by
the second argument \ital{for all clef symbols} of the instrument given by the first,
regardless of the actual musical meaning of the new clef symbol. This method is
generally appropriate only if you want to change the clef symbol(s) of
an instrument for the whole of the score.
As an example, the same gregorian scale has been written with a gregorian C
clef on all four lines of the staff:
All of the special gregorian symbols available in \musixtex\ are described
in the following subsections.
\subsection{Clefs}
\begin{itemize}\setlength{\itemsep}{0ex}
\item Gregorian C clef: \raise 2.5pt\hbox to 1cm{\gregorianCclef\hfil}~=
\keyindex{gregorianCclef}, normally activated for instrument $n$ with the
command
\keyindex{setaltoclefsymbol}\itbrace{n}\keyindex{gregorianCclef}
\item Gregorian F clef: \raise 2.5pt\hbox to 1cm{\gregorianFclef\hfil}~=
\keyindex{gregorianFclef}, normally activated with the command
\keyindex{setbassclefsymbol}\itbrace{n}\keyindex{gregorianFclef}
\end{itemize}
\subsection{Elementary symbols}
\begin{itemize}\setlength{\itemsep}{0ex}
\item Diamond shaped \itxem{punctum} (This has a different shape compared to the
percussion diamond): \raise 2.5pt\hbox{\xgregchar1}~ =
\keyindex{diapunc}\pitchp\ .
\item Square \itxem{punctum}: \raise 2.5pt\hbox{\xgregchar5}~ =
\keyindex{squ}\pitchp\ or \keyindex{punctum}\pitchp\ .
\item Left stemmed \itxem{virga} (not in the 1905 gregorian standard): \raise
2.5pt\hbox{\xgregchar6}~ = \keyindex{lsqu}\pitchp\ .
\item Right stemmed \itxem{virga}: \raise 2.5pt\hbox{\xgregchar7}~ =
\keyindex{rsqu}\pitchp\ or \keyindex{virga}\pitchp\ .
\item \ital{Apostropha}\index{apostropha}: \raise 2.5pt\hbox{\xgregchar3}~ =
\keyindex{apostropha}\pitchp\ .
\item \ital{Oriscus}\index{oriscus}: \raise 2.5pt\hbox{\xgregchar10}~ =
\keyindex{oriscus}\pitchp\ .
\end{itemize}
All non-\ital{liquescens} symbols have non-spacing variants, namely
\keyindex{zdiapunc}, \keyindex{zsqu}, \keyindex{zlsqu}, \keyindex{zrsqu},
\keyindex{zapostropha} and \keyindex{zoriscus}.
\subsection{Plain complex neumes}
Other \itxem{neumes} can be obtained by combining two or more of these
symbols. Since \itxem{neumes} have a special note head width, an additional
shifting macro is provided, namely \keyindex{groff}. It is similar to
\verb|\roff|, but the offset is smaller. For use with comples neumes, another
shifting macro is provided, namely \keyindex{dgroff}, which causes an
offset twice the offset of \verb|\groff|.
Since most of these symbols depend on relative pitches of their components,
we cannot provide all possible compact combinations as single symbols. The ones
that are available in \verb|musixgre| are described below. In the following,
$p_1$, $p_2$, $p_3$, and $p_4$ represent pitches specified as usual. Please refer to
the source file \verb|musixtex.tex| if you wish to see the coding of those
examples for which it is not quoted here.
\verb|\Porrectus| exists in four different shapes, depending on the
difference between first and second argument. The constraint is that
$$ p_1-4 \leq p_2 \leq p_1-1 $$ otherwise a diagnostic occurs. Note also that
\keyindex{bporrectus} provides the first curved part of the \verb|porrectus|
command, if you should need it. It has two arguments, the starting pitch and the lower
pitch.
\item[\keyindex{Porrectusflexus}\fourp], for example:
\item[\keyindex{trigonus}\threep],
%DAS ????????????
%for example\footnote{The second example is in principle irrelevant,
%but it shows the possibilities, in case of.}:
for example:
\medskip
The macro \keyindex{guitar} sets the grid, chord name, barre type,
and on-off indicators for the strings. For example, the first
chord in above example was coded as
\noindent where the first argument is the text to be placed above the grid, the
second is empty (relative barre), and the next six characters indicate if the string
is played or not with either \verb|x|, \verb|o| or \verb|-|. The dots are set with
\keyindex{gdot}~$sb$ where the $s$ is the string and $b$ is the barre. The
rule is set with \keyindex{gbarre}~$b$ where $b$ indicates the position of the barre.
The whole symbol may be vertically shifted with
\keyindex{raiseguitar}\onen, where $n$ is a number
in units of \keyindex{internote}. When using guitar chords, it might be
useful to reserve additional
space above the chord by advancing \keyindex{stafftopmarg} to
something like \verb|stafftopmarg=10\Interligne|.
For frequently used chords, it might be useful to define your own
macros, e.g.
Replaces the default Computer Modern text fonts by Helvetica (sans serif) fonts;
see Section~\ref{UserFonts}.
Use as follows:
\begin{quote}\begin{verbatim}
\input musixtex
\input musixhv
..
\end{verbatim}\end{quote}
The usual ``small'' type commands are supported:
\begin{quote}
\begin{tabular}{lr}
\keyindex{tinytype} & 7pt \\
\keyindex{smalltype} & 8pt \\
\keyindex{Smalltype} & 9pt \\
\keyindex{normtype}& 10pt \\
\keyindex{medtype} & 12pt \\
\end{tabular}
\end{quote}
For all of these, the following variants are supported:
\begin{quote}
\begin{tabular}{ll}
\verb|\rm| & ``Roman'' (sans serif) \\
\verb|\bf| & bold \\
\verb|\it| & ``italic'' (actually oblique) \\
\verb|\bi| & ``bold-italic'' (actually bold-oblique) \\
\verb|\sc| & small capitals\\
\end{tabular}
\end{quote}
The ``big'' type commands are as follows:
\begin{quote}
\begin{tabular}{lr}
\keyindex{bigtype} & 14pt\\
\keyindex{Bigtype} & 17pt\\
\keyindex{BIgtype}& 20pt\\
\keyindex{BIGtype} & 25pt\\
\end{tabular}
\end{quote}
The default variant for all of these is small-caps;
however, \keyindex{font} commands are defined
for all the usual variants at all of these sizes.
To letter-space a title, use the \verb|\so|
command in the \verb\soul\ package.
The following bold-oblique fonts for dynamic marks are defined:
\begin{quote}\begin{tabular}{lr}
\keyindex{ppfftwelve} & 8pt \\
\keyindex{ppffsixteen} & 10pt\\
\keyindex{ppfftwenty} & 12pt \\
\keyindex{ppfftwentyfour} & 14pt \\
\keyindex{ppfftwentynine} & 17pt \\
\end{tabular}\end{quote}
Jazz scores often use a ``handwriting'' font \texttt{JazzText} originally designed by
Richard Sigler and now bundled with Finale. This font is
widely available and is said to be ``free for personal use'' but this
is not sufficiently ``free'' for packaging into TeXLive. A similar
font \texttt{MuseJazzText} is bundled with MuseScore and because it is OFL-licensed,
it can be distributed with \musixtex.
This font will be used for all textual elements of your \musixtex\ score if you input \texttt{musixjt.tex}
after \texttt{musixtex.tex}. Here is an example:
This package provides:
\begin{itemize}\setlength{\itemsep}{0ex}
\item\keyindex{oldGclef} which replaces the ordinary G clef with an old one,
using (for instrument 2 as an example):
\verb|\settrebleclefsymbol2\oldGclef|
\item\keyindex{cqu} $p$ provides a square-headed quarter note with stem up at
pitch $p$.
\item\keyindex{cql} $p$ provides a square-headed quarter note with stem down at
pitch $p$.
\item\keyindex{chu} $p$ provides a square-headed half note with stem up at
pitch $p$.
\item\keyindex{chl} $p$ provides a square-headed half note with stem down at
pitch $p$.
\item\keyindex{cqb} $n$ $p$ provides a square-headed beam note for beam $n$ at pitch $p$.
\item\keyindex{zcqb} $n$ $p$ provides a non-spacing square-headed beam note for beam $n$ at pitch $p$.
\item\keyindex{cnqu} $p$ and \keyindex{cnql} $p$ provide a stemless square
headed
quarter note at pitch $p$.
\item\keyindex{cnhu} $p$ and \keyindex{cnhl} $p$ provide a stemless square
headed half note at pitch $p$.
%\item\keyindex{Hpause} $p$ $n$ provides an arbitrary length pause at pitch
%$p$ and of length $n$ \keyindex{noteskip}. However, in the first of the above
%example, this feature has been used to denote an arbitrary length note rather
%than a rest!
\item\keyindex{Hlonga} $p$ $n$ provides an arbitrary length note at pitch
$p$ and of length $n$ \keyindex{noteskip}.
This feature has been used to denote an arbitrary length note in the second of
the above examples;
in the first example, \keyindex{Hpause}
was used to denote an arbitrary length note rather
than a rest.
\item\keyindex{shortbarrules} has been used to provide bar rules shorter than
the staff vertical width.
\item\keyindex{interbarrules} has been used to provide bars between the
staffs, rather that over them. This is an arbitrary question of taste\ldots
\end{itemize}
\section{musixlyr} \ixtt{musixlyr.tex}
Enables the recommended method for adding lyrics to a score (see Section~\ref{musixlyr}).
\section{musixmad} \ixtt{musixmad.tex} Increases the number of
instruments, slurs and beams up to twelve. When using this extension, it is
not necessary to explicitly input \verb|musixadd.tex|.
If you need greater numbers of these elements, see Sections~\ref{musixmad_setmaxgroups},
\ref{musixmad_setmaxinstruments_ccxviiibeams},
\ref{musixmad_setmaxoctlines},
\ref{musixmad_setmaxslurs} and
\ref{musixmad_setmaxtrills}.
\section{musixmkm} \ixtt{musixmkm.tex}
The following special accidentals used in Turkish classical music (makam\index{makam})
are supported:
\smallskip
\begin{music}
\input musixmkm
\normalmusicsize
\startextract
\Notes\shtanini i\en
\Notes\shbuyukmucenneb i\en
\Notes\shkucuk i\en
\Notes\shbakiye i\en
\Notes\shkoma i\en
\Notes\flkoma i\en
\Notes\flbakiye i\en
\Notes\flkucuk i\en
\Notes\flbuyukmucenneb i\en
\Notes\fltanini i\en
\endextract%
\end{music}%
These are generated by, respectively,
\begin{list}{}{}
\item{}
\begin{tabular}{l}
\keyindex{shtanini} $p$\\
\keyindex{shbuyukmucenneb} $p$\\
\keyindex{shkucuk} $p$\\
\keyindex{shbakiye} $p$\\
\keyindex{shkoma} $p$\\
\keyindex{flkoma} $p$\\
\keyindex{flbakiye} $p$\\
\keyindex{flkucuk} $p$\\
\keyindex{flbuyukmucenneb} $p$\\
\keyindex{fltanini} $p$\\
\end{tabular}
\end{list}
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:
Provides special symbols intended for percussion parts. Included are a
\ital{drum clef}---comprising two vertical parallel lines---and notes with
various specially shaped heads. The note symbols that are available are as
follows:
\begin{itemize}\setlength{\itemsep}{0ex}
\item The \raise.5ex\hbox{\musixchar113}~{}~symbol which is obtained using the
\verb|\qu|, \verb|\qb|, \verb|\cu|, etc. macros preceded by a
``\verb|dc|'' (think of {\it d}iagonal {\it c}ross).
Available are
\keyindex{dcqu},
\keyindex{dcql},
\keyindex{dcqb},
\keyindex{dczq},
\keyindex{dccu},
\keyindex{dcccu},
\keyindex{dccl} and
\keyindex{dcccl}.
\item The \raise.5ex\hbox{\musixchar112}~{}~symbol which is obtained using the
\verb|\qu|, \verb|\qb|, \verb|\cu|, etc. macros preceded by a
``\verb|dh|''
(think of {\it d}iagonal cross {\it h}alf open).
Available are
\keyindex{dhqu},
\keyindex{dhql},
\keyindex{dhqb},
\keyindex{dhzq},
\keyindex{dhcu},
\keyindex{dhccu},
\keyindex{dhcl} and
\keyindex{dhccl}.
\item The \raise.5ex\hbox{\musixchar111}~{}~symbol which is obtained using the
\verb|\qu|, \verb|\qb|, \verb|\cu|, etc. macros preceded by a
``\verb|do|''
(think of {\it d}iagonal cross {\it o}pen).
Available are
\keyindex{doqu},
\keyindex{doql},
\keyindex{doqb},
\keyindex{dozq},
\keyindex{docu},
\keyindex{doccu},
\keyindex{docl} and
\keyindex{doccl}.
\item The \raise.5ex\hbox{\musixchar114}~{}~symbol which is obtained using the
\verb|\qu|, \verb|\qb|, \verb|\cu|, etc. macros preceeded by
``\verb|x|'' (e.g.\ for spoken text of songs).
Available are
\keyindex{xqu},
\keyindex{xql},
\keyindex{xqb},
\keyindex{xzq},
\keyindex{xcu},
\keyindex{xccu},
\keyindex{xcl} and
\keyindex{xccl}.
\item The \raise.5ex\hbox{\musixchar115}~{}~symbol which is obtained using the
\verb|\qu|, \verb|\qb|, \verb|\cu|, etc. macros preceeded by
``\verb|ox|'' .
Available are
\keyindex{oxqu},
\keyindex{oxql},
\keyindex{oxqb},
\keyindex{oxzq},
\keyindex{oxcu},
\keyindex{oxccu},
\keyindex{oxcl} and
\keyindex{oxccl}.
\item The \raise.5ex\hbox{\musixchar118}~{}~symbol which is obtained using the
\verb|\qu|, \verb|\qb|, \verb|\cu|, etc. macros preceeded by
``\verb|ro|'' (think of {\it r}h{\it o}mbus).
Available are
\keyindex{roqu},
\keyindex{roql},
\keyindex{roqb},
\keyindex{rozq},
\keyindex{rocu},
\keyindex{roccu},
\keyindex{rocl} and
\keyindex{roccl}.
\item The \raise.5ex\hbox{\musixchar116}~{}~symbol which is obtained using the
\verb|\qu|, \verb|\qb|, \verb|\cu|, etc. macros preceeded by
``\verb|tg|'' (think of {\it t}rian{\it g}le).
Available are
\keyindex{tgqu},
\keyindex{tgql},
\keyindex{tgqb},
\keyindex{tgzq},
\keyindex{tgcu},
\keyindex{tgccu},
\keyindex{tgcl} and
\keyindex{tgccl}.
\item The \raise.5ex\hbox to 1em{\musixchar117\hfil}~{}~symbol which is obtained
using the
\verb|\qu|, \verb|\qb|, \verb|\cu|, etc.~macros preceeded by
``\verb|k|'' .
Available are
\keyindex{kqu},
\keyindex{kql},
\keyindex{kqb},
\keyindex{kzq},
\keyindex{kcu},
\keyindex{kccu},
\keyindex{kcl} and
\keyindex{kccl}.
\end{itemize}
The diamond shaped noteheads described in Section~\ref{diam} are also
available, because \verb|musixper.tex| inputs \verb|musixdia.tex|.
If any of the foregoing notes need to be dotted, you must use the explicit
dotting macros \verb|\pt|, \verb|\ppt|, or \verb|\pppt| as described in
Section~\ref{dots}.
Since the usage of these note symbols is
not standardized, it would be wise to include in the score a explanation
of which symbol corresponds to which specific percussion instrument.
A special \itxem{drum clef}---comprising two heavy vertical bars---can
be made to replace the normal clef for the $n$-th intrument by saying
\keyindex{setclefsymbol}\onen\keyindex{drumclef} .
To cause this to appear at the right vertical position, the instrument should
previously have been assigned a treble clef (or not explicitly assigned any
clef, thereby giving it a treble clef by default).
Percussion music might be written on a staff with either one or five lines.
If there are several different percussions instruments it may be useful to
use a five-line staff with a drum clef, and differentiate the instruments
by the type of the note heads and the apparent
pitch of the note on the staff. Here is an example of the
latter\footnote{provided by Agusti {\sc Mart\'in Domingo}}:
Here is an example of a single-line percussion staff using
diamond-shaped note heads:
\begin{music}
\parindent 19mm
\instrumentnumber{3}
\setname1{keyboard} \setname2{drum} \setname3{monks}
\setlines2{1}
\setlines3{4}
\setinterinstrument1{-2\Interligne}% less vertical space above
\setinterinstrument2{-2\Interligne}% and below the percussion
\sepbarrules
\setsign1{-1} % one flat at keyboard
\generalmeter{\meterfrac24}
\setmeter3\empty
\setclef3\alto
\setclef1\bass
\setstaffs12 % 2 staffs at keyboard
\setclefsymbol3\gregorianCclef % gregorian C clef at instrument 3
\setclefsymbol2\drumclef % cancel G clef at instrument 2
\startextract
\Notes\hu F|\zh c\hu h&\dnq4&\squ{acd}\en\bar
\NOtes\qu I|\zq N\qu d&\qp&\diapunc f\en
\NOtes\qu J|\zq a\qu e&\ynq4&\diapunc e\en\bar
\notes\hu G|\zh b\hu d&\dnq4&\zsqu d\rsqu g\squ{hgh}\en
\endextract
\end{music}
\noindent which is coded as follows:
\begin{verbatim}
\parindent 19mm
\instrumentnumber{3}
\setname1{keyboard} \setname2{drum} \setname3{monks}
\setlines2{1}
\setlines3{4}
\setinterinstrument1{-2\Interligne}% less vertical space above
\setinterinstrument2{-2\Interligne}% and below the percussion
\sepbarrules
\setsign1{-1} % one flat at keyboard
\generalmeter{\meterfrac24}
\setmeter3{\empty}
\setclef3{\alto}
\setclef1{\bass}
\setstaffs1{2} % 2 staffs at keyboard
\setclefsymbol3{\gregorianCclef} % gregorian C clef at instrument 3
\setclefsymbol2{\drumclef} % cancel G clef at instrument 2
\startextract
\end{verbatim}
% (DAS) Sorry, guys, I couldn't figure out how to get the |'s to work in this
% verbatim.
%
\vskip-11pt
\def\Vert{{\tt\char'174}}
\noindent\verb|\Notes\hu F|\Vert\verb|\zh c\hu h&\dnq4&\squ{acd}\en\bar|\\
\verb|\NOtes\qu I|\Vert\verb|\zq N\qu d&\qp&\diapunc f\en|\\
\verb|\NOtes\qu J|\Vert\verb|\zq a\qu e&\ynq4&\diapunc f\en\bar|\\
\verb|\notes\hu G|\Vert\verb|\zh b\hu d&\dnq4&\zsqu d\rsqu g\squ{hgh}\en|\\
\verb|\endextract|
\section{musixplt}\index{musixplt@{\tt musixplt.tex}}\label{palatino}
Replaces the default Computer Modern text fonts by Palatino fonts;
see Section~\ref{UserFonts}.
Use as follows:
\begin{quote}\begin{verbatim}
\input musixtex
\input musixplt
..
\end{verbatim}\end{quote}
You may need to install additional packages: \texttt{psnfss}, \texttt{palatino} and \texttt{fpl}.
The usual ``small'' type commands are supported:
\begin{quote}
\begin{tabular}{lr}
\keyindex{tinytype} & 7pt \\
\keyindex{smalltype} & 8pt \\
\keyindex{Smalltype} & 9pt \\
\keyindex{normtype}& 10pt \\
\keyindex{medtype} & 12pt \\
\end{tabular}
\end{quote}
For all of these, the following variants are supported:
\begin{quote}
\begin{tabular}{ll}
\verb|\rm| & Roman \\
\verb|\bf| & bold \\
\verb|\it| & italic \\
\verb|\bi| & bold italic \\
\verb|\sc| & small capitals (and old-style figures)\\
\end{tabular}
\end{quote}
The ``big'' type commands are as follows:
\begin{quote}
\begin{tabular}{lr}
\keyindex{bigtype} & 14pt\\
\keyindex{Bigtype} & 17pt\\
\keyindex{BIgtype}& 20pt\\
\keyindex{BIGtype} & 25pt\\
\end{tabular}
\end{quote}
The default variant for the ``small'' types is Roman and for
the ``big'' ones, small-caps;
however, \keyindex{font} commands are defined
for all the usual variants at all of these sizes.
To letter-space a title, use the \verb|\so|
command in the \verb\soul\ package.
The following bold-italic fonts for dynamic marks are defined:
\begin{quote}\begin{tabular}{lr}
\keyindex{ppfftwelve} & 8pt \\
\keyindex{ppffsixteen} & 10pt\\
\keyindex{ppfftwenty} & 12pt \\
\keyindex{ppfftwentyfour} & 14pt \\
\keyindex{ppfftwentynine} & 17pt \\
\end{tabular}\end{quote}
\section{musixpoi}
Adds definitions of less common singly and doubly dotted notes.
Available are
\keyindex{ccup},
\keyindex{zccup},
\keyindex{cclp},
\keyindex{zcclp},
\keyindex{ccupp},
\keyindex{zccupp},
\keyindex{cclpp},
\keyindex{zcclpp},
\keyindex{cccup},
\keyindex{zcccup},
\keyindex{ccclp},
\keyindex{zccclp},
\keyindex{cccupp},
\keyindex{zcccupp},
\keyindex{ccclpp},
\keyindex{zccclpp},
\keyindex{ccccup},
\keyindex{zccccup},
\keyindex{cccclp},
\keyindex{zcccclp},
\keyindex{ccccupp},
\keyindex{zccccupp},
\keyindex{cccclpp} and
\keyindex{zcccclpp}.
This replaces the default definitions used for dynamic marks to use a ``mini-font''
\verb\xppff10\ designed by Hiroaki \textsc{Morimoto}. It is used as follows:
\begin{quote}\begin{verbatim}
\input musixtex
\input musixppff
..
\end{verbatim}\end{quote}
\noindent The new dynamic marks are as follows:
\font\xppff=xppff10
\begin{quote}
\xppff
pppp\ ppp\ pp\ p\ mp\ mf\ f\ fp\ sf\ ff\ fff\ ffff\ sfz\ sfzp
\end{quote}
Note that the \verb|xppff10| font has defined glyphs only for the following five characters: f, m, p, s and~z;
use \keyindex{ppff} etc.\@
for other bold-italic text in music.
\section{musixps}\label{musixps}\index{musixps@{\tt musixps.tex}}
Activates type K Postscript slurs, ties, and hairpins; see Chapter~\ref{PostscriptSlurs}.
Use as follows:
\begin{quote}\begin{verbatim}
\input musixtex
\input musixps
..
\end{verbatim}\end{quote}
\section{musixstr}\label{musixstr}\index{musixstr@{\tt musixstr.tex}}
Provides bowing and other symbols for \itxem{string instruments}\footnote{provided
by Werner {\sc Icking}}. The symbol can be posted at the desired position using
\verb|\zcharnote|\pitchp\verb|{|$command$\verb|}|. The available symbols and
their meanings are as follows:
Provides certain text-handling facilities for titles, footnotes, and other
items not related to lyrics. It should not be used with \LaTeX. It includes
\begin{itemize}\setlength{\itemsep}{0ex}
\item definitions of \keyindex{hsize}, \keyindex{vsize},
\keyindex{hoffset}, \keyindex{voffset} suitable for A$4$ paper; those using
other sizes may wish to modify it once and for all;
\item a \keyindex{rectoverso}\verb|{|\emph{dimension}\verb|}| command to set up even/odd-page
asymmetric margins;
\item a set of text size commands:
\begin{description}\setlength{\itemsep}{0ex}
\item[\keyindex{eightpoint}] which sets the usual \keyindex{rm},
\keyindex{bf}, \keyindex{sl}, \keyindex{it} commands to $8$ point font size;
\item[\keyindex{tenpoint}] which sets the usual \keyindex{rm},
\keyindex{bf}, \keyindex{sl}, \keyindex{it} commands to $10$ point font size;
\item[\keyindex{twlpoint}] (or \keyindex{twelvepoint}) to get $12$ point font size;
\item[\keyindex{frtpoint}] to get $14.4$ point font size;
\item[\keyindex{svtpoint}] to get $17.28$ point font size;
\item[\keyindex{twtypoint}] to get $20.74$ point font size;
\item[\keyindex{twfvpoint}] to get $24.88$ point font size;
\end{description}
\item commands for creating title-page headings:
\begin{itemize}\setlength{\itemsep}{0ex} \item \keyindex{author} or
\keyindex{fullauthor} to be put at the right of the first page, below the
title of the piece; the calling sequence is, for example
\noindent where the \verb|\\| causes the author's name to be displayed on
two lines;
\item \keyindex{shortauthor} to be put at the bottom of each page;
\item \keyindex{fulltitle} which is the main title of the piece;
\item \keyindex{subtitle} is displayed below the main title of the piece;
\item \keyindex{shorttitle} or \keyindex{title}
which is the title repeated at the bottom of each page;
\item \keyindex{othermention} which is displayed on the left of the page,
vertically aligned with author's name. It may contain \verb|\\| to display it on
several lines;
\item \keyindex{headline} which displays the argument at the top of the title page (use
\verb|\hss| after or before the argument text or both to left-align or
right-align or center the text);
\item \keyindex{maketitle} which displays all the previous stuff;
\end{itemize}
\item commands for making \itxem{footnotes}:
\begin{itemize}\setlength{\itemsep}{0ex}
\item The normal Plain-\TeX\ \keyindex{footnote} command, which has two
arguments---not just one as in \LaTeX\protect\index{LATEX@\LaTeX}---namely
the label of the footnote, which can be any sequence of characters, and
the text of the footnote. This command does not work inside
boxes, so it cannot be issued within music;
\item The \keyindex{Footnote} command, which counts the footnotes and uses a
number as the label of the footnote (equivalent to \LaTeX's \verb|\footnote|
command). The same restriction as with \verb|\footnote| applies concerning
its use within the music coding;
\item The \keyindex{vfootnote} command, taken from the Plain-\TeX, which
places a footnote at the bottom of the current page, but does not put
the footnote label at the place the command is entered in the main text. This
also may not be used within music, but if a footnote is needed whose reference
lies inside the music, it can be entered in two steps:
\begin{enumerate}
\item manually insert the reference inside the music, using e.g., \verb|zcharnote|;
\item post the footnote itself with \verb|\vfootnote| outside the music,
either before \keyindex{startpiece} or between \keyindex{stoppiece} and
\keyindex{contpiece} or equivalent commands.
\end{enumerate}
\end{itemize}
\end{itemize}
\section{musixthacc}\index{musixthacc@{\tt musixthacc.tex}}\label{musixthacc}
Provides ``thin'' accidentals
\keyindex{thna}~$p$, \keyindex{thsh}~$p$, \keyindex{thfl}~$p$, \keyindex{thdsh}~$p$
and \keyindex{thdfl}~$p$:
\smallskip
\begin{music}
\input musixthacc
\normalmusicsize
\startextract
\Notes\thna i\en
\Notes\thsh i\en
\Notes\thfl i\en
\Notes\thdsh i\en
\Notes\thdfl i\en
\endextract%
\end{music}%
Any necessary adjustment of horizontal position and spacing is up to
the user and \keyindex{relativeaccid} adjustment is not effective.
\section{musixtmr}\index{musixtmr@{\tt musixtmr.tex}}\label{times}
Replaces the default Computer Modern text fonts by Times fonts;
see Section~\ref{UserFonts}.
Use as follows:
\begin{quote}\begin{verbatim}
\input musixtex
\input musixtmr
..
\end{verbatim}\end{quote}
The usual ``small'' type commands are supported:
\begin{quote}
\begin{tabular}{lr}
\keyindex{tinytype} & $7$pt \\
\keyindex{smalltype} & $8$pt \\
\keyindex{Smalltype} & $9$pt \\
\keyindex{normtype}& $10$pt \\
\keyindex{medtype} & $12$pt \\
\end{tabular}
\end{quote}
For all of these, the following variants are supported:
\begin{quote}
\begin{tabular}{ll}
\verb|\rm| & Roman \\
\verb|\bf| & bold \\
\verb|\it| & italic \\
\verb|\bi| & bold italic \\
\verb|\sc| & small capitals \\
\end{tabular}
\end{quote}
The ``big'' type commands are as follows:
\begin{quote}
\begin{tabular}{lr}
\keyindex{bigtype} & $14$pt\\
\keyindex{Bigtype} & $17$pt\\
\keyindex{BIgtype}& $20$pt\\
\keyindex{BIGtype} & $25$pt\\
\end{tabular}
\end{quote}
The default variant for all of them is Roman;
however, \keyindex{font} commands are defined
for all the usual variants at all of these sizes.
To letter-space a title, use the \verb|\so|
command in the \verb\soul\ package.
The following bold-italic fonts for dynamic marks are defined:
\begin{quote}\begin{tabular}{lr}
\keyindex{ppfftwelve} & 8pt \\
\keyindex{ppffsixteen} & 10pt\\
\keyindex{ppfftwenty} & 12pt \\
\keyindex{ppfftwentyfour} & 14pt \\
\keyindex{ppfftwentynine} & 17pt \\
\end{tabular}\end{quote}
\section{musixtnt}\label{musixtnt}
This package (tnt = Transform Notes) provides a macro \keyindex{TransformNotes} which makes
possible several ``transformations'' of the effect of notes commands such as \keyindex{notes}.
The \verb\musixtnt\ package is distributed separately from \verb\musixtex\.
In general the effect of \verb|\TransformNotes{|\textit{input}\verb|}{|\textit{output}\verb|}|
is that subsequent notes commands in the source will expect their arguments
to match the \textit{input} pattern but
the notes will be typeset according to the \textit{output} pattern.
For example,
\begin{verbatim}
\TransformNotes{#2}{#2}
\end{verbatim}
would be appropriate for a four-instrument score (arguments \verb|#2|, \verb|#3|, \verb|#4|, and \verb|#5|, separated by three
\verb\&\s, but the third instrument (\verb|#4|) will be discarded.
The instrument/staff numbers in the first argument must start at $2$ and increase
consecutively, using \verb|&| (or \| for multi-staff instruments) as a separator.
The reason that the segment identifiers start at $2$ is that the first argument for \keyindex{vnotes}
is a spacing parameter.
It is
essential that every \verb|\znotes|, \verb|\notes|, \verb|\Notes|, \verb|\NOtes|, etc.\@ command in
the score match the pattern of the first argument to \keyindex{TransformNotes} exactly; for example,
too few (or too many)
note segments will result in unintentionally discarded material and possibly compilation failure.
Similarly, it is not possible to use \keyindex{nextinstrument}, \keyindex{nextstaff}, \keyindex{selectinstrument} or \keyindex{selectstaff}, or to hide the \verb|&| (or \|) tokens inside
a user-defined macro.
An auxiliary program \verb|msxlint| distributed in the \verb\musixtnt\ package can be used to detect such incompatibilities.
\keyindex{TransformNotes} may be used anywhere between \keyindex{startpiece}
and the command that ends the piece.
\subsection{Extracting single-instrument parts from multi-instrument scores}\index{extracting parts}
To extract
a single-instrument part from a (copy of a) multi-instrument \musixtex\ score:
\begin{itemize}
\item Set \verb|\nbinstrument| to 1; for example, with command \verb|\instrumentnumber1|.
\item Use \keyindex{TransformNotes} to discard all but one of the note segments in notes
commands.
For example, the following line placed after
\verb|\startpiece| (but before any note commands) would be appropriate for a
four-instrument score and will result in a single-instrument part for the second of
these:
\begin{verbatim}
\TransformNotes{#2}{#3}%
\end{verbatim}
\end{itemize}
Caveats:
\begin{itemize}
\item
Some additional revisions to the source for the part might be necessary:
\begin{itemize}
\item adjusting \verb|\setname|, \verb|\setclef|, \verb|\setsign|,
\verb|\setmeter| and \verb|\setstaffs| commands, as necessary; see
Section~\ref{CodingRules} for coding techniques that will make this easier.
\item ensuring that tempo and roadmap markings (\textbf{D.C.}, \textbf{Fine}, etc.) are in
the appropriate instrument segment;
\end{itemize}
\item
When the extracted part score is compiled and viewed, it may be seen
that horizontal-spacing commands designed for \emph{multiple} instruments can produce bad
spacing when used for a \emph{single} instrument. Bad spacing can be corrected manually but
this is very tedious; an auxiliary program called \verb\autosp\
can be used to automate this process; see Section~\ref{autosp}.
\end{itemize}
\subsection{Other applications}
The \keyindex{TransformNotes} macro may be used for other purposes. Here are some examples:
\begin{list}{}{}\item
\verb|\TransformNotes{#2}{#2&\transpose+7#3}%|
\end{list}
will begin transposing\index{transpose@{\Bslash transpose}} just the second instrument (argument \verb|#3|).
\begin{list}{}{}\item
\verb|\TransformNotes{#2|\|\verb|#3}{#2|\|\verb|#3&\tinynotesize#4}%|
\end{list}
will begin typesetting the notes of the second instrument (\verb|#4|) in tiny size.
\begin{list}{}{}\item
\verb|\TransformNotes{#2}{#3}%|
\end{list}
will switch the order of the two instruments.
\begin{list}{}{}\item
\verb|\TransformNotes{#2}{#2}%|
\end{list}
will restore normal two-instrument processing.
The \texttt{musixtnt} implementation of \keyindex{TransformNotes} is not compatible with the
\texttt{musixlyr} extension
package for lyrics described in Section~\ref{musixlyr}. For extracting or omitting parts
in scores with lyrics, one may either use the
\texttt{autosp}\index{autosp@{\tt autosp}} preprocessor discussed in Section~\ref{autosp}, which provides
an alternative implementation of \keyindex{TransformNotes},
or the techniques described in Chapter~\ref{parts}.
\section{musixvbm}\ixtt{musixvbm.tex}
\label{musixvbm}
By default, \texttt{musixtex} produces beams using special fonts. Unfortunately, long beams may have
unsightly minor discontinuities (gaps or bumps). The \texttt{musixvbm} add-on
by Hiroaki \textsc{Morimoto} produces smooth vectorized beams; simply input
\texttt{musixvbm} in the preamble of your score (after inputting \texttt{musixtex}).
For example, compare
\medskip
\begin{music}
\let\extractline\hbox
\vectorizedbeamfalse % disable vectorized beams
\nostartrule
\setclef1{\bass}
\hbox to \hsize{%
\hss
\startextract
\nnotes\ibbl0G1\qb0{GJKLMLMLMLMLMLMK}\tqb0L\en
\zendextract
\hss
\raise20pt\hbox{ and }
\hss
\input musixvbm
\vectorizedbeamtrue % re-enable vectorized beams
\startextract
\nnotes\ibbl0G1\qb0{GJKLMLMLMLMLMLMK}\tqb0L\en
\zendextract
\hss}
\end{music}
\medskip
\noindent
with various magnifications. The output on the left shows a font-based beam; the one
on the right
shows the same beam with
\texttt{musixvbm} activated.
All the other beams in this report are vectorized.
The only known disadvantage with use of \texttt{musixvbm} is that many \texttt{dvi} viewers
(including \texttt{xdvi} and \texttt{yap}) do not support the ``\texttt{tpic} specials''
that implement vectorized beams in \texttt{dvi} output, so that no beams are shown\footnote{%
The \texttt{dviout} program for Windows supports \texttt{tpic} specials;
it is available from CTAN and in the Win32 distribution of TeXLive.};
however, Postscript and PDF
output generated using \texttt{dvips} and \texttt{ps2pdf} (or using
\texttt{dvipdfm},
or by processing the score using \texttt{pdfetex}) should be satisfactory.
If Postscript hairpins
(as described in Section~\ref{PostscriptSlurs}) are not being used,
the \texttt{musixvbm} add-on also vectorizes crescendos and
decrescendos.
\section{tuplet}
This file does nothing; it is provided for compatibility with
\musixtex{} version 1.20 or earlier and legacy scores.
Since version 1.21, \verb|musixtex.tex| itself contains all the functions
of the older \texttt{tuplet.tex}, namely
definitions of
\keyindex{tuplettxt},
\keyindex{uptuplet} and
\keyindex{downtuplet}.
See Section~\ref{tuplet}.
