<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!-- header_tag -->
<html lang="en">
<head>
<title>Music properties - 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="up" href="Music-definitions.es.html#Music-definitions" title="Music definitions">
<link rel="prev" href="Music-classes.es.html#Music-classes" title="Music classes">
<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="Music-properties"></a>
Previous: <a rel="previous" accesskey="p" href="Music-classes.es.html#Music-classes">Music classes</a>,
Up: <a rel="up" accesskey="u" href="Music-definitions.es.html#Music-definitions">Music definitions</a>
<hr>
</div>
<h3 class="unnumberedsec">Music properties</h3>
<dl>
<dt><code>X-offset</code> (number)<dd>Offset of resulting grob; only used for balloon texts.
<br><dt><code>Y-offset</code> (number)<dd>Offset of resulting grob; only used for balloon texts.
<br><dt><code>absolute-octave</code> (integer)<dd>The absolute octave for a octave check note.
<br><dt><code>alteration</code> (number)<dd>Alteration for figured bass.
<br><dt><code>articulation-type</code> (string)<dd>Key for script definitions alist.
<p>TODO: Consider making type into symbol.
<br><dt><code>articulations</code> (list of music)<dd>Articulation events specifically for this note.
<br><dt><code>associated-context</code> (string)<dd>Name of the Voice context associated with
this <code>\newaddlyrics</code> section.
<br><dt><code>augmented</code> (boolean)<dd>This figure is for an augmented figured bass
(with <code>+</code> sign).
<br><dt><code>augmented-slash</code> (boolean)<dd>This figure is for an augmented figured bass
(back-slashed number).
<br><dt><code>bass</code> (boolean)<dd>Set if this note is a bass note in a chord.
<br><dt><code>bracket-start</code> (boolean)<dd>Start a bracket here.
<p>TODO: Use SpanEvents?
<br><dt><code>bracket-stop</code> (boolean)<dd>Stop a bracket here.
<br><dt><code>break-penalty</code> (number)<dd>Penalty for line break hint.
<br><dt><code>break-permission</code> (symbol)<dd>Whether to allow, forbid or force a line break.
<br><dt><code>cautionary</code> (boolean)<dd>If set, this alteration needs a
cautionary accidental.
<br><dt><code>change-to-id</code> (string)<dd>Name of the context to change to.
<br><dt><code>change-to-type</code> (symbol)<dd>Type of the context to change to.
<br><dt><code>compress-procedure</code> (procedure)<dd>Compress this music expression.
Arg 1: the music, arg 2: factor.
<br><dt><code>context-id</code> (string)<dd>Name of context.
<br><dt><code>context-type</code> (symbol)<dd>Type of context.
<br><dt><code>create-new</code> (boolean)<dd>Create a fresh context.
<br><dt><code>delta-step</code> (number)<dd>How much should a fall change pitch?
<br><dt><code>denominator</code> (integer)<dd>Denominator in a time signature.
<br><dt><code>descend-only</code> (boolean)<dd>If set, this <code>\context</code> only descends
in the context tree.
<br><dt><code>digit</code> (integer)<dd>Digit for fingering.
<br><dt><code>diminished</code> (boolean)<dd>This bass figure should be slashed.
<br><dt><code>direction</code> (direction)<dd>Print this up or down?
<br><dt><code>drum-type</code> (symbol)<dd>Which percussion instrument to play this note on.
<br><dt><code>duration</code> (duration)<dd>Duration of this note or lyric.
<br><dt><code>element</code> (music)<dd>The single child of a Music_wrapper music object,
or the body of a repeat.
<br><dt><code>elements</code> (list of music)<dd>A list of elements for sequential of
simultaneous music, or the alternatives of repeated music.
<br><dt><code>elements-callback</code> (procedure)<dd>Return a list of children, for use by
a sequential iterator. Takes a single music parameter.
<br><dt><code>error-found</code> (boolean)<dd>If true, a parsing error was found in this expression.
<br><dt><code>expected-beam-count</code> (integer)<dd>Expected number of non-tremolo beams
in a tremolo repeat.
<br><dt><code>figure</code> (integer)<dd>A bass figure.
<br><dt><code>force-accidental</code> (boolean)<dd>If set, a cautionary accidental should
always be printed on this note.
<br><dt><code>grob-property</code> (symbol)<dd>The symbol of the grob property to set.
<br><dt><code>grob-property-path</code> (list)<dd>A list of symbols, locating a nested grob
property, e.g., <code>(beamed-lengths details)</code>.
<br><dt><code>grob-value</code> (any type)<dd>The value of the grob property to set.
<br><dt><code>input-tag</code> (any type)<dd>Arbitrary marker to relate input and output.
<br><dt><code>inversion</code> (boolean)<dd>If set, this chord note is inverted.
<br><dt><code>iterator-ctor</code> (procedure)<dd>Function to construct a
<code>music-event-iterator</code> object for this music.
<br><dt><code>label</code> (markup)<dd>Label of a mark.
<br><dt><code>last-pitch</code> (pitch)<dd>The last pitch after relativization.
<br><dt><code>length</code> (moment)<dd>The duration of this music.
<br><dt><code>length-callback</code> (procedure)<dd>How to compute the duration of this music.
This property can only be defined as initializer in
<samp><span class="file">scm/define-music-types.scm</span></samp>.
<br><dt><code>line-break-permission</code> (symbol)<dd>When the music is at top-level,
whether to allow, forbid or force a line break.
<br><dt><code>metronome-count</code> (number)<dd>How many beats in a minute?
<br><dt><code>name</code> (symbol)<dd>Name of this music object.
<br><dt><code>no-continuation</code> (boolean)<dd>If set, disallow continuation lines.
<br><dt><code>numerator</code> (integer)<dd>Numerator of a time signature.
<br><dt><code>octavation</code> (integer)<dd>This pitch was octavated by how many octaves?
For chord inversions, this is negative.
<br><dt><code>once</code> (boolean)<dd>Apply this operation only during one time step?
<br><dt><code>origin</code> (input location)<dd>Where was this piece of music defined?
<br><dt><code>page-break-permission</code> (symbol)<dd>When the music is at top-level,
whether to allow, forbid or force a page break.
<br><dt><code>page-label</code> (symbol)<dd>The label of a page marker.
<br><dt><code>page-marker</code> (boolean)<dd>If true, and the music expression is found at
top-level, a page marker object is instanciated instead of a score.
<br><dt><code>page-turn-permission</code> (symbol)<dd>When the music is at top-level,
whether to allow, forbid or force a page turn.
<br><dt><code>parenthesize</code> (boolean)<dd>Enclose resulting objects in parentheses?
<br><dt><code>part-combine-status</code> (symbol)<dd>Change to what kind of state?
Options are <code>solo1</code>, <code>solo2</code> and <code>unisono</code>.
<br><dt><code>pitch</code> (pitch)<dd>The pitch of this note.
<br><dt><code>pitch-alist</code> (list)<dd>A list of pitches jointly forming the scale
of a key signature.
<br><dt><code>pop-first</code> (boolean)<dd>Do a revert before we try to do a override
on some grob property.
<br><dt><code>prob-property</code> (symbol)<dd>The symbol of the prob property to set.
<br><dt><code>procedure</code> (procedure)<dd>The function to run with <code>\applycontext</code>.
It must take a single argument, being the context.
<br><dt><code>property-operations</code> (list)<dd>Do these operations for instantiating
the context.
<br><dt><code>quoted-context-id</code> (string)<dd>The ID of the context to direct quotes to,
e.g., <code>cue</code>.
<br><dt><code>quoted-context-type</code> (symbol)<dd>The name of the context to
direct quotes to, e.g., <code>Voice</code>.
<br><dt><code>quoted-events</code> (vector)<dd>A vector of with <code>moment</code> and
<code>event-list</code> entries.
<br><dt><code>quoted-music-name</code> (string)<dd>The name of the voice to quote.
<br><dt><code>quoted-transposition</code> (pitch)<dd>The pitch used for the quote,
overriding <code>\transposition</code>.
<br><dt><code>quoted-voice-direction</code> (direction)<dd>Should the quoted voice be up-stem
or down-stem?
<br><dt><code>repeat-count</code> (integer)<dd>Do a <code>\repeat</code> how often?
<br><dt><code>span-direction</code> (direction)<dd>Does this start or stop a spanner?
<br><dt><code>span-type</code> (string)<dd>What kind of spanner should be created?
<p>TODO: Consider making type into symbol.
<br><dt><code>split-list</code> (list)<dd>Splitting moments for part combiner.
<br><dt><code>start-callback</code> (procedure)<dd>Function to compute the negative length
of starting grace notes. This property can only be defined as initializer
in <samp><span class="file">scm/define-music-types.scm</span></samp>.
<br><dt><code>string-number</code> (integer)<dd>The number of the string in
a <code>StringNumberEvent.</code>
<br><dt><code>symbol</code> (symbol)<dd>Grob name to perform an override or revert on.
<br><dt><code>tags</code> (list)<dd>List of symbols that for denoting extra details, e.g.,
<code>\tag #'part ...</code> could tag a piece of music as only being active
in a part.
<br><dt><code>tempo-unit</code> (duration)<dd>The unit for the metronome count.
<br><dt><code>text</code> (markup)<dd>Markup expression to be printed.
<br><dt><code>text-type</code> (symbol)<dd>Particular type of text script (e.g., finger, dynamic).
<br><dt><code>to-relative-callback</code> (procedure)<dd>How to transform a piece of music
to relative pitches.
<br><dt><code>tonic</code> (pitch)<dd>Base of the scale.
<br><dt><code>tremolo-type</code> (integer)<dd>Speed of tremolo, e.g., 16 for <code>c4:16</code>.
<br><dt><code>trill-pitch</code> (pitch)<dd>Pitch of other note of the trill.
<br><dt><code>tweaks</code> (list)<dd>An alist of properties to override in the backend
for the grob made of this event.
<br><dt><code>type</code> (symbol)<dd>The type of this music object.
Determines iteration in some cases.
<br><dt><code>types</code> (list)<dd>The types of this music object; determines by what
engraver this music expression is processed.
<br><dt><code>untransposable</code> (boolean)<dd>If set, this music is not transposed.
<br><dt><code>value</code> (any type)<dd>Assignment value for a translation property.
<br><dt><code>void</code> (boolean)<dd>If this property is <code>#t</code>, then the
music expression is to be discarded by the toplevel music handler.
<br><dt><code>what</code> (symbol)<dd>What to change for auto-change.
<p>FIXME: Naming.
</dl>
<!-- footer_tag --><br><hr>
<div class="node">
<p>
Previous: <a rel="previous" accesskey="p" href="Music-classes.es.html#Music-classes">Music classes</a>,
Up: <a rel="up" accesskey="u" href="Music-definitions.es.html#Music-definitions">Music definitions</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>
