<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en" dir="ltr">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<link rel="shortcut icon" href="/favicon.ico" type="image/x-icon" />
<title>attrs | Graphviz - Graph Visualization Software</title>
<link type="text/css" rel="stylesheet" media="all" href="/modules/node/node.css?W" />
<link type="text/css" rel="stylesheet" media="all" href="/modules/system/defaults.css?W" />
<link type="text/css" rel="stylesheet" media="all" href="/modules/system/system.css?W" />
<link type="text/css" rel="stylesheet" media="all" href="/modules/system/system-menus.css?W" />
<link type="text/css" rel="stylesheet" media="all" href="/modules/user/user.css?W" />
<link type="text/css" rel="stylesheet" media="all" href="/sites/all/modules/ckeditor/ckeditor.css?W" />
<link type="text/css" rel="stylesheet" media="all" href="/sites/all/modules/mollom/mollom.css?W" />
<link type="text/css" rel="stylesheet" media="all" href="/modules/forum/forum.css?W" />
<link type="text/css" rel="stylesheet" media="all" href="/sites/all/modules/views/css/views.css?W" />
<link type="text/css" rel="stylesheet" media="all" href="/themes/bluemarine/gv.css?W" />
<link type="text/css" rel="stylesheet" media="all" href="/themes/bluemarine/style.css?W" />
<script type="text/javascript" src="/misc/jquery.js?W"></script>
<script type="text/javascript" src="/misc/drupal.js?W"></script>
<script type="text/javascript" src="/sites/all/modules/mollom/mollom.js?W"></script>
<script type="text/javascript">
<!--//--><![CDATA[//><!--
jQuery.extend(Drupal.settings, { "basePath": "/" });
//--><!]]>
</script>
<script type="text/javascript"> </script>
</head>
<body>
<table border="0" cellpadding="0" cellspacing="0" id="header">
<tr>
<td id="logo">
<a href="/" title="Home"><img src="/app.png" alt="Home" /></a> <h1 class='site-name'><a href="/" title="Home">Graphviz - Graph Visualization Software</a></h1> <div class='site-slogan'>Drawing graphs since 1988</div> </td>
<td id="menu">
<ul class="links" id="navlist"><li class="menu-237 first"><a href="/Forum" title="">Forums</a></li>
<li class="menu-238"><a href="/wiki/" title="Graphviz Wiki">Wiki</a></li>
<li class="menu-210 last"><a href="/contact" title="Get in touch with us.">Contact Us</a></li>
</ul> <form action="/content/attrs" accept-charset="UTF-8" method="post" id="search-theme-form">
<div><div id="search" class="container-inline">
<div class="form-item" id="edit-search-theme-form-1-wrapper">
<label for="edit-search-theme-form-1">Search this site: </label>
<input type="text" maxlength="128" name="search_theme_form" id="edit-search-theme-form-1" size="15" value="" title="Enter the terms you wish to search for." class="form-text" />
</div>
<input type="submit" name="op" id="edit-submit-1" value="Search" class="form-submit" />
<input type="hidden" name="form_build_id" id="form-d2a43fc2cabeab68fb216dd79b7f8f7c" value="form-d2a43fc2cabeab68fb216dd79b7f8f7c" />
<input type="hidden" name="form_id" id="edit-search-theme-form" value="search_theme_form" />
</div>
</div></form>
</td>
</tr>
<tr>
<td colspan="2"><div></div></td>
</tr>
</table>
<table border="0" cellpadding="0" cellspacing="0" id="content">
<tr>
<td id="sidebar-left">
<div class="block block-menu" id="block-menu-menu-menu-user-navigation">
<h2 class="title"></h2>
<div class="content"><ul class="menu"><li class="leaf first"><a href="/Home.php" title="Home Page">Home</a></li>
<li class="leaf"><a href="/About.php" title="About">About</a></li>
<li class="leaf"><a href="/Download.php" title="Download">Download</a></li>
<li class="leaf"><a href="/News.php" title="News">News</a></li>
<li class="leaf"><a href="/Gallery.php" title="Gallery">Gallery</a></li>
<li class="leaf"><a href="/Documentation.php" title="Documentation">Documentation</a></li>
<li class="leaf"><a href="/Theory.php" title="Theory">Theory</a></li>
<li class="leaf"><a href="/content/graphviz-issue-tracker" title="Issue and Bug Tracking">Bug and Issue Tracking</a></li>
<li class="leaf"><a href="/MailingList.php" title="Mailing List">Mailing List</a></li>
<li class="leaf"><a href="/License.php" title="License">License</a></li>
<li class="leaf"><a href="/Resources.php" title="Resources">Resources</a></li>
<li class="leaf"><a href="/Credits.php" title="Credits">Credits</a></li>
<li class="collapsed"><a href="/Forum" title="Forum Link">Forums</a></li>
<li class="leaf"><a href="/content/faq" title="Frequently Asked Questions">FAQ</a></li>
<li class="leaf last"><a href="http://www.graphviz.org/wiki/wiki-main-page" title="Wiki home page">Wiki</a></li>
</ul></div>
</div>
<div class="block block-user" id="block-user-0">
<h2 class="title">User login</h2>
<div class="content"><form action="/content/attrs?destination=node%2F65" accept-charset="UTF-8" method="post" id="user-login-form">
<div><div class="form-item" id="edit-name-wrapper">
<label for="edit-name">Username: <span class="form-required" title="This field is required.">*</span></label>
<input type="text" maxlength="60" name="name" id="edit-name" size="15" value="" class="form-text required" />
</div>
<div class="form-item" id="edit-pass-wrapper">
<label for="edit-pass">Password: <span class="form-required" title="This field is required.">*</span></label>
<input type="password" name="pass" id="edit-pass" maxlength="60" size="15" class="form-text required" />
</div>
<input type="submit" name="op" id="edit-submit" value="Log in" class="form-submit" />
<div class="item-list"><ul><li class="first"><a href="/user/register" title="Create a new user account.">Create new account</a></li>
<li class="last"><a href="/user/password" title="Request new password via e-mail.">Request new password</a></li>
</ul></div><input type="hidden" name="form_build_id" id="form-d6bd9263a99684b3bb7a021c86520812" value="form-d6bd9263a99684b3bb7a021c86520812" />
<input type="hidden" name="form_id" id="edit-user-login-block" value="user_login_block" />
</div></form>
</div>
</div>
</td> <td valign="top">
<div id="main">
<div class="breadcrumb"><a href="/">Home</a></div> <h1 class="title">attrs</h1>
<div class="tabs"></div>
<div class="node">
<span class="submitted"></span>
<div class="taxonomy"></div>
<div class="content"><A NAME="top"></a>
<HR />
The table below describes the attributes used by various Graphviz tools.
The table gives the name of the attribute, the graph components (node,
edge, etc.) which use the attribute and the type of the attribute
(strings representing legal values of that type). Where applicable, the table
also gives a default value for the attribute, a minimum allowed setting
for numeric attributes, and certain restrictions on the use of the attribute.
<P>
Note that attribute names are case-sensitive.
This is usually true for attribute values as well, unless noted.
</p><P>
All Graphviz attributes are specified by name-value pairs. Thus, to
set the fillcolor of a node <TT>abc</tt>, one would use
<TABLE>
<TR><TD><TT>abc [fillcolor = red]</tt></td></tr>
</table>
Similarly, to set the arrowhead style of an edge <TT>abc -> def</tt>,
one would use
<TABLE>
<TR><TD><TT>abc -> def [arrowhead = diamond]</tt></td></tr>
</table>
Further details concerning the setting of attributes can be found
in the description of the
<A HREF=/content/dot-language>DOT language.</a>
</p><P>
At present, most device-independent units are either inches or
<A NAME="points"></a>
<A HREF="http://en.wikipedia.org/wiki/Point_(typography)">points</a>,
which we take as 72 points per inch.
</p><P>
<A NAME=h:undir_note><STRONG>Note:</strong></a> Some attributes, such as
<A HREF=#ddir>dir</a> or <A HREF=#darrowtail>arrowtail</a>, are
ambiguous when used in
<A HREF=/content/dot-language>DOT</a>
with an undirected graph since the head and tail of an edge are meaningless.
As a convention, the first time an undirected edge appears, the
<A HREF=/content/dot-language>DOT</a>
parser will assign the left node as the tail node and the right node as
the head. For example, the edge <TT>A -- B</tt> will have tail <TT>A</tt>
and head <TT>B</tt>. It is the user's responsibility to handle such
edges consistently. If the edge appears later, in the format
<TABLE>
<TR><TD><TT>B -- A [taillabel = "tail"]</tt></td></tr>
</table>
the drawing will attach the tail label to node <TT>A</tt>.
To avoid possible confusion when such attributes are required, the user
is encouraged to use a directed graph.
If it is important to make the graph appear undirected, this can be
done using the <A HREF=#ddir>dir</a>, <A HREF=#darrowtail>arrowtail</a>
or <A HREF=#darrowhead>arrowhead</a> attributes.
</p><P>
The tools accept standard C representations for <EM>int</em> and
<EM>double</em> types.
For the <A NAME=kbool><EM>bool</em></a> type, TRUE values are
represented by "true" or "yes" (case-insensitive)
and any non-zero integer, and FALSE values by "false" or "no" (case-insensitive)
and zero.
In addition, there are a variety of specialized types such as
<EM>arrowType</em>, <EM>color</em>,
<EM>point</em> and <EM>rankdir</em>. Legal values for these types are given
at the end.
</p><P>
In the <A NAME=h:uses><STRONG>Used By</strong></a> field, the
characters E, N, G, S and C
represent edges, nodes, the root graph, subgraphs
and cluster subgraphs, respectively.
This field indicates which graph component uses the attribute.
<HR ALIGN=CENTER WIDTH="70%" SIZE=3 />
<TABLE ALIGN=CENTER>
<TR><TH>Name</th><TH><A HREF=#h:uses>Used By</a></th><TH>Type</th><TH ALIGN=CENTER>Default</th><TH>Minimum</th><TH>Notes</th></tr>
<TR><TD><A NAME=aDamping HREF=#dDamping>Damping</a>
</td><TD>G</td><TD>double</td><TD ALIGN="CENTER">0.99</td><TD>0.0</td><TD>neato only</td> </tr>
<TR><TD><A NAME=aK HREF=#dK>K</a>
</td><TD>GC</td><TD>double</td><TD ALIGN="CENTER">0.3</td><TD>0</td><TD>sfdp, fdp only</td> </tr>
<TR><TD><A NAME=aURL HREF=#dURL>URL</a>
</td><TD>ENGC</td><TD><A HREF=#kescString>escString</a>
</td><TD ALIGN="CENTER"><none></td><TD></td><TD>svg, postscript, map only</td> </tr>
<TR><TD><A NAME=aarea HREF=#darea>area</a>
</td><TD>NC</td><TD>double</td><TD ALIGN="CENTER">1.0</td><TD>>0</td><TD>patchwork only</td> </tr>
<TR><TD><A NAME=aarrowhead HREF=#darrowhead>arrowhead</a>
</td><TD>E</td><TD><A HREF=#karrowType>arrowType</a>
</td><TD ALIGN="CENTER">normal</td><TD></td><TD></td> </tr>
<TR><TD><A NAME=aarrowsize HREF=#darrowsize>arrowsize</a>
</td><TD>E</td><TD>double</td><TD ALIGN="CENTER">1.0</td><TD>0.0</td><TD></td> </tr>
<TR><TD><A NAME=aarrowtail HREF=#darrowtail>arrowtail</a>
</td><TD>E</td><TD><A HREF=#karrowType>arrowType</a>
</td><TD ALIGN="CENTER">normal</td><TD></td><TD></td> </tr>
<TR><TD><A NAME=a:bb HREF=#dbb>bb</a>
</td><TD>G</td><TD><A HREF=#krect>rect</a>
</td><TD ALIGN="CENTER"></td><TD></td><TD>write only</td> </tr>
<TR><TD><A NAME=a:bgcolor HREF=#dbgcolor>bgcolor</a>
</td><TD>GC</td><TD><A HREF=#kcolor>color</a>
<BR /><A HREF=#kcolorList>colorList</a>
</td><TD ALIGN="CENTER"><none></td><TD></td><TD></td> </tr>
<TR><TD><A NAME=acenter HREF=#dcenter>center</a>
</td><TD>G</td><TD><A HREF=#kbool>bool</a>
</td><TD ALIGN="CENTER">false</td><TD></td><TD></td> </tr>
<TR><TD><A NAME=acharset HREF=#dcharset>charset</a>
</td><TD>G</td><TD>string</td><TD ALIGN="CENTER">"UTF-8"</td><TD></td><TD></td> </tr>
<TR><TD><A NAME=aclusterrank HREF=#dclusterrank>clusterrank</a>
</td><TD>G</td><TD><A HREF=#kclusterMode>clusterMode</a>
</td><TD ALIGN="CENTER">local</td><TD></td><TD>dot only</td> </tr>
<TR><TD><A NAME=acolor HREF=#dcolor>color</a>
</td><TD>ENC</td><TD><A HREF=#kcolor>color</a>
<BR /><A HREF=#kcolorList>colorList</a>
</td><TD ALIGN="CENTER">black</td><TD></td><TD></td> </tr>
<TR><TD><A NAME=acolorscheme HREF=#dcolorscheme>colorscheme</a>
</td><TD>ENCG</td><TD>string</td><TD ALIGN="CENTER">""</td><TD></td><TD></td> </tr>
<TR><TD><A NAME=acomment HREF=#dcomment>comment</a>
</td><TD>ENG</td><TD>string</td><TD ALIGN="CENTER">""</td><TD></td><TD></td> </tr>
<TR><TD><A NAME=acompound HREF=#dcompound>compound</a>
</td><TD>G</td><TD><A HREF=#kbool>bool</a>
</td><TD ALIGN="CENTER">false</td><TD></td><TD>dot only</td> </tr>
<TR><TD><A NAME=aconcentrate HREF=#dconcentrate>concentrate</a>
</td><TD>G</td><TD><A HREF=#kbool>bool</a>
</td><TD ALIGN="CENTER">false</td><TD></td><TD></td> </tr>
<TR><TD><A NAME=aconstraint HREF=#dconstraint>constraint</a>
</td><TD>E</td><TD><A HREF=#kbool>bool</a>
</td><TD ALIGN="CENTER">true</td><TD></td><TD>dot only</td> </tr>
<TR><TD><A NAME=adecorate HREF=#ddecorate>decorate</a>
</td><TD>E</td><TD><A HREF=#kbool>bool</a>
</td><TD ALIGN="CENTER">false</td><TD></td><TD></td> </tr>
<TR><TD><A NAME=adefaultdist HREF=#ddefaultdist>defaultdist</a>
</td><TD>G</td><TD>double</td><TD ALIGN="CENTER">1+(avg. len)*sqrt(|V|)</td><TD>epsilon</td><TD>neato only</td> </tr>
<TR><TD><A NAME=adim HREF=#ddim>dim</a>
</td><TD>G</td><TD>int</td><TD ALIGN="CENTER">2</td><TD>2</td><TD>sfdp, fdp, neato only</td> </tr>
<TR><TD><A NAME=adimen HREF=#ddimen>dimen</a>
</td><TD>G</td><TD>int</td><TD ALIGN="CENTER">2</td><TD>2</td><TD>sfdp, fdp, neato only</td> </tr>
<TR><TD><A NAME=adir HREF=#ddir>dir</a>
</td><TD>E</td><TD><A HREF=#kdirType>dirType</a>
</td><TD ALIGN="CENTER">forward(directed)<BR />none(undirected)</td><TD></td><TD></td> </tr>
<TR><TD><A NAME=adiredgeconstraints HREF=#ddiredgeconstraints>diredgeconstraints</a>
</td><TD>G</td><TD>string<BR /><A HREF=#kbool>bool</a>
</td><TD ALIGN="CENTER">false</td><TD></td><TD>neato only</td> </tr>
<TR><TD><A NAME=adistortion HREF=#ddistortion>distortion</a>
</td><TD>N</td><TD>double</td><TD ALIGN="CENTER">0.0</td><TD>-100.0</td><TD></td> </tr>
<TR><TD><A NAME=adpi HREF=#ddpi>dpi</a>
</td><TD>G</td><TD>double</td><TD ALIGN="CENTER">96.0<BR />0.0</td><TD></td><TD>svg, bitmap output only</td> </tr>
<TR><TD><A NAME=aedgeURL HREF=#d:edgeURL>edgeURL</a>
</td><TD>E</td><TD><A HREF=#kescString>escString</a>
</td><TD ALIGN="CENTER">""</td><TD></td><TD>svg, map only</td> </tr>
<TR><TD><A NAME=aedgehref HREF=#d:edgehref>edgehref</a>
</td><TD>E</td><TD><A HREF=#kescString>escString</a>
</td><TD ALIGN="CENTER">""</td><TD></td><TD>svg, map only</td> </tr>
<TR><TD><A NAME=aedgetarget HREF=#d:edgetarget>edgetarget</a>
</td><TD>E</td><TD><A HREF=#kescString>escString</a>
</td><TD ALIGN="CENTER"><none></td><TD></td><TD>svg, map only</td> </tr>
<TR><TD><A NAME=aedgetooltip HREF=#d:edgetooltip>edgetooltip</a>
</td><TD>E</td><TD><A HREF=#kescString>escString</a>
</td><TD ALIGN="CENTER">""</td><TD></td><TD>svg, cmap only</td> </tr>
<TR><TD><A NAME=aepsilon HREF=#d:epsilon>epsilon</a>
</td><TD>G</td><TD>double</td><TD ALIGN="CENTER">.0001 * # nodes(mode == KK)<BR />.0001(mode == major)</td><TD></td><TD>neato only</td> </tr>
<TR><TD><A NAME=aesep HREF=#d:esep>esep</a>
</td><TD>G</td><TD><A HREF=#kaddDouble>addDouble</a>
<BR /><A HREF=#kaddPoint>addPoint</a>
</td><TD ALIGN="CENTER">+3</td><TD></td><TD>not dot</td> </tr>
<TR><TD><A NAME=afillcolor HREF=#dfillcolor>fillcolor</a>
</td><TD>NEC</td><TD><A HREF=#kcolor>color</a>
<BR /><A HREF=#kcolorList>colorList</a>
</td><TD ALIGN="CENTER">lightgrey(nodes)<BR />black(clusters)</td><TD></td><TD></td> </tr>
<TR><TD><A NAME=afixedsize HREF=#dfixedsize>fixedsize</a>
</td><TD>N</td><TD><A HREF=#kbool>bool</a>
</td><TD ALIGN="CENTER">false</td><TD></td><TD></td> </tr>
<TR><TD><A NAME=afontcolor HREF=#dfontcolor>fontcolor</a>
</td><TD>ENGC</td><TD><A HREF=#kcolor>color</a>
</td><TD ALIGN="CENTER">black</td><TD></td><TD></td> </tr>
<TR><TD><A NAME=afontname HREF=#dfontname>fontname</a>
</td><TD>ENGC</td><TD>string</td><TD ALIGN="CENTER">"Times-Roman"</td><TD></td><TD></td> </tr>
<TR><TD><A NAME=afontnames HREF=#dfontnames>fontnames</a>
</td><TD>G</td><TD>string</td><TD ALIGN="CENTER">""</td><TD></td><TD>svg only</td> </tr>
<TR><TD><A NAME=afontpath HREF=#dfontpath>fontpath</a>
</td><TD>G</td><TD>string</td><TD ALIGN="CENTER">system-dependent</td><TD></td><TD></td> </tr>
<TR><TD><A NAME=afontsize HREF=#dfontsize>fontsize</a>
</td><TD>ENGC</td><TD>double</td><TD ALIGN="CENTER">14.0</td><TD>1.0</td><TD></td> </tr>
<TR><TD><A NAME=aforcelabels HREF=#dforcelabels>forcelabels</a>
</td><TD>G</td><TD><A HREF=#kbool>bool</a>
</td><TD ALIGN="CENTER">true</td><TD></td><TD></td> </tr>
<TR><TD><A NAME=agradientangle HREF=#dgradientangle>gradientangle</a>
</td><TD>NCG</td><TD>int</td><TD ALIGN="CENTER">""</td><TD></td><TD></td> </tr>
<TR><TD><A NAME=agroup HREF=#dgroup>group</a>
</td><TD>N</td><TD>string</td><TD ALIGN="CENTER">""</td><TD></td><TD>dot only</td> </tr>
<TR><TD><A NAME=aheadURL HREF=#dheadURL>headURL</a>
</td><TD>E</td><TD><A HREF=#kescString>escString</a>
</td><TD ALIGN="CENTER">""</td><TD></td><TD>svg, map only</td> </tr>
<TR><TD><A NAME=ahead_lp HREF=#dhead_lp>head_lp</a>
</td><TD>E</td><TD><A HREF=#kpoint>point</a>
</td><TD ALIGN="CENTER"></td><TD></td><TD>write only</td> </tr>
<TR><TD><A NAME=aheadclip HREF=#dheadclip>headclip</a>
</td><TD>E</td><TD><A HREF=#kbool>bool</a>
</td><TD ALIGN="CENTER">true</td><TD></td><TD></td> </tr>
<TR><TD><A NAME=aheadhref HREF=#dheadhref>headhref</a>
</td><TD>E</td><TD><A HREF=#kescString>escString</a>
</td><TD ALIGN="CENTER">""</td><TD></td><TD>svg, map only</td> </tr>
<TR><TD><A NAME=aheadlabel HREF=#dheadlabel>headlabel</a>
</td><TD>E</td><TD><A HREF=#klblString>lblString</a>
</td><TD ALIGN="CENTER">""</td><TD></td><TD></td> </tr>
<TR><TD><A NAME=aheadport HREF=#dheadport>headport</a>
</td><TD>E</td><TD><A HREF=#kportPos>portPos</a>
</td><TD ALIGN="CENTER">center</td><TD></td><TD></td> </tr>
<TR><TD><A NAME=aheadtarget HREF=#dheadtarget>headtarget</a>
</td><TD>E</td><TD><A HREF=#kescString>escString</a>
</td><TD ALIGN="CENTER"><none></td><TD></td><TD>svg, map only</td> </tr>
<TR><TD><A NAME=aheadtooltip HREF=#dheadtooltip>headtooltip</a>
</td><TD>E</td><TD><A HREF=#kescString>escString</a>
</td><TD ALIGN="CENTER">""</td><TD></td><TD>svg, cmap only</td> </tr>
<TR><TD><A NAME=aheight HREF=#dheight>height</a>
</td><TD>N</td><TD>double</td><TD ALIGN="CENTER">0.5</td><TD>0.02</td><TD></td> </tr>
<TR><TD><A NAME=ahref HREF=#dhref>href</a>
</td><TD>GCNE</td><TD><A HREF=#kescString>escString</a>
</td><TD ALIGN="CENTER">""</td><TD></td><TD>svg, postscript, map only</td> </tr>
<TR><TD><A NAME=aid HREF=#did>id</a>
</td><TD>GCNE</td><TD><A HREF=#kescString>escString</a>
</td><TD ALIGN="CENTER">""</td><TD></td><TD>svg, postscript, map only</td> </tr>
<TR><TD><A NAME=aimage HREF=#dimage>image</a>
</td><TD>N</td><TD>string</td><TD ALIGN="CENTER">""</td><TD></td><TD></td> </tr>
<TR><TD><A NAME=aimagepath HREF=#dimagepath>imagepath</a>
</td><TD>G</td><TD>string</td><TD ALIGN="CENTER">""</td><TD></td><TD></td> </tr>
<TR><TD><A NAME=aimagescale HREF=#dimagescale>imagescale</a>
</td><TD>N</td><TD><A HREF=#kbool>bool</a>
<BR />string</td><TD ALIGN="CENTER">false</td><TD></td><TD></td> </tr>
<TR><TD><A NAME=ainputscale HREF=#dinputscale>inputscale</a>
</td><TD>G</td><TD>double</td><TD ALIGN="CENTER"><none></td><TD></td><TD>fdp, neato only</td> </tr>
<TR><TD><A NAME=alabel HREF=#dlabel>label</a>
</td><TD>ENGC</td><TD><A HREF=#klblString>lblString</a>
</td><TD ALIGN="CENTER">"\N" (nodes)<BR />"" (otherwise)</td><TD></td><TD></td> </tr>
<TR><TD><A NAME=alabelURL HREF=#dlabelURL>labelURL</a>
</td><TD>E</td><TD><A HREF=#kescString>escString</a>
</td><TD ALIGN="CENTER">""</td><TD></td><TD>svg, map only</td> </tr>
<TR><TD><A NAME=alabel_scheme HREF=#dlabel_scheme>label_scheme</a>
</td><TD>G</td><TD>int</td><TD ALIGN="CENTER">0</td><TD>0</td><TD>sfdp only</td> </tr>
<TR><TD><A NAME=alabelangle HREF=#dlabelangle>labelangle</a>
</td><TD>E</td><TD>double</td><TD ALIGN="CENTER">-25.0</td><TD>-180.0</td><TD></td> </tr>
<TR><TD><A NAME=alabeldistance HREF=#dlabeldistance>labeldistance</a>
</td><TD>E</td><TD>double</td><TD ALIGN="CENTER">1.0</td><TD>0.0</td><TD></td> </tr>
<TR><TD><A NAME=alabelfloat HREF=#dlabelfloat>labelfloat</a>
</td><TD>E</td><TD><A HREF=#kbool>bool</a>
</td><TD ALIGN="CENTER">false</td><TD></td><TD></td> </tr>
<TR><TD><A NAME=alabelfontcolor HREF=#dlabelfontcolor>labelfontcolor</a>
</td><TD>E</td><TD><A HREF=#kcolor>color</a>
</td><TD ALIGN="CENTER">black</td><TD></td><TD></td> </tr>
<TR><TD><A NAME=alabelfontname HREF=#dlabelfontname>labelfontname</a>
</td><TD>E</td><TD>string</td><TD ALIGN="CENTER">"Times-Roman"</td><TD></td><TD></td> </tr>
<TR><TD><A NAME=alabelfontsize HREF=#dlabelfontsize>labelfontsize</a>
</td><TD>E</td><TD>double</td><TD ALIGN="CENTER">14.0</td><TD>1.0</td><TD></td> </tr>
<TR><TD><A NAME=alabelhref HREF=#dlabelhref>labelhref</a>
</td><TD>E</td><TD><A HREF=#kescString>escString</a>
</td><TD ALIGN="CENTER">""</td><TD></td><TD>svg, map only</td> </tr>
<TR><TD><A NAME=alabeljust HREF=#dlabeljust>labeljust</a>
</td><TD>GC</td><TD>string</td><TD ALIGN="CENTER">"c"</td><TD></td><TD></td> </tr>
<TR><TD><A NAME=alabelloc HREF=#dlabelloc>labelloc</a>
</td><TD>NGC</td><TD>string</td><TD ALIGN="CENTER">"t"(clusters)<BR />"b"(root graphs)<BR />"c"(nodes)</td><TD></td><TD></td> </tr>
<TR><TD><A NAME=alabeltarget HREF=#dlabeltarget>labeltarget</a>
</td><TD>E</td><TD><A HREF=#kescString>escString</a>
</td><TD ALIGN="CENTER"><none></td><TD></td><TD>svg, map only</td> </tr>
<TR><TD><A NAME=alabeltooltip HREF=#dlabeltooltip>labeltooltip</a>
</td><TD>E</td><TD><A HREF=#kescString>escString</a>
</td><TD ALIGN="CENTER">""</td><TD></td><TD>svg, cmap only</td> </tr>
<TR><TD><A NAME=alandscape HREF=#dlandscape>landscape</a>
</td><TD>G</td><TD><A HREF=#kbool>bool</a>
</td><TD ALIGN="CENTER">false</td><TD></td><TD></td> </tr>
<TR><TD><A NAME=alayer HREF=#dlayer>layer</a>
</td><TD>ENC</td><TD><A HREF=#klayerRange>layerRange</a>
</td><TD ALIGN="CENTER">""</td><TD></td><TD></td> </tr>
<TR><TD><A NAME=alayerlistsep HREF=#dlayerlistsep>layerlistsep</a>
</td><TD>G</td><TD>string</td><TD ALIGN="CENTER">","</td><TD></td><TD></td> </tr>
<TR><TD><A NAME=alayers HREF=#dlayers>layers</a>
</td><TD>G</td><TD><A HREF=#klayerList>layerList</a>
</td><TD ALIGN="CENTER">""</td><TD></td><TD></td> </tr>
<TR><TD><A NAME=alayerselect HREF=#dlayerselect>layerselect</a>
</td><TD>G</td><TD><A HREF=#klayerRange>layerRange</a>
</td><TD ALIGN="CENTER">""</td><TD></td><TD></td> </tr>
<TR><TD><A NAME=alayersep HREF=#dlayersep>layersep</a>
</td><TD>G</td><TD>string</td><TD ALIGN="CENTER">" :\t"</td><TD></td><TD></td> </tr>
<TR><TD><A NAME=alayout HREF=#dlayout>layout</a>
</td><TD>G</td><TD>string</td><TD ALIGN="CENTER">""</td><TD></td><TD></td> </tr>
<TR><TD><A NAME=alen HREF=#dlen>len</a>
</td><TD>E</td><TD>double</td><TD ALIGN="CENTER">1.0(neato)<BR />0.3(fdp)</td><TD></td><TD>fdp, neato only</td> </tr>
<TR><TD><A NAME=alevels HREF=#dlevels>levels</a>
</td><TD>G</td><TD>int</td><TD ALIGN="CENTER">MAXINT</td><TD>0.0</td><TD>sfdp only</td> </tr>
<TR><TD><A NAME=alevelsgap HREF=#dlevelsgap>levelsgap</a>
</td><TD>G</td><TD>double</td><TD ALIGN="CENTER">0.0</td><TD></td><TD>neato only</td> </tr>
<TR><TD><A NAME=alhead HREF=#dlhead>lhead</a>
</td><TD>E</td><TD>string</td><TD ALIGN="CENTER">""</td><TD></td><TD>dot only</td> </tr>
<TR><TD><A NAME=alheight HREF=#dlheight>lheight</a>
</td><TD>GC</td><TD>double</td><TD ALIGN="CENTER"></td><TD></td><TD>write only</td> </tr>
<TR><TD><A NAME=alp HREF=#dlp>lp</a>
</td><TD>EGC</td><TD><A HREF=#kpoint>point</a>
</td><TD ALIGN="CENTER"></td><TD></td><TD>write only</td> </tr>
<TR><TD><A NAME=altail HREF=#dltail>ltail</a>
</td><TD>E</td><TD>string</td><TD ALIGN="CENTER">""</td><TD></td><TD>dot only</td> </tr>
<TR><TD><A NAME=alwidth HREF=#dlwidth>lwidth</a>
</td><TD>GC</td><TD>double</td><TD ALIGN="CENTER"></td><TD></td><TD>write only</td> </tr>
<TR><TD><A NAME=amargin HREF=#dmargin>margin</a>
</td><TD>NCG</td><TD>double<BR /><A HREF=#kpoint>point</a>
</td><TD ALIGN="CENTER"><device-dependent></td><TD></td><TD></td> </tr>
<TR><TD><A NAME=amaxiter HREF=#dmaxiter>maxiter</a>
</td><TD>G</td><TD>int</td><TD ALIGN="CENTER">100 * # nodes(mode == KK)<BR />200(mode == major)<BR />600(fdp)</td><TD></td><TD>fdp, neato only</td> </tr>
<TR><TD><A NAME=amclimit HREF=#dmclimit>mclimit</a>
</td><TD>G</td><TD>double</td><TD ALIGN="CENTER">1.0</td><TD></td><TD>dot only</td> </tr>
<TR><TD><A NAME=amindist HREF=#dmindist>mindist</a>
</td><TD>G</td><TD>double</td><TD ALIGN="CENTER">1.0</td><TD>0.0</td><TD>circo only</td> </tr>
<TR><TD><A NAME=aminlen HREF=#dminlen>minlen</a>
</td><TD>E</td><TD>int</td><TD ALIGN="CENTER">1</td><TD>0</td><TD>dot only</td> </tr>
<TR><TD><A NAME=amode HREF=#dmode>mode</a>
</td><TD>G</td><TD>string</td><TD ALIGN="CENTER">major</td><TD></td><TD>neato only</td> </tr>
<TR><TD><A NAME=amodel HREF=#dmodel>model</a>
</td><TD>G</td><TD>string</td><TD ALIGN="CENTER">shortpath</td><TD></td><TD>neato only</td> </tr>
<TR><TD><A NAME=amosek HREF=#dmosek>mosek</a>
</td><TD>G</td><TD><A HREF=#kbool>bool</a>
</td><TD ALIGN="CENTER">false</td><TD></td><TD>neato only</td> </tr>
<TR><TD><A NAME=anodesep HREF=#dnodesep>nodesep</a>
</td><TD>G</td><TD>double</td><TD ALIGN="CENTER">0.25</td><TD>0.02</td><TD></td> </tr>
<TR><TD><A NAME=anojustify HREF=#dnojustify>nojustify</a>
</td><TD>GCNE</td><TD><A HREF=#kbool>bool</a>
</td><TD ALIGN="CENTER">false</td><TD></td><TD></td> </tr>
<TR><TD><A NAME=anormalize HREF=#dnormalize>normalize</a>
</td><TD>G</td><TD>double<BR /><A HREF=#kbool>bool</a>
</td><TD ALIGN="CENTER">false</td><TD></td><TD>not dot</td> </tr>
<TR><TD><A NAME=anslimit HREF=#dnslimit>nslimit</a>
<BR /><A NAME=anslimit1 HREF=#dnslimit1>nslimit1</a>
</td><TD>G</td><TD>double</td><TD ALIGN="CENTER"></td><TD></td><TD>dot only</td> </tr>
<TR><TD><A NAME=aordering HREF=#dordering>ordering</a>
</td><TD>GN</td><TD>string</td><TD ALIGN="CENTER">""</td><TD></td><TD>dot only</td> </tr>
<TR><TD><A NAME=aorientation HREF=#dorientation>orientation</a>
</td><TD>N</td><TD>double</td><TD ALIGN="CENTER">0.0</td><TD>360.0</td><TD></td> </tr>
<TR><TD><A NAME=aaorientation HREF=#ddorientation>orientation</a>
</td><TD>G</td><TD>string</td><TD ALIGN="CENTER">""</td><TD></td><TD></td> </tr>
<TR><TD><A NAME=aoutputorder HREF=#doutputorder>outputorder</a>
</td><TD>G</td><TD><A HREF=#koutputMode>outputMode</a>
</td><TD ALIGN="CENTER">breadthfirst</td><TD></td><TD></td> </tr>
<TR><TD><A NAME=aoverlap HREF=#doverlap>overlap</a>
</td><TD>G</td><TD>string<BR /><A HREF=#kbool>bool</a>
</td><TD ALIGN="CENTER">true</td><TD></td><TD>not dot</td> </tr>
<TR><TD><A NAME=aoverlap_scaling HREF=#doverlap_scaling>overlap_scaling</a>
</td><TD>G</td><TD>double</td><TD ALIGN="CENTER">-4</td><TD>-1.0e10</td><TD>prism only</td> </tr>
<TR><TD><A NAME=aoverlap_shrink HREF=#doverlap_shrink>overlap_shrink</a>
</td><TD>G</td><TD><A HREF=#kbool>bool</a>
</td><TD ALIGN="CENTER">true</td><TD></td><TD>prism only</td> </tr>
<TR><TD><A NAME=apack HREF=#dpack>pack</a>
</td><TD>G</td><TD><A HREF=#kbool>bool</a>
<BR />int</td><TD ALIGN="CENTER">false</td><TD></td><TD>not dot</td> </tr>
<TR><TD><A NAME=apackmode HREF=#dpackmode>packmode</a>
</td><TD>G</td><TD><A HREF=#kpackMode>packMode</a>
</td><TD ALIGN="CENTER">node</td><TD></td><TD>not dot</td> </tr>
<TR><TD><A NAME=apad HREF=#dpad>pad</a>
</td><TD>G</td><TD>double<BR /><A HREF=#kpoint>point</a>
</td><TD ALIGN="CENTER">0.0555 (4 points)</td><TD></td><TD></td> </tr>
<TR><TD><A NAME=apage HREF=#dpage>page</a>
</td><TD>G</td><TD>double<BR /><A HREF=#kpoint>point</a>
</td><TD ALIGN="CENTER"></td><TD></td><TD></td> </tr>
<TR><TD><A NAME=apagedir HREF=#dpagedir>pagedir</a>
</td><TD>G</td><TD><A HREF=#kpagedir>pagedir</a>
</td><TD ALIGN="CENTER">BL</td><TD></td><TD></td> </tr>
<TR><TD><A NAME=apencolor HREF=#dpencolor>pencolor</a>
</td><TD>C</td><TD><A HREF=#kcolor>color</a>
</td><TD ALIGN="CENTER">black</td><TD></td><TD></td> </tr>
<TR><TD><A NAME=apenwidth HREF=#dpenwidth>penwidth</a>
</td><TD>CNE</td><TD>double</td><TD ALIGN="CENTER">1.0</td><TD>0.0</td><TD></td> </tr>
<TR><TD><A NAME=aperipheries HREF=#dperipheries>peripheries</a>
</td><TD>NC</td><TD>int</td><TD ALIGN="CENTER">shape default(nodes)<BR />1(clusters)</td><TD>0</td><TD></td> </tr>
<TR><TD><A NAME=apin HREF=#dpin>pin</a>
</td><TD>N</td><TD><A HREF=#kbool>bool</a>
</td><TD ALIGN="CENTER">false</td><TD></td><TD>fdp, neato only</td> </tr>
<TR><TD><A NAME=apos HREF=#dpos>pos</a>
</td><TD>EN</td><TD><A HREF=#kpoint>point</a>
<BR /><A HREF=#ksplineType>splineType</a>
</td><TD ALIGN="CENTER"></td><TD></td><TD></td> </tr>
<TR><TD><A NAME=aquadtree HREF=#dquadtree>quadtree</a>
</td><TD>G</td><TD><A HREF=#kquadType>quadType</a>
<BR /><A HREF=#kbool>bool</a>
</td><TD ALIGN="CENTER">normal</td><TD></td><TD>sfdp only</td> </tr>
<TR><TD><A NAME=aquantum HREF=#dquantum>quantum</a>
</td><TD>G</td><TD>double</td><TD ALIGN="CENTER">0.0</td><TD>0.0</td><TD></td> </tr>
<TR><TD><A NAME=arank HREF=#drank>rank</a>
</td><TD>S</td><TD><A HREF=#krankType>rankType</a>
</td><TD ALIGN="CENTER"></td><TD></td><TD>dot only</td> </tr>
<TR><TD><A NAME=arankdir HREF=#drankdir>rankdir</a>
</td><TD>G</td><TD><A HREF=#krankdir>rankdir</a>
</td><TD ALIGN="CENTER">TB</td><TD></td><TD>dot only</td> </tr>
<TR><TD><A NAME=aranksep HREF=#dranksep>ranksep</a>
</td><TD>G</td><TD>double<BR /><A HREF=#kdoubleList>doubleList</a>
</td><TD ALIGN="CENTER">0.5(dot)<BR />1.0(twopi)</td><TD>0.02</td><TD>twopi, dot only</td> </tr>
<TR><TD><A NAME=aratio HREF=#dratio>ratio</a>
</td><TD>G</td><TD>double<BR />string</td><TD ALIGN="CENTER"></td><TD></td><TD></td> </tr>
<TR><TD><A NAME=arects HREF=#drects>rects</a>
</td><TD>N</td><TD><A HREF=#krect>rect</a>
</td><TD ALIGN="CENTER"></td><TD></td><TD>write only</td> </tr>
<TR><TD><A NAME=aregular HREF=#dregular>regular</a>
</td><TD>N</td><TD><A HREF=#kbool>bool</a>
</td><TD ALIGN="CENTER">false</td><TD></td><TD></td> </tr>
<TR><TD><A NAME=aremincross HREF=#dremincross>remincross</a>
</td><TD>G</td><TD><A HREF=#kbool>bool</a>
</td><TD ALIGN="CENTER">false</td><TD></td><TD>dot only</td> </tr>
<TR><TD><A NAME=arepulsiveforce HREF=#drepulsiveforce>repulsiveforce</a>
</td><TD>G</td><TD>double</td><TD ALIGN="CENTER">1.0</td><TD>0.0</td><TD>sfdp only</td> </tr>
<TR><TD><A NAME=aresolution HREF=#dresolution>resolution</a>
</td><TD>G</td><TD>double</td><TD ALIGN="CENTER">96.0<BR />0.0</td><TD></td><TD>svg, bitmap output only</td> </tr>
<TR><TD><A NAME=aroot HREF=#droot>root</a>
</td><TD>GN</td><TD>string<BR /><A HREF=#kbool>bool</a>
</td><TD ALIGN="CENTER"><none>(graphs)<BR />false(nodes)</td><TD></td><TD>circo, twopi only</td> </tr>
<TR><TD><A NAME=arotate HREF=#drotate>rotate</a>
</td><TD>G</td><TD>int</td><TD ALIGN="CENTER">0</td><TD></td><TD></td> </tr>
<TR><TD><A NAME=arotation HREF=#drotation>rotation</a>
</td><TD>G</td><TD>double</td><TD ALIGN="CENTER">0</td><TD></td><TD>sfdp only</td> </tr>
<TR><TD><A NAME=asamehead HREF=#dsamehead>samehead</a>
</td><TD>E</td><TD>string</td><TD ALIGN="CENTER">""</td><TD></td><TD>dot only</td> </tr>
<TR><TD><A NAME=asametail HREF=#dsametail>sametail</a>
</td><TD>E</td><TD>string</td><TD ALIGN="CENTER">""</td><TD></td><TD>dot only</td> </tr>
<TR><TD><A NAME=asamplepoints HREF=#dsamplepoints>samplepoints</a>
</td><TD>N</td><TD>int</td><TD ALIGN="CENTER">8(output)<BR />20(overlap and image maps)</td><TD></td><TD></td> </tr>
<TR><TD><A NAME=ascale HREF=#dscale>scale</a>
</td><TD>G</td><TD>double<BR /><A HREF=#kpoint>point</a>
</td><TD ALIGN="CENTER"></td><TD></td><TD>twopi only</td> </tr>
<TR><TD><A NAME=asearchsize HREF=#dsearchsize>searchsize</a>
</td><TD>G</td><TD>int</td><TD ALIGN="CENTER">30</td><TD></td><TD>dot only</td> </tr>
<TR><TD><A NAME=asep HREF=#dsep>sep</a>
</td><TD>G</td><TD><A HREF=#kaddDouble>addDouble</a>
<BR /><A HREF=#kaddPoint>addPoint</a>
</td><TD ALIGN="CENTER">+4</td><TD></td><TD>not dot</td> </tr>
<TR><TD><A NAME=ashape HREF=#dshape>shape</a>
</td><TD>N</td><TD><A HREF=#kshape>shape</a>
</td><TD ALIGN="CENTER">ellipse</td><TD></td><TD></td> </tr>
<TR><TD><A NAME=ashapefile HREF=#dshapefile>shapefile</a>
</td><TD>N</td><TD>string</td><TD ALIGN="CENTER">""</td><TD></td><TD></td> </tr>
<TR><TD><A NAME=ashowboxes HREF=#dshowboxes>showboxes</a>
</td><TD>ENG</td><TD>int</td><TD ALIGN="CENTER">0</td><TD>0</td><TD>dot only</td> </tr>
<TR><TD><A NAME=asides HREF=#dsides>sides</a>
</td><TD>N</td><TD>int</td><TD ALIGN="CENTER">4</td><TD>0</td><TD></td> </tr>
<TR><TD><A NAME=asize HREF=#dsize>size</a>
</td><TD>G</td><TD>double<BR /><A HREF=#kpoint>point</a>
</td><TD ALIGN="CENTER"></td><TD></td><TD></td> </tr>
<TR><TD><A NAME=askew HREF=#dskew>skew</a>
</td><TD>N</td><TD>double</td><TD ALIGN="CENTER">0.0</td><TD>-100.0</td><TD></td> </tr>
<TR><TD><A NAME=asmoothing HREF=#dsmoothing>smoothing</a>
</td><TD>G</td><TD><A HREF=#ksmoothType>smoothType</a>
</td><TD ALIGN="CENTER">"none"</td><TD></td><TD>sfdp only</td> </tr>
<TR><TD><A NAME=asortv HREF=#dsortv>sortv</a>
</td><TD>GCN</td><TD>int</td><TD ALIGN="CENTER">0</td><TD>0</td><TD></td> </tr>
<TR><TD><A NAME=asplines HREF=#dsplines>splines</a>
</td><TD>G</td><TD><A HREF=#kbool>bool</a>
<BR />string</td><TD ALIGN="CENTER"></td><TD></td><TD></td> </tr>
<TR><TD><A NAME=astart HREF=#dstart>start</a>
</td><TD>G</td><TD><A HREF=#kstartType>startType</a>
</td><TD ALIGN="CENTER">""</td><TD></td><TD>fdp, neato only</td> </tr>
<TR><TD><A NAME=astyle HREF=#dstyle>style</a>
</td><TD>ENCG</td><TD><A HREF=#kstyle>style</a>
</td><TD ALIGN="CENTER">""</td><TD></td><TD></td> </tr>
<TR><TD><A NAME=astylesheet HREF=#dstylesheet>stylesheet</a>
</td><TD>G</td><TD>string</td><TD ALIGN="CENTER">""</td><TD></td><TD>svg only</td> </tr>
<TR><TD><A NAME=atailURL HREF=#dtailURL>tailURL</a>
</td><TD>E</td><TD><A HREF=#kescString>escString</a>
</td><TD ALIGN="CENTER">""</td><TD></td><TD>svg, map only</td> </tr>
<TR><TD><A NAME=atail_lp HREF=#dtail_lp>tail_lp</a>
</td><TD>E</td><TD><A HREF=#kpoint>point</a>
</td><TD ALIGN="CENTER"></td><TD></td><TD>write only</td> </tr>
<TR><TD><A NAME=atailclip HREF=#dtailclip>tailclip</a>
</td><TD>E</td><TD><A HREF=#kbool>bool</a>
</td><TD ALIGN="CENTER">true</td><TD></td><TD></td> </tr>
<TR><TD><A NAME=atailhref HREF=#dtailhref>tailhref</a>
</td><TD>E</td><TD><A HREF=#kescString>escString</a>
</td><TD ALIGN="CENTER">""</td><TD></td><TD>svg, map only</td> </tr>
<TR><TD><A NAME=ataillabel HREF=#dtaillabel>taillabel</a>
</td><TD>E</td><TD><A HREF=#klblString>lblString</a>
</td><TD ALIGN="CENTER">""</td><TD></td><TD></td> </tr>
<TR><TD><A NAME=atailport HREF=#dtailport>tailport</a>
</td><TD>E</td><TD><A HREF=#kportPos>portPos</a>
</td><TD ALIGN="CENTER">center</td><TD></td><TD></td> </tr>
<TR><TD><A NAME=atailtarget HREF=#dtailtarget>tailtarget</a>
</td><TD>E</td><TD><A HREF=#kescString>escString</a>
</td><TD ALIGN="CENTER"><none></td><TD></td><TD>svg, map only</td> </tr>
<TR><TD><A NAME=atailtooltip HREF=#dtailtooltip>tailtooltip</a>
</td><TD>E</td><TD><A HREF=#kescString>escString</a>
</td><TD ALIGN="CENTER">""</td><TD></td><TD>svg, cmap only</td> </tr>
<TR><TD><A NAME=atarget HREF=#dtarget>target</a>
</td><TD>ENGC</td><TD><A HREF=#kescString>escString</a>
<BR />string</td><TD ALIGN="CENTER"><none></td><TD></td><TD>svg, map only</td> </tr>
<TR><TD><A NAME=atooltip HREF=#dtooltip>tooltip</a>
</td><TD>NEC</td><TD><A HREF=#kescString>escString</a>
</td><TD ALIGN="CENTER">""</td><TD></td><TD>svg, cmap only</td> </tr>
<TR><TD><A NAME=atruecolor HREF=#dtruecolor>truecolor</a>
</td><TD>G</td><TD><A HREF=#kbool>bool</a>
</td><TD ALIGN="CENTER"></td><TD></td><TD>bitmap output only</td> </tr>
<TR><TD><A NAME=avertices HREF=#dvertices>vertices</a>
</td><TD>N</td><TD><A HREF=#kpointList>pointList</a>
</td><TD ALIGN="CENTER"></td><TD></td><TD>write only</td> </tr>
<TR><TD><A NAME=aviewport HREF=#dviewport>viewport</a>
</td><TD>G</td><TD><A HREF=#kviewPort>viewPort</a>
</td><TD ALIGN="CENTER">""</td><TD></td><TD></td> </tr>
<TR><TD><A NAME=avoro_margin HREF=#dvoro_margin>voro_margin</a>
</td><TD>G</td><TD>double</td><TD ALIGN="CENTER">0.05</td><TD>0.0</td><TD>not dot</td> </tr>
<TR><TD><A NAME=aweight HREF=#dweight>weight</a>
</td><TD>E</td><TD>int<BR />double</td><TD ALIGN="CENTER">1</td><TD>0(dot)<BR />1(neato,fdp)</td><TD></td> </tr>
<TR><TD><A NAME=awidth HREF=#dwidth>width</a>
</td><TD>N</td><TD>double</td><TD ALIGN="CENTER">0.75</td><TD>0.01</td><TD></td> </tr>
<TR><TD><A NAME=axdotversion HREF=#dxdotversion>xdotversion</a>
</td><TD>G</td><TD>string</td><TD ALIGN="CENTER"></td><TD></td><TD>xdot only</td> </tr>
<TR><TD><A NAME=axlabel HREF=#dxlabel>xlabel</a>
</td><TD>EN</td><TD><A HREF=#klblString>lblString</a>
</td><TD ALIGN="CENTER">""</td><TD></td><TD></td> </tr>
<TR><TD><A NAME=axlp HREF=#dxlp>xlp</a>
</td><TD>NE</td><TD><A HREF=#kpoint>point</a>
</td><TD ALIGN="CENTER"></td><TD></td><TD>write only</td> </tr>
<TR><TD><A NAME=az HREF=#dz>z</a>
</td><TD>N</td><TD>double</td><TD ALIGN="CENTER">0.0</td><TD>-MAXFLOAT<BR />-1000</td><TD></td> </tr>
</table>
<HR />
<H1>Attribute Descriptions</h1>
<DL>
<DT><A NAME=dDamping HREF=#aDamping><STRONG>Damping</strong></a>
<DD> Factor damping force motions. On each iteration, a nodes movement
is limited to this factor of its potential motion. By being less than
1.0, the system tends to ``cool'', thereby preventing cycling.
<DT><A NAME=dK HREF=#aK><STRONG>K</strong></a>
<DD> Spring constant used in virtual physical model. It roughly corresponds
to an ideal edge length (in inches), in that increasing K tends to
increase the distance between nodes.
Note that the edge attribute <A HREF=#dlen>len</a> can be used to
override this value for adjacent nodes.
<DT><A NAME=dURL HREF=#aURL><STRONG>URL</strong></a>
<DD> Hyperlinks incorporated into device-dependent output.
At present, used in ps2, cmap, i*map and svg formats.
For all these formats, URLs can be attached to nodes, edges and
clusters. URL attributes can also be attached to the root graph in ps2,
cmap and i*map formats. This serves as the base URL for relative URLs in the
former, and as the default image map file in the latter.
<P>
For svg, cmapx and imap output, the active area for a node is its
visible image.
For example, an unfilled
node with no drawn boundary will only be active on its label.
For other output, the active area is its bounding box.
The active area for a cluster is its bounding box.
For edges, the active areas are small circles where the edge contacts its head
and tail nodes. In addition, for svg, cmapx and imap, the active area
includes a thin polygon approximating the edge. The circles may
overlap the related node, and the edge URL dominates.
If the edge has a label, this will also be active.
Finally, if the edge has a head or tail label, this will also be active.
</p><P>
Note that, for edges, the attributes <A HREF=#dheadURL>headURL</a>,
<A HREF=#dtailURL>tailURL</a>, <A HREF=#dlabelURL>labelURL</a> and
<A HREF=#d:edgeURL>edgeURL</a> allow control of various parts of an
edge.
Also note that, if active areas of two edges overlap, it is unspecified
which area dominates.
<DT><A NAME=darea HREF=#aarea><STRONG>area</strong></a>
<DD> Indicates the preferred area for a node or empty cluster when laid out by patchwork.
<DT><A NAME=darrowhead HREF=#aarrowhead><STRONG>arrowhead</strong></a>
<DD> Style of arrowhead on the head node of an edge.
This will only appear if the <A HREF=#ddir>dir</a> attribute
is "forward" or "both".
See the <A HREF=#h:undir_note>limitation</a>.
<DT><A NAME=darrowsize HREF=#aarrowsize><STRONG>arrowsize</strong></a>
<DD> Multiplicative scale factor for arrowheads.
<DT><A NAME=darrowtail HREF=#aarrowtail><STRONG>arrowtail</strong></a>
<DD> Style of arrowhead on the tail node of an edge.
This will only appear if the <A HREF=#ddir>dir</a> attribute
is "back" or "both".
See the <A HREF=#h:undir_note>limitation</a>.
<DT><A NAME=dbb HREF=#a:bb><STRONG>bb</strong></a>
<DD> Bounding box of drawing in points.
<DT><A NAME=dbgcolor HREF=#a:bgcolor><STRONG>bgcolor</strong></a>
<DD> When attached to the root graph, this color is used as the background for
entire canvas. When a cluster attribute, it is used as the initial
background for the cluster. If a cluster has a filled
<A HREF=#dstyle>style</a>, the
cluster's <A HREF=#dfillcolor>fillcolor</a> will overlay the
background color.
<P>
If the value is a <A HREF=#kcolorList>colorList</a>, a gradient fill is
used. By default, this is a linear fill; setting <TT>style=radial</tt> will
cause a radial fill. At present, only two colors are used. If the second
color (after a colon) is missing, the default color is used for it.
See also the <A HREF=#dgradientangle>gradientangle</a> attribute
for setting the gradient angle.
</p><P>
If no background color is specified for the root graph, no graphics
operation are performed on the background. This works fine for
PostScript but for bitmap output, all bits are initialized to something.
This means that when the bitmap output is included in some other
document, all of the bits within the bitmap's bounding box will be
set, overwriting whatever color or graphics where already on the page.
If this effect is not desired, and you only want to set bits explicitly
assigned in drawing the graph, set <B>bgcolor</b>="transparent".
<DT><A NAME=dcenter HREF=#acenter><STRONG>center</strong></a>
<DD> If true, the drawing is centered in the output canvas.
<DT><A NAME=dcharset HREF=#acharset><STRONG>charset</strong></a>
<DD> Specifies the character encoding used when interpreting string input
as a text label. The default value is <TT>"UTF-8"</tt>.
The other legal value is <TT>"iso-8859-1"</tt> or,
equivalently,
<TT>"Latin1"</tt>. The <B>charset</b> attribute is case-insensitive.
Note that if the character encoding used in the input does not
match the <B>charset</b> value, the resulting output may be very strange.
<DT><A NAME=dclusterrank HREF=#aclusterrank><STRONG>clusterrank</strong></a>
<DD> Mode used for handling clusters. If <B>clusterrank</b> is "local", a
subgraph whose name begins with "cluster" is given special treatment.
The subgraph is laid out separately, and then integrated as a unit into
its parent graph, with a bounding rectangle drawn about it.
If the cluster has a <A HREF=#dlabel>label</a> parameter, this label
is displayed within the rectangle.
Note also that there can be clusters within clusters.
At present, the modes "global" and "none"
appear to be identical, both turning off the special cluster processing.
<DT><A NAME=dcolor HREF=#acolor><STRONG>color</strong></a>
<DD> Basic drawing color for graphics, not text. For the latter, use the
<A HREF=#dfontcolor>fontcolor</a> attribute.
<P>
For edges, the value
can either be a single color or a <A HREF=#kcolorList>colorList</a>.
In the latter case, if colorList has no fractions,
the edge is drawn using parallel splines or lines,
one for each color in the list, in the order given.
The head arrow, if any, is drawn using the first color in the list,
and the tail arrow, if any, the second color. This supports the common
case of drawing opposing edges, but using parallel splines instead of
separately routed multiedges.
If any fraction is used, the colors are drawn in series, with each color
being given roughly its specified fraction of the edge.
For example, the graph
<PRE>
digraph G {
a -> b [dir=both color="red:blue"]
c -> d [dir=none color="green:red;0.25:blue"]
}
</pre>
yields<BR />
<IMG SRC="/doc/info/colorlist.gif" />
<DT><A NAME=dcolorscheme HREF=#acolorscheme><STRONG>colorscheme</strong></a>
<DD> This attribute specifies a color scheme namespace. If defined, it specifies
the context for interpreting color names. In particular, if a
<A HREF=#kcolor>color</a> value has form <TT>"xxx"</tt> or <TT>"//xxx"</tt>,
then the
color <TT>xxx</tt> will be evaluated according to the current color scheme.
If no color scheme is set, the standard X11 naming is used.
For example, if <TT>colorscheme=bugn9</tt>, then <TT>color=7</tt>
is interpreted as <TT>"/bugn9/7"</tt>.
<DT><A NAME=dcomment HREF=#acomment><STRONG>comment</strong></a>
<DD> Comments are inserted into output. Device-dependent
<DT><A NAME=dcompound HREF=#acompound><STRONG>compound</strong></a>
<DD> If true, allow edges between clusters. (See <A HREF=#dlhead>lhead</a>
and <A HREF=#dltail>ltail</a> below.)
<DT><A NAME=dconcentrate HREF=#aconcentrate><STRONG>concentrate</strong></a>
<DD> If true, use edge concentrators.
This merges multiedges into a single edge and causes partially parallel
edges to share part of their paths. The latter feature is not yet available
outside of dot.
<DT><A NAME=dconstraint HREF=#aconstraint><STRONG>constraint</strong></a>
<DD> If false, the edge is not used in ranking the nodes. For example,
in the graph
<PRE>
digraph G {
a -> c;
a -> b;
b -> c [constraint=false];
}
</pre>
the edge <CODE>b -> c</code> does not add a constraint during rank
assignment, so the only constraints are that a be above b and c,
yielding the graph:<BR />
<IMG SRC="/doc/info/constraint.gif" />
<DT><A NAME=ddecorate HREF=#adecorate><STRONG>decorate</strong></a>
<DD> If true, attach edge label to edge by a 2-segment
polyline, underlining the label, then going to the closest point of spline.
<DT><A NAME=ddefaultdist HREF=#adefaultdist><STRONG>defaultdist</strong></a>
<DD> This specifies the distance between nodes in separate connected
components. If set too small, connected components may overlap.
Only applicable if <A HREF=#dpack>pack</a>=false.
<DT><A NAME=ddim HREF=#adim><STRONG>dim</strong></a>
<DD> Set the number of dimensions used for the layout. The maximum value
allowed is 10.
<DT><A NAME=ddimen HREF=#adimen><STRONG>dimen</strong></a>
<DD> Set the number of dimensions used for rendering.
The maximum value allowed is 10.
If both <TT>dimen</tt> and <TT>dim</tt> are set, the latter specifies
the dimension used for layout, and the former for rendering.
If only <TT>dimen</tt> is set, this is used for both layout and rendering
dimensions.
<P>
Note that, at present, all aspects of rendering are 2D. This includes
the shape and size of nodes, overlap removal, and edge routing. Thus,
for <TT>dimen > 2</tt>, the only valid information is the <TT>pos</tt>
attribute of the nodes.
All other coordinates will be 2D and, at best, will reflect a projection
of a higher-dimensional point onto the plane.
<DT><A NAME=ddir HREF=#adir><STRONG>dir</strong></a>
<DD> Set edge type for drawing arrowheads. This indicates which ends of the
edge should be decorated with an arrowhead. The actual style of the
arrowhead can be specified using the <A HREF=#darrowhead>arrowhead</a>
and <A HREF=#darrowtail>arrowtail</a> attributes.
See <A HREF=#h:undir_note>limitation</a>.
<DT><A NAME=ddiredgeconstraints HREF=#adiredgeconstraints><STRONG>diredgeconstraints</strong></a>
<DD> Only valid when <A HREF=#dmode>mode</a>="ipsep".
If true, constraints are generated for each edge in the largest (heuristic)
directed acyclic subgraph such that the edge must point downwards.
If "hier", generates level constraints similar to those used with
<A HREF=#dmode>mode</a>="hier". The main difference is that, in the latter
case, only these constraints are involved, so a faster solver can be used.
<DT><A NAME=ddistortion HREF=#adistortion><STRONG>distortion</strong></a>
<DD> Distortion factor for <A HREF=#dshape><B>shape</b></a>=polygon.
Positive values cause top part to
be larger than bottom; negative values do the opposite.
<DT><A NAME=ddpi HREF=#adpi><STRONG>dpi</strong></a>
<DD> This specifies the expected number of pixels per inch on a display device.
For bitmap output, this guarantees that text rendering will be
done more accurately, both in size and in placement. For SVG output,
it is used to guarantee that the dimensions in the output correspond to
the correct number of points or inches.
<DT><A NAME=d:edgeURL HREF=#aedgeURL><STRONG>edgeURL</strong></a>
<DD> If <B>edgeURL</b> is defined, this is the link used for the non-label
parts of an edge. This value overrides any <A HREF=#dURL>URL</a>
defined for the edge.
Also, this value is used near the head or tail node unless overridden
by a <A HREF=#dheadURL>headURL</a> or <A HREF=#dtailURL>tailURL</a> value,
respectively.
See <A HREF=#h:undir_note>limitation</a>.
<DT><A NAME=d:edgehref HREF=#aedgehref><STRONG>edgehref</strong></a>
<DD> Synonym for <A HREF=#d:edgeURL>edgeURL</a>.
<DT><A NAME=d:edgetarget HREF=#aedgetarget><STRONG>edgetarget</strong></a>
<DD> If the edge has a <A HREF=#dURL>URL</a> or <A HREF=#d:edgeURL>edgeURL</a>
attribute, this attribute determines which window of the
browser is used
for the URL attached to the non-label part of the edge.
Setting it to "_graphviz" will open a new window if it
doesn't already exist, or reuse it if it does.
If undefined, the value of the <A HREF=#dtarget>target</a> is used.
<DT><A NAME=d:edgetooltip HREF=#aedgetooltip><STRONG>edgetooltip</strong></a>
<DD> Tooltip annotation attached to the non-label part of an edge.
This is used only if the edge has a <A HREF=#dURL>URL</a>
or <A HREF=#d:edgeURL>edgeURL</a> attribute.
<DT><A NAME=d:epsilon HREF=#aepsilon><STRONG>epsilon</strong></a>
<DD> Terminating condition. If the length squared of all energy gradients are
< <B>epsilon</b>, the algorithm stops.
<DT><A NAME=d:esep HREF=#aesep><STRONG>esep</strong></a>
<DD> Margin used around polygons for purposes of spline edge routing.
The interpretation is the same as given for <A HREF=#dsep>sep</a>.
This should normally be strictly less than <A HREF=#dsep>sep</a>.
<DT><A NAME=dfillcolor HREF=#afillcolor><STRONG>fillcolor</strong></a>
<DD> Color used to fill the background of a node or cluster
assuming <A HREF=#dstyle>style</a>=filled, or a filled arrowhead.
If <B>fillcolor</b> is not defined, <A HREF=#dcolor>color</a> is
used. (For clusters, if <B>color</b> is not defined,
<A HREF=#dbgcolor>bgcolor</a> is used.) If this is not defined,
the default is used, except for
<A HREF=#dshape><B>shape</b></a>=point or when the output
format is MIF,
which use black by default.
<P>
If the value is a <A HREF=#kcolorList>colorList</a>, a gradient fill is
used. By default, this is a linear fill; setting <TT>style=radial</tt> will
cause a radial fill. At present, only two colors are used. If the second
color (after a colon) is missing, the default color is used for it.
See also the <A HREF=#dgradientangle>gradientangle</a> attribute
for setting the gradient angle.
</p><P>
Note that a cluster inherits the root graph's attributes if defined.
Thus, if the root graph has defined a <B>fillcolor</b>, this will override a
<B>color</b> or <B>bgcolor</b> attribute set for the cluster.
<DT><A NAME=dfixedsize HREF=#afixedsize><STRONG>fixedsize</strong></a>
<DD> If true, the node size is specified by the values of the
<A HREF=#dwidth><B>width</b></a>
and <A HREF=#dheight><B>height</b></a> attributes only
and is not expanded to contain the text label.
<DT><A NAME=dfontcolor HREF=#afontcolor><STRONG>fontcolor</strong></a>
<DD> Color used for text.
<DT><A NAME=dfontname HREF=#afontname><STRONG>fontname</strong></a>
<DD> Font used for text. This very much depends on the output format and, for
non-bitmap output such as PostScript or SVG, the availability of the font
when the graph is displayed or printed. As such, it is best to rely on
font faces that are generally available, such as Times-Roman, Helvetica or
Courier.
<P>
How font names are resolved also depends on the underlying library that handles
font name resolution.
If Graphviz was built using the
<A HREF=http://pdx.freedesktop.org/~fontconfig/fontconfig-user.html>fontconfig library</a>,
the latter library will be used to search for the font.
See the commands <B>fc-list</b>, <B>fc-match</b> and the other fontconfig commands for how
names are resolved and which fonts are available.
Other systems may provide their own font package, such as Quartz for OS X.
</p><P>
Note that various font attributes, such as weight and slant, can be built into the
font name. Thus, using the <TT>fontname=times:italic</tt> will produce a slanted
Times font from fontconfig, while <TT>fontname=times-bold</tt> will resolve to a bold
Times using Quartz. Obviously, the syntax differs from system to system.
You will need
to ascertain which package is used by your Graphviz system and refer to the relevant
documentation.
</p><P>
If Graphviz is not built with a high-level font library, <TT>fontname</tt> will be
considered the name of a Type 1 or True Type font file.
If you specify <TT>fontname=schlbk</tt>, the tool will look for a
file named <TT>schlbk.ttf</tt> or <TT>schlbk.pfa</tt> or <TT>schlbk.pfb</tt>
in one of the directories specified by
the <A HREF=#dfontpath>fontpath</a> attribute.
The lookup does support various aliases for the common fonts.
<DT><A NAME=dfontnames HREF=#afontnames><STRONG>fontnames</strong></a>
<DD> Allows user control of how basic fontnames are represented in SVG output.
If <TT>fontnames</tt> is undefined or <TT>"svg"</tt>,
the output will try to use known SVG fontnames. For example, the
default font <TT>"Times-Roman"</tt> will be mapped to the
basic SVG font <TT>"serif"</tt>. This can be overridden by setting
<TT>fontnames</tt> to <TT>"ps"</tt> or <TT>"gd"</tt>.
In the former case, known PostScript font names such as
<TT>"Times-Roman"</tt> will be used in the output.
In the latter case, the fontconfig font conventions
are used. Thus, <TT>"Times-Roman"</tt> would be treated as
<TT>"Nimbus Roman No9 L"</tt>. These last two options are useful
with SVG viewers that support these richer fontname spaces.
<DT><A NAME=dfontpath HREF=#afontpath><STRONG>fontpath</strong></a>
<DD> Directory list used by libgd to search for bitmap fonts if Graphviz
was not built with the fontconfig library.
If <B>fontpath</b> is not set, the environment
variable <TT>DOTFONTPATH</tt> is checked.
If that is not set, <TT>GDFONTPATH</tt> is checked.
If not set, libgd uses its compiled-in font path.
Note that fontpath is an attribute of the root graph.
<DT><A NAME=dfontsize HREF=#afontsize><STRONG>fontsize</strong></a>
<DD> Font size, <A HREF=#points>in points</a>, used for text.
<DT><A NAME=dforcelabels HREF=#aforcelabels><STRONG>forcelabels</strong></a>
<DD> If true, all <A HREF=#dxlabel><B>xlabel</b></a> attributes are placed, even if there is some overlap with nodes
or other labels.
<DT><A NAME=dgradientangle HREF=#agradientangle><STRONG>gradientangle</strong></a>
<DD> If a gradient fill is being used, this determines the angle of the fill. For linear fills, the colors transform
along a line specified by the angle and the center of the object. For radial fills, a value of zero causes the
colors to transform radially from the center; for non-zero values, the colors transform from a point near the
object's periphery as specified by the value.
<P>
If unset, the default angle is 0.
<DT><A NAME=dgroup HREF=#agroup><STRONG>group</strong></a>
<DD> If the end points of an edge belong to the same group, i.e., have the
same group attribute, parameters are set to avoid crossings and keep
the edges straight.
<DT><A NAME=dheadURL HREF=#aheadURL><STRONG>headURL</strong></a>
<DD> If <B>headURL</b> is defined, it is
output as part of the head label of the edge.
Also, this value is used near the head node, overriding any
<A HREF=#dURL>URL</a> value.
See <A HREF=#h:undir_note>limitation</a>.
<DT><A NAME=dhead_lp HREF=#ahead_lp><STRONG>head_lp</strong></a>
<DD> Position of an edge's head label, <A HREF=#points>in points</a>.
The position indicates the center of the label.
<DT><A NAME=dheadclip HREF=#aheadclip><STRONG>headclip</strong></a>
<DD> If true, the head of an edge is clipped to the boundary of the head node;
otherwise, the end of the edge goes to the center of the node, or the
center of a port, if applicable.
<DT><A NAME=dheadhref HREF=#aheadhref><STRONG>headhref</strong></a>
<DD> Synonym for <A HREF=#dheadURL>headURL</a>.
<DT><A NAME=dheadlabel HREF=#aheadlabel><STRONG>headlabel</strong></a>
<DD> Text label to be placed near head of edge.
See <A HREF=#h:undir_note>limitation</a>.
<DT><A NAME=dheadport HREF=#aheadport><STRONG>headport</strong></a>
<DD> Indicates where on the head node to attach the head of the edge.
In the default case, the edge is aimed towards the center of the node,
and then clipped at the node boundary.
See <A HREF=#h:undir_note>limitation</a>.
<DT><A NAME=dheadtarget HREF=#aheadtarget><STRONG>headtarget</strong></a>
<DD> If the edge has a <A HREF=#dheadURL>headURL</a>,
this attribute determines which window of the
browser is used
for the URL. Setting it to "_graphviz" will open a new window if it
doesn't already exist, or reuse it if it does.
If undefined, the value of the <A HREF=#dtarget>target</a> is used.
<DT><A NAME=dheadtooltip HREF=#aheadtooltip><STRONG>headtooltip</strong></a>
<DD> Tooltip annotation attached to the head of an edge. This is used only
if the edge has a <A HREF=#dheadURL>headURL</a> attribute.
<DT><A NAME=dheight HREF=#aheight><STRONG>height</strong></a>
<DD> Height of node, in inches. This is taken as the initial, minimum height
of the node. If <A HREF=#dfixedsize><B>fixedsize</b></a> is true, this
will be the final height of the node. Otherwise, if the node label
requires more height to fit, the node's height will be increased to
contain the label. Note also that, if the output format is dot, the
value given to <B>height</b> will be the final value.
<P>
If the node shape is regular, the width and height are made identical.
In this case, if either the width or the height is set explicitly,
that value is used.
In this case, if both the width or the height are set explicitly,
the maximum of the two values is used.
If neither is set explicitly, the minimum of the two default values
is used.
<DT><A NAME=dhref HREF=#ahref><STRONG>href</strong></a>
<DD> Synonym for <A HREF=#dURL>URL</a>.
<DT><A NAME=did HREF=#aid><STRONG>id</strong></a>
<DD> Allows the graph author to provide an id for graph objects which is to be included in the output.
Normal "\N", "\E", "\G" substitutions are applied.
If provided, it is the responsiblity of the provider to keep
its values sufficiently unique for its intended downstream use.
Note, in particular, that "\E" does not provide a unique id for multi-edges.
If no id attribute is provided, then a unique internal id is used. However,
this value is unpredictable by the graph writer.
An externally provided id is not used internally.
<P>
If the graph provides an id attribute, this will be used as a prefix for
internally generated attributes. By making these distinct, the user
can include multiple image maps in the same document.
<DT><A NAME=dimage HREF=#aimage><STRONG>image</strong></a>
<DD> Gives the name of a file containing an image to be displayed inside
a node. The image file must be in one of the recognized
<A HREF=output-formats#dimage_fmts>formats</a>,
typically JPEG, PNG, GIF, BMP, SVG or Postscript, and be able to be converted
into the desired output format.
<P>
The file must contain the image size information. This is usually trivially
true for the bitmap formats. For PostScript, the file must contain a
line starting with <TT>%%BoundingBox: </tt> followed by four integers
specifying the lower left x and y coordinates and the upper right x and y
coordinates of the bounding box for the image, the coordinates being in
points. An SVG image file must contain <TT>width</tt> and <TT>height</tt>
attributes, typically as part of the <TT>svg</tt> element.
The values for these should have the form of a floating point number,
followed by optional units, e.g., <TT>width="76pt"</tt>.
Recognized units are <TT>in</tt>, <TT>px</tt>,
<TT>pc</tt>, <TT>pt</tt>, <TT>cm</tt> and <TT>mm</tt> for inches, pixels,
picas, points, centimeters and millimeters, respectively.
The default unit is points.
</p><P>
Unlike with the <A HREF=#dshapefile>shapefile</a> attribute,
the image is treated as node
content rather than the entire node. In particular, an image can
be contained in a node of any shape, not just a rectangle.
<DT><A NAME=dimagepath HREF=#aimagepath><STRONG>imagepath</strong></a>
<DD> Specifies a list of directories in which to look for image files as specified by the
<a href="#dimage">image</a> attribute or using the <TT>IMG</tt> element in
<a href="node-shapes#html">HTML-like labels</a>.
The string should be a list of (absolute or relative) pathnames, each separated by
a semicolon (for Windows) or a colon (all other OS).
The first directory in which a file of the given name is found will be used to
load the image. If <tt>imagepath</tt> is not set, relative pathnames for the image
file will be interpreted with respect to the current working directory.
<DT><A NAME=dimagescale HREF=#aimagescale><STRONG>imagescale</strong></a>
<DD> Attribute controlling how an image fills its
containing node. In general, the image is given its natural size,
(cf. <A HREF=#ddpi>dpi</a>),
and the node size is made large enough to contain its image, its
label, its margin, and its peripheries.
Its width and height will also be at least as large as its
minimum <A HREF=#dwidth>width</a> and <A HREF=#dheight>height</a>.
If, however, <TT>fixedsize=true</tt>,
the width and height attributes specify the exact size of the node.
<P>
During rendering, in the default case (<TT>imagescale=false</tt>),
the image retains its natural size.
If <TT>imagescale=true</tt>,
the image is uniformly scaled (i.e., its aspect ratio is
preserved) to fit inside the node.
At least one dimension of the image will be as large as possible
given the size of the node.
When <TT>imagescale=width</tt>,
the width of the image is scaled to fill the node width.
The corresponding property holds when <TT>imagescale=height</tt>.
When <TT>imagescale=both</tt>,
both the height and the width are scaled separately to fill the node.
</p><P>
In all cases, if a dimension of the image is larger than the
corresponding dimension of the node, that dimension of the
image is scaled down to fit the node. As with the case of
expansion, if <TT>imagescale=true</tt>, width and height are
scaled uniformly.
<DT><A NAME=dinputscale HREF=#ainputscale><STRONG>inputscale</strong></a>
<DD> For layout algorithms that support initial input positions (specified by the <A HREF=#dpos><B>pos</b></a> attribute),
this attribute can be used to appropriately scale the values. By default, fdp and neato interpret
the x and y values of pos as being in inches. (<B>NOTE</b>: neato -n(2) treats the coordinates as
being in points, being the unit used by the layout algorithms for the pos attribute.) Thus, if
the graph has pos attributes in points, one should set <TT>inputscale=72</tt>.
This can also be set on the command line using the <A HREF=command-line-invocation#minusK><TT>-s</tt> flag</a> flag.
<P>
If not set, no scaling is done and the units on input are treated as inches.
A value of 0 is equivalent to <TT>inputscale=72</tt>.
<DT><A NAME=dlabel HREF=#alabel><STRONG>label</strong></a>
<DD> Text label attached to objects.
If a node's <A HREF=#dshape>shape</a> is record, then the label can
have a <A HREF=node-shapes#record>special format</a>
which describes the record layout.
<DT><A NAME=dlabelURL HREF=#alabelURL><STRONG>labelURL</strong></a>
<DD> If <B>labelURL</b> is defined, this is the link used for the label
of an edge. This value overrides any <A HREF=#dURL>URL</a>
defined for the edge.
<DT><A NAME=dlabel_scheme HREF=#alabel_scheme><STRONG>label_scheme</strong></a>
<DD> The value indicates
whether to treat a node whose name has the form |edgelabel|* as a special node representing an edge label.
The default (0) produces no effect.
If the attribute is set to 1, sfdp uses a penalty-based method to make that kind of node close to the
center of its neighbor. With a value of 2, sfdp uses a penalty-based method to make that kind of node
close to the old center of its neighbor. Finally, a value of 3 invokes a two-step process of overlap
removal and straightening.
<DT><A NAME=dlabelangle HREF=#alabelangle><STRONG>labelangle</strong></a>
<DD> This, along with <A HREF=#dlabeldistance>labeldistance</a>, determine
where the
headlabel (taillabel) are placed with respect to the head (tail)
in polar coordinates. The origin in the coordinate system is
the point where the edge touches the node. The ray of 0 degrees
goes from the origin back along the edge, parallel to the edge
at the origin.
<P>
The angle, in degrees, specifies the rotation from the 0 degree ray,
with positive angles moving counterclockwise and negative angles
moving clockwise.
<DT><A NAME=dlabeldistance HREF=#alabeldistance><STRONG>labeldistance</strong></a>
<DD> Multiplicative scaling factor adjusting the distance that
the headlabel(taillabel) is from the head(tail) node.
The default distance is 10 points. See <A HREF=#dlabelangle>labelangle</a>
for more details.
<DT><A NAME=dlabelfloat HREF=#alabelfloat><STRONG>labelfloat</strong></a>
<DD> If true, allows edge labels to be less constrained in position.
In particular, it may appear on top of other edges.
<DT><A NAME=dlabelfontcolor HREF=#alabelfontcolor><STRONG>labelfontcolor</strong></a>
<DD> Color used for headlabel and taillabel.
If not set, defaults to edge's fontcolor.
<DT><A NAME=dlabelfontname HREF=#alabelfontname><STRONG>labelfontname</strong></a>
<DD> Font used for headlabel and taillabel.
If not set, defaults to edge's fontname.
<DT><A NAME=dlabelfontsize HREF=#alabelfontsize><STRONG>labelfontsize</strong></a>
<DD> Font size, <A HREF=#points>in points</a>, used for headlabel and taillabel.
If not set, defaults to edge's fontsize.
<DT><A NAME=dlabelhref HREF=#alabelhref><STRONG>labelhref</strong></a>
<DD> Synonym for <A HREF=#dlabelURL>labelURL</a>.
<DT><A NAME=dlabeljust HREF=#alabeljust><STRONG>labeljust</strong></a>
<DD> Justification for cluster labels. If "r", the label
is right-justified within bounding rectangle; if "l", left-justified;
else the label is centered.
Note that a subgraph inherits attributes from its parent. Thus, if
the root graph sets <B>labeljust</b> to "l", the subgraph inherits
this value.
<DT><A NAME=dlabelloc HREF=#alabelloc><STRONG>labelloc</strong></a>
<DD> Vertical placement of labels for nodes, root graphs and clusters.
<P>
For graphs and clusters, only "t" and "b" are allowed, corresponding
to placement at the top and bottom, respectively.
By default, root
graph labels go on the bottom and cluster labels go on the top.
Note that a subgraph inherits attributes from its parent. Thus, if
the root graph sets <B>labelloc</b> to "b", the subgraph inherits
this value.
</p><P>
For nodes, this attribute is used only when the height of the node
is larger than the height of its label.
If <TT>labelloc</tt> is set to "t", "c", or "b", the label is aligned
with the top, centered, or aligned with the bottom of the node, respectively.
In the default case, the label is vertically centered.
<DT><A NAME=dlabeltarget HREF=#alabeltarget><STRONG>labeltarget</strong></a>
<DD> If the edge has a <A HREF=#dURL>URL</a> or <A HREF=#dlabelURL>labelURL</a>
attribute, this attribute determines which window of the
browser is used
for the URL attached to the label.
Setting it to "_graphviz" will open a new window if it
doesn't already exist, or reuse it if it does.
If undefined, the value of the <A HREF=#dtarget>target</a> is used.
<DT><A NAME=dlabeltooltip HREF=#alabeltooltip><STRONG>labeltooltip</strong></a>
<DD> Tooltip annotation attached to label of an edge.
This is used only if the edge has a <A HREF=#dURL>URL</a>
or <A HREF=#dlabelURL>labelURL</a> attribute.
<DT><A NAME=dlandscape HREF=#alandscape><STRONG>landscape</strong></a>
<DD> If true, the graph is rendered in landscape mode. Synonymous with
<A HREF=#drotate><TT>rotate=90</tt></a> or
<A HREF=#dorientation><TT>orientation=landscape</tt></a>.
<DT><A NAME=dlayer HREF=#alayer><STRONG>layer</strong></a>
<DD> Specifies layers in which the node, edge or cluster is present.
<DT><A NAME=dlayerlistsep HREF=#alayerlistsep><STRONG>layerlistsep</strong></a>
<DD> Specifies the separator characters used to split
an attribute of type <A HREF=#klayerRange>layerRange</a> into a list of ranges.
<DT><A NAME=dlayers HREF=#alayers><STRONG>layers</strong></a>
<DD> Specifies a linearly ordered list of layer names attached to the graph
The graph is then output in separate layers. Only those components
belonging to the current output layer appear. For more information,
see the page <A HREF="http://www.graphviz.org/wiki/how-use-drawing-layers-overlays">How to use drawing layers (overlays)</a>.
<DT><A NAME=dlayerselect HREF=#alayerselect><STRONG>layerselect</strong></a>
<DD> Selects a list of layers to be emitted.
<DT><A NAME=dlayersep HREF=#alayersep><STRONG>layersep</strong></a>
<DD> Specifies the separator characters used to split the
<A HREF=#dlayers>layers</a> attribute into a list of layer names.
<DT><A NAME=dlayout HREF=#alayout><STRONG>layout</strong></a>
<DD> Specifies the name of the layout algorithm to use, such as "dot"
or "neato". Normally, graphs should be kept independent of a type of
layout. In some cases, however, it can be convenient to embed the type
of layout desired within the graph. For example, a graph containing
position information from a layout might want to record what the
associated layout algorithm was.
<P>
This attribute takes precedence over
the <A HREF=command-line-invocation#minusK>-K flag</a>
or the actual command name used.
<DT><A NAME=dlen HREF=#alen><STRONG>len</strong></a>
<DD> Preferred edge length, in inches.
<DT><A NAME=dlevels HREF=#alevels><STRONG>levels</strong></a>
<DD> Number of levels allowed in the multilevel scheme.
<DT><A NAME=dlevelsgap HREF=#alevelsgap><STRONG>levelsgap</strong></a>
<DD> Specifies strictness of level constraints in neato
when <TT><A HREF=#dmode>mode</a>="ipsep" or "hier"</tt>.
Larger positive values mean stricter constraints, which demand more
separation between levels. On the other hand, negative values will relax
the constraints by allowing some overlap between the levels.
<DT><A NAME=dlhead HREF=#alhead><STRONG>lhead</strong></a>
<DD> Logical head of an edge. When <A HREF=#dcompound><B>compound</b></a> is true,
if <B>lhead</b> is defined and is the name of a cluster containing
the real head,
the edge is clipped to the boundary of the cluster.
See <A HREF=#h:undir_note>limitation</a>.
<DT><A NAME=dlheight HREF=#alheight><STRONG>lheight</strong></a>
<DD> Height of graph or cluster label, in inches.
<DT><A NAME=dlp HREF=#alp><STRONG>lp</strong></a>
<DD> Label position, <A HREF=#points>in points</a>.
The position indicates the center of the label.
<DT><A NAME=dltail HREF=#altail><STRONG>ltail</strong></a>
<DD> Logical tail of an edge. When <A HREF=#dcompound><B>compound</b></a> is true,
if <B>ltail</b> is defined and is the name of a cluster
containing the real tail,
the edge is clipped to the boundary of the cluster.
See <A HREF=#h:undir_note>limitation</a>.
<DT><A NAME=dlwidth HREF=#alwidth><STRONG>lwidth</strong></a>
<DD> Width of graph or cluster label, in inches.
<DT><A NAME=dmargin HREF=#amargin><STRONG>margin</strong></a>
<DD> For graphs, this sets x and y margins of canvas, in inches. If the margin
is a single double, both margins are set equal to the given value.
<P>
Note that the margin is not part of the drawing but just empty space
left around the drawing. It basically corresponds to a translation of
drawing, as would be necessary to center a drawing on a page. Nothing
is actually drawn in the margin. To actually extend the background of
a drawing, see the <A HREF=#dpad>pad</a> attribute.
</p><P>
For clusters, this specifies the space between the nodes in the cluster and
the cluster bounding box. By default, this is 8 points.
</p><P>
For nodes, this attribute specifies space left around the node's label.
By default, the value is <TT>0.11,0.055</tt>.
<DT><A NAME=dmaxiter HREF=#amaxiter><STRONG>maxiter</strong></a>
<DD> Sets the number of iterations used.
<DT><A NAME=dmclimit HREF=#amclimit><STRONG>mclimit</strong></a>
<DD> Multiplicative scale factor used to alter the MinQuit (default = 8)
and MaxIter (default = 24) parameters used during crossing
minimization. These correspond to the
number of tries without improvement before quitting and the
maximum number of iterations in each pass.
<DT><A NAME=dmindist HREF=#amindist><STRONG>mindist</strong></a>
<DD> Specifies the minimum separation between all nodes.
<DT><A NAME=dminlen HREF=#aminlen><STRONG>minlen</strong></a>
<DD> Minimum edge length (rank difference between head and tail).
<DT><A NAME=dmode HREF=#amode><STRONG>mode</strong></a>
<DD> Technique for optimizing the layout. For neato, if <B>mode</b> is <TT>"major"</tt>,
neato uses stress majorization. If <B>mode</b> is <TT>"KK"</tt>,
neato uses a version of the gradient descent method. The only advantage
to the latter technique is that it is sometimes appreciably faster for
small (number of nodes < 100) graphs. A significant disadvantage is that
it may cycle.
<P>
There are two experimental modes in neato, "hier", which adds a top-down
directionality similar to the layout used in dot, and "ipsep", which
allows the graph to specify minimum vertical and horizontal distances
between nodes. (See the <A HREF=#dsep>sep</a> attribute.)
</p><P>
For sfdp, the default <B>mode</b> is <TT>"spring"</tt>, which corresponds to using
a spring-electrical model. Setting <B>mode</b> to <TT>"maxent"</tt> causes a similar
model to be run but one that also takes into account edge lengths specified by the
<TT>"len"</tt> attribute.
<DT><A NAME=dmodel HREF=#amodel><STRONG>model</strong></a>
<DD> This value specifies how the distance matrix is computed for the input
graph. The distance matrix specifies the ideal distance between every
pair of nodes. neato attemps to find a layout which best achieves
these distances. By default, it uses the length of the shortest path,
where the length of each edge is given by its <A HREF=#dlen>len</a>
attribute. If <B>model</b> is <TT>"circuit"</tt>, neato uses the
circuit resistance
model to compute the distances. This tends to emphasize clusters. If
<B>model</b> is <TT>"subset"</tt>, neato uses the subset model. This sets the
edge length to be the number of nodes that are neighbors of exactly one
of the end points, and then calculates the shortest paths. This helps
to separate nodes with high degree.
<P>
For more control of distances, one can use <TT>model=mds</tt>. In this
case, the <A HREF=#dlen>len</a> of an edge is used as the ideal distance
between its vertices. A shortest path calculation is only used for
pairs of nodes not connected by an edge. Thus, by supplying a complete
graph, the input can specify all of the relevant distances.
<DT><A NAME=dmosek HREF=#amosek><STRONG>mosek</strong></a>
<DD> If Graphviz is built with MOSEK defined, mode=ipsep and mosek=true,
the Mosek software (<a href="http://www.mosek.com" title="www.mosek.com">www.mosek.com</a>) is use to solve the ipsep constraints.
<DT><A NAME=dnodesep HREF=#anodesep><STRONG>nodesep</strong></a>
<DD> In dot, this specifies the minimum space between two adjacent nodes in the same rank, in inches.
<P>
For other layouts, this affects the spacing between loops on a single node, or multiedges between
a pair of nodes.
<DT><A NAME=dnojustify HREF=#anojustify><STRONG>nojustify</strong></a>
<DD> By default, the justification of multi-line labels is done within the
largest context that makes sense. Thus, in the label of a polygonal
node, a left-justified line will align with the left side of the node
(shifted by the prescribed <A HREF=#dmargin>margin</a>).
In record nodes, left-justified
line will line up with the left side of the enclosing column of fields.
If <B>nojustify</b> is <TT>"true"</tt>, multi-line labels will be justified
in the context of itself. For example, if the attribute is set,
the first label line is long, and the second is shorter and left-justified,
the second will align with the left-most character in the first line,
regardless of how large the node might be.
<DT><A NAME=dnormalize HREF=#anormalize><STRONG>normalize</strong></a>
<DD> If set, normalize coordinates of final
layout so that the first point is at the origin, and then rotate the
layout so that the angle of the first edge is specified by the value of <TT>normalize</tt> in degrees.
If <TT>normalize</tt> is not a number, it is evaluated as a <TT>bool</tt>, with true
corresponding to 0 degrees. <B>NOTE:</b> Since the attribute is evaluated first as a number,
0 and 1 cannot be used for false and true.
<DT><A NAME=dnslimit HREF=#anslimit><STRONG>nslimit</strong></a>
,<DT><A NAME=dnslimit1 HREF=#anslimit1><STRONG>nslimit1</strong></a>
<DD> Used to set number of iterations in
network simplex applications. <B>nslimit</b> is used in
computing node x coordinates, <B>nslimit1</b> for ranking nodes.
If defined, # iterations = <B>nslimit(1)</b> * # nodes;
otherwise, # iterations = MAXINT.
<DT><A NAME=dordering HREF=#aordering><STRONG>ordering</strong></a>
<DD> If the value of the attribute is "out", then
the outedges of a node, that is, edges with the node as its tail node,
must appear
left-to-right in the same order in which they are defined in
the input.
If the value of the attribute is "in", then
the inedges of a node must appear
left-to-right in the same order in which they are defined in
the input.
If defined as a graph or subgraph attribute, the value is applied to all nodes
in the graph or subgraph. Note that the graph attribute takes
precedence over the node attribute.
<DT><A NAME=dorientation HREF=#aorientation><STRONG>orientation</strong></a>
<DD> Angle, in degrees, used to rotate polygon node shapes. For any number of polygon sides, 0 degrees rotation results in a flat base.
<DT><A NAME=ddorientation HREF=#aaorientation><STRONG>orientation</strong></a>
<DD> If "[lL]*", set graph orientation to landscape
Used only if <A HREF=#drotate><B>rotate</b></a> is not defined.
<DT><A NAME=doutputorder HREF=#aoutputorder><STRONG>outputorder</strong></a>
<DD> Specify order in which nodes and edges are drawn.
<DT><A NAME=doverlap HREF=#aoverlap><STRONG>overlap</strong></a>
<DD> Determines if and how node overlaps should be removed. Nodes are first
enlarged using the <A HREF=#dsep><B>sep</b></a> attribute.
If "true" , overlaps are retained.
If the value is "scale", overlaps are removed by uniformly scaling in x and y.
If the value converts to "false", and it is available, Prism, a proximity graph-based algorithm, is
used to remove node overlaps.
This can also be invoked explicitly with "overlap=prism".
This technique starts with a
small scaling up, controlled by the
<A HREF="#doverlap_scaling"><TT>overlap_scaling</tt></a> attribute,
which can remove a significant portion of the overlap.
The prism option also accepts an optional non-negative integer suffix.
This can be used to control the number of attempts made at overlap
removal. By default, <TT>overlap="prism"</tt> is equivalent to
<TT>overlap="prism1000"</tt>. Setting <TT>overlap="prism0"</tt>
causes only the scaling phase to be run.
<P>
If Prism is not available, or the version of Graphviz is earlier than 2.28, "overlap=false"
uses a Voronoi-based technique.
This can always be invoked explicitly with "overlap=voronoi".
</p><P>
If the value is "scalexy", x and y are separately
scaled to remove overlaps.
</p><P>
If the value is "compress", the layout will be scaled down as much as
possible without introducing any overlaps, obviously assuming there are
none to begin with.
</p><P>
<B>N.B.</b>The remaining allowed values of <TT>overlap</tt>
correspond to algorithms which, at present, can produce bad aspect ratios.
In addition, we deprecate the use of the "ortho*" and "portho*".
</p><P>
If the value is "vpsc", overlap removal is done as a
quadratic optimization to minimize node displacement while removing
node overlaps.
</p><P>
If the value is "orthoxy" or "orthoyx", overlaps
are moved by optimizing two constraint problems, one for the x axis and
one for the y. The suffix indicates which axis is processed first.
If the value is "ortho", the technique is similar to "orthoxy" except a
heuristic is used to reduce the bias between the two passes.
If the value is "ortho_yx", the technique is the same as "ortho", except
the roles of x and y are reversed.
The values "portho", "porthoxy", "porthoxy", and "portho_yx" are similar
to the previous four, except only pseudo-orthogonal ordering is
enforced.
</p><P>
If the layout is done by neato with <A HREF=#dmode>mode</a>="ipsep",
then one can use <TT>overlap=ipsep</tt>.
In this case, the overlap removal constraints are
incorporated into the layout algorithm itself.
N.B. At present, this only supports one level of clustering.
</p><P>
Except for fdp and sfdp, the layouts assume <TT>overlap="true"</tt> as the default.
Fdp first uses a number of passes using a built-in, force-directed technique
to try to remove overlaps. Thus, fdp accepts <B>overlap</b> with an integer
prefix followed by a colon, specifying the number of tries. If there is
no prefix, no initial tries will be performed. If there is nothing following
a colon, none of the above methods will be attempted. By default, fdp
uses <TT>overlap="9:prism"</tt>. Note that <TT>overlap="true"</tt>,
<TT>overlap="0:true"</tt> and <TT>overlap="0:"</tt> all turn off all overlap
removal.
</p><P>
By default, sfdp uses <TT>overlap="prism0"</tt>.
</p><P>
Except for the Voronoi and prism methods, all of these transforms preserve the
orthogonal ordering of the original layout. That is, if the x coordinates
of two nodes are originally the same, they will remain the same, and if
the x coordinate of one node is originally less than the x coordinate of
another, this relation will still hold in the transformed layout. The
similar properties hold for the y coordinates.
This is not quite true for the "porth*" cases. For these, orthogonal
ordering is only preserved among nodes related by an edge.
<DT><A NAME=doverlap_scaling HREF=#aoverlap_scaling><STRONG>overlap_scaling</strong></a>
<DD> When <TT>overlap=prism</tt>, the layout is scaled by this factor, thereby
removing a fair amount of node overlap, and making node overlap removal
faster and better able to retain the graph's shape.
<P>
If <TT>overlap_scaling</tt> is negative, the layout is scaled by
<TT>-1*overlap_scaling</tt> times the average label size.
If <TT>overlap_scaling</tt> is positive, the layout is scaled by
<TT>overlap_scaling</tt>.
If <TT>overlap_scaling</tt> is zero, no scaling is done.
<DT><A NAME=doverlap_shrink HREF=#aoverlap_shrink><STRONG>overlap_shrink</strong></a>
<DD> If true, the overlap removal algorithm will perform a compression pass to reduce the
size of the layout.
<DT><A NAME=dpack HREF=#apack><STRONG>pack</strong></a>
<DD> This is true if the value of pack is "true" (case-insensitive) or a
non-negative integer. If true, each connected component of the graph is
laid out separately, and then the graphs are packed together.
If pack has an integral value, this is used as the size,
in <A HREF=#points>points</a>, of
a margin around each part; otherwise, a default margin of 8 is used.
If pack is interpreted as false, the entire graph is laid out together.
The granularity and method of packing is influenced by the
<A HREF=#dpackmode>packmode</a> attribute.
<P>
For layouts which always do packing, such a twopi, the <B>pack</b>
attribute is just used to set the margin.
<DT><A NAME=dpackmode HREF=#apackmode><STRONG>packmode</strong></a>
<DD> This indicates how connected components should be packed
(cf. <A HREF=#kpackMode>packMode</a>). Note that defining
<B>packmode</b> will automatically turn on packing as though one had
set <B>pack=true</b>.
<DT><A NAME=dpad HREF=#apad><STRONG>pad</strong></a>
<DD> The pad attribute specifies how much, in inches, to extend the
drawing area around the minimal area needed to draw the graph.
If the pad is a single double, both the x and y pad values are set
equal to the given value. This area is part of the
drawing and will be filled with the background color, if appropriate.
<P>
Normally, a small pad is used for aesthetic reasons, especially when
a background color is used, to avoid having nodes and edges abutting
the boundary of the drawn region.
<DT><A NAME=dpage HREF=#apage><STRONG>page</strong></a>
<DD> Width and height of output pages, in inches. If only a single value
is given, this is used for both the width and height.
<P>
If this is set and is
smaller than the size of the layout, a rectangular array of pages of
the specified page size is overlaid on the layout, with origins
aligned in the lower-left corner, thereby partitioning the layout
into pages. The pages are then produced one at a time, in
<A HREF=#dpagedir>pagedir</a> order.
</p><P>
At present, this only works for PostScript output. For other types of
output, one should use another tool to split the output into multiple
output files. Or use the <A HREF=#dviewport>viewport</a> to generate
multiple files.
<DT><A NAME=dpagedir HREF=#apagedir><STRONG>pagedir</strong></a>
<DD> If the <A HREF=#dpage>page</a> attribute is set and applicable,
this attribute specifies the order in which the pages are emitted.
This is limited to one of the 8 row or column major orders.
<DT><A NAME=dpencolor HREF=#apencolor><STRONG>pencolor</strong></a>
<DD> Color used to draw the bounding box around a cluster.
If <B>pencolor</b> is not defined, <A HREF=#dcolor><B>color</b></a> is
used. If this is not defined, <A HREF=#dbgcolor>bgcolor</a> is used.
If this is not defined, the default is used.
<P>
Note that a cluster inherits the root graph's attributes if defined.
Thus, if the root graph has defined a <B>pencolor</b>, this will override a
<B>color</b> or <B>bgcolor</b> attribute set for the cluster.
<DT><A NAME=dpenwidth HREF=#apenwidth><STRONG>penwidth</strong></a>
<DD> Specifies the width of the pen, in points, used to draw lines and curves,
including the boundaries of edges and clusters. The value is inherited
by subclusters.
It has no effect on text.
<P>
Previous to 31 January 2008, the effect of <TT>penwidth=<I>W</i></tt>
was achieved by including <TT>setlinewidth(<I>W</i>)</tt>
as part of a <A HREF=#dstyle><TT>style</tt></a> specification.
If both are used, <TT>penwidth</tt> will be used.
<DT><A NAME=dperipheries HREF=#aperipheries><STRONG>peripheries</strong></a>
<DD> Set number of peripheries used in polygonal shapes and cluster
boundaries. Note that
<A HREF=node-shapes#epsf>user-defined shapes</a> are treated as a
form of box shape, so the default
peripheries value is 1 and the user-defined shape will be drawn in
a bounding rectangle. Setting <TT>peripheries=0</tt> will turn this off.
Also, 1 is the maximum peripheries value for clusters.
<DT><A NAME=dpin HREF=#apin><STRONG>pin</strong></a>
<DD> If true and the node has a pos attribute on input, neato or fdp prevents the
node from moving from the input position. This property can also be specified
in the pos attribute itself (cf. the <A HREF=#kpoint>point</a> type).
<P>
<B>Note:</b> Due to an artifact of the implementation, final coordinates
are translated to the origin. Thus, if you look at the output coordinates
given in the (x)dot or plain format, pinned nodes will not have the same
output coordinates as were given on input. If this is important, a
simple workaround is to maintain the coordinates of a pinned node. The vector
difference between the old and new coordinates will give the translation,
which can then be subtracted from all of the appropriate coordinates.
<DT><A NAME=dpos HREF=#apos><STRONG>pos</strong></a>
<DD> Position of node, or spline control points.
For nodes, the position indicates the center of the node.
On output, the coordinates are in <A HREF=#points>points</a>.
<P>
In neato and fdp, pos can be used to set the initial position of a node.
By default, the coordinates are assumed to be in inches. However, the
<A HREF=command-line-invocation#ds>-s</a> command line flag can be used to specify
different units. As the output coordinates are in points,
feeding the output of a graph laid out by a Graphviz program into
neato or fdp will almost always require the -s flag.
</p><P>
When the <A HREF=command-line-invocation#dn>-n</a> command line flag is used with
neato, it is assumed the positions have been set by one of the layout
programs, and are therefore in points. Thus, <TT>neato -n</tt> can accept
input correctly without requiring a <TT>-s</tt> flag and, in fact,
ignores any such flag.
<DT><A NAME=dquadtree HREF=#aquadtree><STRONG>quadtree</strong></a>
<DD> Quadtree scheme to use.
<P>
A TRUE bool value corresponds to "normal";
a FALSE bool value corresponds to "none".
As a slight exception to the normal interpretation of bool,
a value of "2" corresponds to "fast".
<DT><A NAME=dquantum HREF=#aquantum><STRONG>quantum</strong></a>
<DD> If <B>quantum</b> > 0.0, node label dimensions
will be rounded to integral multiples of the quantum.
<DT><A NAME=drank HREF=#arank><STRONG>rank</strong></a>
<DD> Rank constraints on the nodes in a subgraph.
If <B>rank</b>="same", all nodes are placed on the same rank.
If <B>rank</b>="min", all nodes are placed on the minimum rank.
If <B>rank</b>="source", all nodes are placed on the minimum rank, and
the only nodes on the minimum rank belong to some subgraph whose
rank attribute is "source" or "min".
Analogous criteria hold for <B>rank</b>="max" and <B>rank</b>="sink".
(Note: the
minimum rank is topmost or leftmost, and the maximum rank is bottommost
or rightmost.)
<DT><A NAME=drankdir HREF=#arankdir><STRONG>rankdir</strong></a>
<DD> Sets direction of graph layout. For example, if <B>rankdir</b>="LR",
and barring cycles, an edge <CODE>T -> H;</code> will go
from left to right. By default, graphs are laid out from top to bottom.
<P>
This attribute also has a side-effect in determining how record nodes
are interpreted. See <A HREF="node-shapes#record">record shapes</a>.
<DT><A NAME=dranksep HREF=#aranksep><STRONG>ranksep</strong></a>
<DD> In dot, this gives the desired rank separation, in inches. This is
the minimum vertical distance between the bottom of the nodes in one
rank and the tops of nodes in the next. If the value
contains "equally", the centers of all ranks are spaced equally apart.
Note that both
settings are possible, e.g., ranksep = "1.2 equally".
<P>
In twopi, this attribute specifies the radial separation of concentric circles.
For twopi, <TT>ranksep</tt> can also be a list of doubles. The first double specifies
the radius of the inner circle; the second double specifies the increase in
radius from the first circle to the second; etc. If there are more circles than
numbers, the last number is used as the increment for the remainder.
<DT><A NAME=dratio HREF=#aratio><STRONG>ratio</strong></a>
<DD> Sets the aspect ratio (drawing height/drawing width) for the drawing.
Note that this is adjusted before
the <A HREF=#dsize><B>size</b></a> attribute constraints are enforced.
In addition, the calculations usually ignore the node sizes, so the
final drawing size may only approximate what is desired.
<P>
If <B>ratio</b> is numeric, it is taken as the desired aspect ratio.
Then, if the actual aspect ratio is less than the desired ratio,
the drawing height is scaled up to achieve the
desired ratio; if the actual ratio is greater than that desired ratio,
the drawing width is scaled up.
</p><P>
If <B>ratio</b> = "fill" and the <A HREF=#dsize><B>size</b></a>
attribute is set, node positions are scaled, separately in both x
and y, so that the final drawing exactly fills the specified size.
If both <A HREF=#dsize><B>size</b></a> values exceed the width
and height of the drawing, then both coordinate values of each
node are scaled up accordingly. However, if either size dimension
is smaller than the corresponding dimension in the drawing, one
dimension is scaled up so that the final drawing has the same aspect
ratio as specified by <A HREF=#dsize><B>size</b></a>.
Then, when rendered, the layout will be
scaled down uniformly in both dimensions to fit the given
<A HREF=#dsize><B>size</b></a>, which may cause nodes and text
to shrink as well. This may not be what the user
wants, but it avoids the hard problem of how to reposition the
nodes in an acceptable fashion to reduce the drawing size.
</p><P>
If <B>ratio</b> = "compress" and the <A HREF=#dsize><B>size</b></a>
attribute is set, dot attempts to compress the initial layout to fit
in the given size. This achieves a tighter packing of nodes but
reduces the balance and symmetry. This feature only works in dot.
</p><P>
If <B>ratio</b> = "expand", the <A HREF=#dsize><B>size</b></a>
attribute is set, and both the width and the height of the graph are
less than the value in <A HREF=#dsize><B>size</b></a>, node positions are scaled
uniformly until at least
one dimension fits <A HREF=#dsize><B>size</b></a> exactly.
Note that this is distinct from using <A HREF=#dsize><B>size</b></a> as the
desired size, as here the drawing is expanded before edges are generated and
all node and text sizes remain unchanged.
</p><P>
If <B>ratio</b> = "auto", the <A HREF=#dpage><B>page</b></a>
attribute is set and the graph cannot be drawn on a single page,
then <A HREF=#dsize><B>size</b></a> is set to an ``ideal'' value.
In particular, the size in a given dimension will be the smallest integral
multiple of the page size in that dimension which is at least half the
current size. The two dimensions are then scaled independently to the
new size. This feature only works in dot.
<DT><A NAME=drects HREF=#arects><STRONG>rects</strong></a>
<DD> Rectangles for fields of records, <A HREF=#points>in points</a>.
<DT><A NAME=dregular HREF=#aregular><STRONG>regular</strong></a>
<DD> If true, force polygon to be regular, i.e., the vertices of the
polygon will lie on a circle whose center is the center of the node.
<DT><A NAME=dremincross HREF=#aremincross><STRONG>remincross</strong></a>
<DD> If true and there are multiple clusters, run cross
minimization a second time.
<DT><A NAME=drepulsiveforce HREF=#arepulsiveforce><STRONG>repulsiveforce</strong></a>
<DD> The power of the repulsive force used in an extended Fruchterman-Reingold
force directed model. Values larger than 1 tend to reduce
the warping effect at the expense of less clustering.
<DT><A NAME=dresolution HREF=#aresolution><STRONG>resolution</strong></a>
<DD> This is a synonym for the <A HREF=#ddpi>dpi</a> attribute.
<DT><A NAME=droot HREF=#aroot><STRONG>root</strong></a>
<DD> This specifies nodes to be used as the center of the
layout and the root of the generated spanning tree. As a graph attribute,
this gives the name of the node. As a node attribute (circo only), it
specifies that the node should be used as a central node. In twopi,
this will actually be the central node. In circo, the block containing
the node will be central in the drawing of its connected component.
If not defined,
twopi will pick a most central node, and circo will pick a random node.
<P>
If the root attribute is defined as the empty string, twopi will reset it
to name of the node picked as the root node.
<DT><A NAME=drotate HREF=#arotate><STRONG>rotate</strong></a>
<DD> If 90, set drawing orientation to landscape.
<DT><A NAME=drotation HREF=#arotation><STRONG>rotation</strong></a>
<DD> Causes the final layout to be rotated counter-clockwise by the specified number of degrees.
<DT><A NAME=dsamehead HREF=#asamehead><STRONG>samehead</strong></a>
<DD> Edges with the same head and the same <B>samehead</b> value are aimed
at the same point on the head. This has no effect on loops.
Each node can have at most 5 unique samehead values.
See <A HREF=#h:undir_note>limitation</a>.
<DT><A NAME=dsametail HREF=#asametail><STRONG>sametail</strong></a>
<DD> Edges with the same tail and the same <B>sametail</b> value are aimed
at the same point on the tail. This has no effect on loops.
Each node can have at most 5 unique sametail values.
See <A HREF=#h:undir_note>limitation</a>.
<DT><A NAME=dsamplepoints HREF=#asamplepoints><STRONG>samplepoints</strong></a>
<DD> If the input graph defines the <A HREF=#dvertices><B>vertices</b></a>
attribute, and output is dot or xdot, this gives
the number of points used for a node whose shape is a circle or ellipse.
It plays the same role in neato, when adjusting the layout to avoid
overlapping nodes, and in image maps.
<DT><A NAME=dscale HREF=#ascale><STRONG>scale</strong></a>
<DD> If set, after the initial layout, twopi will scale the layout by the given factors.
The scaling uses the root node of each component as the center of the scaling.
If only a single number is given, this is used for both factors.
<DT><A NAME=dsearchsize HREF=#asearchsize><STRONG>searchsize</strong></a>
<DD> During network simplex, maximum number of edges with negative cut values
to search when looking for one with minimum cut value.
<DT><A NAME=dsep HREF=#asep><STRONG>sep</strong></a>
<DD> Specifies margin to leave around nodes when removing node overlap.
This guarantees a minimal non-zero distance between nodes.
<P>
If the attribute begins with a plus sign '+', an additive margin is
specified. That is, "+w,h" causes the node's bounding box to be increased
by w
points on the left and right sides, and by h points on the top and bottom.
Without a plus sign, the node is scaled by 1 + w in the x coordinate
and 1 + h in the y coordinate.
</p><P>
If only a single number is given, this is used for both dimensions.
</p><P>
If unset but <A HREF=#d:esep>esep</a> is defined, the <tt>sep</tt> values
will be set to the <tt>esep</tt> values divided by <tt>0.8</tt>.
If <tt>esep</tt> is unset, the default value is used.
<DT><A NAME=dshape HREF=#ashape><STRONG>shape</strong></a>
<DD> Set the shape of a node.
<DT><A NAME=dshapefile HREF=#ashapefile><STRONG>shapefile</strong></a>
<DD> (Deprecated) If defined, shapefile specifies a file containing user-supplied node content.
The <A HREF=#dshape><B>shape</b></a> of the node is set to box.
The image in the shapefile must be
rectangular. The image formats supported as well as the precise semantics of
how the file is used depends on the
<A HREF="output-formats">output format</a>. For further details, see
<A HREF=output-formats#dimage_fmts>Image Formats</a> and
<A HREF=http://www.graphviz.org/wiki/how-create-custom-shapes#ext_image>External PostScript files</a>.
<P>
There is one exception to this usage.
If <B>shape</b> is set to "epsf", shapefile gives
a filename containing a definition of the node in PostScript.
The graphics defined must be contain all of the
node content, including any desired boundaries.
For further details, see
<A HREF=http://www.graphviz.org/wiki/how-create-custom-shapes#ext_ps>
External PostScript files</a>.
<DT><A NAME=dshowboxes HREF=#ashowboxes><STRONG>showboxes</strong></a>
<DD> Print guide boxes in PostScript at the beginning of
routesplines if 1, or at the end if 2. (Debugging)
<DT><A NAME=dsides HREF=#asides><STRONG>sides</strong></a>
<DD> Number of sides if <A HREF=#dshape><B>shape</b></a>=polygon.
<DT><A NAME=dsize HREF=#asize><STRONG>size</strong></a>
<DD> Maximum width and height of drawing, in inches.
If only a single number is given, this is used for both the width
and the height.
<P>
If defined and the drawing is larger than the given size,
the drawing is uniformly
scaled down so that it fits within the given size.
</p><P>
If <TT>size</tt> ends in an exclamation point (<TT>!</tt>),
then it is taken to be
the desired size. In this case, if both dimensions of the drawing are
less than <TT>size</tt>, the drawing is scaled up uniformly until at
least one dimension equals its dimension in <TT>size</tt>.
</p><P>
Note that there is some interaction between the <B>size</b> and
<A HREF=#dratio><B>ratio</b></a> attributes.
<DT><A NAME=dskew HREF=#askew><STRONG>skew</strong></a>
<DD> Skew factor for <A HREF=#dshape><B>shape</b></a>=polygon. Positive values
skew top of polygon to right; negative to left.
<DT><A NAME=dsmoothing HREF=#asmoothing><STRONG>smoothing</strong></a>
<DD> Specifies a post-processing step used to smooth out an uneven distribution
of nodes.
<DT><A NAME=dsortv HREF=#asortv><STRONG>sortv</strong></a>
<DD> If <A HREF="#dpackmode">packmode</a> indicates an array packing,
this attribute specifies an
insertion order among the components, with smaller values inserted first.
<DT><A NAME=dsplines HREF=#asplines><STRONG>splines</strong></a>
<DD> Controls how, and if, edges are represented. If true, edges are drawn as
splines routed around nodes; if false, edges are drawn as line segments.
If set to <tt>none</tt> or "", no edges are drawn at all.
<P>
(1 March 2007) The values <TT>line</tt> and <TT>spline</tt> can be
used as synonyms for <TT>false</tt> and <TT>true</tt>, respectively.
In addition, the value <TT>polyline</tt> specifies that edges should be
drawn as polylines.
</p><P>
(28 Sep 2010) The value <TT>ortho</tt> specifies edges should be
routed as polylines of axis-aligned segments. Currently, the routing
does not handle ports or, in dot, edge labels.
</p><P>
(25 Sep 2012) The value <TT>curved</tt> specifies edges should be
drawn as curved arcs.
</p><P>
<TABLE>
<TR><TD><IMG WIDTH="200" VSPACE="10" HSPACE="10" SRC="/doc/info/spline_none.png" />
<TD><IMG WIDTH="200" VSPACE="10" HSPACE="10" SRC="/doc/info/spline_line.png" />
<TD><IMG WIDTH="200" VSPACE="10" HSPACE="10" SRC="/doc/info/spline_polyline.png" />
<TD><IMG WIDTH="200" VSPACE="10" HSPACE="10" SRC="/doc/info/spline_curved.png" />
<TD><IMG WIDTH="200" VSPACE="10" HSPACE="10" SRC="/doc/info/spline_ortho.png" />
<TD><IMG WIDTH="200" VSPACE="10" HSPACE="10" SRC="/doc/info/spline_spline.png" />
</td></td></td></td></td></td></tr>
<TR><TD ALIGN="center">splines=none<BR />splines=""
<TD ALIGN="center">splines=line<BR />splines=false
<TD ALIGN="center">splines=polyline
<TD ALIGN="center">splines=curved
<TD ALIGN="center">splines=ortho
<TD ALIGN="center">splines=spline<BR />splines=true
</td></td></td></td></td></td></tr>
</table>
</p><P>
By default, the attribute is unset. How this is interpreted depends on
the layout. For dot, the default is to draw edges as splines. For all
other layouts, the default is to draw edges as line segments. Note that
for these latter layouts, if <TT>splines="true"</tt>, this
requires non-overlapping nodes (cf. <A HREF=#doverlap><B>overlap</b></a>).
If fdp is used for layout and <TT>splines="compound"</tt>, then the edges are
drawn to avoid clusters as well as nodes.
<DT><A NAME=dstart HREF=#astart><STRONG>start</strong></a>
<DD> Parameter used to determine the initial layout of nodes. If unset, the
nodes are randomly placed in a unit square with
the same seed is always used for the random number generator, so the
initial placement is repeatable.
<DT><A NAME=dstyle HREF=#astyle><STRONG>style</strong></a>
<DD> Set style information for components of the graph. For cluster subgraphs, if <TT>style="filled"</tt>, the
cluster box's background is filled.
<P>
If the default style attribute has been set for a component, an individual component can use
<TT>style=""</tt> to revert to the normal default. For example, if the graph has
</p><P>
<TT>edge [style="invis"]</tt>
</p><P>
making all edges invisible, a specific edge can overrride this via
</p><P>
<TT>a -> b [style=""]</tt>
</p><P>
Of course, the component can also explicitly set its <TT>style</tt> attribute to the desired value.
<DT><A NAME=dstylesheet HREF=#astylesheet><STRONG>stylesheet</strong></a>
<DD> A URL or pathname specifying an XML style sheet, used in SVG output.
<DT><A NAME=dtailURL HREF=#atailURL><STRONG>tailURL</strong></a>
<DD> If <B>tailURL</b> is defined, it is
output as part of the tail label of the edge.
Also, this value is used near the tail node, overriding any
<A HREF=#dURL>URL</a> value.
See <A HREF=#h:undir_note>limitation</a>.
<DT><A NAME=dtail_lp HREF=#atail_lp><STRONG>tail_lp</strong></a>
<DD> Position of an edge's tail label, <A HREF=#points>in points</a>.
The position indicates the center of the label.
<DT><A NAME=dtailclip HREF=#atailclip><STRONG>tailclip</strong></a>
<DD> If true, the tail of an edge is clipped to the boundary of the tail node;
otherwise, the end of the edge goes to the center of the node, or the
center of a port, if applicable.
<DT><A NAME=dtailhref HREF=#atailhref><STRONG>tailhref</strong></a>
<DD> Synonym for <A HREF=#dtailURL>tailURL</a>.
<DT><A NAME=dtaillabel HREF=#ataillabel><STRONG>taillabel</strong></a>
<DD> Text label to be placed near tail of edge.
See <A HREF=#h:undir_note>limitation</a>.
<DT><A NAME=dtailport HREF=#atailport><STRONG>tailport</strong></a>
<DD> Indicates where on the tail node to attach the tail of the edge.
See <A HREF=#h:undir_note>limitation</a>.
<DT><A NAME=dtailtarget HREF=#atailtarget><STRONG>tailtarget</strong></a>
<DD> If the edge has a <A HREF=#dtailURL>tailURL</a>,
this attribute determines which window of the
browser is used
for the URL. Setting it to "_graphviz" will open a new window if it
doesn't already exist, or reuse it if it does.
If undefined, the value of the <A HREF=#dtarget>target</a> is used.
<DT><A NAME=dtailtooltip HREF=#atailtooltip><STRONG>tailtooltip</strong></a>
<DD> Tooltip annotation attached to the tail of an edge. This is used only
if the edge has a <A HREF=#dtailURL>tailURL</a> attribute.
<DT><A NAME=dtarget HREF=#atarget><STRONG>target</strong></a>
<DD> If the object has a URL, this attribute determines which window
of the browser is used for the URL.
See <A HREF="http://www.w3.org/TR/html401/present/frames.html#adef-target">W3C documentation</a>.
<DT><A NAME=dtooltip HREF=#atooltip><STRONG>tooltip</strong></a>
<DD> Tooltip annotation attached to the node or edge. If unset, Graphviz
will use the object's <A HREF=#dlabel>label</a> if defined.
Note that if the label is a record specification or an HTML-like
label, the resulting tooltip may be unhelpful. In this case, if
tooltips will be generated, the user should set a <TT>tooltip</tt>
attribute explicitly.
<DT><A NAME=dtruecolor HREF=#atruecolor><STRONG>truecolor</strong></a>
<DD> If set explicitly to true or false, the value determines whether or not
internal bitmap rendering relies on a truecolor color model or uses
a color palette.
If the attribute is unset, truecolor is not used
unless there is a <A HREF=#dshapefile>shapefile</a> property
for some node in the graph.
The output model will use the input model when possible.
<P>
Use of color palettes results in less memory usage during creation of the
bitmaps and smaller output files.
</p><P>
Usually, the only time it is necessary to specify the truecolor model
is if the graph uses more than 256 colors.
However, if one uses <A HREF=#dbgcolor>bgcolor</a>=transparent with
a color palette, font
antialiasing can show up as a fuzzy white area around characters.
Using <B>truecolor</b>=true avoids this problem.
<DT><A NAME=dvertices HREF=#avertices><STRONG>vertices</strong></a>
<DD> If the input graph defines this attribute, the node is polygonal,
and output is dot or xdot, this attribute provides the
coordinates of the vertices of the node's polygon, in inches.
If the node is an ellipse or circle, the
<A HREF=#dsamplepoints>samplepoints</a> attribute affects
the output.
<DT><A NAME=dviewport HREF=#aviewport><STRONG>viewport</strong></a>
<DD> Clipping window on final drawing. Note that this attribute supersedes any
<A HREF="#dsize">size</a> attribute. The width and height of the viewport specify
precisely the final size of the output.
<DT><A NAME=dvoro_margin HREF=#avoro_margin><STRONG>voro_margin</strong></a>
<DD> Factor to scale up drawing to allow margin for expansion in
Voronoi technique. dim' = (1+2*margin)*dim.
<DT><A NAME=dweight HREF=#aweight><STRONG>weight</strong></a>
<DD> Weight of edge. In dot, the heavier the weight, the shorter,
straighter and more vertical the edge is.
<B>N.B.</b> Weights in dot must be integers.
For other layouts, a larger weight encourages the layout to
make the edge length closer to that specified by the
<A HREF=#dlen>len</a> attribute.
<DT><A NAME=dwidth HREF=#awidth><STRONG>width</strong></a>
<DD> Width of node, in inches. This is taken as the initial, minimum width
of the node. If <A HREF=#dfixedsize><B>fixedsize</b></a> is true, this
will be the final width of the node. Otherwise, if the node label
requires more width to fit, the node's width will be increased to
contain the label. Note also that, if the output format is dot, the
value given to <B>width</b> will be the final value.
<P>
If the node shape is regular, the width and height are made identical.
In this case, if either the width or the height is set explicitly,
that value is used.
In this case, if both the width or the height are set explicitly,
the maximum of the two values is used.
If neither is set explicitly, the minimum of the two default values
is used.
<DT><A NAME=dxdotversion HREF=#axdotversion><STRONG>xdotversion</strong></a>
<DD> For xdot output, if this attribute is set, this determines the version of xdot used in output.
If not set, the attribute will be set to the xdot version used for output.
<DT><A NAME=dxlabel HREF=#axlabel><STRONG>xlabel</strong></a>
<DD> External label for a node or edge. For nodes, the label will be placed outside of the
node but near it. For edges, the label will be placed near the center of the edge.
This can be useful in dot to avoid the occasional problem when the use of edge labels
distorts the layout. For other layouts, the xlabel attribute can be viewed as a synonym
for the <A HREF=#dlabel><B>label</b></a> attribute.
<P>
These labels are added after all nodes and edges have been placed. The labels will be placed
so that they do not overlap any node or label. This means it may not be possible to place all
of them. To force placing all of them, use the <A HREF=#dforcelabels><B>forcelabels</b></a> attribute.
<DT><A NAME=dxlp HREF=#axlp><STRONG>xlp</strong></a>
<DD> Position of an exterior label, <A HREF=#points>in points</a>.
The position indicates the center of the label.
<DT><A NAME=dz HREF=#az><STRONG>z</strong></a>
<DD> <B>Deprecated</b>Use <A HREF=#dpos><B>pos</b></a> attribute, along
with <A HREF=#ddimen><B>dimen</b></a> and/or <A HREF=#ddim><B>dim</b></a>
to specify dimensions.
<P>
Provides z coordinate value for 3D layouts and displays. If the
graph has <A HREF=#ddim><B>dim</b></a> set to 3 (or more),
neato will use a node's <B>z</b> value
for the z coordinate of its initial position if
its <A HREF=#dpos><B>pos</b></a> attribute is also defined.
</p><P>
Even if no <B>z</b> values are specified in the input, it is necessary to
declare a <B>z</b> attribute for nodes, e.g, using <TT>node[z=""]</tt>
in order to get z values on output.
Thus, setting <TT>dim=3</tt> but not declaring <B>z</b> will
cause <TT>neato -Tvrml</tt> to
layout the graph in 3D but project the layout onto the xy-plane
for the rendering. If the <B>z</b> attribute is declared, the final rendering
will be in 3D.
</p></dd></dt></dd></dt></p></dd></dt></dd></dt></p></dd></dt></dd></dt></dd></dt></dd></dt></dd></dt></p></dd></dt></dd></dt></dd></dt></dd></dt></dd></dt></dd></dt></dd></dt></dd></dt></dd></dt></dd></dt></dd></dt></dd></dt></p></dd></dt></dd></dt></p></dd></dt></dd></dt></dd></dt></dd></dt></p></dd></dt></dd></dt></dd></dt></p></dd></dt></dd></dt></p></dd></dt></dd></dt></dd></dt></dd></dt></dd></dt></dd></dt></dd></dt></dd></dt></p></dd></dt></dd></dt></dd></dt></dd></dt></dd></dt></dd></dt></p></dd></dt></p></dd></dt></p></dd></dt></dd></dt></dd></dt></p></dd></dt></p></dd></dt></p></dd></dt></dd></dt></p></dd></dt></p></dd></dt></dd></dt></p></dd></dt></p></dd></dt></dd></dt></p></dd></dt></dd></dt></p></dd></dt></p></dd></dt></dd></dt></dd></dt></dd></dt></dd></dt></dd></dt></dt></dd></dt></dd></dt></p></dd></dt></dd></dt></p></dd></dt></p></dd></dt></dd></dt></dd></dt></dd></dt></dd></dt></p></dd></dt></dd></dt></dd></dt></dd></dt></dd></dt></dd></dt></dd></dt></dd></dt></dd></dt></p></dd></dt></dd></dt></dd></dt></dd></dt></dd></dt></dd></dt></dd></dt></dd></dt></dd></dt></p></dd></dt></dd></dt></dd></dt></dd></dt></dd></dt></dd></dt></dd></dt></dd></dt></p></dd></dt></dd></dt></dd></dt></dd></dt></p></dd></dt></p></dd></dt></dd></dt></p></dd></dt></p></dd></dt></dd></dt></p></dd></dt></dd></dt></dd></dt></dd></dt></dd></dt></dd></dt></dd></dt></dd></dt></dd></dt></dd></dt></p></dd></dt></dd></dt></dd></dt></dd></dt></dd></dt></p></dd></dt></dd></dt></dd></dt></p></dd></dt></dd></dt></dd></dt></dd></dt></dd></dt></dd></dt></dd></dt></dd></dt></dd></dt></dd></dt></dd></dt></p></dd></dt></dd></dt></dd></dt></dd></dt></dd></dt></dd></dt></dd></dt></dd></dt></dd></dt></p></dd></dt></dd></dt></dd></dt></dd></dt></p></dd></dt></dd></dt></dd></dt></dd></dt></dd></dt></dd></dt></p></dd></dt></dd></dt></dd></dt></dl>
<HR />
<H1>Attribute Type Descriptions</h1>
The following list gives the legal strings corresponding to values of
the given types.
The syntax for describing legal type strings is a mixture of literal strings,
stdio encodings (e.g., <TT>%f</tt> for a double), and regular expressions.
For regular expressions, <TT>(...)*</tt> indicates 0 or more copies of the expression
enclosed in the parentheses, <TT>(...)+</tt> indicates 1 or more, and
<TT>(...)?</tt> denotes 0 or 1 copy.
<DL>
<DT><A NAME=kaddDouble><STRONG>addDouble</strong></a>
<DD><P>A double with an optional prefix '+'.
<DT><A NAME=kaddPoint><STRONG>addPoint</strong></a>
<DD><P>A <A HREF="#kpoint">point</a> with an optional prefix '+'.
<DT><A NAME=karrowType><STRONG>arrowType</strong></a>
<DD><TABLE>
<TR><TD>"normal"<TD><IMG SRC="/doc/info/a_normal.gif" />
<TD>"inv"<TD><IMG SRC="/doc/info/a_inv.gif" /></td></td></td></td></tr>
<TR><TD>"dot"<TD><IMG SRC="/doc/info/a_dot.gif" />
<TD>"invdot"<TD><IMG SRC="/doc/info/a_invdot.gif" /></td></td></td></td></tr>
<TR><TD>"odot"<TD><IMG SRC="/doc/info/a_odot.gif" />
<TD>"invodot"<TD><IMG SRC="/doc/info/a_invodot.gif" /></td></td></td></td></tr>
<TR><TD>"none"<TD><IMG SRC="/doc/info/a_none.gif" />
<TD>"tee"<TD><IMG SRC="/doc/info/a_tee.gif" /></td></td></td></td></tr>
<TR><TD>"empty"<TD><IMG SRC="/doc/info/a_empty.gif" />
<TD>"invempty"<TD><IMG SRC="/doc/info/a_invempty.gif" /></td></td></td></td></tr>
<TR><TD>"diamond"<TD><IMG SRC="/doc/info/a_diamond.gif" />
<TD>"odiamond"<TD><IMG SRC="/doc/info/a_odiamond.gif" /></td></td></td></td></tr>
<TR><TD>"ediamond"<TD><IMG SRC="/doc/info/a_ediamond.gif" />
<TD>"crow"<TD><IMG SRC="/doc/info/a_crow.gif" /></td></td></td></td></tr>
<TR><TD>"box"<TD><IMG SRC="/doc/info/a_box.gif" />
<TD>"obox"<TD><IMG SRC="/doc/info/a_obox.gif" /></td></td></td></td></tr>
<TR><TD>"open"<TD><IMG SRC="/doc/info/a_open.gif" />
<TD>"halfopen"<TD><IMG SRC="/doc/info/a_halfopen.gif" /></td></td></td></td></tr>
<TR><TD>"vee"<TD><IMG SRC="/doc/info/a_open.gif" />
<TD>"circle"<TD><IMG SRC="/doc/info/a_circle.gif" /></td></td></td></td></tr>
</table>
<P>
These are the basic set of backward-compatible arrow shapes. In addition,
there is a grammar of <A HREF=arrow-shapes>arrow shapes</a>
which can be used to describe a collection of 2,313,441 arrow combinations of the
39 varations of the primitive set of 10 arrows. The basic arrows shown
above contain all of the primitive shapes
(<TT>box</tt>, <TT>crow</tt>, <TT>circle</tt>, <TT>diamond</tt>,
<TT>dot</tt>, <TT>inv</tt>, <TT>none</tt>,
<TT>normal</tt>, <TT>tee</tt>, <TT>vee</tt>)
plus ones that can be derived from the grammar
(<TT>odot</tt>, <TT>invdot</tt>, <TT>invodot</tt>,
<TT>obox</tt>, <TT>odiamond</tt>)
plus some supported as special cases for backward-compatibility
(<TT>ediamond</tt>, <TT>open</tt>, <TT>halfopen</tt>,
<TT>empty</tt>, <TT>invempty</tt>).
<DT><A NAME=kclusterMode><STRONG>clusterMode</strong></a>
<DD>"local","global","none"
<DT><A NAME=kcolor><STRONG>color</strong></a>
<DD>Colors can be specified using one of four formats.
<TABLE><TR><TD>"#%2x%2x%2x"<TD>Red-Green-Blue (RGB)</td></td></tr>
<TR><TD>"#%2x%2x%2x%2x"<TD>Red-Green-Blue-Alpha (RGBA)</td></td></tr>
<TR><TD>"H[, ]+S[, ]+V"<TD>Hue-Saturation-Value (HSV) 0.0 <= H,S,V <= 1.0</td></td></tr>
<TR><TD>string<TD><A HREF=color-names>color name</a></td></td></tr></table>
The specification for the RGB and RGBA formats are the format strings used by
<TT>sscanf</tt> to scan the color value. Thus, these values have the form
"#RGB" or "#RGBA", where R, G, B, and A each consist of 2 hexidecimal
digits, and can be separated by whitespace. HSV colors have the form of 3
numbers between 0 and 1, separated by whitespace or commas.
<P>
String-valued color specifications are case-insensitive and interpreted
in the context of the current color scheme, as specified by the
<A HREF=#dcolorscheme>colorscheme</a> attribute. If this is undefined,
the X11 naming scheme will be used.
An initial <TT>"/"</tt> character can be used to override the use of
the <TT>colorscheme</tt> attribute. In particular, a single initial
<TT>"/"</tt> will cause the string to be evaluated using the default
X11 naming. If the color value has the form <TT>"/ssss/yyyy"</tt>,
the name <TT>yyyy</tt> is interpreted using the schema <TT>ssss</tt>.
If the color scheme name is empty, i.e., the color has the
form <TT>"//yyyy"</tt>, the <TT>colorscheme</tt> attribute is used.
Thus, the forms <TT>"yyyy"</tt> and <TT>"//yyyy"</tt> are
equivalent.
</p><P>At present, Graphviz recognizes the default color scheme <TT>X11</tt>,
and the <A HREF="color-names#brewer">Brewer color schemes</a> (cf. <A HREF="http://www.personal.psu.edu/faculty/c/a/cab38/ColorBrewer/ColorBrewer_intro.html">ColorBrewer</a>). Please note that Brewer
color schemes are covered by this <A HREF=color-names#brewer_license>license</a>.
</p><P>
Examples:<BR />
<TABLE border=1>
<TR><TH>Color<TH>RGB<TH>HSV<TH>String</th></th></th></th></tr>
<TR><TD align=center bgcolor=#ffffff>White<TD>"#ffffff"<TD>"0.000 0.000 1.000"<TD>"white"</td></td></td></td></tr>
<TR><TD align=center bgcolor=#000000><font color=white>Black</font><TD>"#000000"<TD>"0.000 0.000 0.000"<TD>"black"</td></td></td></td></tr>
<TR><TD align=center bgcolor=#ff0000>Red<TD>"#ff0000"<TD>"0.000 1.000 1.000"<TD>"red"</td></td></td></td></tr>
<TR><TD align=center bgcolor=#40e0d0>Turquoise<TD>"#40e0d0"<TD>"0.482 0.714 0.878"<TD>"turquoise"</td></td></td></td></tr>
<TR><TD align=center bgcolor=#a0522d>Sienna<TD>"#a0522d"<TD>"0.051 0.718 0.627"<TD>"sienna"</td></td></td></td></tr>
</table>
</p><P>
The string value <TT>transparent</tt> can be used to indicate no color.
This is only available in the output formats
ps, svg, fig, vmrl, and the bitmap formats. It can be used whenever a
color is needed but is most useful with
the <A HREF=#dbgcolor>bgcolor</a> attribute.
Usually, the same effect can be achieved by setting
<A HREF=#dstyle>style</a> to <TT>invis</tt>.
<DT><A NAME=kcolorList><STRONG>colorList</strong></a>
<DD>A colon-separated list of weighted color values: <I>WC</i>(:<I>WC</i>)*
where each <I>WC</i> has the form <I>C(;F)?</i> with C a <A HREF=#kcolor>color</a> value
and the optional <I>F</i> a floating-point number, 0 ≤ <I>F</i> ≤ 1. The sum of the
floating-point numbers in a <TT>colorList</tt> must sum to at most 1.
<P>
<b>NOTE:</b> Gradient fills, described below, are currently only available via CAIRO or SVG rendering.
</p><P>
If the colorList value specifies multiple colors, with no weights, and a filled style is specified,
a linear gradient fill is done using the first two colors.
If weights are present, a degenerate linear gradient fill is done. This essentially does a fill using
two colors, with the weights specifying how much of region is filled with each color.
If the <A HREF=#astyle>style</a> attribute contains the value <tt>radial</tt>, then
a radial gradient fill is done. These fills work with any shape.
</p><P>
For certain shapes, the <A HREF=#astyle>style</a> attribute can be set
to do fills using more than 2 colors. See the <A HREF=#kstyle>style</a> type for more information.
</p><P>
The following table shows some variations of the <TT>yellow:blue</tt> color list depending on the
<A HREF=#astyle>style</a> and <A HREF=#agradientangle>gradientangle</a> attributes.
<TABLE border=1>
<TR><TH>Gradient angle<TH><tt>style=filled</tt><TH><tt>style=filled<br />fillcolor=yellow;0.3:blue</tt><TH><tt>style=radial</tt></th></th></th></th></tr>
<TR><TD align=center>0<TD><IMG SRC="/doc/info/g_lin0.png" /><TD ALIGN="CENTER"><IMG SRC="/doc/info/g_wlin0.png" /><TD><IMG SRC="/doc/info/g_rad0.png" /></td></td></td></td></tr>
<TR><TD align=center>45<TD><IMG SRC="/doc/info/g_lin45.png" /><TD ALIGN="CENTER"><IMG SRC="/doc/info/g_wlin45.png" /><TD><IMG SRC="/doc/info/g_rad45.png" /></td></td></td></td></tr>
<TR><TD align=center>90<TD><IMG SRC="/doc/info/g_lin90.png" /><TD ALIGN="CENTER"><IMG SRC="/doc/info/g_wlin90.png" /><TD><IMG SRC="/doc/info/g_rad90.png" /></td></td></td></td></tr>
<TR><TD align=center>180<TD><IMG SRC="/doc/info/g_lin180.png" /><TD ALIGN="CENTER"><IMG SRC="/doc/info/g_wlin180.png" /><TD><IMG SRC="/doc/info/g_rad180.png" /></td></td></td></td></tr>
<TR><TD align=center>270<TD><IMG SRC="/doc/info/g_lin270.png" /><TD ALIGN="CENTER"><IMG SRC="/doc/info/g_wlin270.png" /><TD><IMG SRC="/doc/info/g_rad270.png" /></td></td></td></td></tr>
<TR><TD align=center>360<TD><IMG SRC="/doc/info/g_lin360.png" /><TD ALIGN="CENTER"><IMG SRC="/doc/info/g_wlin360.png" /><TD><IMG SRC="/doc/info/g_rad360.png" /></td></td></td></td></tr>
</table>
<DT><A NAME=kdirType><STRONG>dirType</strong></a>
<DD>For an edge <CODE>T -> H;</code>
<TABLE>
<TR><TD>"forward"<TD><IMG SRC="/doc/info/forward.gif" />
<TD>"back"<TD><IMG SRC="/doc/info/back.gif" /></td></td></td></td></tr>
<TR><TD>"both"<TD><IMG SRC="/doc/info/both.gif" />
<TD>"none"<TD><IMG SRC="/doc/info/nohead.gif" /></td></td></td></td></tr>
</table>
That is, a glyph is drawn at the head end of an edge if and only
if dirType is "forward" or "both";
a glyph is drawn at the tail end of an edge if and only
if dirType is "back" or "both";
<P>
For undirected edges <CODE>T -- H;</code>, one of the nodes, usually
the righthand one, is treated as the head for the purpose of
interpreting "forward" and "back".
<DT><A NAME=kdoubleList><STRONG>doubleList</strong></a>
<DD>A colon-separated list of doubles: "<I>%f</i>(:<I>%f</i>)*"
where each <I>%f</i> is a double.
<DT><A NAME=kescString><STRONG>escString</strong></a>
<DD>string allowing escape sequences which are replaced according
to the context.
For node attributes, the substring "\N" is replaced by the name of the node,
and the substring "\G" by the name of the graph.
For graph or cluster attributes, the substring "\G" is replaced by the
name of the graph or cluster.
For edge attributes, the substring "\E" is replaced by the name of the edge,
the substring "\G" is replaced by the name of the graph or cluster,
and the substrings "\T" and "\H" by the names of
the tail and head nodes, respectively.
The name of an edge is the string formed from the name of the
tail node, the appropriate edge operator ("--" or "->") and the name of the
head node.
In all cases, the substring "\L" is replaced by the object's label attribute.
<P>
In addition, if the associated attribute is
<A HREF=#alabel>label</a>,
<A HREF=#aheadlabel>headlabel</a> or <A HREF=#ataillabel>taillabel</a>,
the escape sequences "\n", "\l" and "\r"
divide the label into lines, centered, left-justified, and right-justified,
respectively.
<DT><A NAME=klayerList><STRONG>layerList</strong></a>
<DD>list of strings separated by characters from the
<A HREF=#alayersep>layersep</a> attribute (by default, colons,
tabs or spaces), defining <A HREF=#alayer>layer</a>
names and implicitly numbered 1,2,...
<DT><A NAME=klayerRange><STRONG>layerRange</strong></a>
<DD>specifies a list of layers defined by the <A HREF=#alayers>layers</a> attribute.
It consists of a list of layer intervals separated by any collection of characters from
the <A HREF=#alayerlistsep>layerlistsep</a> attribute.
Each layer interval is specified as either a
layerId or a layerId<B>s</b>layerId<BR />, where layerId = "all",
a decimal integer or a <A HREF=#alayer>layer</a> name.
(An integer i corresponds to layer i, layers being numbered from 1.)
The string <B>s</b> consists of 1 or more separator characters specified
by the <A HREF=#alayersep>layersep</a> attribute.
<P>
Thus, assuming the default values for <A HREF=#alayersep>layersep</a>
and <A HREF=#alayerlistsep>layerlistsep</a>, if <TT>layers="a:b:c:d:e:f:g:h"</tt>, the
layerRange string <TT>layers="a:b,d,f:all"</tt> would denote the layers
<TT>a b d f g h"</tt>.
<DT><A NAME=klblString><STRONG>lblString</strong></a>
<DD>an <A HREF=#kescString>escString</a>
or an <A HREF=node-shapes#html>HTML label</a>.
<DT><A NAME=koutputMode><STRONG>outputMode</strong></a>
<DD>"breadthfirst","nodesfirst","edgesfirst"
These specify the order in which nodes and edges are drawn in concrete
output. The default "breadthfirst" is the simplest, but when the graph
layout does not avoid edge-node overlap, this mode will sometimes have
edges drawn over nodes and sometimes on top of nodes. If the mode
"nodesfirst" is chosen, all nodes are drawn first, followed by the
edges. This guarantees an edge-node overlap will not be mistaken for
an edge ending at a node. On the other hand, usually for aesthetic
reasons, it may be desirable that all edges appear beneath nodes, even
if the resulting drawing is ambiguous. This can be achieved by choosing
"edgesfirst".
<DT><A NAME=kpackMode><STRONG>packMode</strong></a>
<DD>"node", "clust" , "graph" , "array(_<I>flags</i>)?(%d)?"
<P>
The modes "node", "clust" or "graph"
specify that the components should be packed together tightly, using
the specified granularity.
A value of "node" causes
packing at the node and edge level, with no overlapping of these objects.
This produces a layout with the least area, but it also allows interleaving,
where a node of one component may lie between two nodes in another
component. A value of "graph" does a packing using the bounding box of the
component. Thus, there will be a rectangular region around a component
free of elements of any other component.
A value of "clust" guarantees that top-level clusters are kept intact.
What effect a value has also depends on the layout algorithm. For
example, neato does not support clusters, so a value of "clust" will
have the same effect as the default "node" value.
</p><P>
The mode "array(_<I>flag</i>)?(%d)?"
indicates that the components should be packed at the
graph level into an array of graphs. By default, the components
are in row-major order, with the number of columns roughly the
square root of the number of components. If the optional flags
contains 'c', then column-major order is used. Finally, if the
optional integer suffix is used, this specifies the number of
columns for row-major or the number of rows for column-major.
Thus, the mode "array_c4" indicates array packing, with 4 rows,
starting in the upper left and going down the first column, then
down the second column, etc., until all components are used.
</p><P>
If a graph is smaller than the array cell it occupies, it is centered by default.
The optional flags may contain 't', 'b', 'l', or 'r', indicating that the graphs
should be aligned along the top, bottom, left or right, respectively.
</p><P>
If the optional flags contains 'u', this causes the insertion
order of elements in the array to be determined by user-supplied
values. Each component can specify its sort value by a
non-negative integer using the <A HREF="#dsortv">sortv</a> attribute.
Components are
inserted in order, starting with the one with the smallest
sort value. If no sort value is specified, zero is used.
<DT><A NAME=kpagedir><STRONG>pagedir</strong></a>
<DD>"BL", "BR", "TL", "TR", "RB", "RT", "LB", "LT".
These specify the 8 row or column major orders for traversing a
rectangular array, the first character corresponding to the major
order and the second to the minor order. Thus, for "BL", the
major order is from bottom to top, and the minor order is from left
to right. This means the bottom row is traversed first, from left
to right, then the next row up, from left to right, and so on,
until the topmost row is traversed.
<DT><A NAME=kpoint><STRONG>point</strong></a>
<DD>"%f,%f('!')?" representing the point (x,y). The
optional '!' indicates the
node position should not change (input-only).
<P>
If <A HREF=#ddim>dim</a> is 3, <B>point</b> may also have
the format "%f,%f,%f('!')?" to represent the point (x,y,z).
<DT><A NAME=kpointList><STRONG>pointList</strong></a>
<DD>A list of points, separated by spaces.
<DT><A NAME=kportPos><STRONG>portPos</strong></a>
<DD>modifier indicating where on a node an edge should be aimed.
It has the form <TT><I>portname</i>(:<I>compass_point</i>)?</tt>
or <TT><I>compass_point</i></tt>.
If the first form is used, the corresponding node must either have
<A HREF=node-shapes#record>record</a> shape with one of its fields
having the given <I>portname</i>,
or have an <A HREF=node-shapes#html>HTML-like label</a>, one of
whose components has a <TT>PORT</tt> attribute set to <I>portname</i>.
<P>
If a compass point is used, it must have the form
<TT>"n","ne","e","se","s","sw","w","nw","c","_"</tt>. This modifies the edge
placement to aim for the corresponding compass point on the port or,
in the second form where no <I>portname</i> is supplied, on the node
itself. The compass point "c" specifies the center of the node or port.
The compass point "_" specifies that an appropriate side of the port
adjacent to the exterior of the node should be used, if such exists.
Otherwise, the center is used.
If no compass point is used with a portname, the default value is "_".
</p><P>
</p><P>
This attribute can be attached to an edge using the
<A HREF=#dheadport>headport</a> and
<A HREF=#dtailport>tailport</a> attributes, or as part of the
edge description as in
<CENTER>
<TT>node1:port1 -> node2:port5:nw;</tt>
</center>
</p><P>
Note that it is legal to have a portname the same as one of
the compass points. In this case, this reference will be resolved to
the port. Thus, if node <TT>A</tt> has a port <TT>w</tt>, then
<TT>headport=w</tt> will refer to the port and not the compass point.
At present, in this case, there is no way to specify that the compass
point should be used.
<DT><A NAME=kquadType><STRONG>quadType</strong></a>
<DD>"normal", "fast", "none".
<P>
Using "fast" gives about a 2-4 times overall speedup compared with "normal",
though layout quality can suffer a little.
<DT><A NAME=krankType><STRONG>rankType</strong></a>
<DD>"same", "min", "source", "max", "sink"
<DT><A NAME=krankdir><STRONG>rankdir</strong></a>
<DD>"TB", "LR", "BT", "RL", corresponding to directed graphs drawn
from top to bottom, from left to right, from bottom to top, and from
right to left, respectively.
<DT><A NAME=krect><STRONG>rect</strong></a>
<DD>"%f,%f,%f,%f" The rectangle llx,lly,urx,ury gives the coordinates, in
points, of the lower-left corner (llx,lly) and the upper-right corner
(urx,ury).
<DT><A NAME=kshape><STRONG>shape</strong></a>
<DD>A string specifying the <A HREF=node-shapes>shape</a> of a node.
There are three
main types of shapes :
<A HREF=node-shapes#polygon>polygon-based</a>,
<A HREF=node-shapes#record>record-based</a> and
<A HREF=node-shapes#epsf>user-defined</a>.
The record-based shape has largely been superseded and greatly generalized
by <A HREF=node-shapes#html>HTML-like labels</a>.
That is, instead of using <TT>shape=record</tt>, one might
consider using <TT>shape=none</tt> and an HTML-like label.
<DT><A NAME=ksmoothType><STRONG>smoothType</strong></a>
<DD>Values are "none", "avg_dist", "graph_dist", "power_dist", "rng",
"spring" and "triangle".
<DT><A NAME=ksplineType><STRONG>splineType</strong></a>
<DD>spline ( ';' spline )*<BR />
<TABLE>
<TR><TD ALIGN=right>where spline<TD>=<TD>(endp)? (startp)? point (triple)+</td></td></td></tr>
<TR><TD ALIGN=right>and triple<TD>=<TD>point point point</td></td></td></tr>
<TR><TD ALIGN=right>and endp<TD>=<TD>"e,%f,%f"</td></td></td></tr>
<TR><TD ALIGN=right>and startp<TD>=<TD>"s,%f,%f"</td></td></td></tr>
</table>
If a spline has points p<SUB>1</sub> p<SUB>2</sub> p<SUB>3</sub> ... p<SUB>n</sub>, (n = 1 (mod 3)), the points
correspond to the control points of a cubic B-spline from p<SUB>1</sub> to p<SUB>n</sub>. If startp
is given, it touches one node of the edge, and the arrowhead
goes from p<SUB>1</sub> to startp. If startp is not given, p<SUB>1</sub> touches a node.
Similarly for p<SUB>n</sub> and endp.
<DT><A NAME=kstartType><STRONG>startType</strong></a>
<DD>has the syntax <TT>(<I>style</i>)?(<I>seed</i>)?</tt>.
<P>
If <I>style</i> is present, it must be one of the strings <TT>"regular"</tt>,
<TT>"self"</tt>, or <TT>"random"</tt>. In the first case, the nodes are
placed regularly about a circle. In the second case,
an abbreviated version of neato is run to obtain the initial layout.
In the last case, the nodes are placed randomly in a unit square.
</p><P>
If <I>seed</i> is present, it specifies a seed for the random number
generator. If <I>seed</i> is a positive number, this is used as the
seed. If it is anything else,
the current time, and possibly the process id, is used to pick a seed,
thereby making the choice more random. In this case, the seed value
is stored in the graph.
</p><P>
If the value is just <TT>"random"</tt>, a time-based seed is chosen.
</p><P>
Note that input positions, specified by a node's
<A HREF=#dpos>pos</a>
attribute, are only used when the style is <TT>"random"</tt>.
<DT><A NAME=kstyle><STRONG>style</strong></a>
<DD>styleItem ( ',' styleItem )*<BR />
<TABLE>
<TR><TD ALIGN=right>where styleItem<TD>=<TD>name or name'('args')'</td></td></td></tr>
<TR><TD ALIGN=right>and args<TD>=<TD>name ( ',' name )*</td></td></td></tr>
</table>
and name can be any string of characters not containing a space, a left or
right parenthesis, or a comma.
Note that whitespace characters are ignored.
<P>
<B>NOTE:</b><EM>The styles <tt>tapered, striped</tt> and <tt>wedged</tt>
are only available in release 2.30 and later.</em>
</p><P>
At present, the recognized style names are
"dashed", "dotted", "solid", "invis" and "bold" for nodes and edges,
"tapered" for edges only,
and "filled", "striped", "wedged", "diagonals" and "rounded" for nodes only.
The styles "filled", "striped" and "rounded" are recognized for clusters.
The style "radial" is recognized for nodes, clusters and graphs, and indicates a
radial-style gradient fill if applicable.
</p><P>
The style "striped" causes the
fill to be done as a set of vertical stripes. The colors are specified via a <A HREF=#kcolorList>colorList</a>,
the colors drawn from left to right in list order. Optional color weights can be specified to indicate the
proportional widths of the bars. If the sum of the weights is less than 1, the remainder is divided evenly
among the colors with no weight. <B>Note</b>: The style "striped" is only supported with clusters and
rectangularly-shaped nodes.
</p><P>
The style "wedged" causes the
fill to be done as a set of wedges. The colors are specified via a <A HREF=#kcolorList>colorList</a>,
with the colors drawn counter-clockwise starting at angle 0. Optional color weights are interpreted
analogously to the striped case described above.
<B>Note</b>: The style "wedged" is allowed only for elliptically-shaped nodes.
</p><P>
The following tables illustrate some of the effects of the style settings.
Examples of tapered line styles are given below.
Examples of linear and radial gradient fill can be seen under <A HREF=#kcolorList>colorList</a>.
</p><P>
<TABLE border=1>
<TR><TD align="center"><tt>solid</tt><TD align="center"><tt>dashed</tt><TD align="center"><tt>dotted</tt><TD align="center"><tt>bold</tt><TD align="center"><tt>rounded</tt><TD align="center"><tt>diagonals</tt><TD align="center"><tt>filled</tt><TD align="center"><tt>striped</tt><TD align="center"><tt>wedged</tt></td></td></td></td></td></td></td></td></td></tr>
<TR><TD><IMG SRC="/doc/info/n_solid.png" /><TD><IMG SRC="/doc/info/n_dashed.png" /><TD><IMG SRC="/doc/info/n_dotted.png" /><TD><IMG SRC="/doc/info/n_bold.png" /><TD><IMG SRC="/doc/info/n_rounded.png" /><TD><IMG SRC="/doc/info/n_diagonals.png" /><TD><IMG SRC="/doc/info/n_filled.png" /><TD><IMG SRC="/doc/info/n_striped.png" /><TD><IMG SRC="/doc/info/n_wedged.png" /></td></td></td></td></td></td></td></td></td></tr>
<CAPTION>Basic style settings for nodes</caption>
</table>
</p><P>
<TABLE border=1>
<TR><TD align="center"><tt>solid</tt><TD align="center"><tt>dashed</tt><TD align="center"><tt>dotted</tt><TD align="center"><tt>bold</tt></td></td></td></td></tr>
<TR><TD><IMG SRC="/doc/info/e_solid.png" /><TD><IMG SRC="/doc/info/e_dashed.png" /><TD><IMG SRC="/doc/info/e_dotted.png" /><TD><IMG SRC="/doc/info/e_bold.png" /></td></td></td></td></tr>
<CAPTION>Basic style settings for edges</caption>
</table>
</p><P>
<TABLE border=1>
<TR><TD align="center"><tt>solid</tt><TD align="center"><tt>dashed</tt><TD align="center"><tt>dotted</tt><TD align="center"><tt>bold</tt><TD align="center"><tt>rounded</tt><TD align="center"><tt>filled</tt><TD align="center"><tt>striped</tt></td></td></td></td></td></td></td></tr>
<TR><TD><IMG SRC="/doc/info/c_solid.png" /><TD><IMG SRC="/doc/info/c_dashed.png" /><TD><IMG SRC="/doc/info/c_dotted.png" /><TD><IMG SRC="/doc/info/c_bold.png" /><TD><IMG SRC="/doc/info/c_rounded.png" /><TD><IMG SRC="/doc/info/c_filled.png" /><TD><IMG SRC="/doc/info/c_striped.png" /></td></td></td></td></td></td></td></tr>
<CAPTION>Basic style settings for clusters</caption>
</table>
</p><P>
The effect of <tt>style=tapered</tt> depends on the <A HREF=#dpenwidth>penwidth</a>,
<A HREF=#ddir>dir</a>, <A HREF=#darrowhead>arrowhead</a> and <A HREF=#darrowtail>arrowtail</a> attributes.
The edge starts with width <tt>penwidth</tt> and tapers to width 1, in points. The <tt>dir</tt> attribute
determines whether the tapering goes from tail to head (<tt>dir=forward</tt>), from head to
tail (<tt>dir=forward</tt>), from the middle to both the head and tail (<tt>dir=both</tt>), or no
tapering at all (<tt>dir=none</tt>). If the <tt>dir</tt> is not explicitly set, the default for the
graph type is used (see <A HREF=#adir>dir</a>). Arrowheads and arrowtails are also drawn, based on the
value of <tt>dir</tt>; to avoid this, set <tt>arrowhead</tt> and/or <TT>arrowtail</tt> to <TT>"none"</tt>.
</p><P>
<B>Note:</b> At present, the tapered style only allows a simple filled polygon.
Additional styles such as <TT>dotted</tt> or <TT>dashed</tt>, or multiple colors
supplied via a <A HREF=#kcolorList>colorList</a> are ignored.
</p><P>
The following table illustrates the <tt>style=tapered</tt> with <tt>penwidth=7</tt> and
<tt>arrowtail=none</tt>.
<TABLE border=1>
<TR><TD><tt>arrowhead</tt> \ <tt>dir</tt><TD align="center"><tt>forward</tt><TD align="center"><tt>back</tt><TD align="center"><tt>both</tt><TD align="center"><tt>none</tt></td></td></td></td></td></tr>
<TR><TD><tt>normal</tt><TD><IMG SRC="/doc/info/normal_forward.png" /><TD><IMG SRC="/doc/info/normal_back.png" /><TD><IMG SRC="/doc/info/normal_both.png" /><TD><IMG SRC="/doc/info/normal_none.png" /></td></td></td></td></td></tr>
<TR><TD><tt>none</tt><TD><IMG SRC="/doc/info/none_forward.png" /><TD><IMG SRC="/doc/info/none_back.png" /><TD><IMG SRC="/doc/info/none_both.png" /><TD><IMG SRC="/doc/info/none_none.png" /></td></td></td></td></td></tr>
</table>
</p><P>
Additional styles are available in
device-dependent form. Style lists are passed to device drivers, which
can use this to generate appropriate output.
</p><P>
The style attribute affects the basic appearance of nodes, edges and graphs,
but has no effect on any text used in labels. For this, use the <A HREF=#dfontname><TT>fontname</tt></a>, <A HREF=#dfontsize><TT>fontsize</tt></a> and <A HREF=#dfontcolor><TT>fontcolor</tt></a>
attributes, or the <TT><FONT></tt>, <TT><B></tt>, <TT><I></tt>, etc.
elements in <A HREF=node-shapes#html>HTML-like labels</a>.
</p><P>
The <TT>setlinewidth</tt> style value can be
used for more control over the width of node borders and edges than is
allowed by <TT>bold</tt>. This style value takes an argument, specifying the
width of the line in <A HREF=#points>points</a>. For example, <TT>style="bold"</tt> is
equivalent to <TT>style="setlinewidth(2)"</tt>.
<B>The use of <TT>setlinewidth</tt> is deprecated; one should use the
<A HREF=#dpenwidth><TT>penwidth</tt></a> attribute instead.</b>
<DT><A NAME=kviewPort><STRONG>viewPort</strong></a>
<DD>"%lf,%lf,%lf,%lf,%lf" or "%lf,%lf,%lf,'%s'"
<P>
The viewPort <TT>W,H,Z,x,y</tt> or <TT>W,H,Z,N</tt>
specifies a viewport for the final image. The pair (W,H) gives the
dimensions (width and height) of the final image, in
<A HREF=#points>points</a>.
The optional Z is the zoom factor, i.e., the image in the original layout will be
W/Z by H/Z points in size. By default, Z is 1.
The optional last part is either a pair (x,y) giving a position in the original layout of the
graph, in
<A HREF=#points>points</a>, of the center of the viewport, or the name N
of a node whose center should used as the focus.
By default, the focus is the center of the graph bounding box, i.e.,
(bbx/2,bby/2), where "bbx,bby" is the
value of the bounding box attribute <A HREF=#a:bb>bb</a>.
</p><P>
Sample values: <TT>50,50,.5,'2.8 BSD' or <TT>100,100,2,450,300</tt>.
The first will take the 100x100 point square centered on the node <TT>2.8 BSD</tt>
and scale it down by 0.5, yielding a 50x50 point final image.
</tt></p></dd></dt></p></dd></dt></p></dd></dt></dd></dt></dd></dt></dd></dt></dd></dt></dd></dt></dd></dt></p></dd></dt></p></dd></dt></dd></dt></p></dd></dt></dd></dt></p></dd></dt></dd></dt></dd></dt></p></dd></dt></dd></dt></p></dd></dt></dd></dt></p></dd></dt></p></dd></dt></p></dd></dt></dd></dt></p></dd></dt></p></dd></dt></p></dd></dt></dl>
</p></div>
</div>
<div class="block block-comment" id="block-comment-0">
<h2 class="title">Recent comments</h2>
<div class="content"><div class="item-list"><ul><li class="first"><a href="/content/gvfreelayout-and-bb-attribute#comment-1552">gvFreeLayout</a><br />5 hours 16 min ago</li>
<li><a href="/content/gvfreelayout-and-bb-attribute#comment-1551">Can you be more specific as</a><br />6 hours 19 min ago</li>
<li><a href="/content/xdot-versions-etc#comment-1550">I don't understand. Anyone</a><br />7 hours 52 min ago</li>
<li><a href="/content/xdot-versions-etc#comment-1549">It looks somehow complicated</a><br />16 hours 3 min ago</li>
<li><a href="/content/mindist-circo-not-working-library#comment-1548">Your patch has been applied.</a><br />2 days 3 hours ago</li>
<li><a href="/content/img-tag-padding#comment-1547">workaround: downgrade to 2.20.2, bug #2397 opened</a><br />2 days 7 hours ago</li>
<li><a href="/content/img-tag-padding#comment-1546">this is regression since graphviz 2.20.2</a><br />2 days 10 hours ago</li>
<li><a href="/content/graphviz-iphone#comment-1543">Graphviz on iPhone</a><br />4 days 12 hours ago</li>
<li><a href="/content/using-gvmap-library#comment-1542">You can certainly modify and</a><br />1 week 1 day ago</li>
<li class="last"><a href="/content/xdot-versions-etc#comment-1541">Future features should be</a><br />1 week 1 day ago</li>
</ul></div></div>
</div>
</div>
</td>
<td id="sidebar-right">
<div class="block block-forum" id="block-forum-1">
<h2 class="title">New forum topics</h2>
<div class="content"><div class="item-list"><ul><li class="first"><a href="/content/gvfreelayout-and-bb-attribute" title="2 comments">gvFreeLayout and bb attribute</a></li>
<li><a href="/content/gvfreelayout-leakage">gvFreeLayout leakage</a></li>
<li><a href="/content/mindist-circo-not-working-library" title="1 comment">Mindist in Circo not working (library)</a></li>
<li><a href="/content/using-gvmap-library" title="1 comment">using gvmap as a library</a></li>
<li class="last"><a href="/content/xdot-versions-etc" title="7 comments">xdot versions etc</a></li>
</ul></div><div class="more-link"><a href="/forum" title="Read the latest forum topics.">more</a></div></div>
</div>
</td> </tr>
</table>
<div id="footer">
</div>
</body>
</html>