Mercurial > hg > camir-aes2014
diff toolboxes/graph_visualisation/share/graphviz/doc/html/info/attrs.html @ 0:e9a9cd732c1e tip
first hg version after svn
author | wolffd |
---|---|
date | Tue, 10 Feb 2015 15:05:51 +0000 |
parents | |
children |
line wrap: on
line diff
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/toolboxes/graph_visualisation/share/graphviz/doc/html/info/attrs.html Tue Feb 10 15:05:51 2015 +0000 @@ -0,0 +1,2087 @@ +<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML//EN"> +<!-- + This is a generated document. Do not edit. +--> +<HTML VERSION="2.0"> +<HEAD> +<TITLE>Node, Edge and Graph Attributes</TITLE> +</HEAD> +<BODY BGCOLOR=white> +<A NAME="top"></A> +<H1 align=CENTER>Node, Edge and Graph Attributes</H1> +<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> +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></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></TR> +</TABLE> +Further details concerning the setting of attributes can be found +in the description of the +<A HREF="http://www.graphviz.org/doc/info/lang.html">DOT language.</A> +<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> +<A NAME=h:undir_note><STRONG>Note:</STRONG></A> Some attributes, such as +<A HREF=#d:dir>dir</A> or <A HREF=#d:arrowtail>arrowtail</A>, are +ambiguous when used in +<A HREF="http://www.graphviz.org/doc/info/lang.html">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="http://www.graphviz.org/doc/info/lang.html">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></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=#d:dir>dir</A>, <A HREF=#d:arrowtail>arrowtail</A> +or <A HREF=#d:arrowhead>arrowhead</A> attributes. +<P> +The tools accept standard C representations for <EM>int</EM> and +<EM>double</EM> types. +For the <A NAME=k:bool><EM>bool</EM></A> type, TRUE values are +represented by "true" (case-insensitive) +and any non-zero integer, and FALSE values by "false" (case-insensitive) +and zero. +In addition, there are a variety of specialized types such as +<EM>arrowType</EM>, <EM>color</EM>, +<EM>pointf</EM> and <EM>rankdir</EM>. Legal values for these types are given +at the end. +<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>Default</TH><TH>Minimum</TH><TH>Notes</TH></TR> + <TR><TD><A NAME=a:Damping HREF=#d:Damping>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=a:K HREF=#d:K>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=a:URL HREF=#d:URL>URL</A> +</TD><TD>ENGC</TD><TD><A HREF=#k:escString>escString</A> +</TD><TD ALIGN="CENTER"><none></TD><TD></TD><TD>svg, postscript, map only</TD> </TR> + <TR><TD><A NAME=a:arrowhead HREF=#d:arrowhead>arrowhead</A> +</TD><TD>E</TD><TD><A HREF=#k:arrowType>arrowType</A> +</TD><TD ALIGN="CENTER">normal</TD><TD></TD><TD></TD> </TR> + <TR><TD><A NAME=a:arrowsize HREF=#d:arrowsize>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=a:arrowtail HREF=#d:arrowtail>arrowtail</A> +</TD><TD>E</TD><TD><A HREF=#k:arrowType>arrowType</A> +</TD><TD ALIGN="CENTER">normal</TD><TD></TD><TD></TD> </TR> + <TR><TD><A NAME=a:aspect HREF=#d:aspect>aspect</A> +</TD><TD>G</TD><TD><A HREF=#k:aspectType>aspectType</A> +</TD><TD ALIGN="CENTER"></TD><TD></TD><TD>dot only</TD> </TR> + <TR><TD><A NAME=a:bb HREF=#d:bb>bb</A> +</TD><TD>G</TD><TD><A HREF=#k:rect>rect</A> +</TD><TD ALIGN="CENTER"></TD><TD></TD><TD>write only</TD> </TR> + <TR><TD><A NAME=a:bgcolor HREF=#d:bgcolor>bgcolor</A> +</TD><TD>GC</TD><TD><A HREF=#k:color>color</A> +</TD><TD ALIGN="CENTER"><none></TD><TD></TD><TD></TD> </TR> + <TR><TD><A NAME=a:center HREF=#d:center>center</A> +</TD><TD>G</TD><TD><A HREF=#k:bool>bool</A> +</TD><TD ALIGN="CENTER">false</TD><TD></TD><TD></TD> </TR> + <TR><TD><A NAME=a:charset HREF=#d:charset>charset</A> +</TD><TD>G</TD><TD>string</TD><TD ALIGN="CENTER">"UTF-8"</TD><TD></TD><TD></TD> </TR> + <TR><TD><A NAME=a:clusterrank HREF=#d:clusterrank>clusterrank</A> +</TD><TD>G</TD><TD><A HREF=#k:clusterMode>clusterMode</A> +</TD><TD ALIGN="CENTER">local</TD><TD></TD><TD>dot only</TD> </TR> + <TR><TD><A NAME=a:color HREF=#d:color>color</A> +</TD><TD>ENC</TD><TD><A HREF=#k:color>color</A> +<BR><A HREF=#k:colorList>colorList</A> +</TD><TD ALIGN="CENTER">black</TD><TD></TD><TD></TD> </TR> + <TR><TD><A NAME=a:colorscheme HREF=#d:colorscheme>colorscheme</A> +</TD><TD>ENCG</TD><TD>string</TD><TD ALIGN="CENTER">""</TD><TD></TD><TD></TD> </TR> + <TR><TD><A NAME=a:comment HREF=#d:comment>comment</A> +</TD><TD>ENG</TD><TD>string</TD><TD ALIGN="CENTER">""</TD><TD></TD><TD></TD> </TR> + <TR><TD><A NAME=a:compound HREF=#d:compound>compound</A> +</TD><TD>G</TD><TD><A HREF=#k:bool>bool</A> +</TD><TD ALIGN="CENTER">false</TD><TD></TD><TD>dot only</TD> </TR> + <TR><TD><A NAME=a:concentrate HREF=#d:concentrate>concentrate</A> +</TD><TD>G</TD><TD><A HREF=#k:bool>bool</A> +</TD><TD ALIGN="CENTER">false</TD><TD></TD><TD></TD> </TR> + <TR><TD><A NAME=a:constraint HREF=#d:constraint>constraint</A> +</TD><TD>E</TD><TD><A HREF=#k:bool>bool</A> +</TD><TD ALIGN="CENTER">true</TD><TD></TD><TD>dot only</TD> </TR> + <TR><TD><A NAME=a:decorate HREF=#d:decorate>decorate</A> +</TD><TD>E</TD><TD><A HREF=#k:bool>bool</A> +</TD><TD ALIGN="CENTER">false</TD><TD></TD><TD></TD> </TR> + <TR><TD><A NAME=a:defaultdist HREF=#d:defaultdist>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=a:dim HREF=#d:dim>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=a:dimen HREF=#d:dimen>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=a:dir HREF=#d:dir>dir</A> +</TD><TD>E</TD><TD><A HREF=#k:dirType>dirType</A> +</TD><TD ALIGN="CENTER">forward(directed)<BR>none(undirected)</TD><TD></TD><TD></TD> </TR> + <TR><TD><A NAME=a:diredgeconstraints HREF=#d:diredgeconstraints>diredgeconstraints</A> +</TD><TD>G</TD><TD>string<BR><A HREF=#k:bool>bool</A> +</TD><TD ALIGN="CENTER">false</TD><TD></TD><TD>neato only</TD> </TR> + <TR><TD><A NAME=a:distortion HREF=#d:distortion>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=a:dpi HREF=#d:dpi>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=a:edgeURL HREF=#d:edgeURL>edgeURL</A> +</TD><TD>E</TD><TD><A HREF=#k:escString>escString</A> +</TD><TD ALIGN="CENTER">""</TD><TD></TD><TD>svg, map only</TD> </TR> + <TR><TD><A NAME=a:edgehref HREF=#d:edgehref>edgehref</A> +</TD><TD>E</TD><TD><A HREF=#k:escString>escString</A> +</TD><TD ALIGN="CENTER">""</TD><TD></TD><TD>svg, map only</TD> </TR> + <TR><TD><A NAME=a:edgetarget HREF=#d:edgetarget>edgetarget</A> +</TD><TD>E</TD><TD><A HREF=#k:escString>escString</A> +</TD><TD ALIGN="CENTER"><none></TD><TD></TD><TD>svg, map only</TD> </TR> + <TR><TD><A NAME=a:edgetooltip HREF=#d:edgetooltip>edgetooltip</A> +</TD><TD>E</TD><TD><A HREF=#k:escString>escString</A> +</TD><TD ALIGN="CENTER">""</TD><TD></TD><TD>svg, cmap only</TD> </TR> + <TR><TD><A NAME=a:epsilon 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=a:esep HREF=#d:esep>esep</A> +</TD><TD>G</TD><TD>double<BR><A HREF=#k:pointf>pointf</A> +</TD><TD ALIGN="CENTER">+3</TD><TD></TD><TD>not dot</TD> </TR> + <TR><TD><A NAME=a:fillcolor HREF=#d:fillcolor>fillcolor</A> +</TD><TD>NC</TD><TD><A HREF=#k:color>color</A> +</TD><TD ALIGN="CENTER">lightgrey(nodes)<BR>black(clusters)</TD><TD></TD><TD></TD> </TR> + <TR><TD><A NAME=a:fixedsize HREF=#d:fixedsize>fixedsize</A> +</TD><TD>N</TD><TD><A HREF=#k:bool>bool</A> +</TD><TD ALIGN="CENTER">false</TD><TD></TD><TD></TD> </TR> + <TR><TD><A NAME=a:fontcolor HREF=#d:fontcolor>fontcolor</A> +</TD><TD>ENGC</TD><TD><A HREF=#k:color>color</A> +</TD><TD ALIGN="CENTER">black</TD><TD></TD><TD></TD> </TR> + <TR><TD><A NAME=a:fontname HREF=#d:fontname>fontname</A> +</TD><TD>ENGC</TD><TD>string</TD><TD ALIGN="CENTER">"Times-Roman"</TD><TD></TD><TD></TD> </TR> + <TR><TD><A NAME=a:fontnames HREF=#d:fontnames>fontnames</A> +</TD><TD>G</TD><TD>string</TD><TD ALIGN="CENTER">""</TD><TD></TD><TD>svg only</TD> </TR> + <TR><TD><A NAME=a:fontpath HREF=#d:fontpath>fontpath</A> +</TD><TD>G</TD><TD>string</TD><TD ALIGN="CENTER">system-dependent</TD><TD></TD><TD></TD> </TR> + <TR><TD><A NAME=a:fontsize HREF=#d:fontsize>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=a:group HREF=#d:group>group</A> +</TD><TD>N</TD><TD>string</TD><TD ALIGN="CENTER">""</TD><TD></TD><TD>dot only</TD> </TR> + <TR><TD><A NAME=a:headURL HREF=#d:headURL>headURL</A> +</TD><TD>E</TD><TD><A HREF=#k:escString>escString</A> +</TD><TD ALIGN="CENTER">""</TD><TD></TD><TD>svg, map only</TD> </TR> + <TR><TD><A NAME=a:headclip HREF=#d:headclip>headclip</A> +</TD><TD>E</TD><TD><A HREF=#k:bool>bool</A> +</TD><TD ALIGN="CENTER">true</TD><TD></TD><TD></TD> </TR> + <TR><TD><A NAME=a:headhref HREF=#d:headhref>headhref</A> +</TD><TD>E</TD><TD><A HREF=#k:escString>escString</A> +</TD><TD ALIGN="CENTER">""</TD><TD></TD><TD>svg, map only</TD> </TR> + <TR><TD><A NAME=a:headlabel HREF=#d:headlabel>headlabel</A> +</TD><TD>E</TD><TD><A HREF=#k:lblString>lblString</A> +</TD><TD ALIGN="CENTER">""</TD><TD></TD><TD></TD> </TR> + <TR><TD><A NAME=a:headport HREF=#d:headport>headport</A> +</TD><TD>E</TD><TD><A HREF=#k:portPos>portPos</A> +</TD><TD ALIGN="CENTER">center</TD><TD></TD><TD></TD> </TR> + <TR><TD><A NAME=a:headtarget HREF=#d:headtarget>headtarget</A> +</TD><TD>E</TD><TD><A HREF=#k:escString>escString</A> +</TD><TD ALIGN="CENTER"><none></TD><TD></TD><TD>svg, map only</TD> </TR> + <TR><TD><A NAME=a:headtooltip HREF=#d:headtooltip>headtooltip</A> +</TD><TD>E</TD><TD><A HREF=#k:escString>escString</A> +</TD><TD ALIGN="CENTER">""</TD><TD></TD><TD>svg, cmap only</TD> </TR> + <TR><TD><A NAME=a:height HREF=#d:height>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=a:href HREF=#d:href>href</A> +</TD><TD>E</TD><TD><A HREF=#k:escString>escString</A> +</TD><TD ALIGN="CENTER">""</TD><TD></TD><TD>svg, postscript, map only</TD> </TR> + <TR><TD><A NAME=a:id HREF=#d:id>id</A> +</TD><TD>GNE</TD><TD><A HREF=#k:lblString>lblString</A> +</TD><TD ALIGN="CENTER">""</TD><TD></TD><TD>svg, postscript, map only</TD> </TR> + <TR><TD><A NAME=a:image HREF=#d:image>image</A> +</TD><TD>N</TD><TD>string</TD><TD ALIGN="CENTER">""</TD><TD></TD><TD></TD> </TR> + <TR><TD><A NAME=a:imagescale HREF=#d:imagescale>imagescale</A> +</TD><TD>N</TD><TD><A HREF=#k:bool>bool</A> +<BR>string</TD><TD ALIGN="CENTER">false</TD><TD></TD><TD></TD> </TR> + <TR><TD><A NAME=a:label HREF=#d:label>label</A> +</TD><TD>ENGC</TD><TD><A HREF=#k:lblString>lblString</A> +</TD><TD ALIGN="CENTER">"\N" (nodes)<BR>"" (otherwise)</TD><TD></TD><TD></TD> </TR> + <TR><TD><A NAME=a:labelURL HREF=#d:labelURL>labelURL</A> +</TD><TD>E</TD><TD><A HREF=#k:escString>escString</A> +</TD><TD ALIGN="CENTER">""</TD><TD></TD><TD>svg, map only</TD> </TR> + <TR><TD><A NAME=a:labelangle HREF=#d:labelangle>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=a:labeldistance HREF=#d:labeldistance>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=a:labelfloat HREF=#d:labelfloat>labelfloat</A> +</TD><TD>E</TD><TD><A HREF=#k:bool>bool</A> +</TD><TD ALIGN="CENTER">false</TD><TD></TD><TD></TD> </TR> + <TR><TD><A NAME=a:labelfontcolor HREF=#d:labelfontcolor>labelfontcolor</A> +</TD><TD>E</TD><TD><A HREF=#k:color>color</A> +</TD><TD ALIGN="CENTER">black</TD><TD></TD><TD></TD> </TR> + <TR><TD><A NAME=a:labelfontname HREF=#d:labelfontname>labelfontname</A> +</TD><TD>E</TD><TD>string</TD><TD ALIGN="CENTER">"Times-Roman"</TD><TD></TD><TD></TD> </TR> + <TR><TD><A NAME=a:labelfontsize HREF=#d:labelfontsize>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=a:labelhref HREF=#d:labelhref>labelhref</A> +</TD><TD>E</TD><TD><A HREF=#k:escString>escString</A> +</TD><TD ALIGN="CENTER">""</TD><TD></TD><TD>svg, map only</TD> </TR> + <TR><TD><A NAME=a:labeljust HREF=#d:labeljust>labeljust</A> +</TD><TD>GC</TD><TD>string</TD><TD ALIGN="CENTER">"c"</TD><TD></TD><TD></TD> </TR> + <TR><TD><A NAME=a:labelloc HREF=#d:labelloc>labelloc</A> +</TD><TD>GC</TD><TD>string</TD><TD ALIGN="CENTER">"t"(clusters)<BR>"b"(root graphs)</TD><TD></TD><TD></TD> </TR> + <TR><TD><A NAME=aa:labelloc HREF=#dd:labelloc>labelloc</A> +</TD><TD>N</TD><TD>string</TD><TD ALIGN="CENTER">"c"(clusters)</TD><TD></TD><TD></TD> </TR> + <TR><TD><A NAME=a:labeltarget HREF=#d:labeltarget>labeltarget</A> +</TD><TD>E</TD><TD><A HREF=#k:escString>escString</A> +</TD><TD ALIGN="CENTER"><none></TD><TD></TD><TD>svg, map only</TD> </TR> + <TR><TD><A NAME=a:labeltooltip HREF=#d:labeltooltip>labeltooltip</A> +</TD><TD>E</TD><TD><A HREF=#k:escString>escString</A> +</TD><TD ALIGN="CENTER">""</TD><TD></TD><TD>svg, cmap only</TD> </TR> + <TR><TD><A NAME=a:landscape HREF=#d:landscape>landscape</A> +</TD><TD>G</TD><TD><A HREF=#k:bool>bool</A> +</TD><TD ALIGN="CENTER">false</TD><TD></TD><TD></TD> </TR> + <TR><TD><A NAME=a:layer HREF=#d:layer>layer</A> +</TD><TD>EN</TD><TD><A HREF=#k:layerRange>layerRange</A> +</TD><TD ALIGN="CENTER">""</TD><TD></TD><TD></TD> </TR> + <TR><TD><A NAME=a:layers HREF=#d:layers>layers</A> +</TD><TD>G</TD><TD><A HREF=#k:layerList>layerList</A> +</TD><TD ALIGN="CENTER">""</TD><TD></TD><TD></TD> </TR> + <TR><TD><A NAME=a:layersep HREF=#d:layersep>layersep</A> +</TD><TD>G</TD><TD>string</TD><TD ALIGN="CENTER">" :\t"</TD><TD></TD><TD></TD> </TR> + <TR><TD><A NAME=a:layout HREF=#d:layout>layout</A> +</TD><TD>G</TD><TD>string</TD><TD ALIGN="CENTER">""</TD><TD></TD><TD></TD> </TR> + <TR><TD><A NAME=a:len HREF=#d:len>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=a:levels HREF=#d:levels>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=a:levelsgap HREF=#d:levelsgap>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=a:lhead HREF=#d:lhead>lhead</A> +</TD><TD>E</TD><TD>string</TD><TD ALIGN="CENTER">""</TD><TD></TD><TD>dot only</TD> </TR> + <TR><TD><A NAME=a:lp HREF=#d:lp>lp</A> +</TD><TD>EGC</TD><TD><A HREF=#k:point>point</A> +</TD><TD ALIGN="CENTER"></TD><TD></TD><TD>write only</TD> </TR> + <TR><TD><A NAME=a:ltail HREF=#d:ltail>ltail</A> +</TD><TD>E</TD><TD>string</TD><TD ALIGN="CENTER">""</TD><TD></TD><TD>dot only</TD> </TR> + <TR><TD><A NAME=a:margin HREF=#d:margin>margin</A> +</TD><TD>NG</TD><TD>double<BR><A HREF=#k:pointf>pointf</A> +</TD><TD ALIGN="CENTER"><device-dependent></TD><TD></TD><TD></TD> </TR> + <TR><TD><A NAME=a:maxiter HREF=#d:maxiter>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=a:mclimit HREF=#d:mclimit>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=a:mindist HREF=#d:mindist>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=a:minlen HREF=#d:minlen>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=a:mode HREF=#d:mode>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=a:model HREF=#d:model>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=a:mosek HREF=#d:mosek>mosek</A> +</TD><TD>G</TD><TD><A HREF=#k:bool>bool</A> +</TD><TD ALIGN="CENTER">false</TD><TD></TD><TD>neato only</TD> </TR> + <TR><TD><A NAME=a:nodesep HREF=#d:nodesep>nodesep</A> +</TD><TD>G</TD><TD>double</TD><TD ALIGN="CENTER">0.25</TD><TD>0.02</TD><TD>dot only</TD> </TR> + <TR><TD><A NAME=a:nojustify HREF=#d:nojustify>nojustify</A> +</TD><TD>GCNE</TD><TD><A HREF=#k:bool>bool</A> +</TD><TD ALIGN="CENTER">false</TD><TD></TD><TD></TD> </TR> + <TR><TD><A NAME=a:normalize HREF=#d:normalize>normalize</A> +</TD><TD>G</TD><TD><A HREF=#k:bool>bool</A> +</TD><TD ALIGN="CENTER">false</TD><TD></TD><TD>not dot</TD> </TR> + <TR><TD><A NAME=a:nslimit HREF=#d:nslimit>nslimit</A> +<BR><A NAME=a:nslimit1 HREF=#d:nslimit1>nslimit1</A> +</TD><TD>G</TD><TD>double</TD><TD ALIGN="CENTER"></TD><TD></TD><TD>dot only</TD> </TR> + <TR><TD><A NAME=a:ordering HREF=#d:ordering>ordering</A> +</TD><TD>G</TD><TD>string</TD><TD ALIGN="CENTER">""</TD><TD></TD><TD>dot only</TD> </TR> + <TR><TD><A NAME=a:orientation HREF=#d:orientation>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=aa:orientation HREF=#dd:orientation>orientation</A> +</TD><TD>G</TD><TD>string</TD><TD ALIGN="CENTER">""</TD><TD></TD><TD></TD> </TR> + <TR><TD><A NAME=a:outputorder HREF=#d:outputorder>outputorder</A> +</TD><TD>G</TD><TD><A HREF=#k:outputMode>outputMode</A> +</TD><TD ALIGN="CENTER">breadthfirst</TD><TD></TD><TD></TD> </TR> + <TR><TD><A NAME=a:overlap HREF=#d:overlap>overlap</A> +</TD><TD>G</TD><TD>string<BR><A HREF=#k:bool>bool</A> +</TD><TD ALIGN="CENTER">true</TD><TD></TD><TD>not dot</TD> </TR> + <TR><TD><A NAME=a:overlap_scaling HREF=#d:overlap_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=a:pack HREF=#d:pack>pack</A> +</TD><TD>G</TD><TD><A HREF=#k:bool>bool</A> +<BR>int</TD><TD ALIGN="CENTER">false</TD><TD></TD><TD>not dot</TD> </TR> + <TR><TD><A NAME=a:packmode HREF=#d:packmode>packmode</A> +</TD><TD>G</TD><TD><A HREF=#k:packMode>packMode</A> +</TD><TD ALIGN="CENTER">node</TD><TD></TD><TD>not dot</TD> </TR> + <TR><TD><A NAME=a:pad HREF=#d:pad>pad</A> +</TD><TD>G</TD><TD>double<BR><A HREF=#k:pointf>pointf</A> +</TD><TD ALIGN="CENTER">0.0555 (4 points)</TD><TD></TD><TD></TD> </TR> + <TR><TD><A NAME=a:page HREF=#d:page>page</A> +</TD><TD>G</TD><TD><A HREF=#k:pointf>pointf</A> +</TD><TD ALIGN="CENTER"></TD><TD></TD><TD></TD> </TR> + <TR><TD><A NAME=a:pagedir HREF=#d:pagedir>pagedir</A> +</TD><TD>G</TD><TD><A HREF=#k:pagedir>pagedir</A> +</TD><TD ALIGN="CENTER">BL</TD><TD></TD><TD></TD> </TR> + <TR><TD><A NAME=a:pencolor HREF=#d:pencolor>pencolor</A> +</TD><TD>C</TD><TD><A HREF=#k:color>color</A> +</TD><TD ALIGN="CENTER">black</TD><TD></TD><TD></TD> </TR> + <TR><TD><A NAME=a:penwidth HREF=#d:penwidth>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=a:peripheries HREF=#d:peripheries>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=a:pin HREF=#d:pin>pin</A> +</TD><TD>N</TD><TD><A HREF=#k:bool>bool</A> +</TD><TD ALIGN="CENTER">false</TD><TD></TD><TD>fdp, neato only</TD> </TR> + <TR><TD><A NAME=a:pos HREF=#d:pos>pos</A> +</TD><TD>EN</TD><TD><A HREF=#k:point>point</A> +<BR><A HREF=#k:splineType>splineType</A> +</TD><TD ALIGN="CENTER"></TD><TD></TD><TD></TD> </TR> + <TR><TD><A NAME=a:quadtree HREF=#d:quadtree>quadtree</A> +</TD><TD>G</TD><TD><A HREF=#k:quadType>quadType</A> +<BR><A HREF=#k:bool>bool</A> +</TD><TD ALIGN="CENTER">"normal"</TD><TD></TD><TD>sfdp only</TD> </TR> + <TR><TD><A NAME=a:quantum HREF=#d:quantum>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=a:rank HREF=#d:rank>rank</A> +</TD><TD>S</TD><TD><A HREF=#k:rankType>rankType</A> +</TD><TD ALIGN="CENTER"></TD><TD></TD><TD>dot only</TD> </TR> + <TR><TD><A NAME=a:rankdir HREF=#d:rankdir>rankdir</A> +</TD><TD>G</TD><TD><A HREF=#k:rankdir>rankdir</A> +</TD><TD ALIGN="CENTER">TB</TD><TD></TD><TD>dot only</TD> </TR> + <TR><TD><A NAME=a:ranksep HREF=#d:ranksep>ranksep</A> +</TD><TD>G</TD><TD>double</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=a:ratio HREF=#d:ratio>ratio</A> +</TD><TD>G</TD><TD>double<BR>string</TD><TD ALIGN="CENTER"></TD><TD></TD><TD></TD> </TR> + <TR><TD><A NAME=a:rects HREF=#d:rects>rects</A> +</TD><TD>N</TD><TD><A HREF=#k:rect>rect</A> +</TD><TD ALIGN="CENTER"></TD><TD></TD><TD>write only</TD> </TR> + <TR><TD><A NAME=a:regular HREF=#d:regular>regular</A> +</TD><TD>N</TD><TD><A HREF=#k:bool>bool</A> +</TD><TD ALIGN="CENTER">false</TD><TD></TD><TD></TD> </TR> + <TR><TD><A NAME=a:remincross HREF=#d:remincross>remincross</A> +</TD><TD>G</TD><TD><A HREF=#k:bool>bool</A> +</TD><TD ALIGN="CENTER">false</TD><TD></TD><TD>dot only</TD> </TR> + <TR><TD><A NAME=a:repulsiveforce HREF=#d:repulsiveforce>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=a:resolution HREF=#d:resolution>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=a:root HREF=#d:root>root</A> +</TD><TD>GN</TD><TD>string<BR><A HREF=#k:bool>bool</A> +</TD><TD ALIGN="CENTER">""(graphs)<BR>false(nodes)</TD><TD></TD><TD>circo, twopi only</TD> </TR> + <TR><TD><A NAME=a:rotate HREF=#d:rotate>rotate</A> +</TD><TD>G</TD><TD>int</TD><TD ALIGN="CENTER">0</TD><TD></TD><TD></TD> </TR> + <TR><TD><A NAME=a:samehead HREF=#d:samehead>samehead</A> +</TD><TD>E</TD><TD>string</TD><TD ALIGN="CENTER">""</TD><TD></TD><TD>dot only</TD> </TR> + <TR><TD><A NAME=a:sametail HREF=#d:sametail>sametail</A> +</TD><TD>E</TD><TD>string</TD><TD ALIGN="CENTER">""</TD><TD></TD><TD>dot only</TD> </TR> + <TR><TD><A NAME=a:samplepoints HREF=#d:samplepoints>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=a:searchsize HREF=#d:searchsize>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=a:sep HREF=#d:sep>sep</A> +</TD><TD>G</TD><TD>double<BR><A HREF=#k:pointf>pointf</A> +</TD><TD ALIGN="CENTER">+4</TD><TD></TD><TD>not dot</TD> </TR> + <TR><TD><A NAME=a:shape HREF=#d:shape>shape</A> +</TD><TD>N</TD><TD><A HREF=#k:shape>shape</A> +</TD><TD ALIGN="CENTER">ellipse</TD><TD></TD><TD></TD> </TR> + <TR><TD><A NAME=a:shapefile HREF=#d:shapefile>shapefile</A> +</TD><TD>N</TD><TD>string</TD><TD ALIGN="CENTER">""</TD><TD></TD><TD></TD> </TR> + <TR><TD><A NAME=a:showboxes HREF=#d:showboxes>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=a:sides HREF=#d:sides>sides</A> +</TD><TD>N</TD><TD>int</TD><TD ALIGN="CENTER">4</TD><TD>0</TD><TD></TD> </TR> + <TR><TD><A NAME=a:size HREF=#d:size>size</A> +</TD><TD>G</TD><TD><A HREF=#k:pointf>pointf</A> +</TD><TD ALIGN="CENTER"></TD><TD></TD><TD></TD> </TR> + <TR><TD><A NAME=a:skew HREF=#d:skew>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=a:smoothing HREF=#d:smoothing>smoothing</A> +</TD><TD>G</TD><TD><A HREF=#k:smoothType>smoothType</A> +</TD><TD ALIGN="CENTER">"none"</TD><TD></TD><TD>sfdp only</TD> </TR> + <TR><TD><A NAME=a:sortv HREF=#d:sortv>sortv</A> +</TD><TD>GCN</TD><TD>int</TD><TD ALIGN="CENTER">0</TD><TD>0</TD><TD></TD> </TR> + <TR><TD><A NAME=a:splines HREF=#d:splines>splines</A> +</TD><TD>G</TD><TD><A HREF=#k:bool>bool</A> +<BR>string</TD><TD ALIGN="CENTER"></TD><TD></TD><TD></TD> </TR> + <TR><TD><A NAME=a:start HREF=#d:start>start</A> +</TD><TD>G</TD><TD><A HREF=#k:startType>startType</A> +</TD><TD ALIGN="CENTER">""</TD><TD></TD><TD>fdp, neato only</TD> </TR> + <TR><TD><A NAME=a:style HREF=#d:style>style</A> +</TD><TD>ENC</TD><TD><A HREF=#k:style>style</A> +</TD><TD ALIGN="CENTER"></TD><TD></TD><TD></TD> </TR> + <TR><TD><A NAME=a:stylesheet HREF=#d:stylesheet>stylesheet</A> +</TD><TD>G</TD><TD>string</TD><TD ALIGN="CENTER">""</TD><TD></TD><TD>svg only</TD> </TR> + <TR><TD><A NAME=a:tailURL HREF=#d:tailURL>tailURL</A> +</TD><TD>E</TD><TD><A HREF=#k:escString>escString</A> +</TD><TD ALIGN="CENTER">""</TD><TD></TD><TD>svg, map only</TD> </TR> + <TR><TD><A NAME=a:tailclip HREF=#d:tailclip>tailclip</A> +</TD><TD>E</TD><TD><A HREF=#k:bool>bool</A> +</TD><TD ALIGN="CENTER">true</TD><TD></TD><TD></TD> </TR> + <TR><TD><A NAME=a:tailhref HREF=#d:tailhref>tailhref</A> +</TD><TD>E</TD><TD><A HREF=#k:escString>escString</A> +</TD><TD ALIGN="CENTER">""</TD><TD></TD><TD>svg, map only</TD> </TR> + <TR><TD><A NAME=a:taillabel HREF=#d:taillabel>taillabel</A> +</TD><TD>E</TD><TD><A HREF=#k:lblString>lblString</A> +</TD><TD ALIGN="CENTER">""</TD><TD></TD><TD></TD> </TR> + <TR><TD><A NAME=a:tailport HREF=#d:tailport>tailport</A> +</TD><TD>E</TD><TD><A HREF=#k:portPos>portPos</A> +</TD><TD ALIGN="CENTER">center</TD><TD></TD><TD></TD> </TR> + <TR><TD><A NAME=a:tailtarget HREF=#d:tailtarget>tailtarget</A> +</TD><TD>E</TD><TD><A HREF=#k:escString>escString</A> +</TD><TD ALIGN="CENTER"><none></TD><TD></TD><TD>svg, map only</TD> </TR> + <TR><TD><A NAME=a:tailtooltip HREF=#d:tailtooltip>tailtooltip</A> +</TD><TD>E</TD><TD><A HREF=#k:escString>escString</A> +</TD><TD ALIGN="CENTER">""</TD><TD></TD><TD>svg, cmap only</TD> </TR> + <TR><TD><A NAME=a:target HREF=#d:target>target</A> +</TD><TD>ENGC</TD><TD><A HREF=#k:escString>escString</A> +<BR>string</TD><TD ALIGN="CENTER"><none></TD><TD></TD><TD>svg, map only</TD> </TR> + <TR><TD><A NAME=a:tooltip HREF=#d:tooltip>tooltip</A> +</TD><TD>NEC</TD><TD><A HREF=#k:escString>escString</A> +</TD><TD ALIGN="CENTER">""</TD><TD></TD><TD>svg, cmap only</TD> </TR> + <TR><TD><A NAME=a:truecolor HREF=#d:truecolor>truecolor</A> +</TD><TD>G</TD><TD><A HREF=#k:bool>bool</A> +</TD><TD ALIGN="CENTER"></TD><TD></TD><TD>bitmap output only</TD> </TR> + <TR><TD><A NAME=a:vertices HREF=#d:vertices>vertices</A> +</TD><TD>N</TD><TD><A HREF=#k:pointfList>pointfList</A> +</TD><TD ALIGN="CENTER"></TD><TD></TD><TD>write only</TD> </TR> + <TR><TD><A NAME=a:viewport HREF=#d:viewport>viewport</A> +</TD><TD>G</TD><TD><A HREF=#k:viewPort>viewPort</A> +</TD><TD ALIGN="CENTER">""</TD><TD></TD><TD></TD> </TR> + <TR><TD><A NAME=a:voro_margin HREF=#d:voro_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=a:weight HREF=#d:weight>weight</A> +</TD><TD>E</TD><TD>double</TD><TD ALIGN="CENTER">1.0</TD><TD>0(dot)<BR>1(neato,fdp,sfdp)</TD><TD></TD> </TR> + <TR><TD><A NAME=a:width HREF=#d:width>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=a:z HREF=#d:z>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=d:Damping HREF=#a:Damping><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=d:K HREF=#a:K><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=#d:len>len</A> can be used to + override this value for adjacent nodes. + +<DT><A NAME=d:URL HREF=#a:URL><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> + Note that, for edges, the attributes <A HREF=#d:headURL>headURL</A>, + <A HREF=#d:tailURL>tailURL</A>, <A HREF=#d:labelURL>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=d:arrowhead HREF=#a:arrowhead><STRONG>arrowhead</STRONG></A> +<DD> Style of arrowhead on the head node of an edge. + See also the <A HREF=#d:dir>dir</A> attribute, + and a <A HREF=#h:undir_note>limitation</A>. + +<DT><A NAME=d:arrowsize HREF=#a:arrowsize><STRONG>arrowsize</STRONG></A> +<DD> Multiplicative scale factor for arrowheads. + +<DT><A NAME=d:arrowtail HREF=#a:arrowtail><STRONG>arrowtail</STRONG></A> +<DD> Style of arrowhead on the tail node of an edge. + See also the <A HREF=#d:dir>dir</A> attribute, + and a <A HREF=#h:undir_note>limitation</A>. + +<DT><A NAME=d:aspect HREF=#a:aspect><STRONG>aspect</STRONG></A> +<DD> Target aspect ratio (width of the layout divided by the height) + of the graph drawing. If unset, dot minimizes the total edge length. + For certain graphs, like those with large fan-in or fan-out, this can + lead to very wide layouts. Setting <TT>aspect</TT> will cause dot to try + to adjust the layout to get an aspect ratio close to that specified + by <TT>aspect</TT>. + <P> + By default, dot will do 5 passes attempting to achieve the desired + aspect ratio. For certain graphs, more passes will be needed to get + close enough. The <TT>aspect</TT> attribute can also be used to + specify the maximum number of passes to try. + <P> + At present, there is no mechanism for widening a very tall layout. + Also, the algorithm doesn't handle clusters, nor disconnected graphs. + For the latter case, one can split the pipeline<BR> + <TT>ccomps -x | dot | gvpack | neato -n2</TT> + to get a similar effect. + +<DT><A NAME=d:bb HREF=#a:bb><STRONG>bb</STRONG></A> +<DD> Bounding box of drawing in points. + +<DT><A NAME=d:bgcolor 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=#d:style>style</A>, the + cluster's <A HREF=#d:fillcolor>fillcolor</A> will overlay the + background color. + <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=d:center HREF=#a:center><STRONG>center</STRONG></A> +<DD> If true, the drawing is centered in the output canvas. + +<DT><A NAME=d:charset HREF=#a:charset><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=d:clusterrank HREF=#a:clusterrank><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=#d:label>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=d:color HREF=#a:color><STRONG>color</STRONG></A> +<DD> Basic drawing color for graphics, not text. For the latter, use the + <A HREF=#d.fontcolor>fontcolor</A> attribute. + <P> + For edges, the value + can either be a single color or a <A HREF=#k:colorList>colorList</A>. + In the latter case, 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. For example, the graph + <PRE> + digraph G { + a -> b [dir=both color="red:blue"] + } + </PRE> + yields<BR> + <IMG SRC="colorlist.gif"> + +<DT><A NAME=d:colorscheme HREF=#a:colorscheme><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=#k:color>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=d:comment HREF=#a:comment><STRONG>comment</STRONG></A> +<DD> Comments are inserted into output. Device-dependent + +<DT><A NAME=d:compound HREF=#a:compound><STRONG>compound</STRONG></A> +<DD> If true, allow edges between clusters. (See <A HREF=#d:lhead>lhead</A> + and <A HREF=#d:ltail>ltail</A> below.) + +<DT><A NAME=d:concentrate HREF=#a:concentrate><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=d:constraint HREF=#a:constraint><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="constraint.gif"> + +<DT><A NAME=d:decorate HREF=#a:decorate><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=d:defaultdist HREF=#a:defaultdist><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=#d:pack>pack</A>=false. + +<DT><A NAME=d:dim HREF=#a:dim><STRONG>dim</STRONG></A> +<DD> Set the number of dimensions used for the layout. The maximum value + allowed is 10. + +<DT><A NAME=d:dimen HREF=#a:dimen><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. + +<DT><A NAME=d:dir HREF=#a:dir><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=#d:arrowhead>arrowhead</A> + and <A HREF=#d:arrowtail>arrowtail</A> attributes. + See <A HREF=#h:undir_note>limitation</A>. + +<DT><A NAME=d:diredgeconstraints HREF=#a:diredgeconstraints><STRONG>diredgeconstraints</STRONG></A> +<DD> Only valid when <A HREF=#d:mode>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=#d:mode>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=d:distortion HREF=#a:distortion><STRONG>distortion</STRONG></A> +<DD> Distortion factor for <A HREF=#d:shape><B>shape</B></A>=polygon. + Positive values cause top part to + be larger than bottom; negative values do the opposite. + +<DT><A NAME=d:dpi HREF=#a:dpi><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=#a:edgeURL><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=#d:URL>URL</A> + defined for the edge. + Also, this value is used near the head or tail node unless overridden + by a <A HREF=#d:headURL>headURL</A> or <A HREF=#d:tailURL>tailURL</A> value, + respectively. + See <A HREF=#h:undir_note>limitation</A>. + +<DT><A NAME=d:edgehref HREF=#a:edgehref><STRONG>edgehref</STRONG></A> +<DD> Synonym for <A HREF=#d:edgeURL>edgeURL</A>. + +<DT><A NAME=d:edgetarget HREF=#a:edgetarget><STRONG>edgetarget</STRONG></A> +<DD> If the edge has a <A HREF=#d:URL>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=#d:target>target</A> is used. + +<DT><A NAME=d:edgetooltip HREF=#a:edgetooltip><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=#d:URL>URL</A> + or <A HREF=#d:edgeURL>edgeURL</A> attribute. + +<DT><A NAME=d:epsilon HREF=#a:epsilon><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=#a:esep><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=#d:sep>sep</A>. + This should normally be strictly less than <A HREF=#d:sep>sep</A>. + +<DT><A NAME=d:fillcolor HREF=#a:fillcolor><STRONG>fillcolor</STRONG></A> +<DD> Color used to fill the background of a node or cluster + assuming <A HREF=#d:style>style</A>=filled. + If <B>fillcolor</B> is not defined, <A HREF=#d:color>color</A> is + used. (For clusters, if <B>color</B> is not defined, + <A HREF=#d:bgcolor>bgcolor</A> is used.) If this is not defined, + the default is used, except for + <A HREF=#d:shape><B>shape</B></A>=point or when the output + format is MIF, + which use black by default. + <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=d:fixedsize HREF=#a:fixedsize><STRONG>fixedsize</STRONG></A> +<DD> If true, the node size is specified by the values of the + <A HREF=#d:width><B>width</B></A> + and <A HREF=#d:height><B>height</B></A> attributes only + and is not expanded to contain the text label. + +<DT><A NAME=d:fontcolor HREF=#a:fontcolor><STRONG>fontcolor</STRONG></A> +<DD> Color used for text. + +<DT><A NAME=d:fontname HREF=#a:fontname><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> + 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. However, if the <TT>fontname</TT> string + contains a slash character "/", it is treated as a pathname for the font + file, though font lookup will append the usual font suffixes. + <P> + If Graphviz does not use fontconfig, <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=#d:fontpath>fontpath</A> attribute. + The lookup does support various aliases for the common fonts. + +<DT><A NAME=d:fontnames HREF=#a:fontnames><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=d:fontpath HREF=#a:fontpath><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=d:fontsize HREF=#a:fontsize><STRONG>fontsize</STRONG></A> +<DD> Font size, <A HREF=#points>in points</A>, used for text. + +<DT><A NAME=d:group HREF=#a:group><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=d:headURL HREF=#a:headURL><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=#d:URL>URL</A> value. + See <A HREF=#h:undir_note>limitation</A>. + +<DT><A NAME=d:headclip HREF=#a:headclip><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=d:headhref HREF=#a:headhref><STRONG>headhref</STRONG></A> +<DD> Synonym for <A HREF=#d:headURL>headURL</A>. + +<DT><A NAME=d:headlabel HREF=#a:headlabel><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=d:headport HREF=#a:headport><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=d:headtarget HREF=#a:headtarget><STRONG>headtarget</STRONG></A> +<DD> If the edge has a <A HREF=#d:headURL>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=#d:target>target</A> is used. + +<DT><A NAME=d:headtooltip HREF=#a:headtooltip><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=#d:headURL>headURL</A> attribute. + +<DT><A NAME=d:height HREF=#a:height><STRONG>height</STRONG></A> +<DD> Height of node, in inches. This is taken as the initial, minimum height + of the node. If <A HREF=#d:fixedsize><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. + +<DT><A NAME=d:href HREF=#a:href><STRONG>href</STRONG></A> +<DD> Synonym for <A HREF=#d:URL>URL</A>. + +<DT><A NAME=d:id HREF=#a:id><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 reponsiblity 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. + +<DT><A NAME=d:image HREF=#a:image><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.html#d:image_fmts>formats</A>, + typically JPEG, PNG, GIF or Postscript, and be able to be converted + into the desired output format. + <P> + Unlike with the <A HREF=#d:shapefile>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=d:imagescale HREF=#a:imagescale><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=#d:dpi>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=#d:width>width</A> and <A HREF=#d:height>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> + 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=d:label HREF=#a:label><STRONG>label</STRONG></A> +<DD> Text label attached to objects. + If a node's <A HREF=#d:shape>shape</A> is record, then the label can + have a <A HREF=shapes.html#record>special format</A> + which describes the record layout. + +<DT><A NAME=d:labelURL HREF=#a:labelURL><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=#d:URL>URL</A> + defined for the edge. + +<DT><A NAME=d:labelangle HREF=#a:labelangle><STRONG>labelangle</STRONG></A> +<DD> This, along with <A HREF=#d:labeldistance>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=d:labeldistance HREF=#a:labeldistance><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=#d:labelangle>labelangle</A> + for more details. + +<DT><A NAME=d:labelfloat HREF=#a:labelfloat><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=d:labelfontcolor HREF=#a:labelfontcolor><STRONG>labelfontcolor</STRONG></A> +<DD> Color used for headlabel and taillabel. + If not set, defaults to edge's fontcolor. + +<DT><A NAME=d:labelfontname HREF=#a:labelfontname><STRONG>labelfontname</STRONG></A> +<DD> Font used for headlabel and taillabel. + If not set, defaults to edge's fontname. + +<DT><A NAME=d:labelfontsize HREF=#a:labelfontsize><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=d:labelhref HREF=#a:labelhref><STRONG>labelhref</STRONG></A> +<DD> Synonym for <A HREF=#d:labelURL>labelURL</A>. + +<DT><A NAME=d:labeljust HREF=#a:labeljust><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=d:labelloc HREF=#a:labelloc><STRONG>labelloc</STRONG></A> +<DD> Top/bottom placement of graph and cluster labels. + If the attribute is "t", place label at the top; + if the attribute is "b", place label at the bottom. + 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. + +<DT><A NAME=dd:labelloc HREF=#aa:labelloc><STRONG>labelloc</STRONG></A> +<DD> Vertical placement of node label. By default, if the height of a node + is larger than the height of its label, the label is vertically centered. + 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. + +<DT><A NAME=d:labeltarget HREF=#a:labeltarget><STRONG>labeltarget</STRONG></A> +<DD> If the edge has a <A HREF=#d:URL>URL</A> or <A HREF=#d:labelURL>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=#d:target>target</A> is used. + +<DT><A NAME=d:labeltooltip HREF=#a:labeltooltip><STRONG>labeltooltip</STRONG></A> +<DD> Tooltip annotation attached to label of an edge. + This is used only if the edge has a <A HREF=#d:URL>URL</A> + or <A HREF=#d:labelURL>labelURL</A> attribute. + +<DT><A NAME=d:landscape HREF=#a:landscape><STRONG>landscape</STRONG></A> +<DD> If true, the graph is rendered in landscape mode. Synonymous with + <A HREF=#d:rotate><TT>rotate=90</TT></A> or + <A HREF=#d:orientation><TT>orientation=landscape</TT></A>. + +<DT><A NAME=d:layer HREF=#a:layer><STRONG>layer</STRONG></A> +<DD> Specifies layers in which the node or edge is present. + +<DT><A NAME=d:layers HREF=#a:layers><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/Documentation/html/layers/">How to use drawing layers (overlays)</A>. + +<DT><A NAME=d:layersep HREF=#a:layersep><STRONG>layersep</STRONG></A> +<DD> Specifies the separator characters used to split the + <A HREF=#d:layers>layers </A>attribute into a list of layer names. + +<DT><A NAME=d:layout HREF=#a:layout><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.html#minusK>-K flag</A> + or the actual command name used. + +<DT><A NAME=d:len HREF=#a:len><STRONG>len</STRONG></A> +<DD> Preferred edge length, in inches. + +<DT><A NAME=d:levels HREF=#a:levels><STRONG>levels</STRONG></A> +<DD> Number of levels allowed in the multilevel scheme. + +<DT><A NAME=d:levelsgap HREF=#a:levelsgap><STRONG>levelsgap</STRONG></A> +<DD> Specifies strictness of level constraints in neato + when <TT><A HREF=#d:mode>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=d:lhead HREF=#a:lhead><STRONG>lhead</STRONG></A> +<DD> Logical head of an edge. When <A HREF=#d:compound><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=d:lp HREF=#a:lp><STRONG>lp</STRONG></A> +<DD> Label position, <A HREF=#points>in points</A>. + The position indicates the center of the label. + +<DT><A NAME=d:ltail HREF=#a:ltail><STRONG>ltail</STRONG></A> +<DD> Logical tail of an edge. When <A HREF=#d:compound><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=d:margin HREF=#a:margin><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=#d:pad>pad</A> attribute. + <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=d:maxiter HREF=#a:maxiter><STRONG>maxiter</STRONG></A> +<DD> Sets the number of iterations used. + +<DT><A NAME=d:mclimit HREF=#a:mclimit><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=d:mindist HREF=#a:mindist><STRONG>mindist</STRONG></A> +<DD> Specifies the minimum separation between all nodes. + +<DT><A NAME=d:minlen HREF=#a:minlen><STRONG>minlen</STRONG></A> +<DD> Minimum edge length (rank difference between head and tail). + +<DT><A NAME=d:mode HREF=#a:mode><STRONG>mode</STRONG></A> +<DD> Technique for optimizing the layout. 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 new, 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=#d:sep>sep</A> attribute.) + +<DT><A NAME=d:model HREF=#a:model><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=#d:len>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. + +<DT><A NAME=d:mosek HREF=#a:mosek><STRONG>mosek</STRONG></A> +<DD> If Graphviz is built with MOSEK defined, mode=ipsep and mosek=true, + the Mosek software (www.mosek.com) is use to solve the ipsep constraints. + +<DT><A NAME=d:nodesep HREF=#a:nodesep><STRONG>nodesep</STRONG></A> +<DD> Minimum space between two adjacent nodes in the same rank, in inches. + +<DT><A NAME=d:nojustify HREF=#a:nojustify><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=#d:margin>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=d:normalize HREF=#a:normalize><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 first edge is horizontal. + +<DT><A NAME=d:nslimit HREF=#a:nslimit><STRONG>nslimit</STRONG></A> +,<DT><A NAME=d:nslimit1 HREF=#a:nslimit1><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=d:ordering HREF=#a:ordering><STRONG>ordering</STRONG></A> +<DD> If "out" for a graph G, and n is a node in G, then edges n->* appear + left-to-right in the same order in which they are defined. + If "in", the edges *->n appear + left-to-right in the same order in which they are defined for all + nodes n. + +<DT><A NAME=d:orientation HREF=#a:orientation><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=dd:orientation HREF=#aa:orientation><STRONG>orientation</STRONG></A> +<DD> If "[lL]*", set graph orientation to landscape + Used only if <A HREF=#d:rotate><B>rotate</B></A> is not defined. + +<DT><A NAME=d:outputorder HREF=#a:outputorder><STRONG>outputorder</STRONG></A> +<DD> Specify order in which nodes and edges are drawn. + +<DT><A NAME=d:overlap HREF=#a:overlap><STRONG>overlap</STRONG></A> +<DD> Determines if and how node overlaps should be removed. Nodes are first + enlarged using the <A HREF=#d:sep><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", node overlaps are removed by a + Voronoi-based technique. + If the value is "scalexy", x and y are separately + scaled to remove overlaps. + <P> + If sfdp is available, one can set overlap to "prism" to use a + proximity graph-based algorithm for overlap removal. + This is the preferred technique, + though "scale" and "false" can work well with small graphs. + This technique starts with a + small scaling up, controlled by the + <A HREF="#d:overlap_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 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> + <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> + If the value is "vpsc", overlap removal is done as a + quadratic optimization to minimize node displacement while removing + node overlaps. + <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> + If the layout is done by neato with <A HREF=#d:mode>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> + Except for fdp and sfdp, the layouts assume <TT>overlap="true"</TT> as the default. + Fdp first uses a number of passes using built-in, force-directed technique + 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:portho"</TT>. Note that <TT>overlap="true"</TT>, + <TT>overlap="0:true"</TT> and <TT>overlap="0:"</TT> all turn off all overlap + removal. + <P> + By default, sfdp uses <TT>overlap="prism0"</TT>. + <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=d:overlap_scaling HREF=#a:overlap_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=d:pack HREF=#a:pack><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=#d:packmode>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=d:packmode HREF=#a:packmode><STRONG>packmode</STRONG></A> +<DD> This indicates how connected components should be packed + (cf. <A HREF=#k:packMode>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=d:pad HREF=#a:pad><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=d:page HREF=#a:page><STRONG>page</STRONG></A> +<DD> Width and height of output pages, in inches. 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=#d:pagedir>pagedir</A> order. + <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=#d:viewport>viewport</A> to generate + multiple files. + +<DT><A NAME=d:pagedir HREF=#a:pagedir><STRONG>pagedir</STRONG></A> +<DD> If the <A HREF=#d:page>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=d:pencolor HREF=#a:pencolor><STRONG>pencolor</STRONG></A> +<DD> Color used to draw the bounding box around a cluster. + If <B>pencolor</B> is not defined, <A HREF=#d:color><B>color</B></A> is + used. If this is not defined, <A HREF=#d:bgcolor>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=d:penwidth HREF=#a:penwidth><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=#d:style><TT>style</TT></A> specification. + If both are used, <TT>penwidth</TT> will be used. + +<DT><A NAME=d:peripheries HREF=#a:peripheries><STRONG>peripheries</STRONG></A> +<DD> Set number of peripheries used in polygonal shapes and cluster + boundaries. Note that + <A HREF=shapes.html#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=d:pin HREF=#a:pin><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=#d:point>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=d:pos HREF=#a:pos><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.html#d:s>-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> + When the <A HREF=command.html#d:n>-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=d:quadtree HREF=#a:quadtree><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=d:quantum HREF=#a:quantum><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=d:rank HREF=#a:rank><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=d:rankdir HREF=#a:rankdir><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="shapes.html#record">record shapes</A>. + +<DT><A NAME=d:ranksep HREF=#a:ranksep><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". + In twopi, specifies radial separation of concentric circles. + +<DT><A NAME=d:ratio HREF=#a:ratio><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=#d:size><B>size</B></A> attribute constraints are enforced. + <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> + If <B>ratio</B> = "fill" and the <A HREF=#d:size><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. + <P> + If <B>ratio</B> = "compress" and the <A HREF=#d:size><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> + If <B>ratio</B> = "expand", the <A HREF=#d:size><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=#d:size><B>size</B></A>, node positions are scaled + uniformly until at least + one dimension fits <A HREF=#d:size><B>size</B></A> exactly. + Note that this is distinct from using <A HREF=#d:size><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> + If <B>ratio</B> = "auto", the <A HREF=#d:page><B>page</B></A> + attribute is set and the graph cannot be drawn on a single page, + then <A HREF=#d:size><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=d:rects HREF=#a:rects><STRONG>rects</STRONG></A> +<DD> Rectangles for fields of records, <A HREF=#points>in points</A>. + +<DT><A NAME=d:regular HREF=#a:regular><STRONG>regular</STRONG></A> +<DD> If true, force polygon to be regular. + +<DT><A NAME=d:remincross HREF=#a:remincross><STRONG>remincross</STRONG></A> +<DD> If true and there are multiple clusters, run cross + minimization a second time. + +<DT><A NAME=d:repulsiveforce HREF=#a:repulsiveforce><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=d:resolution HREF=#a:resolution><STRONG>resolution</STRONG></A> +<DD> This is a synonym for the <A HREF=#d:dpi>dpi</A> attribute. + +<DT><A NAME=d:root HREF=#a:root><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. + +<DT><A NAME=d:rotate HREF=#a:rotate><STRONG>rotate</STRONG></A> +<DD> If 90, set drawing orientation to landscape. + +<DT><A NAME=d:samehead HREF=#a:samehead><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. + See <A HREF=#h:undir_note>limitation</A>. + +<DT><A NAME=d:sametail HREF=#a:sametail><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. + See <A HREF=#h:undir_note>limitation</A>. + +<DT><A NAME=d:samplepoints HREF=#a:samplepoints><STRONG>samplepoints</STRONG></A> +<DD> If the input graph defines the <A HREF=#d:vertices><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=d:searchsize HREF=#a:searchsize><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=d:sep HREF=#a:sep><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> + If only a single number is given, this is used for both dimensions. + <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=d:shape HREF=#a:shape><STRONG>shape</STRONG></A> +<DD> Set the shape of a node. + +<DT><A NAME=d:shapefile HREF=#a:shapefile><STRONG>shapefile</STRONG></A> +<DD> (Deprecated) If defined, shapefile specifies a file containing user-supplied node content. + The <A HREF=#d:shape><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="http://www.graphviz.org/doc/info/output.html">output format</A>. For further details, see + <A HREF=output.html#d:image_fmts>Image Formats</A> and + <A HREF=http://www.graphviz.org/Documentation/html/shapehowto.html#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/Documentation/html/shapehowto.html#ext_ps> + External PostScript files</A>. + +<DT><A NAME=d:showboxes HREF=#a:showboxes><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=d:sides HREF=#a:sides><STRONG>sides</STRONG></A> +<DD> Number of sides if <A HREF=#d:shape><B>shape</B></A>=polygon. + +<DT><A NAME=d:size HREF=#a:size><STRONG>size</STRONG></A> +<DD> Maximum width and height of drawing, in inches. + If defined and the drawing is too large, the drawing is uniformly + scaled down so that it fits within the given size. + <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> + Note that there is some interaction between the <B>size</B> and + <A HREF=#d:ratio><B>ratio</B></A> attributes. + +<DT><A NAME=d:skew HREF=#a:skew><STRONG>skew</STRONG></A> +<DD> Skew factor for <A HREF=#d:shape><B>shape</B></A>=polygon. Positive values + skew top of polygon to right; negative to left. + +<DT><A NAME=d:smoothing HREF=#a:smoothing><STRONG>smoothing</STRONG></A> +<DD> Specifies a post-processing step used to smooth out an uneven distribution + of nodes. + +<DT><A NAME=d:sortv HREF=#a:sortv><STRONG>sortv</STRONG></A> +<DD> If <A HREF="#d:packmode">packmode</A> indicates an array packing, + this attribute specifies an + insertion order among the components, with smaller values inserted first. + +<DT><A NAME=d:splines HREF=#a:splines><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 "", 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> + 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=#d:overlap><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=d:start HREF=#a:start><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=d:style HREF=#a:style><STRONG>style</STRONG></A> +<DD> Set style for node or edge. For cluster subgraph, if "filled", the + cluster box's background is filled. + +<DT><A NAME=d:stylesheet HREF=#a:stylesheet><STRONG>stylesheet</STRONG></A> +<DD> A URL or pathname specifying an XML style sheet, used in SVG output. + +<DT><A NAME=d:tailURL HREF=#a:tailURL><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=#d:URL>URL</A> value. + See <A HREF=#h:undir_note>limitation</A>. + +<DT><A NAME=d:tailclip HREF=#a:tailclip><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=d:tailhref HREF=#a:tailhref><STRONG>tailhref</STRONG></A> +<DD> Synonym for <A HREF=#d:tailURL>tailURL</A>. + +<DT><A NAME=d:taillabel HREF=#a:taillabel><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=d:tailport HREF=#a:tailport><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=d:tailtarget HREF=#a:tailtarget><STRONG>tailtarget</STRONG></A> +<DD> If the edge has a <A HREF=#d:tailURL>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=#d:target>target</A> is used. + +<DT><A NAME=d:tailtooltip HREF=#a:tailtooltip><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=#d:tailURL>tailURL</A> attribute. + +<DT><A NAME=d:target HREF=#a:target><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=d:tooltip HREF=#a:tooltip><STRONG>tooltip</STRONG></A> +<DD> Tooltip annotation attached to the node or edge. If unset, Graphviz + will use the object's <A HREF=#d:label>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=d:truecolor HREF=#a:truecolor><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=#d:shapefile>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> + Usually, the only time it is necessary to specify the truetype model + is if the graph uses more than 256 colors. + However, if one uses <A HREF=#d:bgcolor>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=d:vertices HREF=#a:vertices><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=#d:samplepoints>samplepoints</A> attribute affects + the output. + +<DT><A NAME=d:viewport HREF=#a:viewport><STRONG>viewport</STRONG></A> +<DD> Clipping window on final drawing. + +<DT><A NAME=d:voro_margin HREF=#a:voro_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=d:weight HREF=#a:weight><STRONG>weight</STRONG></A> +<DD> Weight of edge. In dot, the heavier the weight, the shorter, + straighter and more vertical the edge is. + +<DT><A NAME=d:width HREF=#a:width><STRONG>width</STRONG></A> +<DD> Width of node, in inches. This is taken as the initial, minimum width + of the node. If <A HREF=#d:fixedsize><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. + +<DT><A NAME=d:z HREF=#a:z><STRONG>z</STRONG></A> +<DD> <B>Deprecated:</B>Use <A HREF=#d:pos><B>pos</B></A> attribute, along + with <A HREF=#d:dimen><B>dimen</B></A> and/or <A HREF=#d:dim><B>dim</B></A> + to specify dimensions. + <P> + Provides z coordinate value for 3D layouts and displays. If the + graph has <A HREF=#d:dim><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=#d:pos><B>pos</B></A> attribute is also defined. + <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. + +</DL> +<HR> +<H1>Attribute Type Descriptions</H1> +The following list gives the legal strings corresponding to values of +the given types. +<DL> +<DT><A NAME=k:arrowType><STRONG>arrowType</STRONG></A> +<DD><TABLE> + <TR><TD>"normal"<TD><IMG SRC="a_normal.gif"> + <TD>"inv"<TD><IMG SRC="a_inv.gif"></TR> + <TR><TD>"dot"<TD><IMG SRC="a_dot.gif"> + <TD>"invdot"<TD><IMG SRC="a_invdot.gif"></TR> + <TR><TD>"odot"<TD><IMG SRC="a_odot.gif"> + <TD>"invodot"<TD><IMG SRC="a_invodot.gif"></TR> + <TR><TD>"none"<TD><IMG SRC="a_none.gif"> + <TD>"tee"<TD><IMG SRC="a_tee.gif"></TR> + <TR><TD>"empty"<TD><IMG SRC="a_empty.gif"> + <TD>"invempty"<TD><IMG SRC="a_invempty.gif"></TR> + <TR><TD>"diamond"<TD><IMG SRC="a_diamond.gif"> + <TD>"odiamond"<TD><IMG SRC="a_odiamond.gif"></TR> + <TR><TD>"ediamond"<TD><IMG SRC="a_ediamond.gif"> + <TD>"crow"<TD><IMG SRC="a_crow.gif"></TR> + <TR><TD>"box"<TD><IMG SRC="a_box.gif"> + <TD>"obox"<TD><IMG SRC="a_obox.gif"></TR> + <TR><TD>"open"<TD><IMG SRC="a_open.gif"> + <TD>"halfopen"<TD><IMG SRC="a_halfopen.gif"></TR> + <TR><TD>"vee"<TD><IMG SRC="a_open.gif"> + </TABLE> + <P> + These are the basic set of backward-compatible arrow shapes. In addition, + there is a grammar of <A HREF=arrows.html>arrow shapes</A> + which can be used to describe a collection of 1,544,761 arrow combinations of the 36 varations of the primitive set of 9 arrows. The basic arrows shown + above contain all of the primitive shapes + (<TT>box</TT>, <TT>crow</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=k:aspectType><STRONG>aspectType</STRONG></A> +<DD><p>An aspect ratio, double, followed optionally by a ',' and a maximum pass + count. If the aspect ratio is given, but no maximum pass count, the + latter defaults to 5. + +<DT><A NAME=k:clusterMode><STRONG>clusterMode</STRONG></A> +<DD>"local","global","none" + +<DT><A NAME=k:color><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)</TR> + <TR><TD>"#%2x%2x%2x%2x"<TD>Red-Green-Blue-Alpha (RGBA)</TR> + <TR><TD>H[, ]+S[, ]+V<TD>Hue-Saturation-Value (HSV) 0.0 <= H,S,V <= 1.0</TR> + <TR><TD>string<TD><A HREF=colors.html>color name</A></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=#d:colorscheme>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>At present, Graphviz recognizes the default color scheme <TT>X11</TT>, + and the <A HREF="http://www.personal.psu.edu/faculty/c/a/cab38/ColorBrewer/ColorBrewer_intro.html">Brewer color schemes</A>. Please note that Brewer + color schemes are covered by this <A HREF=colors.html#brewer_license>license</A>. + <P> + Examples:<BR> + <TABLE border=1> + <TR><TH>Color<TH>RGB<TH>HSV<TH>String</TR> + <TR><TD align=center bgcolor=#ffffff>White<TD>"#ffffff"<TD>"0.000 0.000 1.000"<TD>"white"</TR> + <TR><TD align=center bgcolor=#000000><font color=white>Black</font><TD>"#000000"<TD>"0.000 0.000 0.000"<TD>"black"</TR> + <TR><TD align=center bgcolor=#ff0000>Red<TD>"#ff0000"<TD>"0.000 1.000 1.000"<TD>"red"</TR> + <TR><TD align=center bgcolor=#40e0d0>Turquoise<TD>"#40e0d0"<TD>"0.482 0.714 0.878"<TD>"turquoise"</TR> + <TR><TD align=center bgcolor=#a0522d>Sienna<TD>"#a0522d"<TD>"0.051 0.718 0.627"<TD>"sienna"</TR> + </TABLE> + <P> + Note that some output formats, e.g., <A HREF="output.html#a:mif">mif</A>, + only support a limited number of specific colors. + <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=#d:bgcolor>bgcolor</A> attribute. + Usually, the same effect can be achieved by setting + <A HREF=#d:style>style</A> to <TT>invis</TT>. + +<DT><A NAME=k:colorList><STRONG>colorList</STRONG></A> +<DD>A colon-separated list of color values: <I>C</I>(:<I>C</I>)* + where each <I>C</I> is a <A HREF=#k:color>color</A> value. + +<DT><A NAME=k:dirType><STRONG>dirType</STRONG></A> +<DD>For an edge <CODE>T -> H;</CODE> + <TABLE> + <TR><TD>"forward"<TD><IMG SRC="forward.gif"> + <TD>"back"<TD><IMG SRC="back.gif"></TR> + <TR><TD>"both"<TD><IMG SRC="both.gif"> + <TD>"none"<TD><IMG SRC="nohead.gif"></TR> + </TABLE> + 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=k:escString><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=#a:label>label</A>, + <A HREF=#a:headlabel>headlabel</A> or <A HREF=#a:taillabel>taillabel</A>, + the escape sequences "\n", "\l" and "\r" + divide the label into lines, centered, left-justified, and right-justified, + respectively. + +<DT><A NAME=k:layerList><STRONG>layerList</STRONG></A> +<DD>list of strings separated by characters from the + <A HREF=#a:layersep>layersep</A> attribute (by default, colons, + tabs or spaces), defining <A HREF=#a:layer>layer</A> + names and implicitly numbered 1,2,... + +<DT><A NAME=k:layerRange><STRONG>layerRange</STRONG></A> +<DD>layerId or layerId<B>s</B>layerId,<BR> where layerId = "all", + a decimal integer or a <A HREF=#a:layer>layer</A> name. + (An integer i corresponds to layer i.) + The string <B>s</B> consists of 1 or more separator characters specified + by the <A HREF=#a:layersep>layersep</A> attribute. + +<DT><A NAME=k:lblString><STRONG>lblString</STRONG></A> +<DD>an <A HREF=#k:escString>escString</A> + or an <A HREF=shapes.html#html>HTML label</A>. + +<DT><A NAME=k:outputMode><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=k:packMode><STRONG>packMode</STRONG></A> +<DD>"node", "clust" , "graph" , "array[_flags][%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> + The mode "array[_flags][%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> + 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="#d:sortv">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=k:pagedir><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=k:point><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=#d:dim>dim</A> is 3 or more, <B>point</B> may also have + the format "%f,%f,%f"('!') to represent the point (x,y,z). + +<DT><A NAME=k:pointf><STRONG>pointf</STRONG></A> +<DD>"%lf,%lf" representing the point (x,y). + +<DT><A NAME=k:pointfList><STRONG>pointfList</STRONG></A> +<DD>list of pointf, separated by spaces. + +<DT><A NAME=k:portPos><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=shapes.html#record>record</A> shape with one of its fields + having the given <I>portname</I>, + or have an <A HREF=shapes.html#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> + This attribute can be attached to an edge using the + <A HREF=#k:headport>headport</A> and + <A HREF=#k:tailport>tailport</A> attributes, or as part of the + edge description as in + <CENTER> + <TT>node1:port1 -> node2:port5:nw;</TT> + </CENTER> + <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=k:quadType><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=k:rankType><STRONG>rankType</STRONG></A> +<DD>"same", "min", "source", "max", "sink" + +<DT><A NAME=k:rankdir><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=k:rect><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=k:shape><STRONG>shape</STRONG></A> +<DD>A string specifying the <A HREF=shapes.html>shape</A> of a node. + There are three + main types of shapes : + <A HREF=shapes.html#polygon>polygon-based</A>, + <A HREF=shapes.html#record>record-based</A> and + <A HREF=shapes.html#epsf>user-defined</A>. + +<DT><A NAME=k:smoothType><STRONG>smoothType</STRONG></A> +<DD>Values are "none", "avg_dist", "graph_dist", "power_dist", "rng", + "spring" and "triangle". + +<DT><A NAME=k:splineType><STRONG>splineType</STRONG></A> +<DD>spline ( ';' spline )*<BR> + <TABLE> + <TR><TD ALIGN=right>where spline<TD>=<TD>(endp)? (startp)? point (triple)+</TR> + <TR><TD ALIGN=right>and triple<TD>=<TD>point point point</TR> + <TR><TD ALIGN=right>and endp<TD>=<TD>"e,%f,%f"</TR> + <TR><TD ALIGN=right>and startp<TD>=<TD>"s,%f,%f"</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 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=k:startType><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> + 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> + If the value is just <TT>"random"</TT>, a time-based seed is chosen. + <P> + Note that input positions, specified by a node's + <A HREF=#d:pos>pos</A> + attribute, are only used when the style is <TT>"random"</TT>. + +<DT><A NAME=k:style><STRONG>style</STRONG></A> +<DD>styleItem ( ',' styleItem )*<BR> + <TABLE> + <TR><TD ALIGN=right>where styleItem<TD>=<TD>name or name'('args')'</TR> + <TR><TD ALIGN=right>and args<TD>=<TD>name ( ',' name )*</TR> + <TR><TD ALIGN=right>and name<TD>=<TD>[^)(, ][^)(,]*</TR> + </TABLE> + Note that whitespace characters are ignored, except for names which + can contain them. A + name cannot contain any comma, or left or right parenthesis, and it cannot + begin with a whitespace character. + <P> + At present, the recognized style names are + "dashed", "dotted", "solid", "invis" and "bold" for nodes and edges, + and "filled", "diagonals" and "rounded" for nodes only. + The styles "filled" and "rounded" are recognized for clusters. + Additional styles are available in + device-dependent form. Style lists are passed to device drivers, which + can use this to generate appropriate output. + <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=#d:penwidth><TT>penwidth</TT></A> attribute instead.</B> + +<DT><A NAME=k:viewPort><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> + Sample values: <TT>50,50,.5,'2.8 BSD'</T> 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. + +</DL> +</BODY> +</HTML>