musiktheorietheorie/musixtex/doc/musixdoc/parameters.tex

\chapter{Layout Parameters}\label{LayoutParameters}
 Most layout parameters are set by \musixtex\ to reasonable default values.
However, some projects will require altering one or more of them. In this
section we discuss the most important parameters and how to change them.

 \section{List of layout parameters}
 In the following, the indication ``\nochange'' does not mean that this
parameter cannot be changed at all, but that it should not be modified
directly, e.g,.~by saying something like \verb|\Interligne=14pt|. In other
words, changes in these parameters must be accomplished only by more
comprehensive macros which not only revise them but at the same time perform
other necessary related changes. Even though you cannot \ital{change} these,
you may \ital{refer} to them in your coding if that proves useful.

\begin{description}\setlength{\itemsep}{0ex}
 \item[\keyindex{Interligne} :]vertical distance between the bottoms of
consecutive staff lines of the current instrument, taking no account of a
possible alteration by \keyindex{setsize}; \nochange.
 \item[\keyindex{internote} :]vertical spacing between notes one scale
step apart in the current instrument, taking account of a possible alteration
by \keyindex{setsize}; \nochange.
Note that each distinct instrument may have a different
\verb|\internote| (see Chapter~\ref{staffspacing}).
 \item[\keyindex{Internote} :]vertical spacing between notes one scale
step apart in any instrument whose \keyindex{setsize} has the default
value \keyindex{normalvalue} ($1.0$), equal to \verb|0.5\Interligne|; \nochange.
\item[\keyindex{staffbotmarg} :]margin below the first (lowest) staff of the
first (lowest) instrument. Changes are recognized at the next system.
Default is \verb|3\Interligne|.
 \item[\keyindex{stafftopmarg} :]margin above the last (uppermost) staff of
last (uppermost) instrument. Changes are recognized at the next system.
Default is \verb|3\Interligne|.
 \item[\keyindex{interbeam} :]vertical distance between beams; \nochange.
\item[\keyindex{interstaff} :]a very important macro with a single numerical
argument representing the factor that multiplies \verb|2\internote| to give the
distance between the bottom of one staff and the bottom of the next one. In
fact the macro redefines the parameter \verb|\interfacteur|. Default is 9.
\verb|\interstaff| applies to all the
instruments; to set the inter-staff spacing for a single instrument,
use \keyindex{setinterstaff}\itbrace{n}\itbrace{m},
$n$ is the instrument and $m$ is the replacement factor for that instrument.
Note that
after you have used \keyindex{setinterstaff},
you cannot reset the distances for that instrument with
\keyindex{interstaff}; you must subsequently use
\keyindex{setinterstaff} for that purpose.
\item[\keyindex{interportee} :]distance between the bottom of one staff and
the bottom of the next one. It is always reset to
2 times \keyindex{internote} times the \keyindex{interfacteur} for the current
instrument at the next system.
Therefore, trying to change \verb|\interportee| will have no effect. Change
\verb|\interstaff| or use \keyindex{setinterstaff} instead. 
\item[\keyindex{interinstrument} :]additional vertical distance between
two consecutive instruments. This means that the distance between the lowest
line of the previous instrument and the lowest line of the top staff of the current
instrument is \verb|\interportee+\interinstrument|. The
default value of \verb|\interinstrument| is zero, but sometimes you
may want additional space between distinct instruments. This is a general
dimension register. As usual in \TeX, it can be set using a command such as
\verb|\interinstrument=10pt| or \verb|\interinstrument=6\internote|. Its
value can be overridden for the space above any particular instrument
with the macro \keyindex{setinterinstrument}\itbrace{n}\itbrace{s}, where
$n$ is the instrument and $s$ is the replacement value of the space to
be added. The \verb|\setinterinstrument| macro may be useful in some vocal
scores to provide vertical space for lyrics. 
Note that
after you have used \keyindex{setinterinstrument},
you cannot reset the distances for that instrument with
\keyindex{interinstrument}; you must subsequently use
\keyindex{setinterinstrument} for that purpose.

 \item[\keyindex{systemheight} :]distance from the bottom of the
