1 %%% lilyponddefs.tex -- TeX macros for LilyPond output.
3 %%% source file of the GNU LilyPond music typesetter
5 %%% (c) 1998--2004 Jan Nieuwenhuizen <janneke@gnu.org>
6 %%% Han-Wen Nienhuys <hanwen@cs.uu.nl>
7 %%% Mats Bengtsson <mats.bengtsson@s3.kth.se>
10 %% Avoid \par while reading this file.
12 \edef\lilyponddefsELC{\the\endlinechar}%
15 %% This runs with plain TeX, LaTeX, pdftex, and texinfo.
17 %% To avoid interferences, lilyponddefs.tex must be loaded within a group.
18 %% It is loaded only once, so the definitions must be global.
20 %% The overall structure of a file created by LilyPond is as follows:
22 %% <lilypond parameter definitions>
24 %% \ifx\lilypondstart \undefined
25 %% \input lilyponddefs
31 %% A temporary variable.
35 %% The scaling factor for all dimensions.
39 \long\gdef\lilypondfirst#1#2{#1}
40 \long\gdef\lilypondsecond#1#2{#2}
42 %% \lilypondundefined{xxx}{foo}{bar}
44 %% If `xxx' (without the leading backslash) is an undefined macro,
45 %% execute block `foo'. Otherwise, execute block `bar'. Based on
46 %% a similar macro from the LaTeX kernel.
48 \gdef\lilypondifundefined#1{
49 \expandafter\ifx\csname#1\endcsname\relax
50 \expandafter\lilypondfirst
52 \expandafter\lilypondsecond
56 %% Urgh. LilyPond uses EC fonts, but texinfo is based on CM. We thus
57 %% have to handle T1 font encoding by ourselves; all manipulations are
58 %% collected in the macro \lilypondECencoding. Note that the following
59 %% code only provides the texinfo interface, not complete access to all
62 %% All definitions are taken from texinfo or LaTeX (with modifications
67 \gdef\lilypondECencoding{
99 % \def\tieaccent##1{} % unsupported: this is TS1
108 \sh@ft{29}\vbox to.2ex{
123 \chardef\exclamdown=189
124 \chardef\questiondown=190
144 %% This macro provides the necessary setup to make the lilypond data
145 %% work with plain TeX, LaTeX, and texinfo.
147 %% The reason of using \begingroup and \endgroup is to make the macro \x
148 %% immediately disappear after it has been executed. Since we have \def
149 %% within \def within \gdef, four hash signs (`#') are needed for
152 %% \lilypondfontencoding is emitted by LilyPond to set the encoding of
157 \outputscale \lilypondpaperoutputscale\lilypondpaperunit
160 \catcode `\@=11\relax
162 %% \@nodocument is defined as \relax after `\begin{document}'
163 \lilypondifundefined{@nodocument}
164 {%% Either plain TeX or texinfo or not at the beginning of LaTeX input.
168 \def\lilypondfontencoding####1{
170 \def\lilypondpagebreak{
172 \def\lilypondnopagebreak{
177 {%% LaTeX mode: Provide a complete preamble.
181 %% Indicate that we shall emit `\end{document}' while executing
183 \def\lilyponddocument{}
185 \def\lilypondfontencoding####1{
188 \def\lilypondpagebreak{
190 \def\lilypondnopagebreak{
193 \documentclass[\lilyponddocumentclassoptions]{article}
195 %% As a safety guard, don't produce auxiliary files.
198 \usepackage[\lilypondpaperinputencoding]{inputenc}
201 \lilypondifundefined{lilypondclassic}
202 {%% If not in `classic' mode, undo LaTeX's page layout settings
203 %% since LilyPond does the layout by itself.
205 \headheight0pt\headsep0pt
207 \evensidemargin\oddsidemargin}
209 {%% Otherwise center output horizontally, without changing the
210 %% vertical positioning.
211 \hsize\lilypondpaperlinewidth\lilypondpaperunit
212 \lytempdim \paperwidth
213 \advance\lytempdim -\the\hsize
214 \lytempdim 0.5\lytempdim
215 \advance\lytempdim -1in
216 \oddsidemargin \lytempdim
217 \evensidemargin \lytempdim}
221 %% We can't directly say `\begin{document}' in this macro since
222 %% older versions of texinfo.tex define \begin as \outer; this
223 %% means that it causes an error if \begin is found within another
224 %% macro (even if the corresponding code will never be executed).
225 %% As a workaround we use \csname to call \begin.
226 \csname begin\endcsname{document}}}
229 %% The opposite of \lilypondstart.
232 %% Handle the `lastpagefill' parameter from the \layout block.
233 %% Ignore it if \lilypondbook is defined.
234 \lilypondifundefined{lilypondbook}
235 {\lilypondifundefined{lilypondpaperlastpagefill}
236 {\vskip 0pt plus\lilypondpaperinterscorelinefill00 fill}
241 \lilypondifundefined{lilyponddocument}
246 \csname end\endcsname{document}}}
249 %% Load the PostScript drawing routines. This is done using \special.
250 %% To avoid multiple inclusions, redefine \lilypondspecial to a no-op
253 \gdef\lilypondspecial{
254 \special{header=music-drawing-routines.ps}
255 \gdef\lilypondspecial{}}
257 %% Put the argument into a box which has zero height and depth (the
258 %% \vss forces the latter -- TeXbook, page 80).
265 %% Put the argument into a box which has zero width.
272 %% The most used macro in LilyPond output. Put #3 into a zero-width box
273 %% which is moved to the right by #1 (scaled by \outputscale) and moved
274 %% up by #2 (also scaled by \outputscale). Note that negative values for
275 %% #2 change the depth of the box defined by \leftalign, not the height.
278 \raise#2\outputscale \leftalign{
282 %% All LilyPond music data is enclosed in this macro (as fifth argument).
283 %% The data is first put into a box with zero height and depth which is
284 %% then moved to the right by #1 and moved down by #2. After this, it is
285 %% put into a zero-width box, giving it a height #4 (and depth zero).
286 %% Finally, the box is raised so that its true height is exactly the
287 %% distance from one baseline to the next.
289 %% Parameters #1 to #4 are scaled by \outputscale.
291 \gdef\lybox#1#2#3#4#5{
292 \lytempdim\baselineskip
293 \advance\lytempdim -#4\outputscale
295 \vbox to #4\outputscale{
298 \lower #2\outputscale \topalign{
302 %% Produce a black bar (width #2, depth #3, height #4) with a vertical
303 %% offset #1. Everything is scaled by \outputscale.
305 \gdef\lyvrule#1#2#3#4{
307 \vrule width #2\outputscale depth #3\outputscale height #4\outputscale}
309 %% FIXME: 'interscoreline' and 'lilypondPAPERinterscoreline
311 \lilypondifundefined{lilypondpaperinterscorelinefill}
312 {\gdef\lilypondpaperinterscorelinefill{0}}
313 {\gdef\lilypondpaperinterscorelinefill{1}}
315 %% Allow overriding of interscoreline, e.g., for LilyPond's --preview
317 \lilypondifundefined{interscoreline}
318 {\lilypondifundefined{lilypondclassic}
319 {\gdef\interscoreline{}}
320 {\gdef\interscoreline{
321 \vskip\lilypondpaperinterscoreline\lilypondpaperunit
322 plus \lilypondpaperinterscorelinefill fill}}}
325 %% Include PostScript definitions (which are differently defined for
326 %% TeX and pdfTeX). This is loaded once only because the inputted files
327 %% define \lilypondpostscript.
329 %% (Don't remove the spaces after the arguments to \input!)
331 \lilypondifundefined{lilypondpostscript}
332 {\lilypondifundefined{pdfoutput}
333 {\input lily-ps-defs }
335 \input lily-pdf-defs }}
338 %% Restore newline functionality (disabled to avoid \par).
340 \endlinechar \lilyponddefsELC
343 %% end lilyponddefs.tex