diff options
Diffstat (limited to 'macros/musixtex/doc/musixdoc/parameters.tex')
-rw-r--r-- | macros/musixtex/doc/musixdoc/parameters.tex | 220 |
1 files changed, 0 insertions, 220 deletions
diff --git a/macros/musixtex/doc/musixdoc/parameters.tex b/macros/musixtex/doc/musixdoc/parameters.tex deleted file mode 100644 index 8ecffdad46..0000000000 --- a/macros/musixtex/doc/musixdoc/parameters.tex +++ /dev/null @@ -1,220 +0,0 @@ -\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} |