lowest staff to the top of the highest one. This is the length of any
vertical lines such as repeats that span the full height of a system;
\nochange.
\end{description}

 In addition, when handling notes of a given staff of a given instrument, the
following dimensions are available (note these are not true registers, but
\ital{equivalenced symbols} through a \verb|\def|):

\begin{description}\setlength{\itemsep}{0ex}
 \item[\keyindex{altplancher} :]altitude of the lowest line of the lowest
instrument; \nochange.
 \item[\keyindex{altitude} :]altitude of the lowest line of the lowest
staff of the current instrument; \nochange.
 \item[\keyindex{altportee} :]altitude of the lowest line of the current
staff; \nochange.

 %??? Next perhaps will change to steps of \verb|\internote|.

 \item[\keyindex{stemfactor} :]parameter defining the length of stems on
half, quarter, and beamed eighth notes, in units of \verb|\interbeam|.
Normally a stem has the length of one octave,
i.e.,~\verb|3.5|\keyindex{Interligne}. However, this is not correct for small or tiny
note sizes. Therefore, stem length is defined as a multiple of the
dimension \keyindex{interbeam}, which is chosen because it is automatically
redefined as a
different multiple of \keyindex{Interligne} whenever note size is changed. For
example, with \verb|\normalmusicsize| when \verb|\setsize| is
\verb|\normalvalue|, \verb|\interbeam| is \verb|0.75|\keyindex{Interligne}. This
legislates a default value for \keyindex{stemfactor} of $4.66$ ($=3.5/0.75$).
To change stem length, it is easiest to use e.g.,~\keyindex{stemlength}\verb|{3.5}|, which simply redefines \verb|\stemfactor|.
Subsequently, \verb|\stemfactor| will not automatically be reset to the default,
but keep in mind that if it is changed
inside a notes group, the change will only be effective within that notes group.
\end{description}

 \section{A convenient macro for changing layout parameters}
Of the parameters just described that can be changed, many should only be
changed between the end of one system and the beginning of the next. The
command sequence \verb|\def\atnextline{|\ital{any control sequence}\verb|}|
may be useful for this purpose. It will cause \ital{any control sequence} to
be inserted right before the next new line is begun, provided the line break
is not initiated by a \verb|\startpiece|. Thus this will work with
automatically generated line breaks, with those forced by \verb|\alaligne|, and
with those forced by explicit use of \verb|\endpiece| or \verb|\stoppiece|
followed by \verb|\contpiece|. (Note, however, that in the latter case it
would be just as convenient to enter the parameter changes explicitly as well.)
The control sequence will only be executed once,
after which \verb|\atnextline| is redefined as \verb|\empty|.

 \section{Changing the number of lines per staff}\label{stafflinenumber}
Naturally, the default number of lines per staff is five. But you may want a
different number in some or all staves, for example for gregorian music,
percussion music, guitar tablature, or early baroque keyboard music. To do so,
use the command \keyindex{setlines}\itbrace{n}\itbrace{m}~where $n$ is the
instrument number and $m$ is the number of lines.

 \section{Resetting normal layout parameters}
The general size can only be changed with one of the commands
\keyindex{smallmusicsize},
\keyindex{normalmusicsize}, \keyindex{largemusicsize}, or
\keyindex{Largemusicsize}. Beyond that, the command
\keyindex{resetlayout} will reset the following key layout parameters
to their default values: \keyindex{staffbotmarg} (\verb|3\Interligne|),
\keyindex{stafftopmarg} (\verb|3\Interligne|), \keyindex{interstaff} ($9$),
 number of lines per staff for all instruments ($5$); and will reset all clef
symbols to standard clef symbols.

 \section{Split and Shortened Systems}
It is sometimes desirable to typeset a ``shortened'' system or to split
a system into left and right segments, as in the following (extracted from a 
Geminiani \emph{concerto grosso}):

