<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!-- header_tag -->
<html lang="en">
<head>
<title>Scheme functions - LilyPond program-reference</title>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<meta name="description" content="LilyPond program-reference">
<meta name="generator" content="makeinfo 4.11">
<link title="Top" rel="start" href="index.es.html#Top">
<link rel="prev" href="Backend.es.html#Backend" title="Backend">
<link rel="next" href="Indices.es.html#Indices" title="Indices">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">
<meta http-equiv="Content-Style-Type" content="text/css">
<style type="text/css"><!--
pre.display { font-family:inherit }
pre.format { font-family:inherit }
pre.smalldisplay { font-family:inherit; font-size:smaller }
pre.smallformat { font-family:inherit; font-size:smaller }
pre.smallexample { font-size:smaller }
pre.smalllisp { font-size:smaller }
span.sc { font-variant:small-caps }
span.roman { font-family:serif; font-weight:normal; }
span.sansserif { font-family:sans-serif; font-weight:normal; }
hr { border:0; height:1; color: #000000; background-color: #000000; }
/* hr {
border: none;
height: 1px;
color: #666666;
background-color: #666666;
}
body {
border-left: 1px solid #666666;
border-right: 1px solid #666666;
color: #332d28;
margin-right: auto;
margin-left: auto;
width: 60em;
list-style-type: square;
font-family: Arial,Helvetica,sans-serif;
padding-right: 1em;
padding-left: 1em;
}
a {
border-bottom: 1px dashed #344242;
text-decoration: none;
color: #344242;
}
a:link {
text-decoration: none;
}
a:visited {
border-bottom: 1px dashed #666666;
color: #666666;
}
a:active {
border-bottom: 1px solid #00cccc;
color: #00cccc;
}
a:hover {
border-bottom: 1px solid #1d7b85;
color: #1d7b85;
}
blockquote {
border: 1px solid #cccccc;
padding: 3px;
width: 40em;
}
.node {
border-left: 1px solid #666666;
margin: -0.5em 0px 1em;
padding: 2px 1px 0px;
font-style: italic;
}
.node a {
border: none;
text-decoration: underline;
font-style: normal;
font-weight: bold;
}
.verbatim {
font-family: "Courier New",Courier,monospace;
}
.unnumberedsubsubsec {
font-size: large;
color: #1d7b85;
}
.subsubheading {
font-size: large;
color: #3b220d;
}
.contents {
border: 1px dashed #339999;
margin: 3px 2em;
list-style-type: square;
padding-right: 1em;
width: 40em;
background-color: #fcfff9;
}
.contents a {
border-bottom: 1px dashed #423d34;
text-decoration: none;
color: #423d34;
}
.contents a:visited {
border-bottom: 1px dashed #666666;
color: #666666;
}
.contents a:active {
border-bottom: 1px solid #f0d86d;
color: #f0d86d;
}
.contents a:hover {
border-bottom: 1px solid #3b220d;
color: #3b220d;
}
.menu {
border-left: 1px dashed #339999;
margin: 3px 2em 1em;
list-style-type: square;
padding-left: 1.4em;
width: 40em;
}
.unnumbered {
}
h2 {
font-size: x-large;
color: #1d7b85;
}
*/
--></style>
</head>
<BODY BGCOLOR=WHITE TEXT=BLACK>
<div class="node">
<p>
<a name="Scheme-functions"></a>
Next: <a rel="next" accesskey="n" href="Indices.es.html#Indices">Indices</a>,
Previous: <a rel="previous" accesskey="p" href="Backend.es.html#Backend">Backend</a>,
Up: <a rel="up" accesskey="u" href="index.es.html#Top">Top</a>
<hr>
</div>
<h2 class="unnumbered">Scheme functions</h2>
<div class="defun">
— Function: <b>dispatcher</b><var> x<a name="index-dispatcher-27"></a></var><br>
<blockquote><p>Is <var>x</var> a <code>Dispatcher</code> object?
</p></blockquote></div>
<div class="defun">
— Function: <b>listener</b><var> x<a name="index-listener-28"></a></var><br>
<blockquote><p>Is <var>x</var> a <code>Listener</code> object?
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:add-file-name-alist</b><var> alist<a name="index-ly_003aadd_002dfile_002dname_002dalist-29"></a></var><br>
<blockquote><p>Add mappings for error messages from <var>alist</var>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:add-interface</b><var> a b c<a name="index-ly_003aadd_002dinterface-30"></a></var><br>
<blockquote><p>Add an interface description.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:add-listener</b><var> list disp cl<a name="index-ly_003aadd_002dlistener-31"></a></var><br>
<blockquote><p>Add the listener <var>list</var> to the dispatcher <var>disp</var>. Whenever <var>disp</var> hears an event of class <var>cl</var>, it is forwarded to <var>list</var>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:add-option</b><var> sym val description<a name="index-ly_003aadd_002doption-32"></a></var><br>
<blockquote><p>Add a program option <var>sym</var> with default <var>val</var>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:all-grob-interfaces</b><var><a name="index-ly_003aall_002dgrob_002dinterfaces-33"></a></var><br>
<blockquote><p>Get a hash table with all interface descriptions.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:all-options</b><var><a name="index-ly_003aall_002doptions-34"></a></var><br>
<blockquote><p>Get all option settings in an alist.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:all-stencil-expressions</b><var><a name="index-ly_003aall_002dstencil_002dexpressions-35"></a></var><br>
<blockquote><p>Return all symbols recognized as stencil expressions.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:assoc-get</b><var> key alist default-value<a name="index-ly_003aassoc_002dget-36"></a></var><br>
<blockquote><p>Return value if <var>key</var> in <var>alist</var>, else <code>default-value</code> (or <code>#f</code> if not specified).
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:book-add-score!</b><var> book-smob score<a name="index-ly_003abook_002dadd_002dscore_0021-37"></a></var><br>
<blockquote><p>Add <var>score</var> to <var>book-smob</var> score list.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:book-process</b><var> book-smob default-paper default-layout output<a name="index-ly_003abook_002dprocess-38"></a></var><br>
<blockquote><p>Print book. <var>output</var> is passed to the backend unchanged. For example, it may be a string (for file based outputs) or a socket (for network based output).
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:book-process-to-systems</b><var> book-smob default-paper default-layout output<a name="index-ly_003abook_002dprocess_002dto_002dsystems-39"></a></var><br>
<blockquote><p>Print book. <var>output</var> is passed to the backend unchanged. For example, it may be a string (for file based outputs) or a socket (for network based output).
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:box?</b><var> x<a name="index-ly_003abox_003f-40"></a></var><br>
<blockquote><p>Is <var>x</var> a <code>Box</code> object?
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:bp</b><var> num<a name="index-ly_003abp-41"></a></var><br>
<blockquote><p><var>num</var> bigpoints (1/72th inch).
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:bracket</b><var> a iv t p<a name="index-ly_003abracket-42"></a></var><br>
<blockquote><p>Make a bracket in direction <var>a</var>. The extent of the bracket is given by <var>iv</var>. The wings protrude by an amount of <var>p</var>, which may be negative. The thickness is given by <var>t</var>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:broadcast</b><var> disp ev<a name="index-ly_003abroadcast-43"></a></var><br>
<blockquote><p>Send the stream event <var>ev</var> to the dispatcher <var>disp</var>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:camel-case->lisp-identifier</b><var> name-sym<a name="index-ly_003acamel_002dcase_002d_003elisp_002didentifier-44"></a></var><br>
<blockquote><p>Convert <code>FooBar_Bla</code> to <code>foo-bar-bla</code> style symbol.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:chain-assoc-get</b><var> key achain dfault<a name="index-ly_003achain_002dassoc_002dget-45"></a></var><br>
<blockquote><p>Return value for <var>key</var> from a list of alists <var>achain</var>. If no entry is found, return <var>dfault</var> or <code>#f</code> if no <var>dfault</var> is specified.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:clear-anonymous-modules</b><var><a name="index-ly_003aclear_002danonymous_002dmodules-46"></a></var><br>
<blockquote><p>Plug a GUILE 1.6 and 1.7 memory leak by breaking a weak reference pointer cycle explicitly.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:cm</b><var> num<a name="index-ly_003acm-47"></a></var><br>
<blockquote><p><var>num</var> cm.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:command-line-code</b><var><a name="index-ly_003acommand_002dline_002dcode-48"></a></var><br>
<blockquote><p>The Scheme code specified on command-line with <samp><span class="option">-e</span></samp>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:command-line-options</b><var><a name="index-ly_003acommand_002dline_002doptions-49"></a></var><br>
<blockquote><p>The Scheme options specified on command-line with <samp><span class="option">-d</span></samp>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:command-line-verbose?</b><var><a name="index-ly_003acommand_002dline_002dverbose_003f-50"></a></var><br>
<blockquote><p>Was <code>be_verbose_global</code> set?
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:connect-dispatchers</b><var> to from<a name="index-ly_003aconnect_002ddispatchers-51"></a></var><br>
<blockquote><p>Make the dispatcher <var>to</var> listen to events from <var>from</var>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:context-event-source</b><var> context<a name="index-ly_003acontext_002devent_002dsource-52"></a></var><br>
<blockquote><p>Return <code>event-source</code> of context <var>context</var>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:context-events-below</b><var> context<a name="index-ly_003acontext_002devents_002dbelow-53"></a></var><br>
<blockquote><p>Return a <code>stream-distributor</code> that distributes all events from <var>context</var> and all its subcontexts.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:context-find</b><var> context name<a name="index-ly_003acontext_002dfind-54"></a></var><br>
<blockquote><p>Find a parent of <var>context</var> that has name or alias <var>name</var>. Return <code>#f</code> if not found.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:context-grob-definition</b><var> context name<a name="index-ly_003acontext_002dgrob_002ddefinition-55"></a></var><br>
<blockquote><p>Return the definition of <var>name</var> (a symbol) within <var>context</var> as an alist.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:context-id</b><var> context<a name="index-ly_003acontext_002did-56"></a></var><br>
<blockquote><p>Return the ID string of <var>context</var>, i.e., for <code>\context Voice = one ...</code> return the string <code>one</code>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:context-name</b><var> context<a name="index-ly_003acontext_002dname-57"></a></var><br>
<blockquote><p>Return the name of <var>context</var>, i.e., for <code>\context Voice = one ...</code> return the symbol <code>Voice</code>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:context-now</b><var> context<a name="index-ly_003acontext_002dnow-58"></a></var><br>
<blockquote><p>Return <code>now-moment</code> of context <var>context</var>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:context-parent</b><var> context<a name="index-ly_003acontext_002dparent-59"></a></var><br>
<blockquote><p>Return the parent of <var>context</var>, <code>#f</code> if none.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:context-property</b><var> c name<a name="index-ly_003acontext_002dproperty-60"></a></var><br>
<blockquote><p>Return the value of <var>name</var> from context <var>c</var>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:context-property-where-defined</b><var> context name<a name="index-ly_003acontext_002dproperty_002dwhere_002ddefined-61"></a></var><br>
<blockquote><p>Return the context above <var>context</var> where <var>name</var> is defined.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:context-pushpop-property</b><var> context grob eltprop val<a name="index-ly_003acontext_002dpushpop_002dproperty-62"></a></var><br>
<blockquote><p>Do a single <code>\override</code> or <code>\revert</code> operation in <var>context</var>. The grob definition <var>grob</var> is extended with <var>eltprop</var> (if <var>val</var> is specified) or reverted (if unspecified).
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:context-set-property!</b><var> context name val<a name="index-ly_003acontext_002dset_002dproperty_0021-63"></a></var><br>
<blockquote><p>Set value of property <var>name</var> in context <var>context</var> to <var>val</var>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:context-unset-property</b><var> context name<a name="index-ly_003acontext_002dunset_002dproperty-64"></a></var><br>
<blockquote><p>Unset value of property <var>name</var> in context <var>context</var>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:context?</b><var> x<a name="index-ly_003acontext_003f-65"></a></var><br>
<blockquote><p>Is <var>x</var> a <code>Context</code> object?
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:default-scale</b><var><a name="index-ly_003adefault_002dscale-66"></a></var><br>
<blockquote><p>Get the global default scale.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:dimension?</b><var> d<a name="index-ly_003adimension_003f-67"></a></var><br>
<blockquote><p>Return <var>d</var> as a number. Used to distinguish length variables from normal numbers.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:dir?</b><var> s<a name="index-ly_003adir_003f-68"></a></var><br>
<blockquote><p>A type predicate. The direction <code>s</code> is <code>-1</code>, <code>0</code> or <code>1</code>, where <code>-1</code> represents left or down and <code>1</code> represents right or up.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:duration->string</b><var> dur<a name="index-ly_003aduration_002d_003estring-69"></a></var><br>
<blockquote><p>Convert <var>dur</var> to a string.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:duration-dot-count</b><var> dur<a name="index-ly_003aduration_002ddot_002dcount-70"></a></var><br>
<blockquote><p>Extract the dot count from <var>dur</var>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:duration-factor</b><var> dur<a name="index-ly_003aduration_002dfactor-71"></a></var><br>
<blockquote><p>Extract the compression factor from <var>dur</var>. Return it as a pair.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:duration-length</b><var> dur<a name="index-ly_003aduration_002dlength-72"></a></var><br>
<blockquote><p>The length of the duration as a <code>moment</code>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:duration-log</b><var> dur<a name="index-ly_003aduration_002dlog-73"></a></var><br>
<blockquote><p>Extract the duration log from <var>dur</var>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:duration<?</b><var> p1 p2<a name="index-ly_003aduration_003c_003f-74"></a></var><br>
<blockquote><p>Is <var>p1</var> shorter than <var>p2</var>?
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:duration?</b><var> x<a name="index-ly_003aduration_003f-75"></a></var><br>
<blockquote><p>Is <var>x</var> a <code>Duration</code> object?
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:effective-prefix</b><var><a name="index-ly_003aeffective_002dprefix-76"></a></var><br>
<blockquote><p>Return effective prefix.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:error</b><var> str rest<a name="index-ly_003aerror-77"></a></var><br>
<blockquote><p>A Scheme callable function to issue the error <var>str</var>. The error is formatted with <code>format</code> and <var>rest</var>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:eval-simple-closure</b><var> delayed closure scm-start scm-end<a name="index-ly_003aeval_002dsimple_002dclosure-78"></a></var><br>
<blockquote><p>Evaluate a simple <var>closure</var> with the given <var>delayed</var> argument. If <var>scm-start</var> and <var>scm-end</var> are defined, evaluate it purely with those start and end points.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:event-deep-copy</b><var> m<a name="index-ly_003aevent_002ddeep_002dcopy-79"></a></var><br>
<blockquote><p>Copy <var>m</var> and all sub expressions of <var>m</var>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:event-property</b><var> sev sym<a name="index-ly_003aevent_002dproperty-80"></a></var><br>
<blockquote><p>Get the property <var>sym</var> of stream event <var>mus</var>. If <var>sym</var> is undefined, return <code>'()</code>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:event-set-property!</b><var> ev sym val<a name="index-ly_003aevent_002dset_002dproperty_0021-81"></a></var><br>
<blockquote><p>Set property <var>sym</var> in event <var>ev</var> to <var>val</var>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:expand-environment</b><var> str<a name="index-ly_003aexpand_002denvironment-82"></a></var><br>
<blockquote><p>Expand <code>$VAR</code> and <code>${VAR}</code> in <var>str</var>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:export</b><var> arg<a name="index-ly_003aexport-83"></a></var><br>
<blockquote><p>Export a Scheme object to the parser so it is treated as an identifier.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:find-file</b><var> name<a name="index-ly_003afind_002dfile-84"></a></var><br>
<blockquote><p>Return the absolute file name of <var>name</var>, or <code>#f</code> if not found.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:font-config-display-fonts</b><var><a name="index-ly_003afont_002dconfig_002ddisplay_002dfonts-85"></a></var><br>
<blockquote><p>Dump a list of all fonts visible to FontConfig.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:font-config-get-font-file</b><var> name<a name="index-ly_003afont_002dconfig_002dget_002dfont_002dfile-86"></a></var><br>
<blockquote><p>Get the file for font <var>name</var>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:font-design-size</b><var> font<a name="index-ly_003afont_002ddesign_002dsize-87"></a></var><br>
<blockquote><p>Given the font metric <var>font</var>, return the design size, relative to the current output-scale.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:font-file-name</b><var> font<a name="index-ly_003afont_002dfile_002dname-88"></a></var><br>
<blockquote><p>Given the font metric <var>font</var>, return the corresponding file name.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:font-get-glyph</b><var> font name<a name="index-ly_003afont_002dget_002dglyph-89"></a></var><br>
<blockquote><p>Return a stencil from <var>font</var> for the glyph named <var>name</var>. If the glyph is not available, return an empty stencil.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:font-glyph-name-to-charcode</b><var> font name<a name="index-ly_003afont_002dglyph_002dname_002dto_002dcharcode-90"></a></var><br>
<blockquote><p>Return the character code for glyph <var>name</var> in <var>font</var>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:font-glyph-name-to-index</b><var> font name<a name="index-ly_003afont_002dglyph_002dname_002dto_002dindex-91"></a></var><br>
<blockquote><p>Return the index for <var>name</var> in <var>font</var>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:font-index-to-charcode</b><var> font index<a name="index-ly_003afont_002dindex_002dto_002dcharcode-92"></a></var><br>
<blockquote><p>Return the character code for <var>index</var> in <var>font</var>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:font-load</b><var> name<a name="index-ly_003afont_002dload-93"></a></var><br>
<blockquote><p>Load the font <var>name</var>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:font-magnification</b><var> font<a name="index-ly_003afont_002dmagnification-94"></a></var><br>
<blockquote><p>Given the font metric <var>font</var>, return the magnification, relative to the current output-scale.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:font-metric?</b><var> x<a name="index-ly_003afont_002dmetric_003f-95"></a></var><br>
<blockquote><p>Is <var>x</var> a <code>Font_metric</code> object?
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:font-name</b><var> font<a name="index-ly_003afont_002dname-96"></a></var><br>
<blockquote><p>Given the font metric <var>font</var>, return the corresponding name.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:font-sub-fonts</b><var> font<a name="index-ly_003afont_002dsub_002dfonts-97"></a></var><br>
<blockquote><p>Given the font metric <var>font</var> of an OpenType font, return the names of the subfonts within <var>font</var>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:format</b><var> str rest<a name="index-ly_003aformat-98"></a></var><br>
<blockquote><p>LilyPond specific format, supporting <code>~a</code> and <code>~[0-9]f</code>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:format-output</b><var> context<a name="index-ly_003aformat_002doutput-99"></a></var><br>
<blockquote><p>Given a global context in its final state, process it and return the <code>Music_output</code> object in its final state.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:get-all-function-documentation</b><var><a name="index-ly_003aget_002dall_002dfunction_002ddocumentation-100"></a></var><br>
<blockquote><p>Get a hash table with all LilyPond Scheme extension functions.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:get-all-translators</b><var><a name="index-ly_003aget_002dall_002dtranslators-101"></a></var><br>
<blockquote><p>Return a list of all translator objects that may be instantiated.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:get-glyph</b><var> font index<a name="index-ly_003aget_002dglyph-102"></a></var><br>
<blockquote><p>Retrieve a stencil for the glyph numbered <var>index</var> in <var>font</var>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:get-listened-event-classes</b><var><a name="index-ly_003aget_002dlistened_002devent_002dclasses-103"></a></var><br>
<blockquote><p>Return a list of all event classes that some translator listens to.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:get-option</b><var> var<a name="index-ly_003aget_002doption-104"></a></var><br>
<blockquote><p>Get a global option setting.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:gettext</b><var> original<a name="index-ly_003agettext-105"></a></var><br>
<blockquote><p>A Scheme wrapper function for <code>gettext</code>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:grob-alist-chain</b><var> grob global<a name="index-ly_003agrob_002dalist_002dchain-106"></a></var><br>
<blockquote><p>Get an alist chain for grob <var>grob</var>, with <var>global</var> as the global default. If unspecified, <code>font-defaults</code> from the layout block is taken.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:grob-array-length</b><var> grob-arr<a name="index-ly_003agrob_002darray_002dlength-107"></a></var><br>
<blockquote><p>Return the length of <var>grob-arr</var>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:grob-array-ref</b><var> grob-arr index<a name="index-ly_003agrob_002darray_002dref-108"></a></var><br>
<blockquote><p>Retrieve the <var>index</var>th element of <var>grob-arr</var>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:grob-array?</b><var> x<a name="index-ly_003agrob_002darray_003f-109"></a></var><br>
<blockquote><p>Is <var>x</var> a <code>Grob_array</code> object?
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:grob-basic-properties</b><var> grob<a name="index-ly_003agrob_002dbasic_002dproperties-110"></a></var><br>
<blockquote><p>Get the immutable properties of <var>grob</var>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:grob-common-refpoint</b><var> grob other axis<a name="index-ly_003agrob_002dcommon_002drefpoint-111"></a></var><br>
<blockquote><p>Find the common refpoint of <var>grob</var> and <var>other</var> for <var>axis</var>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:grob-common-refpoint-of-array</b><var> grob others axis<a name="index-ly_003agrob_002dcommon_002drefpoint_002dof_002darray-112"></a></var><br>
<blockquote><p>Find the common refpoint of <var>grob</var> and <var>others</var> (a grob-array) for <var>axis</var>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:grob-default-font</b><var> grob<a name="index-ly_003agrob_002ddefault_002dfont-113"></a></var><br>
<blockquote><p>Return the default font for grob <var>gr</var>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:grob-extent</b><var> grob refp axis<a name="index-ly_003agrob_002dextent-114"></a></var><br>
<blockquote><p>Get the extent in <var>axis</var> direction of <var>grob</var> relative to the grob <var>refp</var>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:grob-interfaces</b><var> grob<a name="index-ly_003agrob_002dinterfaces-115"></a></var><br>
<blockquote><p>Return the interfaces list of grob <var>grob</var>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:grob-layout</b><var> grob<a name="index-ly_003agrob_002dlayout-116"></a></var><br>
<blockquote><p>Get <code>\layout</code> definition from grob <var>grob</var>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:grob-object</b><var> grob sym<a name="index-ly_003agrob_002dobject-117"></a></var><br>
<blockquote><p>Return the value of a pointer in grob <var>g</var> of property <var>sym</var>. It returns <code>'()</code> (end-of-list) if <var>sym</var> is undefined in <var>g</var>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:grob-original</b><var> grob<a name="index-ly_003agrob_002doriginal-118"></a></var><br>
<blockquote><p>Return the unbroken original grob of <var>grob</var>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:grob-parent</b><var> grob axis<a name="index-ly_003agrob_002dparent-119"></a></var><br>
<blockquote><p>Get the parent of <var>grob</var>. <var>axis</var> is 0 for the X-axis, 1 for the Y-axis.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:grob-pq<?</b><var> a b<a name="index-ly_003agrob_002dpq_003c_003f-120"></a></var><br>
<blockquote><p>Compare two grob priority queue entries. This is an internal function.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:grob-properties</b><var> grob<a name="index-ly_003agrob_002dproperties-121"></a></var><br>
<blockquote><p>Get the mutable properties of <var>grob</var>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:grob-property</b><var> grob sym deflt<a name="index-ly_003agrob_002dproperty-122"></a></var><br>
<blockquote><p>Return the value of a value in grob <var>g</var> of property <var>sym</var>. It returns <code>'()</code> (end-of-list) or <var>deflt</var> (if specified) if <var>sym</var> is undefined in <var>g</var>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:grob-property-data</b><var> grob sym<a name="index-ly_003agrob_002dproperty_002ddata-123"></a></var><br>
<blockquote><p>Retrieve <var>sym</var> for <var>grob</var> but don't process callbacks.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:grob-relative-coordinate</b><var> grob refp axis<a name="index-ly_003agrob_002drelative_002dcoordinate-124"></a></var><br>
<blockquote><p>Get the coordinate in <var>axis</var> direction of <var>grob</var> relative to the grob <var>refp</var>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:grob-robust-relative-extent</b><var> grob refp axis<a name="index-ly_003agrob_002drobust_002drelative_002dextent-125"></a></var><br>
<blockquote><p>Get the extent in <var>axis</var> direction of <var>grob</var> relative to the grob <var>refp</var>, or <code>(0,0)</code> if empty.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:grob-script-priority-less</b><var> a b<a name="index-ly_003agrob_002dscript_002dpriority_002dless-126"></a></var><br>
<blockquote><p>Compare two grobs by script priority. For internal use.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:grob-set-property!</b><var> grob sym val<a name="index-ly_003agrob_002dset_002dproperty_0021-127"></a></var><br>
<blockquote><p>Set <var>sym</var> in grob <var>grob</var> to value <var>val</var>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:grob-staff-position</b><var> sg<a name="index-ly_003agrob_002dstaff_002dposition-128"></a></var><br>
<blockquote><p>Return the Y-position of <var>sg</var> relative to the staff.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:grob-suicide!</b><var> grob<a name="index-ly_003agrob_002dsuicide_0021-129"></a></var><br>
<blockquote><p>Kill <var>grob</var>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:grob-system</b><var> grob<a name="index-ly_003agrob_002dsystem-130"></a></var><br>
<blockquote><p>Return the system grob of <var>grob</var>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:grob-translate-axis!</b><var> grob d a<a name="index-ly_003agrob_002dtranslate_002daxis_0021-131"></a></var><br>
<blockquote><p>Translate <var>g</var> on axis <var>a</var> over distance <var>d</var>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:grob?</b><var> x<a name="index-ly_003agrob_003f-132"></a></var><br>
<blockquote><p>Is <var>x</var> a <code>Grob</code> object?
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:gulp-file</b><var> name size<a name="index-ly_003agulp_002dfile-133"></a></var><br>
<blockquote><p>Read the file <var>name</var>, and return its contents in a string. The file is looked up using the search path.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:hash-table-keys</b><var> tab<a name="index-ly_003ahash_002dtable_002dkeys-134"></a></var><br>
<blockquote><p>Return a list of keys in <var>tab</var>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:inch</b><var> num<a name="index-ly_003ainch-135"></a></var><br>
<blockquote><p><var>num</var> inches.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:input-both-locations</b><var> sip<a name="index-ly_003ainput_002dboth_002dlocations-136"></a></var><br>
<blockquote><p>Return input location in <var>sip</var> as <code>(file-name first-line first-column last-line last-column)</code>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:input-file-line-char-column</b><var> sip<a name="index-ly_003ainput_002dfile_002dline_002dchar_002dcolumn-137"></a></var><br>
<blockquote><p>Return input location in <var>sip</var> as <code>(file-name line char column)</code>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:input-location?</b><var> x<a name="index-ly_003ainput_002dlocation_003f-138"></a></var><br>
<blockquote><p>Is <var>x</var> an <code>input-location</code>?
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:input-message</b><var> sip msg rest<a name="index-ly_003ainput_002dmessage-139"></a></var><br>
<blockquote><p>Print <var>msg</var> as a GNU compliant error message, pointing to the location in <var>sip</var>. <var>msg</var> is interpreted similar to <code>format</code>'s argument, using <var>rest</var>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:interpret-music-expression</b><var> mus ctx<a name="index-ly_003ainterpret_002dmusic_002dexpression-140"></a></var><br>
<blockquote><p>Interpret the music expression <var>mus</var> in the global context <var>ctx</var>. The context is returned in its final state.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:interpret-stencil-expression</b><var> expr func arg1 offset<a name="index-ly_003ainterpret_002dstencil_002dexpression-141"></a></var><br>
<blockquote><p>Parse <var>expr</var>, feed bits to <var>func</var> with first arg <var>arg1</var> having offset <var>offset</var>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:intlog2</b><var> d<a name="index-ly_003aintlog2-142"></a></var><br>
<blockquote><p>The 2-logarithm of 1/<var>d</var>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:is-listened-event-class</b><var> sym<a name="index-ly_003ais_002dlistened_002devent_002dclass-143"></a></var><br>
<blockquote><p>Is <var>sym</var> a listened event class?
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:item-break-dir</b><var> it<a name="index-ly_003aitem_002dbreak_002ddir-144"></a></var><br>
<blockquote><p>The break status direction of item <var>it</var>. <code>-1</code> means end of line, <code>0</code> unbroken, and <code>1</code> beginning of line.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:item?</b><var> g<a name="index-ly_003aitem_003f-145"></a></var><br>
<blockquote><p>Is <var>g</var> an <code>Item</code> object?
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:iterator?</b><var> x<a name="index-ly_003aiterator_003f-146"></a></var><br>
<blockquote><p>Is <var>x</var> a <code>Music_iterator</code> object?
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:lexer-keywords</b><var> lexer<a name="index-ly_003alexer_002dkeywords-147"></a></var><br>
<blockquote><p>Return a list of <code>(KEY . CODE)</code> pairs, signifying the LilyPond reserved words list.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:lily-lexer?</b><var> x<a name="index-ly_003alily_002dlexer_003f-148"></a></var><br>
<blockquote><p>Is <var>x</var> a <code>Lily_lexer</code> object?
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:lily-parser?</b><var> x<a name="index-ly_003alily_002dparser_003f-149"></a></var><br>
<blockquote><p>Is <var>x</var> a <code>Lily_parser</code> object?
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:load-text-dimensions</b><var> dimension-alist<a name="index-ly_003aload_002dtext_002ddimensions-150"></a></var><br>
<blockquote><p>Load dimensions from TeX in a <code>(KEY . (W H D))</code> format alist.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:make-book</b><var> paper header scores<a name="index-ly_003amake_002dbook-151"></a></var><br>
<blockquote><p>Make a <code>\book</code> of <var>paper</var> and <var>header</var> (which may be <code>#f</code> as well) containing <code>\scores</code>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:make-dispatcher</b><var><a name="index-ly_003amake_002ddispatcher-152"></a></var><br>
<blockquote><p>Return a newly created dispatcher.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:make-duration</b><var> length dotcount num den<a name="index-ly_003amake_002dduration-153"></a></var><br>
<blockquote><p><var>length</var> is the negative logarithm (base 2) of the duration: 1 is a half note, 2 is a quarter note, 3 is an eighth note, etc. The number of dots after the note is given by the optional argument <var>dotcount</var>.
<p>The duration factor is optionally given by <var>num</var> and <var>den</var>.
<p>A duration is a musical duration, i.e., a length of time described by a power of two (whole, half, quarter, etc.) and a number of augmentation dots.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:make-global-context</b><var> output-def<a name="index-ly_003amake_002dglobal_002dcontext-154"></a></var><br>
<blockquote><p>Set up a global interpretation context, using the output block <var>output_def</var>. The context is returned.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:make-global-translator</b><var> global<a name="index-ly_003amake_002dglobal_002dtranslator-155"></a></var><br>
<blockquote><p>Create a translator group and connect it to the global context <var>global</var>. The translator group is returned.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:make-listener</b><var> callback<a name="index-ly_003amake_002dlistener-156"></a></var><br>
<blockquote><p>Create a listener. Any time the listener hears an object, it will call <var>callback</var> with that object.
<p><var>callback</var> should take exactly one argument.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:make-moment</b><var> n d gn gd<a name="index-ly_003amake_002dmoment-157"></a></var><br>
<blockquote><p>Create the rational number with main timing <var>n</var>/<var>d</var>, and optional grace timing <var>gn</var>/<var>gd</var>.
<p>A <dfn>moment</dfn> is a point in musical time. It consists of a pair of rationals (<var>m</var>, <var>g</var>), where <var>m</var> is the timing for the main notes, and <var>g</var> the timing for grace notes. In absence of grace notes, <var>g</var> is zero.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:make-music</b><var> props<a name="index-ly_003amake_002dmusic-158"></a></var><br>
<blockquote><p>Make a C++ <code>Music</code> object and initialize it with <var>props</var>.
<p>This function is for internal use and is only called by <code>make-music</code>, which is the preferred interface for creating music objects.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:make-music-function</b><var> signature func<a name="index-ly_003amake_002dmusic_002dfunction-159"></a></var><br>
<blockquote><p>Make a function to process music, to be used for the parser. <code>func</code> is the function, and <code>signature</code> describes its arguments. <code>signature</code> is a list containing either <code>ly:music?</code> predicates or other type predicates.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:make-output-def</b><var><a name="index-ly_003amake_002doutput_002ddef-160"></a></var><br>
<blockquote><p>Make an output definition.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:make-page-label-marker</b><var> label<a name="index-ly_003amake_002dpage_002dlabel_002dmarker-161"></a></var><br>
<blockquote><p>Return page marker with label.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:make-page-permission-marker</b><var> symbol permission<a name="index-ly_003amake_002dpage_002dpermission_002dmarker-162"></a></var><br>
<blockquote><p>Return page marker with page breaking and turning permissions.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:make-pango-description-string</b><var> chain size<a name="index-ly_003amake_002dpango_002ddescription_002dstring-163"></a></var><br>
<blockquote><p>Make a <code>PangoFontDescription</code> string for the property alist <var>chain</var> at size <var>size</var>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:make-paper-outputter</b><var> port format<a name="index-ly_003amake_002dpaper_002doutputter-164"></a></var><br>
<blockquote><p>Create an outputter that evaluates within <code>output-</code><var>format</var>, writing to <var>port</var>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:make-pitch</b><var> octave note alter<a name="index-ly_003amake_002dpitch-165"></a></var><br>
<blockquote><p><var>octave</var> is specified by an integer, zero for the octave containing middle C. <var>note</var> is a number from 0 to 6, with 0 corresponding to pitch C and 6 corresponding to pitch B. <var>alter</var> is a rational number of whole tones for alteration.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:make-prob</b><var> type init rest<a name="index-ly_003amake_002dprob-166"></a></var><br>
<blockquote><p>Create a <code>Prob</code> object.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:make-scale</b><var> steps<a name="index-ly_003amake_002dscale-167"></a></var><br>
<blockquote><p>Create a scale. Takes a vector of integers as argument.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:make-score</b><var> music<a name="index-ly_003amake_002dscore-168"></a></var><br>
<blockquote><p>Return score with <var>music</var> encapsulated in <var>score</var>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:make-simple-closure</b><var> expr<a name="index-ly_003amake_002dsimple_002dclosure-169"></a></var><br>
<blockquote><p>Make a simple closure. <var>expr</var> should be form of <code>(</code><var>func</var> <var>a1</var> <var>A2</var><code> ...)</code>, and will be invoked as <code>(</code><var>func</var> <var>delayed-arg</var> <var>a1</var> <var>a2</var><code> ...)</code>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:make-stencil</b><var> expr xext yext<a name="index-ly_003amake_002dstencil-170"></a></var><br>
<blockquote><p>Stencils are device independent output expressions. They carry two pieces of information:
<ol type=1 start=1>
<li>A specification of how to print this object. This specification is processed by the output backends, for example <samp><span class="file">scm/output-ps.scm</span></samp>.
<li>The vertical and horizontal extents of the object, given as pairs. If an extent is unspecified (or if you use <code>(1000 . -1000)</code> as its value), it is taken to be empty.
</ol>
</blockquote></div>
<div class="defun">
— Function: <b>ly:make-stream-event</b><var> cl proplist<a name="index-ly_003amake_002dstream_002devent-171"></a></var><br>
<blockquote><p>Create a stream event of class <var>cl</var> with the given mutable property list.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:message</b><var> str rest<a name="index-ly_003amessage-172"></a></var><br>
<blockquote><p>A Scheme callable function to issue the message <var>str</var>. The message is formatted with <code>format</code> and <var>rest</var>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:minimal-breaking</b><var> pb<a name="index-ly_003aminimal_002dbreaking-173"></a></var><br>
<blockquote><p>Break (pages and lines) the <code>Paper_book</code> object <var>pb</var> without looking for optimal spacing: stack as many lines on a page before moving to the next one.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:mm</b><var> num<a name="index-ly_003amm-174"></a></var><br>
<blockquote><p><var>num</var> mm.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:module->alist</b><var> mod<a name="index-ly_003amodule_002d_003ealist-175"></a></var><br>
<blockquote><p>Dump the contents of module <var>mod</var> as an alist.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:module-copy</b><var> dest src<a name="index-ly_003amodule_002dcopy-176"></a></var><br>
<blockquote><p>Copy all bindings from module <var>src</var> into <var>dest</var>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:modules-lookup</b><var> modules sym def<a name="index-ly_003amodules_002dlookup-177"></a></var><br>
<blockquote><p>Look up <var>sym</var> in the list <var>modules</var>, returning the first occurence. If not found, return <var>def</var> or <code>#f</code> if <var>def</var> isn't specified.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:moment-add</b><var> a b<a name="index-ly_003amoment_002dadd-178"></a></var><br>
<blockquote><p>Add two moments.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:moment-div</b><var> a b<a name="index-ly_003amoment_002ddiv-179"></a></var><br>
<blockquote><p>Divide two moments.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:moment-grace-denominator</b><var> mom<a name="index-ly_003amoment_002dgrace_002ddenominator-180"></a></var><br>
<blockquote><p>Extract denominator from grace timing.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:moment-grace-numerator</b><var> mom<a name="index-ly_003amoment_002dgrace_002dnumerator-181"></a></var><br>
<blockquote><p>Extract numerator from grace timing.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:moment-main-denominator</b><var> mom<a name="index-ly_003amoment_002dmain_002ddenominator-182"></a></var><br>
<blockquote><p>Extract denominator from main timing.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:moment-main-numerator</b><var> mom<a name="index-ly_003amoment_002dmain_002dnumerator-183"></a></var><br>
<blockquote><p>Extract numerator from main timing.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:moment-mod</b><var> a b<a name="index-ly_003amoment_002dmod-184"></a></var><br>
<blockquote><p>Modulo of two moments.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:moment-mul</b><var> a b<a name="index-ly_003amoment_002dmul-185"></a></var><br>
<blockquote><p>Multiply two moments.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:moment-sub</b><var> a b<a name="index-ly_003amoment_002dsub-186"></a></var><br>
<blockquote><p>Subtract two moments.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:moment<?</b><var> a b<a name="index-ly_003amoment_003c_003f-187"></a></var><br>
<blockquote><p>Compare two moments.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:moment?</b><var> x<a name="index-ly_003amoment_003f-188"></a></var><br>
<blockquote><p>Is <var>x</var> a <code>Moment</code> object?
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:music-compress</b><var> m factor<a name="index-ly_003amusic_002dcompress-189"></a></var><br>
<blockquote><p>Compress music object <var>m</var> by moment <var>factor</var>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:music-deep-copy</b><var> m<a name="index-ly_003amusic_002ddeep_002dcopy-190"></a></var><br>
<blockquote><p>Copy <var>m</var> and all sub expressions of <var>m</var>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:music-duration-compress</b><var> mus fact<a name="index-ly_003amusic_002dduration_002dcompress-191"></a></var><br>
<blockquote><p>Compress <var>mus</var> by factor <var>fact</var>, which is a <code>Moment</code>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:music-duration-length</b><var> mus<a name="index-ly_003amusic_002dduration_002dlength-192"></a></var><br>
<blockquote><p>Extract the duration field from <var>mus</var> and return the length.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:music-function-extract</b><var> x<a name="index-ly_003amusic_002dfunction_002dextract-193"></a></var><br>
<blockquote><p>Return the Scheme function inside <var>x</var>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:music-function?</b><var> x<a name="index-ly_003amusic_002dfunction_003f-194"></a></var><br>
<blockquote><p>Is <var>x</var> a <code>music-function</code>?
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:music-length</b><var> mus<a name="index-ly_003amusic_002dlength-195"></a></var><br>
<blockquote><p>Get the length of music expression <var>mus</var> and return it as a <code>Moment</code> object.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:music-list?</b><var> lst<a name="index-ly_003amusic_002dlist_003f-196"></a></var><br>
<blockquote><p>Type predicate: Return true if <var>lst</var> is a list of music objects.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:music-mutable-properties</b><var> mus<a name="index-ly_003amusic_002dmutable_002dproperties-197"></a></var><br>
<blockquote><p>Return an alist containing the mutable properties of <var>mus</var>. The immutable properties are not available, since they are constant and initialized by the <code>make-music</code> function.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:music-output?</b><var> x<a name="index-ly_003amusic_002doutput_003f-198"></a></var><br>
<blockquote><p>Is <var>x</var> a <code>Music_output</code> object?
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:music-property</b><var> mus sym dfault<a name="index-ly_003amusic_002dproperty-199"></a></var><br>
<blockquote><p>Get the property <var>sym</var> of music expression <var>mus</var>. If <var>sym</var> is undefined, return <code>'()</code>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:music-set-property!</b><var> mus sym val<a name="index-ly_003amusic_002dset_002dproperty_0021-200"></a></var><br>
<blockquote><p>Set property <var>sym</var> in music expression <var>mus</var> to <var>val</var>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:music-transpose</b><var> m p<a name="index-ly_003amusic_002dtranspose-201"></a></var><br>
<blockquote><p>Transpose <var>m</var> such that central C is mapped to <var>p</var>. Return <var>m</var>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:music?</b><var> obj<a name="index-ly_003amusic_003f-202"></a></var><br>
<blockquote><p>Type predicate.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:note-head::stem-attachment</b><var> font-metric glyph-name<a name="index-ly_003anote_002dhead_003a_003astem_002dattachment-203"></a></var><br>
<blockquote><p>Get attachment in <var>font-metric</var> for attaching a stem to notehead <var>glyph-name</var>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:number->string</b><var> s<a name="index-ly_003anumber_002d_003estring-204"></a></var><br>
<blockquote><p>Convert <var>num</var> to a string without generating many decimals.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:optimal-breaking</b><var> pb<a name="index-ly_003aoptimal_002dbreaking-205"></a></var><br>
<blockquote><p>Optimally break (pages and lines) the <code>Paper_book</code> object <var>pb</var> to minimize badness in bother vertical and horizontal spacing.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:option-usage</b><var><a name="index-ly_003aoption_002dusage-206"></a></var><br>
<blockquote><p>Print <code>ly:set-option</code> usage.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:otf->cff</b><var> otf-file-name<a name="index-ly_003aotf_002d_003ecff-207"></a></var><br>
<blockquote><p>Convert the contents of an OTF file to a CFF file, returning it as a string.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:otf-font-glyph-info</b><var> font glyph<a name="index-ly_003aotf_002dfont_002dglyph_002dinfo-208"></a></var><br>
<blockquote><p>Given the font metric <var>font</var> of an OpenType font, return the information about named glyph <var>glyph</var> (a string).
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:otf-font-table-data</b><var> font tag<a name="index-ly_003aotf_002dfont_002dtable_002ddata-209"></a></var><br>
<blockquote><p>Extract a table <var>tag</var> from <var>font</var>. Return empty string for non-existent <var>tag</var>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:otf-font?</b><var> font<a name="index-ly_003aotf_002dfont_003f-210"></a></var><br>
<blockquote><p>Is <var>font</var> an OpenType font?
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:otf-glyph-list</b><var> font<a name="index-ly_003aotf_002dglyph_002dlist-211"></a></var><br>
<blockquote><p>Return a list of glyph names for <var>font</var>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:output-def-clone</b><var> def<a name="index-ly_003aoutput_002ddef_002dclone-212"></a></var><br>
<blockquote><p>Clone output definition <var>def</var>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:output-def-lookup</b><var> pap sym def<a name="index-ly_003aoutput_002ddef_002dlookup-213"></a></var><br>
<blockquote><p>Look up <var>sym</var> in the <var>pap</var> output definition (e.g., <code>\paper</code>). Return the value or <var>def</var> (which defaults to <code>'()</code>) if undefined.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:output-def-parent</b><var> def<a name="index-ly_003aoutput_002ddef_002dparent-214"></a></var><br>
<blockquote><p>Get the parent output definition of <var>def</var>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:output-def-scope</b><var> def<a name="index-ly_003aoutput_002ddef_002dscope-215"></a></var><br>
<blockquote><p>Get the variable scope inside <var>def</var>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:output-def-set-variable!</b><var> def sym val<a name="index-ly_003aoutput_002ddef_002dset_002dvariable_0021-216"></a></var><br>
<blockquote><p>Set an output definition <var>def</var> variable <var>sym</var> to <var>val</var>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:output-def?</b><var> def<a name="index-ly_003aoutput_002ddef_003f-217"></a></var><br>
<blockquote><p>Is <var>def</var> a layout definition?
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:output-description</b><var> output-def<a name="index-ly_003aoutput_002ddescription-218"></a></var><br>
<blockquote><p>Return the description of translators in <var>output-def</var>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:output-formats</b><var><a name="index-ly_003aoutput_002dformats-219"></a></var><br>
<blockquote><p>Formats passed to <samp><span class="option">--format</span></samp> as a list of strings, used for the output.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:outputter-close</b><var> outputter<a name="index-ly_003aoutputter_002dclose-220"></a></var><br>
<blockquote><p>Close port of <var>outputter</var>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:outputter-dump-stencil</b><var> outputter stencil<a name="index-ly_003aoutputter_002ddump_002dstencil-221"></a></var><br>
<blockquote><p>Dump stencil <var>expr</var> onto <var>outputter</var>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:outputter-dump-string</b><var> outputter str<a name="index-ly_003aoutputter_002ddump_002dstring-222"></a></var><br>
<blockquote><p>Dump <var>str</var> onto <var>outputter</var>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:outputter-output-scheme</b><var> outputter expr<a name="index-ly_003aoutputter_002doutput_002dscheme-223"></a></var><br>
<blockquote><p>Eval <var>expr</var> in module of <var>outputter</var>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:outputter-port</b><var> outputter<a name="index-ly_003aoutputter_002dport-224"></a></var><br>
<blockquote><p>Return output port for <var>outputter</var>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:page-marker?</b><var> x<a name="index-ly_003apage_002dmarker_003f-225"></a></var><br>
<blockquote><p>Is <var>x</var> a <code>Page_marker</code> object?
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:page-turn-breaking</b><var> pb<a name="index-ly_003apage_002dturn_002dbreaking-226"></a></var><br>
<blockquote><p>Optimally break (pages and lines) the <code>Paper_book</code> object <var>pb</var> such that page turns only happen in specified places, returning its pages.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:pango-font-physical-fonts</b><var> f<a name="index-ly_003apango_002dfont_002dphysical_002dfonts-227"></a></var><br>
<blockquote><p>Return alist of <code>(PSNAME . FILENAME)</code> tuples.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:pango-font?</b><var> f<a name="index-ly_003apango_002dfont_003f-228"></a></var><br>
<blockquote><p>Is <var>f</var> a pango font?
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:paper-book-pages</b><var> pb<a name="index-ly_003apaper_002dbook_002dpages-229"></a></var><br>
<blockquote><p>Return pages in book <var>pb</var>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:paper-book-paper</b><var> pb<a name="index-ly_003apaper_002dbook_002dpaper-230"></a></var><br>
<blockquote><p>Return pages in book <var>pb</var>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:paper-book-performances</b><var> paper-book<a name="index-ly_003apaper_002dbook_002dperformances-231"></a></var><br>
<blockquote><p>Return performances in book <var>paper-book</var>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:paper-book-scopes</b><var> book<a name="index-ly_003apaper_002dbook_002dscopes-232"></a></var><br>
<blockquote><p>Return pages in layout book <var>book</var>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:paper-book-systems</b><var> pb<a name="index-ly_003apaper_002dbook_002dsystems-233"></a></var><br>
<blockquote><p>Return systems in book <var>pb</var>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:paper-book?</b><var> x<a name="index-ly_003apaper_002dbook_003f-234"></a></var><br>
<blockquote><p>Is <var>x</var> a <code>Paper_book</code> object?
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:paper-fonts</b><var> bp<a name="index-ly_003apaper_002dfonts-235"></a></var><br>
<blockquote><p>Return fonts from the <code>\paper</code> block <var>bp</var>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:paper-get-font</b><var> paper-smob chain<a name="index-ly_003apaper_002dget_002dfont-236"></a></var><br>
<blockquote><p>Return a font metric satisfying the font-qualifiers in the alist chain <var>chain</var>. (An alist chain is a list of alists, containing grob properties.)
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:paper-get-number</b><var> layout-smob name<a name="index-ly_003apaper_002dget_002dnumber-237"></a></var><br>
<blockquote><p>Return the layout variable <var>name</var>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:paper-outputscale</b><var> bp<a name="index-ly_003apaper_002doutputscale-238"></a></var><br>
<blockquote><p>Get output-scale for <var>bp</var>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:paper-score-paper-systems</b><var> paper-score<a name="index-ly_003apaper_002dscore_002dpaper_002dsystems-239"></a></var><br>
<blockquote><p>Return vector of <code>paper_system</code> objects from <var>paper-score</var>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:paper-system-minimum-distance</b><var> sys1 sys2<a name="index-ly_003apaper_002dsystem_002dminimum_002ddistance-240"></a></var><br>
<blockquote><p>Measure the minimum distance between these two paper-systems, using their stored skylines if possible and falling back to their extents otherwise.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:paper-system?</b><var> obj<a name="index-ly_003apaper_002dsystem_003f-241"></a></var><br>
<blockquote><p>Type predicate.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:parse-file</b><var> name<a name="index-ly_003aparse_002dfile-242"></a></var><br>
<blockquote><p>Parse a single <code>.ly</code> file. Upon failure, throw <code>ly-file-failed</code> key.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:parser-clear-error</b><var> parser<a name="index-ly_003aparser_002dclear_002derror-243"></a></var><br>
<blockquote><p>Clear the error flag for the parser.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:parser-clone</b><var> parser-smob<a name="index-ly_003aparser_002dclone-244"></a></var><br>
<blockquote><p>Return a clone of <var>parser-smob</var>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:parser-define!</b><var> parser-smob symbol val<a name="index-ly_003aparser_002ddefine_0021-245"></a></var><br>
<blockquote><p>Bind <var>symbol</var> to <var>val</var> in <var>parser-smob</var>'s module.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:parser-error</b><var> parser msg input<a name="index-ly_003aparser_002derror-246"></a></var><br>
<blockquote><p>Display an error message and make the parser fail.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:parser-has-error?</b><var> parser<a name="index-ly_003aparser_002dhas_002derror_003f-247"></a></var><br>
<blockquote><p>Does <var>parser</var> have an error flag?
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:parser-lexer</b><var> parser-smob<a name="index-ly_003aparser_002dlexer-248"></a></var><br>
<blockquote><p>Return the lexer for <var>parser-smob</var>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:parser-lookup</b><var> parser-smob symbol<a name="index-ly_003aparser_002dlookup-249"></a></var><br>
<blockquote><p>Look up <var>symbol</var> in <var>parser-smob</var>'s module. Return <code>'()</code> if not defined.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:parser-output-name</b><var> parser<a name="index-ly_003aparser_002doutput_002dname-250"></a></var><br>
<blockquote><p>Return the base name of the output file.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:parser-parse-string</b><var> parser-smob ly-code<a name="index-ly_003aparser_002dparse_002dstring-251"></a></var><br>
<blockquote><p>Parse the string <var>ly-code</var> with <var>parser-smob</var>. Upon failure, throw <code>ly-file-failed</code> key.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:parser-set-note-names</b><var> parser names<a name="index-ly_003aparser_002dset_002dnote_002dnames-252"></a></var><br>
<blockquote><p>Replace current note names in <var>parser</var>. <var>names</var> is an alist of symbols. This only has effect if the current mode is notes.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:performance-write</b><var> performance filename<a name="index-ly_003aperformance_002dwrite-253"></a></var><br>
<blockquote><p>Write <var>performance</var> to <var>filename</var>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:pfb->pfa</b><var> pfb-file-name<a name="index-ly_003apfb_002d_003epfa-254"></a></var><br>
<blockquote><p>Convert the contents of a PFB file to PFA.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:pitch-alteration</b><var> pp<a name="index-ly_003apitch_002dalteration-255"></a></var><br>
<blockquote><p>Extract the alteration from pitch <var>pp</var>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:pitch-diff</b><var> pitch root<a name="index-ly_003apitch_002ddiff-256"></a></var><br>
<blockquote><p>Return pitch <var>delta</var> such that <var>pitch</var> transposed by <var>delta</var> equals <var>root</var>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:pitch-negate</b><var> p<a name="index-ly_003apitch_002dnegate-257"></a></var><br>
<blockquote><p>Negate <var>p</var>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:pitch-notename</b><var> pp<a name="index-ly_003apitch_002dnotename-258"></a></var><br>
<blockquote><p>Extract the note name from pitch <var>pp</var>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:pitch-octave</b><var> pp<a name="index-ly_003apitch_002doctave-259"></a></var><br>
<blockquote><p>Extract the octave from pitch <var>pp</var>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:pitch-quartertones</b><var> pp<a name="index-ly_003apitch_002dquartertones-260"></a></var><br>
<blockquote><p>Calculate the number of quarter tones of <var>pp</var> from middle C.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:pitch-semitones</b><var> pp<a name="index-ly_003apitch_002dsemitones-261"></a></var><br>
<blockquote><p>Calculate the number of semitones of <var>pp</var> from middle C.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:pitch-steps</b><var> p<a name="index-ly_003apitch_002dsteps-262"></a></var><br>
<blockquote><p>Number of steps counted from middle C of the pitch <var>p</var>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:pitch-transpose</b><var> p delta<a name="index-ly_003apitch_002dtranspose-263"></a></var><br>
<blockquote><p>Transpose <var>p</var> by the amount <var>delta</var>, where <var>delta</var> is relative to middle C.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:pitch<?</b><var> p1 p2<a name="index-ly_003apitch_003c_003f-264"></a></var><br>
<blockquote><p>Is <var>p1</var> lexicographically smaller than <var>p2</var>?
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:pitch?</b><var> x<a name="index-ly_003apitch_003f-265"></a></var><br>
<blockquote><p>Is <var>x</var> a <code>Pitch</code> object?
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:prob-immutable-properties</b><var> prob<a name="index-ly_003aprob_002dimmutable_002dproperties-266"></a></var><br>
<blockquote><p>Retrieve an alist of mutable properties.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:prob-mutable-properties</b><var> prob<a name="index-ly_003aprob_002dmutable_002dproperties-267"></a></var><br>
<blockquote><p>Retrieve an alist of mutable properties.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:prob-property</b><var> obj sym dfault<a name="index-ly_003aprob_002dproperty-268"></a></var><br>
<blockquote><p>Return the value for <var>sym</var>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:prob-property?</b><var> obj sym<a name="index-ly_003aprob_002dproperty_003f-269"></a></var><br>
<blockquote><p>Is boolean prop <var>sym</var> set?
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:prob-set-property!</b><var> obj sym value<a name="index-ly_003aprob_002dset_002dproperty_0021-270"></a></var><br>
<blockquote><p>Set property <var>sym</var> of <var>obj</var> to <var>value</var>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:prob-type?</b><var> obj type<a name="index-ly_003aprob_002dtype_003f-271"></a></var><br>
<blockquote><p>Is <var>obj</var> the specified prob-type?
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:prob?</b><var> x<a name="index-ly_003aprob_003f-272"></a></var><br>
<blockquote><p>Is <var>x</var> a <code>Prob</code> object?
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:programming-error</b><var> str rest<a name="index-ly_003aprogramming_002derror-273"></a></var><br>
<blockquote><p>A Scheme callable function to issue the internal warning <var>str</var>. The message is formatted with <code>format</code> and <var>rest</var>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:progress</b><var> str rest<a name="index-ly_003aprogress-274"></a></var><br>
<blockquote><p>A Scheme callable function to print progress <var>str</var>. The message is formatted with <code>format</code> and <var>rest</var>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:property-lookup-stats</b><var> sym<a name="index-ly_003aproperty_002dlookup_002dstats-275"></a></var><br>
<blockquote><p>Return hash table with a property access corresponding to <var>sym</var>. Choices are <code>prob</code>, <code>grob</code>, and <code>context</code>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:protects</b><var><a name="index-ly_003aprotects-276"></a></var><br>
<blockquote><p>Return hash of protected objects.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:pt</b><var> num<a name="index-ly_003apt-277"></a></var><br>
<blockquote><p><var>num</var> printer points.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:register-stencil-expression</b><var> symbol<a name="index-ly_003aregister_002dstencil_002dexpression-278"></a></var><br>
<blockquote><p>Add <var>symbol</var> as head of a stencil expression.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:relative-group-extent</b><var> elements common axis<a name="index-ly_003arelative_002dgroup_002dextent-279"></a></var><br>
<blockquote><p>Determine the extent of <var>elements</var> relative to <var>common</var> in the <var>axis</var> direction.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:reset-all-fonts</b><var><a name="index-ly_003areset_002dall_002dfonts-280"></a></var><br>
<blockquote><p>Forget all about previously loaded fonts.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:round-filled-box</b><var> xext yext blot<a name="index-ly_003around_002dfilled_002dbox-281"></a></var><br>
<blockquote><p>Make a <code>Stencil</code> object that prints a black box of dimensions <var>xext</var>, <var>yext</var> and roundness <var>blot</var>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:round-filled-polygon</b><var> points blot<a name="index-ly_003around_002dfilled_002dpolygon-282"></a></var><br>
<blockquote><p>Make a <code>Stencil</code> object that prints a black polygon with corners at the points defined by <var>points</var> (list of coordinate pairs) and roundness <var>blot</var>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:run-translator</b><var> mus output-def<a name="index-ly_003arun_002dtranslator-283"></a></var><br>
<blockquote><p>Process <var>mus</var> according to <var>output-def</var>. An interpretation context is set up, and <var>mus</var> is interpreted with it. The context is returned in its final state.
<p>Optionally, this routine takes an object-key to to uniquely identify the score block containing it.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:score-add-output-def!</b><var> score def<a name="index-ly_003ascore_002dadd_002doutput_002ddef_0021-284"></a></var><br>
<blockquote><p>Add an output definition <var>def</var> to <var>score</var>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:score-embedded-format</b><var> score layout<a name="index-ly_003ascore_002dembedded_002dformat-285"></a></var><br>
<blockquote><p>Run <var>score</var> through <var>layout</var> (an output definition) scaled to correct output-scale already, returning a list of layout-lines. This function takes an optional <code>Object_key</code> argument.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:score-error?</b><var> score<a name="index-ly_003ascore_002derror_003f-286"></a></var><br>
<blockquote><p>Was there an error in the score?
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:score-header</b><var> score<a name="index-ly_003ascore_002dheader-287"></a></var><br>
<blockquote><p>Return score header.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:score-music</b><var> score<a name="index-ly_003ascore_002dmusic-288"></a></var><br>
<blockquote><p>Return score music.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:score-output-defs</b><var> score<a name="index-ly_003ascore_002doutput_002ddefs-289"></a></var><br>
<blockquote><p>All output definitions in a score.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:score-set-header!</b><var> score module<a name="index-ly_003ascore_002dset_002dheader_0021-290"></a></var><br>
<blockquote><p>Set the score header.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:score?</b><var> x<a name="index-ly_003ascore_003f-291"></a></var><br>
<blockquote><p>Is <var>x</var> a <code>Score</code> object?
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:set-default-scale</b><var> scale<a name="index-ly_003aset_002ddefault_002dscale-292"></a></var><br>
<blockquote><p>Set the global default scale.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:set-grob-modification-callback</b><var> cb<a name="index-ly_003aset_002dgrob_002dmodification_002dcallback-293"></a></var><br>
<blockquote><p>Specify a procedure that will be called every time LilyPond modifies a grob property. The callback will receive as arguments the grob that is being modified, the name of the C++ file in which the modification was requested, the line number in the C++ file in which the modification was requested, the name of the function in which the modification was requested, the property to be changed, and the new value for the property.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:set-middle-C!</b><var> context<a name="index-ly_003aset_002dmiddle_002dC_0021-294"></a></var><br>
<blockquote><p>Set the <code>middleCPosition</code> variable in <var>context</var> based on the variables <code>middleCClefPosition</code> and middleCOffset.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:set-option</b><var> var val<a name="index-ly_003aset_002doption-295"></a></var><br>
<blockquote><p>Set a program option.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:set-point-and-click</b><var> what<a name="index-ly_003aset_002dpoint_002dand_002dclick-296"></a></var><br>
<blockquote><p>Deprecated.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:set-property-cache-callback</b><var> cb<a name="index-ly_003aset_002dproperty_002dcache_002dcallback-297"></a></var><br>
<blockquote><p>Specify a procedure that will be called whenever lilypond calculates a callback function and caches the result. The callback will receive as arguments the grob whose property it is, the name of the property, the name of the callback that calculated the property, and the new (cached) value of the property.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:simple-closure?</b><var> clos<a name="index-ly_003asimple_002dclosure_003f-298"></a></var><br>
<blockquote><p>Type predicate.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:skyline-pair?</b><var> x<a name="index-ly_003askyline_002dpair_003f-299"></a></var><br>
<blockquote><p>Is <var>x</var> a <code>Skyline_pair</code> object?
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:skyline?</b><var> x<a name="index-ly_003askyline_003f-300"></a></var><br>
<blockquote><p>Is <var>x</var> a <code>Skyline</code> object?
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:smob-protects</b><var><a name="index-ly_003asmob_002dprotects-301"></a></var><br>
<blockquote><p>Return LilyPond's internal smob protection list.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:solve-spring-rod-problem</b><var> springs rods length ragged<a name="index-ly_003asolve_002dspring_002drod_002dproblem-302"></a></var><br>
<blockquote><p>Solve a spring and rod problem for <var>count</var> objects, that are connected by <var>count</var>-1 <var>springs</var>, and an arbitrary number of <var>rods</var>. <var>count</var> is implicitly given by <var>springs</var> and <var>rods</var>. The <var>springs</var> argument has the format <code>(ideal, inverse_hook)</code> and <var>rods</var> is of the form <code>(idx1, idx2, distance)</code>.
<p><var>length</var> is a number, <var>ragged</var> a boolean.
<p>The function returns a list containing the force (positive for stretching, negative for compressing and <code>#f</code> for non-satisfied constraints) followed by <var>spring-count</var>+1 positions of the objects.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:source-file?</b><var> x<a name="index-ly_003asource_002dfile_003f-303"></a></var><br>
<blockquote><p>Is <var>x</var> a <code>Source_file</code> object?
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:spanner-bound</b><var> slur dir<a name="index-ly_003aspanner_002dbound-304"></a></var><br>
<blockquote><p>Get one of the bounds of <var>slur</var>. <var>dir</var> is <code>-1</code> for left, and <code>1</code> for right.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:spanner-broken-into</b><var> spanner<a name="index-ly_003aspanner_002dbroken_002dinto-305"></a></var><br>
<blockquote><p>Return broken-into list for <var>spanner</var>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:spanner?</b><var> g<a name="index-ly_003aspanner_003f-306"></a></var><br>
<blockquote><p>Is <var>g</var> a spanner object?
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:start-environment</b><var><a name="index-ly_003astart_002denvironment-307"></a></var><br>
<blockquote><p>Return the environment (a list of strings) that was in effect at program start.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:stderr-redirect</b><var> file-name mode<a name="index-ly_003astderr_002dredirect-308"></a></var><br>
<blockquote><p>Redirect stderr to <var>file-name</var>, opened with <var>mode</var>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:stencil-add</b><var> args<a name="index-ly_003astencil_002dadd-309"></a></var><br>
<blockquote><p>Combine stencils. Takes any number of arguments.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:stencil-aligned-to</b><var> stil axis dir<a name="index-ly_003astencil_002daligned_002dto-310"></a></var><br>
<blockquote><p>Align <var>stil</var> using its own extents. <var>dir</var> is a number. <code>-1</code> and <code>1</code> are left and right, respectively. Other values are interpolated (so <code>0</code> means the center).
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:stencil-combine-at-edge</b><var> first axis direction second padding minimum<a name="index-ly_003astencil_002dcombine_002dat_002dedge-311"></a></var><br>
<blockquote><p>Construct a stencil by putting <var>second</var> next to <var>first</var>. <var>axis</var> can be 0 (x-axis) or 1 (y-axis). <var>direction</var> can be -1 (left or down) or 1 (right or up). The stencils are juxtaposed with <var>padding</var> as extra space. If this puts the reference points closer than <var>minimum</var>, they are moved by the latter amount. <var>first</var> and <var>second</var> may also be <code>'()</code> or <code>#f</code>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:stencil-empty?</b><var> stil<a name="index-ly_003astencil_002dempty_003f-312"></a></var><br>
<blockquote><p>Return whether <var>stil</var> is empty.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:stencil-expr</b><var> stil<a name="index-ly_003astencil_002dexpr-313"></a></var><br>
<blockquote><p>Return the expression of <var>stil</var>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:stencil-extent</b><var> stil axis<a name="index-ly_003astencil_002dextent-314"></a></var><br>
<blockquote><p>Return a pair of numbers signifying the extent of <var>stil</var> in <var>axis</var> direction (<code>0</code> or <code>1</code> for x and y axis, respectively).
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:stencil-fonts</b><var> s<a name="index-ly_003astencil_002dfonts-315"></a></var><br>
<blockquote><p>Analyze <var>s</var>, and return a list of fonts used in <var>s</var>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:stencil-in-color</b><var> stc r g b<a name="index-ly_003astencil_002din_002dcolor-316"></a></var><br>
<blockquote><p>Put <var>stc</var> in a different color.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:stencil-rotate</b><var> stil angle x y<a name="index-ly_003astencil_002drotate-317"></a></var><br>
<blockquote><p>Return a stencil <var>stil</var> rotated <var>angle</var> degrees around point (<var>x</var>, <var>y</var>).
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:stencil-translate</b><var> stil offset<a name="index-ly_003astencil_002dtranslate-318"></a></var><br>
<blockquote><p>Return a <var>stil</var>, but translated by <var>offset</var> (a pair of numbers).
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:stencil-translate-axis</b><var> stil amount axis<a name="index-ly_003astencil_002dtranslate_002daxis-319"></a></var><br>
<blockquote><p>Return a copy of <var>stil</var> but translated by <var>amount</var> in <var>axis</var> direction.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:stencil?</b><var> x<a name="index-ly_003astencil_003f-320"></a></var><br>
<blockquote><p>Is <var>x</var> a <code>Stencil</code> object?
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:stream-event?</b><var> x<a name="index-ly_003astream_002devent_003f-321"></a></var><br>
<blockquote><p>Is <var>x</var> a <code>Stream_event</code> object?
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:string-substitute</b><var> a b s<a name="index-ly_003astring_002dsubstitute-322"></a></var><br>
<blockquote><p>Replace string <var>a</var> by string <var>b</var> in string <var>s</var>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:system-print</b><var> system<a name="index-ly_003asystem_002dprint-323"></a></var><br>
<blockquote><p>Draw the system and return the prob containing its stencil.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:system-stretch</b><var> system amount-scm<a name="index-ly_003asystem_002dstretch-324"></a></var><br>
<blockquote><p>Stretch the system vertically by the given amount. This must be called before the system is drawn (for example with <code>ly:system-print</code>).
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:text-dimension</b><var> font text<a name="index-ly_003atext_002ddimension-325"></a></var><br>
<blockquote><p>Given the font metric in <var>font</var> and the string <var>text</var>, compute the extents of that text in that font. The return value is a pair of number-pairs.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:text-interface::interpret-markup</b><var><a name="index-ly_003atext_002dinterface_003a_003ainterpret_002dmarkup-326"></a></var><br>
<blockquote><p>Convert a text markup into a stencil. Takes three arguments, <var>layout</var>, <var>props</var>, and <var>markup</var>.
<p><var>layout</var> is a <code>\layout</code> block; it may be obtained from a grob with <code>ly:grob-layout</code>. <var>props</var> is a alist chain, ie. a list of alists. This is typically obtained with <code>(ly:grob-alist-chain (ly:layout-lookup layout 'text-font-defaults))</code>. <var>markup</var> is the markup text to be processed.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:translator-description</b><var> me<a name="index-ly_003atranslator_002ddescription-327"></a></var><br>
<blockquote><p>Return an alist of properties of translator <var>me</var>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:translator-group?</b><var> x<a name="index-ly_003atranslator_002dgroup_003f-328"></a></var><br>
<blockquote><p>Is <var>x</var> a <code>Translator_group</code> object?
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:translator-name</b><var> trans<a name="index-ly_003atranslator_002dname-329"></a></var><br>
<blockquote><p>Return the type name of the translator object <var>trans</var>. The name is a symbol.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:translator?</b><var> x<a name="index-ly_003atranslator_003f-330"></a></var><br>
<blockquote><p>Is <var>x</var> a <code>Translator</code> object?
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:transpose-key-alist</b><var> l pit<a name="index-ly_003atranspose_002dkey_002dalist-331"></a></var><br>
<blockquote><p>Make a new key alist of <var>l</var> transposed by pitch <var>pit</var>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:truncate-list!</b><var> lst i<a name="index-ly_003atruncate_002dlist_0021-332"></a></var><br>
<blockquote><p>Take at most the first <var>i</var> of list <var>lst</var>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:ttf->pfa</b><var> ttf-file-name<a name="index-ly_003attf_002d_003epfa-333"></a></var><br>
<blockquote><p>Convert the contents of a TTF file to Type42 PFA, returning it as a string.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:ttf-ps-name</b><var> ttf-file-name<a name="index-ly_003attf_002dps_002dname-334"></a></var><br>
<blockquote><p>Extract the PostScript name from a TrueType font.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:unit</b><var><a name="index-ly_003aunit-335"></a></var><br>
<blockquote><p>Return the unit used for lengths as a string.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:usage</b><var><a name="index-ly_003ausage-336"></a></var><br>
<blockquote><p>Print usage message.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:version</b><var><a name="index-ly_003aversion-337"></a></var><br>
<blockquote><p>Return the current lilypond version as a list, e.g., <code>(1 3 127 uu1)</code>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:warning</b><var> str rest<a name="index-ly_003awarning-338"></a></var><br>
<blockquote><p>A Scheme callable function to issue the warning <code>str</code>. The message is formatted with <code>format</code> and <code>rest</code>.
</p></blockquote></div>
<div class="defun">
— Function: <b>ly:wide-char->utf-8</b><var> wc<a name="index-ly_003awide_002dchar_002d_003eutf_002d8-339"></a></var><br>
<blockquote><p>Encode the Unicode codepoint <var>wc</var>, an integer, as UTF-8.
</p></blockquote></div>
<!-- footer_tag --><br><hr>
<div class="node">
<p>
Next: <a rel="next" accesskey="n" href="Indices.es.html#Indices">Indices</a>,
Previous: <a rel="previous" accesskey="p" href="Backend.es.html#Backend">Backend</a>,
Up: <a rel="up" accesskey="u" href="index.es.html#Top">Top</a>
</div>
<div style="background-color: #e8ffe8; padding: 2; border: #c0ffc0 1px solid;">
<p>
<font size="-1">
Esta página corresponde a LilyPond-2.11.57 (rama de desarrollo).
<br>
<address>
Informe de los fallos a través de la lista en español <a href="http://es.groups.yahoo.com/group/lilypond-es/">lilypond-es</a>, o en inglés a través de <a href="http://post.gmane.org/post.php?group=gmane.comp.gnu.lilypond.bugs">http://post.gmane.org/post.php?group=gmane.comp.gnu.lilypond.bugs</a>. </address>
<br>
Se agradecen las <a href="http://lilypond.org/web/devel/participating/documentation-adding">sugerencias para la documentación</a>.
</font>
</p>
</div>
</BODY></html>
