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 %% The most used macro in LilyPond output. Put #3 into a zero-width box
258 %% which is moved to the right by #1 (scaled by \outputscale) and moved
259 %% up by #2 (also scaled by \outputscale).
262 \raise #2\outputscale \hbox to 0pt {
267 %% All LilyPond music data is enclosed in this macro (as third argument).
268 %% The data (which consists of boxes with zero width) gets an artificial
269 %% width of #1 and a height of #2. The resulting box is then centered
270 %% vertically along the x-height of the current font.
272 %% Parameters #1 and #2 are scaled by \outputscale.
275 \lytempdim #2\outputscale
276 \lytempdim -0.5\lytempdim
277 \advance\lytempdim 1ex
279 \raise \lytempdim \hbox to #1\outputscale {
280 %% Convert depth of #3 into height only.
281 \vbox to #2\outputscale {\hbox{#3}\vss}
284 %% Produce a black bar (width #2, depth #3, height #4) with a vertical
285 %% offset #1. Everything is scaled by \outputscale.
287 \gdef\lyvrule#1#2#3#4{
289 \vrule width #2\outputscale depth #3\outputscale height #4\outputscale}
291 %% FIXME: 'interscoreline' and 'lilypondPAPERinterscoreline
293 \lilypondifundefined{lilypondpaperinterscorelinefill}
294 {\gdef\lilypondpaperinterscorelinefill{0}}
295 {\gdef\lilypondpaperinterscorelinefill{1}}
297 %% Allow overriding of interscoreline, e.g., for LilyPond's --preview
299 \lilypondifundefined{interscoreline}
300 {\lilypondifundefined{lilypondclassic}
301 {\gdef\interscoreline{}}
302 {\gdef\interscoreline{
303 \vskip\lilypondpaperinterscoreline\lilypondpaperunit
304 plus \lilypondpaperinterscorelinefill fill}}}
307 %% Include PostScript definitions (which are differently defined for
308 %% TeX and pdfTeX). This is loaded once only because the inputted files
309 %% define \lilypondpostscript.
311 %% (Don't remove the spaces after the arguments to \input!)
313 \lilypondifundefined{lilypondpostscript}
314 {\lilypondifundefined{pdfoutput}
315 {\input lily-ps-defs }
317 \input lily-pdf-defs }}
320 %% Restore newline functionality (disabled to avoid \par).
322 \endlinechar \lilyponddefsELC
325 %% end lilyponddefs.tex