\begin{music}
\smallmusicsize
\setclef1\bass
\setclef5\treble\settrebleclefsymbol5\trebleoct
\generalsignature{-2}
\instrumentnumber5
\songbottom{1}\songtop{5}
\setinterinstrument4{1\internote}
\nobarnumbers
\generalmeter{\meterfrac38}
\hbox to\hsize\bgroup\vbox\bgroup\hsize=1.7in  
\startpiece\addspace\afterruleskip
\Notes\qa G\sk&\ibu1i{-1}\qb1i\qb1{.g}&\ca d\qa g&\ca n\itieu3n\qa n&\ca g\ds\en
\notes\ds\sk&\sk\tbbu1\tqu1g&\sk\sk&\sk\sk\ttie3&\ds\sk\en
\znotes&&&&\lcn{q}{\bf D.S. al\kern3ex}\coda p\en
\setdoublebar\endpiece
\egroup\hfill\vbox\bgroup\hsize=3.7in         
\generalmeter{\allabreve}
\startpiece\addspace\afterruleskip
\znotes&&&&\coda o\en
\NOtes\qa{.G}&\qa{.k}&\qa{.d}&\qa n&\qa g\en
\notes\sk\sk\qs\cca N&\sk\sk\qs\cca i&\sk\sk\qs\cca k&\qs\ibbl3p{-2}\qb3{p}\qb3{o}\tql3n&\qp\sk\sk\sk\en
\NOtes\qa{.M}&\qa{.h}&\qa{.k}&\qa o&\ha k\en
\Notes\sk&\sk&\sk&\itieu3r\qa r&\sk\en
\notes\qs\cca M&\qs\cca h&\qs\cca k&\sk\sk&\sk\sk\en
\bar
\NOtes\wh L\sk&\qa{g}\qa{g}&\ha{l}\sk&\ttie3\ha r\sk&\ha{g}\sk\en
\NOTes\sk&\ha j&\ha{n}&\tr s\ha q&\ha{n}\en
\bar
\nspace
\NOtesp\ha{.K}&\ha{.h}&\ha{.k}&\ha{.r}&\ha{.^m}\en
\setdoublebar\endpiece
\egroup\egroup                                  
\end{music}

This was coded as follows:
\begin{footnotesize}
\begin{quote}\begin{verbatim}
\setclef1\bass\setclef5\treble\settrebleclefsymbol5\trebleoct
\generalsignature{-2}
\instrumentnumber5\songbottom{1}\songtop{5}
\nobarnumbers
\generalmeter{\meterfrac38}
\hbox to\hsize\bgroup\vbox\bgroup\hsize=1.7in % specify length of left segment
\startpiece\addspace\afterruleskip
\Notes\qa G\sk&\ibu1i{-1}\qb1i\qb1{.g}
  &\ca d\qa g&\ca n\itieu3n\qa n&\ca g\ds\en
\notes\ds\sk&\sk\tbbu1\tqu1g
  &\sk\sk&\sk\sk\ttie3&\ds\sk\en
\znotes&&&&\lcn{q}{\bf D.S. al\kern3ex}\coda p\en
\setdoublebar\endpiece
\egroup\hfill\vbox\bgroup\hsize=3.7in         % specify length of right segment
\generalmeter{\allabreve}
\startpiece\addspace\afterruleskip
\znotes&&&&\coda o\en
\NOtes\qa{.G}&\qa{.k}&\qa{.d}&\qa n&\qa g\en
\notes\sk\sk\qs\cca N&\sk\sk\qs\cca i
  &\sk\sk\qs\cca k
  &\qs\ibbl3p{-2}\qb3{p}\qb3{o}\tql3n
  &\qp\sk\sk\sk\en
\NOtes\qa{.M}&\qa{.h}&\qa{.k}&\qa o&\ha k\en
\Notes\sk&\sk&\sk&\itieu3r\qa r&\sk\en
\notes\qs\cca M&\qs\cca h&\qs\cca k
  &\sk\sk&\sk\sk\en
\bar
\NOtes\wh L\sk&\qa{g}\qa{g}&\ha{l}\sk
  &\ttie3\ha r\sk&\ha{g}\sk\en
\NOTes\sk&\ha j&\ha{n}&\tr s\ha q&\ha{n}\en
\bar
\nspace
\NOtesp\ha{.K}&\ha{.h}&\ha{.k}&\ha{.r}&\ha{.^m}\en
\setdoublebar\endpiece
\egroup\egroup                                % close open \bgroups 
\end{verbatim}\end{quote}
\end{footnotesize}