diff --git a/CHANGELOG.md b/CHANGELOG.md index a59dcaf39..ebae55c50 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -11,6 +11,9 @@ As of v3.0.0 this project adheres to [Semantic Versioning](http://semver.org/). - In cases of a syllable without note, the space between notes of the previous and next syllables was sometimes not enough (see [#1137](https://github.com/gregorio-project/gregorio/issues/1137)). - `moraadjustment` and `moraadjustmentbar` did not scale when changing factor, they do now. +### Added +- Some vertical spaces can now be adjusted for a particular line in a score. Use `\grechangenextscorelinedim` prior to including the score to set the desired values. `spaceabovelines`, `spacebeneathtext`, and `spacelinestext` may be changed with this command. See GregorioRef and [#1156](https://github.com/gregorio-project/gregorio/issues/1156) for details. + ### Changed - When the clef and the first note are at a reasonable vertical distance, `shortspaceafterlineclef` is used instead of `spaceafterlineclef` (make them equal if you don't want this feature). This is used only on the first line, when there is an initial on one line. See [#1138](https://github.com/gregorio-project/gregorio/issues/1138). - When an alteration follows a bar, it is not completely taken into consideration in the new bar spacing algorithm (similarly to the punctum mora), this behavior can be tuned with the newly introduced space `alterationadjustmentbar`. See [#1146](https://github.com/gregorio-project/gregorio/issues/1146). diff --git a/doc/Command_Index_User.tex b/doc/Command_Index_User.tex index d0f40a491..64dae5e2d 100644 --- a/doc/Command_Index_User.tex +++ b/doc/Command_Index_User.tex @@ -249,6 +249,18 @@ \subsubsection{Fine Tuning Dimensions} & \texttt{inherited} & Distance will inherit its value from another distance. When this argument is used, then \#2 should be the name of another Gregorio\TeX\ distance. \end{argtable} +\macroname{\textbackslash grechangenextscorelinedim}{\{\#1\}\{\#2\}\{\#3\}\{\#4\}}{gregoriotex-spaces.tex} +Changes one of Gregorio\TeX’s distances for a given line in the next included score. This works with \texttt{spaceabovelines}, \texttt{spacebeneathtext}, and \texttt{spacelinestext}. + +\begin{argtable} + \#1 & integer & The number of the line in the next score to be adjusted.\\ + \#2 & string & The name of the distance to be changed. See \nameref{distances} below.\\ + \#3 & string & The distance in string format. \textbf{Note:} You cannot use a length register for this argument. You \emph{must} use a string because of the way that Gregorio\TeX\ handles spaces.\\ + \#4 & \texttt{fixed} & Distance will not scale when staff size is changed.\\ + & \texttt{scalable} & Distance will scale when staff size is changed.\\ + & \texttt{inherited} & Distance will inherit its value from another distance. When this argument is used, then \#3 should be the name of another Gregorio\TeX\ distance. +\end{argtable} + \macroname{\textbackslash grescaledim}{\{\#1\}\{\#2\}}{gregoriotex-spaces.tex} Macro to turn on or off scaling with the staff size for a particular distance. diff --git a/doc/Command_Index_internal.tex b/doc/Command_Index_internal.tex index d3784fbe8..b040d19f0 100644 --- a/doc/Command_Index_internal.tex +++ b/doc/Command_Index_internal.tex @@ -1209,6 +1209,11 @@ \section{Gregorio\TeX{} Controls} \macroname{\textbackslash gre@dimension}{}{gregoriotex-spaces.tex} Workhorse function for setting distances in \verb=\grecreatedim= and \verb=\grechangedim=. +\macroname{\textbackslash gre@changedimforline}{\#1\#2\#3}{gregoriotex-spaces.tex} +Saves the current value of the dimension and then changes it. The arguments +are the same as \verb=\grechangedim=. Used to temporarily change the dimension +for a given line, which is restored at the next beginning of the next line. + \macroname{\textbackslash gre@setstafflines}{\#1}{gregoriotex-main.tex} Sets the number of staff lines. diff --git a/doc/Makefile.am b/doc/Makefile.am index a79d76bb8..becba6094 100644 --- a/doc/Makefile.am +++ b/doc/Makefile.am @@ -30,7 +30,7 @@ GregorioRef.pdf: $(SRCFILES) $(MAKE) $(AM_MAKEFLAGS) -C ../src gregorio ../src/gregorio -o factus.gtex $(