<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!-- header_tag -->
<html lang="en">
<head>
<title>Graphic - GNU LilyPond Notation Reference</title>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<meta name="description" content="GNU LilyPond Notation Reference">
<meta name="generator" content="makeinfo 4.11">
<link title="Top" rel="start" href="index.html#Top">
<link rel="up" href="Text-markup-commands.html#Text-markup-commands" title="Text markup commands">
<link rel="prev" href="Align.html#Align" title="Align">
<link rel="next" href="Music.html#Music" title="Music">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">
<!--
Copyright (C) 1999--2007 by the authors
Permission is granted to copy, distribute and/or modify this
document under the terms of the GNU Free Documentation License,
Version 1.1 or any later version published by the Free Software
Foundation; with no Invariant Sections. A copy of the license is
included in the section entitled ``GNU Free Documentation
License''.
-->
<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="Graphic"></a>
Next: <a rel="next" accesskey="n" href="Music.html#Music">Music</a>,
Previous: <a rel="previous" accesskey="p" href="Align.html#Align">Align</a>,
Up: <a rel="up" accesskey="u" href="Text-markup-commands.html#Text-markup-commands">Text markup commands</a>
<hr>
</div>
<h4 class="appendixsubsec">B.8.3 Graphic</h4>
<dl>
<dt><code>\arrow-head</code> <var>axis</var> (integer) <var>direction</var> (direction) <var>filled</var> (boolean)<dd><a name="index-g_t_005carrow_002dhead-3075"></a><a name="index-g_t_005carrow_002dhead-3076"></a>
<p><a name="index-g_t_005carrow_002dhead-3077"></a>Produce an arrow head in specified direction and axis.
Use the filled head if <var>filled</var> is specified.
<blockquote>
<pre class="verbatim">
\markup {
\fontsize #5 {
\general-align #Y #DOWN {
\arrow-head #Y #UP ##t
\arrow-head #Y #DOWN ##f
\hspace #2
\arrow-head #X #RIGHT ##f
\arrow-head #X #LEFT ##f
}
}
}
</pre>
<p>
<a href="../be/lily-44ccbed0.ly">
<img align="middle"
border="0" src="../be/lily-44ccbed0.png" alt="[image of music]">
</a>
</p>
</blockquote>
<br><dt><code>\beam</code> <var>width</var> (number) <var>slope</var> (number) <var>thickness</var> (number)<dd><a name="index-g_t_005cbeam-3078"></a><a name="index-g_t_005cbeam-3079"></a>
<p><a name="index-g_t_005cbeam-3080"></a>
<a name="index-drawing-beams-within-text-3081"></a>
Create a beam with the specified parameters.
<blockquote>
<pre class="verbatim">
\markup {
\beam #5 #1 #2
}
</pre>
<p>
<a href="../a5/lily-582f2e54.ly">
<img align="middle"
border="0" src="../a5/lily-582f2e54.png" alt="[image of music]">
</a>
</p>
</blockquote>
<br><dt><code>\bracket</code> <var>arg</var> (markup)<dd><a name="index-g_t_005cbracket-3082"></a><a name="index-g_t_005cbracket-3083"></a>
<p><a name="index-g_t_005cbracket-3084"></a>
<a name="index-placing-vertical-brackets-around-text-3085"></a>
Draw vertical brackets around <var>arg</var>.
<blockquote>
<pre class="verbatim">
\markup {
\bracket {
\note #"2." #UP
}
}
</pre>
<p>
<a href="../49/lily-986d3d42.ly">
<img align="middle"
border="0" src="../49/lily-986d3d42.png" alt="[image of music]">
</a>
</p>
</blockquote>
<br><dt><code>\circle</code> <var>arg</var> (markup)<dd><a name="index-g_t_005ccircle-3086"></a><a name="index-g_t_005ccircle-3087"></a>
<p><a name="index-g_t_005ccircle-3088"></a>
<a name="index-circling-text-3089"></a>
Draw a circle around <var>arg</var>. Use <code>thickness</code>,
<code>circle-padding</code> and <code>font-size</code> properties to determine line
thickness and padding around the markup.
<blockquote>
<pre class="verbatim">
\markup {
\circle {
Hi
}
}
</pre>
<p>
<a href="../4e/lily-d760d079.ly">
<img align="middle"
border="0" src="../4e/lily-d760d079.png" alt="[image of music]">
</a>
</p>
</blockquote>
<p>Used properties:
<ul>
<li><code>circle-padding</code> (0.2)
<li><code>font-size</code> (0)
<li><code>thickness</code> (1)
</ul>
<br><dt><code>\draw-circle</code> <var>radius</var> (number) <var>thickness</var> (number) <var>fill</var> (boolean)<dd><a name="index-g_t_005cdraw_002dcircle-3090"></a><a name="index-g_t_005cdraw_002dcircle-3091"></a>
<p><a name="index-g_t_005cdraw_002dcircle-3092"></a>
<a name="index-drawing-circles-within-text-3093"></a>
A circle of radius <var>radius</var>, thickness <var>thickness</var> and
optionally filled.
<blockquote>
<pre class="verbatim">
\markup {
\draw-circle #2 #0.5 ##f
\hspace #2
\draw-circle #2 #0 ##t
}
</pre>
<p>
<a href="../97/lily-afbde510.ly">
<img align="middle"
border="0" src="../97/lily-afbde510.png" alt="[image of music]">
</a>
</p>
</blockquote>
<br><dt><code>\draw-line</code> <var>dest</var> (pair of numbers)<dd><a name="index-g_t_005cdraw_002dline-3094"></a><a name="index-g_t_005cdraw_002dline-3095"></a>
<p><a name="index-g_t_005cdraw_002dline-3096"></a>
<a name="index-drawing-lines-within-text-3097"></a>
A simple line.
<blockquote>
<pre class="verbatim">
\markup {
\draw-line #'(4 . 4)
\override #'(thickness . 5)
\draw-line #'(-3 . 0)
}
</pre>
<p>
<a href="../87/lily-1e028000.ly">
<img align="middle"
border="0" src="../87/lily-1e028000.png" alt="[image of music]">
</a>
</p>
</blockquote>
<p>Used properties:
<ul>
<li><code>thickness</code> (1)
</ul>
<br><dt><code>\epsfile</code> <var>axis</var> (number) <var>size</var> (number) <var>file-name</var> (string)<dd><a name="index-g_t_005cepsfile-3098"></a><a name="index-g_t_005cepsfile-3099"></a>
<p><a name="index-g_t_005cepsfile-3100"></a>
<a name="index-inlining-an-Encapsulated-PostScript-image-3101"></a>
Inline an EPS image. The image is scaled along <var>axis</var> to
<var>size</var>.
<blockquote>
<pre class="verbatim">
\markup {
\general-align #Y #DOWN {
\epsfile #X #20 #"context-example.eps"
\epsfile #Y #20 #"context-example.eps"
}
}
</pre>
<p>
<a href="../a2/lily-02235581.ly">
<img align="middle"
border="0" src="../a2/lily-02235581.png" alt="[image of music]">
</a>
</p>
</blockquote>
<br><dt><code>\filled-box</code> <var>xext</var> (pair of numbers) <var>yext</var> (pair of numbers) <var>blot</var> (number)<dd><a name="index-g_t_005cfilled_002dbox-3102"></a><a name="index-g_t_005cfilled_002dbox-3103"></a>
<p><a name="index-g_t_005cfilled_002dbox-3104"></a>
<a name="index-drawing-solid-boxes-within-text-3105"></a><a name="index-drawing-boxes-with-rounded-corners-3106"></a>
Draw a box with rounded corners of dimensions <var>xext</var> and
<var>yext</var>. For example,
<pre class="verbatim">
\filled-box #'(-.3 . 1.8) #'(-.3 . 1.8) #0
</pre>
creates a box extending horizontally from -0.3 to 1.8 and
vertically from -0.3 up to 1.8, with corners formed from a
circle of diameter 0 (i.e. sharp corners).
<blockquote>
<pre class="verbatim">
\markup {
\filled-box #'(0 . 4) #'(0 . 4) #0
\filled-box #'(0 . 2) #'(-4 . 2) #0.4
\filled-box #'(1 . 8) #'(0 . 7) #0.2
\with-color #white
\filled-box #'(-4.5 . -2.5) #'(3.5 . 5.5) #0.7
}
</pre>
<p>
<a href="../21/lily-188b1dd1.ly">
<img align="middle"
border="0" src="../21/lily-188b1dd1.png" alt="[image of music]">
</a>
</p>
</blockquote>
<br><dt><code>\hbracket</code> <var>arg</var> (markup)<dd><a name="index-g_t_005chbracket-3107"></a><a name="index-g_t_005chbracket-3108"></a>
<p><a name="index-g_t_005chbracket-3109"></a>
<a name="index-placing-horizontal-brackets-around-text-3110"></a>
Draw horizontal brackets around <var>arg</var>.
<blockquote>
<pre class="verbatim">
\markup {
\hbracket {
\line {
one two three
}
}
}
</pre>
<p>
<a href="../ba/lily-8ea71f61.ly">
<img align="middle"
border="0" src="../ba/lily-8ea71f61.png" alt="[image of music]">
</a>
</p>
</blockquote>
<br><dt><code>\postscript</code> <var>str</var> (string)<dd><a name="index-g_t_005cpostscript-3111"></a><a name="index-g_t_005cpostscript-3112"></a>
<p><a name="index-g_t_005cpostscript-3113"></a>
<a name="index-inserting-PostScript-directly-into-text-3114"></a>
This inserts <var>str</var> directly into the output as a PostScript
command string. Due to technicalities of the output backends,
different scales should be used for the TeX and PostScript backend,
selected with <code>-f</code>.
<p>For the TeX backend, the following string prints a rotated text
<pre class="example"> 0 0 moveto /ecrm10 findfont
1.75 scalefont setfont 90 rotate (hello) show
</pre>
<p class="noindent">The magical constant 1.75 scales from LilyPond units (staff spaces) to
TeX dimensions.
<p>For the postscript backend, use the following
<pre class="example"> gsave /ecrm10 findfont
10.0 output-scale div
scalefont setfont 90 rotate (hello) show grestore
</pre>
<blockquote>
<pre class="verbatim">
eyeglassesps = #"
0.15 setlinewidth
-0.9 0 translate
1.1 1.1 scale
1.2 0.7 moveto
0.7 0.7 0.5 0 361 arc
stroke
2.20 0.70 0.50 0 361 arc
stroke
1.45 0.85 0.30 0 180 arc
stroke
0.20 0.70 moveto
0.80 2.00 lineto
0.92 2.26 1.30 2.40 1.15 1.70 curveto
stroke
2.70 0.70 moveto
3.30 2.00 lineto
3.42 2.26 3.80 2.40 3.65 1.70 curveto
stroke"
eyeglasses = \markup {
\with-dimensions #'(0 . 4.4) #'(0 . 2.5)
\postscript #eyeglassesps
}
\relative c'' {
c2^\eyeglasses
a2_\eyeglasses
}
</pre>
<p>
<a href="../61/lily-978846dd.ly">
<img align="middle"
border="0" src="../61/lily-978846dd.png" alt="[image of music]">
</a>
</p>
</blockquote>
<br><dt><code>\rounded-box</code> <var>arg</var> (markup)<dd><a name="index-g_t_005crounded_002dbox-3115"></a><a name="index-g_t_005crounded_002dbox-3116"></a>
<p><a name="index-g_t_005crounded_002dbox-3117"></a><a name="index-enclosing-text-in-a-box-with-rounded-corners-3118"></a> <a name="index-drawing-boxes-with-rounded-corners-around-text-3119"></a>Draw a box with rounded corners around <var>arg</var>. Looks at <code>thickness</code>,
<code>box-padding</code> and <code>font-size</code> properties to determine line
thickness and padding around the markup; the <code>corner-radius</code> property
makes it possible to define another shape for the corners (default is 1).
<blockquote>
<pre class="verbatim">
c4^\markup {
\rounded-box {
Overtura
}
}
c,8. c16 c4 r
</pre>
<p>
<a href="../e8/lily-76b6593c.ly">
<img align="middle"
border="0" src="../e8/lily-76b6593c.png" alt="[image of music]">
</a>
</p>
</blockquote>
<p>Used properties:
<ul>
<li><code>box-padding</code> (0.5)
<li><code>font-size</code> (0)
<li><code>corner-radius</code> (1)
<li><code>thickness</code> (1)
</ul>
<br><dt><code>\triangle</code> <var>filled</var> (boolean)<dd><a name="index-g_t_005ctriangle-3120"></a><a name="index-g_t_005ctriangle-3121"></a>
<p><a name="index-g_t_005ctriangle-3122"></a>
<a name="index-drawing-triangles-within-text-3123"></a>
A triangle, either filled or empty.
<blockquote>
<pre class="verbatim">
\markup {
\triangle ##t
\hspace #2
\triangle ##f
}
</pre>
<p>
<a href="../21/lily-1fc1e946.ly">
<img align="middle"
border="0" src="../21/lily-1fc1e946.png" alt="[image of music]">
</a>
</p>
</blockquote>
<p>Used properties:
<ul>
<li><code>baseline-skip</code> (2)
<li><code>font-size</code> (0)
<li><code>thickness</code> (0.1)
</ul>
<br><dt><code>\with-url</code> <var>url</var> (string) <var>arg</var> (markup)<dd><a name="index-g_t_005cwith_002durl-3124"></a><a name="index-g_t_005cwith_002durl-3125"></a>
<p><a name="index-g_t_005cwith_002durl-3126"></a>
<a name="index-inserting-URL-links-into-text-3127"></a>
Add a link to URL <var>url</var> around <var>arg</var>. This only works in
the PDF backend.
<blockquote>
<pre class="verbatim">
\markup {
\with-url #"http://lilypond.org/web/" {
LilyPond ... \italic {
music notation for everyone
}
}
}
</pre>
<p>
<a href="../00/lily-54d0b859.ly">
<img align="middle"
border="0" src="../00/lily-54d0b859.png" alt="[image of music]">
</a>
</p>
</blockquote>
</dl>
<!-- footer_tag --><br><hr>
<div class="node">
<p>
Next: <a rel="next" accesskey="n" href="Music.html#Music">Music</a>,
Previous: <a rel="previous" accesskey="p" href="Align.html#Align">Align</a>,
Up: <a rel="up" accesskey="u" href="Text-markup-commands.html#Text-markup-commands">Text markup commands</a>
</div>
<div style="background-color: #e8ffe8; padding: 2; border: #c0ffc0 1px solid;">
<p>
<font size="-1">
This page is for LilyPond-2.11.57 (development-branch).
<br>
<address>
Report errors to <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>
Your <a href="http://lilypond.org/web/devel/participating/documentation-adding">suggestions for the documentation</a> are welcome.
</font>
</p>
</div>
<P>
Other languages: <a href="Graphic.fr.html">français</a>, <a href="Graphic.es.html">español</a>, <a href="Graphic.de.html">deutsch</a>.
<BR>
</P>
</BODY></html>
