From: dperry Date: Thu, 31 Mar 2011 18:09:46 +0000 (+0000) Subject: Fixed links for new website. X-Git-Tag: LAST_LIBGRAPH~32^2~892 X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=9a3ccd8a3027d0dcbf10c972a3345f92d5e50cbf;p=graphviz Fixed links for new website. --- diff --git a/doc/info/attrs.html b/doc/info/attrs.html index abccfe90b..89f938b7b 100644 --- a/doc/info/attrs.html +++ b/doc/info/attrs.html @@ -29,20 +29,20 @@ one would use Further details concerning the setting of attributes can be found in the description of the -DOT language. +DOT language.

At present, most device-independent units are either inches or -points, +points, which we take as 72 points per inch.

-Note: Some attributes, such as -dir or arrowtail, are +Note: Some attributes, such as +dir or arrowtail, are ambiguous when used in -DOT +DOT 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 -DOT +DOT parser will assign the left node as the tail node and the right node as the head. For example, the edge A -- B will have tail A and head B. It is the user's responsibility to handle such @@ -54,12 +54,12 @@ the drawing will attach the tail label to node A. 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 dir, arrowtail -or arrowhead attributes. +done using the dir, arrowtail +or arrowhead attributes.

The tools accept standard C representations for int and double types. -For the bool type, TRUE values are +For the bool type, TRUE values are represented by "true" or "yes" (case-insensitive) and any non-zero integer, and FALSE values by "false" or "no" (case-insensitive) and zero. @@ -68,431 +68,431 @@ In addition, there are a variety of specialized types such as pointf and rankdir. Legal values for these types are given at the end.

-In the Used By field, the +In the Used By 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.


- - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
NameUsed ByTypeDefaultMinimumNotes
Damping +
NameUsed ByTypeDefaultMinimumNotes
Damping Gdouble0.990.0neato only
K +
K GCdouble0.30sfdp, fdp only
URL -ENGCescString +
URL +ENGCescString <none>svg, postscript, map only
arrowhead -EarrowType +
arrowhead +EarrowType normal
arrowsize +
arrowsize Edouble1.00.0
arrowtail -EarrowType +
arrowtail +EarrowType normal
aspect -GaspectType +
aspect +GaspectType dot only
bb -Grect +
bb +Grect write only
bgcolor -GCcolor +
bgcolor +GCcolor <none>
center -Gbool +
center +Gbool false
charset +
charset Gstring"UTF-8"
clusterrank -GclusterMode +
clusterrank +GclusterMode localdot only
color -ENCcolor -
colorList +
color +ENCcolor +
colorList
black
colorscheme +
colorscheme ENCGstring""
comment +
comment ENGstring""
compound -Gbool +
compound +Gbool falsedot only
concentrate -Gbool +
concentrate +Gbool false
constraint -Ebool +
constraint +Ebool truedot only
decorate -Ebool +
decorate +Ebool false
defaultdist +
defaultdist Gdouble1+(avg. len)*sqrt(|V|)epsilonneato only
dim +
dim Gint22sfdp, fdp, neato only
dimen +
dimen Gint22sfdp, fdp, neato only
dir -EdirType +
dir +EdirType forward(directed)
none(undirected)
diredgeconstraints -Gstring
bool +
diredgeconstraints +Gstring
bool
falseneato only
distortion +
distortion Ndouble0.0-100.0
dpi +
dpi Gdouble96.0
0.0
svg, bitmap output only
edgeURL -EescString +
edgeURL +EescString ""svg, map only
edgehref -EescString +
edgehref +EescString ""svg, map only
edgetarget -EescString +
edgetarget +EescString <none>svg, map only
edgetooltip -EescString +
edgetooltip +EescString ""svg, cmap only
epsilon +
epsilon Gdouble.0001 * # nodes(mode == KK)
.0001(mode == major)
neato only
esep -Gdouble
pointf +
esep +Gdouble
pointf
+3not dot
fillcolor -NCcolor +
fillcolor +NCcolor lightgrey(nodes)
black(clusters)
fixedsize -Nbool +
fixedsize +Nbool false
fontcolor -ENGCcolor +
fontcolor +ENGCcolor black
fontname +
fontname ENGCstring"Times-Roman"
fontnames +
fontnames Gstring""svg only
fontpath +
fontpath Gstringsystem-dependent
fontsize +
fontsize ENGCdouble14.01.0
group +
group Nstring""dot only
headURL -EescString +
headURL +EescString ""svg, map only
headclip -Ebool +
headclip +Ebool true
headhref -EescString +
headhref +EescString ""svg, map only
headlabel -ElblString +
headlabel +ElblString ""
headport -EportPos +
headport +EportPos center
headtarget -EescString +
headtarget +EescString <none>svg, map only
headtooltip -EescString +
headtooltip +EescString ""svg, cmap only
height +
height Ndouble0.50.02
href -GCNEescString +
href +GCNEescString ""svg, postscript, map only
id -GNEescString +
id +GNEescString ""svg, postscript, map only
image +
image Nstring""
imagescale -Nbool +
imagescale +Nbool
string
false
label -ENGClblString +
label +ENGClblString "\N" (nodes)
"" (otherwise)
labelURL -EescString +
labelURL +EescString ""svg, map only
label_scheme +
label_scheme Gint00sfdp only
labelangle +
labelangle Edouble-25.0-180.0
labeldistance +
labeldistance Edouble1.00.0
labelfloat -Ebool +
labelfloat +Ebool false
labelfontcolor -Ecolor +
labelfontcolor +Ecolor black
labelfontname +
labelfontname Estring"Times-Roman"
labelfontsize +
labelfontsize Edouble14.01.0
labelhref -EescString +
labelhref +EescString ""svg, map only
labeljust +
labeljust GCstring"c"
labelloc +
labelloc NGCstring"t"(clusters)
"b"(root graphs)
"c"(nodes)
labeltarget -EescString +
labeltarget +EescString <none>svg, map only
labeltooltip -EescString +
labeltooltip +EescString ""svg, cmap only
landscape -Gbool +
landscape +Gbool false
layer -ENlayerRange +
layer +ENlayerRange ""
layers -GlayerList +
layers +GlayerList ""
layersep -Gstring" :\t"
layout +
layersep +Gstring" \t"
layout Gstring""
len +
len Edouble1.0(neato)
0.3(fdp)
fdp, neato only
levels +
levels GintMAXINT0.0sfdp only
levelsgap +
levelsgap Gdouble0.0neato only
lhead +
lhead Estring""dot only
lheight +
lheight GCdoublewrite only
lp -EGCpoint +
lp +EGCpoint write only
ltail +
ltail Estring""dot only
lwidth +
lwidth GCdoublewrite only
margin -NGdouble
pointf +
margin +NGdouble
pointf
<device-dependent>
maxiter +
maxiter Gint100 * # nodes(mode == KK)
200(mode == major)
600(fdp)
fdp, neato only
mclimit +
mclimit Gdouble1.0dot only
mindist +
mindist Gdouble1.00.0circo only
minlen +
minlen Eint10dot only
mode +
mode Gstringmajor
spring
sfdp, neato only
model +
model Gstringshortpathneato only
mosek -Gbool +
mosek +Gbool falseneato only
nodesep +
nodesep Gdouble0.250.02dot only
nojustify -GCNEbool +
nojustify +GCNEbool false
normalize -Gbool +
normalize +Gbool falsenot dot
nslimit -
nslimit1 +
nslimit +
nslimit1
Gdoubledot only
ordering +
ordering GNstring""dot only
orientation +
orientation Ndouble0.0360.0
orientation +
orientation Gstring""
outputorder -GoutputMode +
outputorder +GoutputMode breadthfirst
overlap -Gstring
bool +
overlap +Gstring
bool
truenot dot
overlap_scaling +
overlap_scaling Gdouble-4-1.0e10prism only
pack -Gbool +
pack +Gbool
int
falsenot dot
packmode -GpackMode +
packmode +GpackMode nodenot dot
pad -Gdouble
pointf +
pad +Gdouble
pointf
0.0555 (4 points)
page -Gdouble
pointf +
page +Gdouble
pointf
pagedir -Gpagedir +
pagedir +Gpagedir BL
pencolor -Ccolor +
pencolor +Ccolor black
penwidth +
penwidth CNEdouble1.00.0
peripheries +
peripheries NCintshape default(nodes)
1(clusters)
0
pin -Nbool +
pin +Nbool falsefdp, neato only
pos -ENpoint -
splineType +
pos +ENpoint +
splineType
quadtree -GquadType -
bool +
quadtree +GquadType +
bool
normalsfdp only
quantum +
quantum Gdouble0.00.0
rank -SrankType +
rank +SrankType dot only
rankdir -Grankdir +
rankdir +Grankdir TBdot only
ranksep -Gdouble
doubleList +
ranksep +Gdouble
doubleList
0.5(dot)
1.0(twopi)
0.02twopi, dot only
ratio +
ratio Gdouble
string
rects -Nrect +
rects +Nrect write only
regular -Nbool +
regular +Nbool false
remincross -Gbool +
remincross +Gbool falsedot only
repulsiveforce +
repulsiveforce Gdouble1.00.0sfdp only
resolution +
resolution Gdouble96.0
0.0
svg, bitmap output only
root -GNstring
bool +
root +GNstring
bool
<none>(graphs)
false(nodes)
circo, twopi only
rotate +
rotate Gint0
rotation +
rotation Gdouble0sfdp only
samehead +
samehead Estring""dot only
sametail +
sametail Estring""dot only
samplepoints +
samplepoints Nint8(output)
20(overlap and image maps)
scale -Gdouble
pointf +
scale +Gdouble
pointf
twopi only
searchsize +
searchsize Gint30dot only
sep -Gdouble
pointf +
sep +Gdouble
pointf
+4not dot
shape -Nshape +
shape +Nshape ellipse
shapefile +
shapefile Nstring""
showboxes +
showboxes ENGint00dot only
sides +
sides Nint40
size -Gdouble
pointf +
size +Gdouble
pointf
skew +
skew Ndouble0.0-100.0
smoothing -GsmoothType +
smoothing +GsmoothType "none"sfdp only
sortv +
sortv GCNint00
splines -Gbool +
splines +Gbool
string
start -GstartType +
start +GstartType ""fdp, neato only
style -ENCstyle +
style +ENCstyle
stylesheet +
stylesheet Gstring""svg only
tailURL -EescString +
tailURL +EescString ""svg, map only
tailclip -Ebool +
tailclip +Ebool true
tailhref -EescString +
tailhref +EescString ""svg, map only
taillabel -ElblString +
taillabel +ElblString ""
tailport -EportPos +
tailport +EportPos center
tailtarget -EescString +
tailtarget +EescString <none>svg, map only
tailtooltip -EescString +
tailtooltip +EescString ""svg, cmap only
target -ENGCescString +
target +ENGCescString
string
<none>svg, map only
tooltip -NECescString +
tooltip +NECescString ""svg, cmap only
truecolor -Gbool +
truecolor +Gbool bitmap output only
vertices -NpointfList +
vertices +NpointfList write only
viewport -GviewPort +
viewport +GviewPort ""
voro_margin +
voro_margin Gdouble0.050.0not dot
weight +
weight Edouble1.00(dot)
1(neato,fdp,sfdp)
width +
width Ndouble0.750.01
z +
z Ndouble0.0-MAXFLOAT
-1000

Attribute Descriptions

-
Damping +
Damping
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. -
K +
K
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 len can be used to + Note that the edge attribute len can be used to override this value for adjacent nodes. -
URL +
URL
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 @@ -513,29 +513,29 @@ This field indicates which graph component uses the attribute. 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.

- Note that, for edges, the attributes headURL, - tailURL, labelURL and - edgeURL allow control of various parts of an + Note that, for edges, the attributes headURL, + tailURL, labelURL and + edgeURL allow control of various parts of an edge. Also note that, if active areas of two edges overlap, it is unspecified which area dominates. -

arrowhead +
arrowhead
Style of arrowhead on the head node of an edge. - This will only appear if the dir attribute + This will only appear if the dir attribute is "forward" or "both". - See the limitation. + See the limitation. -
arrowsize +
arrowsize
Multiplicative scale factor for arrowheads. -
arrowtail +
arrowtail
Style of arrowhead on the tail node of an edge. - This will only appear if the dir attribute + This will only appear if the dir attribute is "back" or "both". - See the limitation. + See the limitation. -
aspect +
aspect
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 @@ -554,15 +554,15 @@ This field indicates which graph component uses the attribute. ccomps -x | dot | gvpack | neato -n2 to get a similar effect. -
bb +
bb
Bounding box of drawing in points. -
bgcolor +
bgcolor
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 - style, the - cluster's fillcolor will overlay the + style, the + cluster's fillcolor will overlay the background color.

If no background color is specified for the root graph, no graphics @@ -574,10 +574,10 @@ This field indicates which graph component uses the attribute. If this effect is not desired, and you only want to set bits explicitly assigned in drawing the graph, set bgcolor="transparent". -

center +
center
If true, the drawing is centered in the output canvas. -
charset +
charset
Specifies the character encoding used when interpreting string input as a text label. The default value is "UTF-8". The other legal value is "iso-8859-1" or, @@ -586,23 +586,23 @@ This field indicates which graph component uses the attribute. Note that if the character encoding used in the input does not match the charset value, the resulting output may be very strange. -
clusterrank +
clusterrank
Mode used for handling clusters. If clusterrank 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 label parameter, this label + If the cluster has a label 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. -
color +
color
Basic drawing color for graphics, not text. For the latter, use the - fontcolor attribute. + fontcolor attribute.

For edges, the value - can either be a single color or a colorList. + can either be a single color or a colorList. 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, @@ -617,30 +617,30 @@ This field indicates which graph component uses the attribute. yields
-

colorscheme +
colorscheme
This attribute specifies a color scheme namespace. If defined, it specifies the context for interpreting color names. In particular, if a - color value has form "xxx" or "//xxx", + color value has form "xxx" or "//xxx", then the color xxx will be evaluated according to the current color scheme. If no color scheme is set, the standard X11 naming is used. For example, if colorscheme=bugn9, then color=7 is interpreted as "/bugn9/7". -
comment +
comment
Comments are inserted into output. Device-dependent -
compound -
If true, allow edges between clusters. (See lhead - and ltail below.) +
compound +
If true, allow edges between clusters. (See lhead + and ltail below.) -
concentrate +
concentrate
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. -
constraint +
constraint
If false, the edge is not used in ranking the nodes. For example, in the graph
@@ -655,20 +655,20 @@ This field indicates which graph component uses the attribute.
   yielding the graph:
-
decorate +
decorate
If true, attach edge label to edge by a 2-segment polyline, underlining the label, then going to the closest point of spline. -
defaultdist +
defaultdist
This specifies the distance between nodes in separate connected components. If set too small, connected components may overlap. - Only applicable if pack=false. + Only applicable if pack=false. -
dim +
dim
Set the number of dimensions used for the layout. The maximum value allowed is 10. -
dimen +
dimen
Set the number of dimensions used for rendering. The maximum value allowed is 10. If both dimen and dim are set, the latter specifies @@ -683,76 +683,76 @@ This field indicates which graph component uses the attribute. All other coordinates will be 2D and, at best, will reflect a projection of a higher-dimensional point onto the plane. -
dir +
dir
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 arrowhead - and arrowtail attributes. - See limitation. + arrowhead can be specified using the arrowhead + and arrowtail attributes. + See limitation. -
diredgeconstraints -
Only valid when mode="ipsep". +
diredgeconstraints +
Only valid when mode="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 - mode="hier". The main difference is that, in the latter + mode="hier". The main difference is that, in the latter case, only these constraints are involved, so a faster solver can be used. -
distortion -
Distortion factor for shape=polygon. +
distortion +
Distortion factor for shape=polygon. Positive values cause top part to be larger than bottom; negative values do the opposite. -
dpi +
dpi
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. -
edgeURL +
edgeURL
If edgeURL is defined, this is the link used for the non-label - parts of an edge. This value overrides any URL + parts of an edge. This value overrides any URL defined for the edge. Also, this value is used near the head or tail node unless overridden - by a headURL or tailURL value, + by a headURL or tailURL value, respectively. - See limitation. + See limitation. -
edgehref -
Synonym for edgeURL. +
edgehref +
Synonym for edgeURL. -
edgetarget -
If the edge has a URL or edgeURL +
edgetarget +
If the edge has a URL or edgeURL 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 target is used. + If undefined, the value of the target is used. -
edgetooltip +
edgetooltip
Tooltip annotation attached to the non-label part of an edge. - This is used only if the edge has a URL - or edgeURL attribute. + This is used only if the edge has a URL + or edgeURL attribute. -
epsilon +
epsilon
Terminating condition. If the length squared of all energy gradients are < epsilon, the algorithm stops. -
esep +
esep
Margin used around polygons for purposes of spline edge routing. - The interpretation is the same as given for sep. - This should normally be strictly less than sep. + The interpretation is the same as given for sep. + This should normally be strictly less than sep. -
fillcolor +
fillcolor
Color used to fill the background of a node or cluster - assuming style=filled. - If fillcolor is not defined, color is + assuming style=filled. + If fillcolor is not defined, color is used. (For clusters, if color is not defined, - bgcolor is used.) If this is not defined, + bgcolor is used.) If this is not defined, the default is used, except for - shape=point or when the output + shape=point or when the output format is MIF, which use black by default.

@@ -760,16 +760,16 @@ This field indicates which graph component uses the attribute. Thus, if the root graph has defined a fillcolor, this will override a color or bgcolor attribute set for the cluster. -

fixedsize +
fixedsize
If true, the node size is specified by the values of the - width - and height attributes only + width + and height attributes only and is not expanded to contain the text label. -
fontcolor +
fontcolor
Color used for text. -
fontname +
fontname
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 @@ -777,7 +777,7 @@ This field indicates which graph component uses the attribute. Courier.

If Graphviz was built using the - fontconfig library, the latter library + fontconfig library, the latter library will be used to search for the font. However, if the fontname string contains a slash character "/", it is treated as a pathname for the font file, though font lookup will append the usual font suffixes. @@ -787,10 +787,10 @@ This field indicates which graph component uses the attribute. If you specify fontname=schlbk, the tool will look for a file named schlbk.ttf or schlbk.pfa or schlbk.pfb in one of the directories specified by - the fontpath attribute. + the fontpath attribute. The lookup does support various aliases for the common fonts. -

fontnames +
fontnames
Allows user control of how basic fontnames are represented in SVG output. If fontnames is undefined or "svg", the output will try to use known SVG fontnames. For example, the @@ -804,7 +804,7 @@ This field indicates which graph component uses the attribute. "Nimbus Roman No9 L". These last two options are useful with SVG viewers that support these richer fontname spaces. -
fontpath +
fontpath
Directory list used by libgd to search for bitmap fonts if Graphviz was not built with the fontconfig library. If fontpath is not set, the environment @@ -813,54 +813,54 @@ This field indicates which graph component uses the attribute. If not set, libgd uses its compiled-in font path. Note that fontpath is an attribute of the root graph. -
fontsize +
fontsize
Font size, in points, used for text. -
group +
group
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. -
headURL +
headURL
If headURL 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 - URL value. - See limitation. + URL value. + See limitation. -
headclip +
headclip
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. -
headhref -
Synonym for headURL. +
headhref +
Synonym for headURL. -
headlabel +
headlabel
Text label to be placed near head of edge. - See limitation. + See limitation. -
headport +
headport
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 limitation. + See limitation. -
headtarget -
If the edge has a headURL, +
headtarget +
If the edge has a headURL, 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 target is used. + If undefined, the value of the target is used. -
headtooltip +
headtooltip
Tooltip annotation attached to the head of an edge. This is used only - if the edge has a headURL attribute. + if the edge has a headURL attribute. -
height +
height
Height of node, in inches. This is taken as the initial, minimum height - of the node. If fixedsize is true, this + of the node. If fixedsize 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 @@ -874,10 +874,10 @@ This field indicates which graph component uses the attribute. If neither is set explicitly, the minimum of the two default values is used. -
href -
Synonym for URL. +
href +
Synonym for URL. -
id +
id
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 @@ -891,26 +891,26 @@ This field indicates which graph component uses the attribute. internally generated attributes. By making these distinct, the user can include multiple image maps in the same document. -
image +
image
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 - formats, + formats, typically JPEG, PNG, GIF or Postscript, and be able to be converted into the desired output format.

- Unlike with the shapefile attribute, + Unlike with the shapefile 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. -

imagescale +
imagescale
Attribute controlling how an image fills its containing node. In general, the image is given its natural size, - (cf. dpi), + (cf. dpi), 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 width and height. + minimum width and height. If, however, fixedsize=true, the width and height attributes specify the exact size of the node.

@@ -933,18 +933,18 @@ This field indicates which graph component uses the attribute. expansion, if imagescale=true, width and height are scaled uniformly. -

label +
label
Text label attached to objects. - If a node's shape is record, then the label can - have a special format + If a node's shape is record, then the label can + have a special format which describes the record layout. -
labelURL +
labelURL
If labelURL is defined, this is the link used for the label - of an edge. This value overrides any URL + of an edge. This value overrides any URL defined for the edge. -
label_scheme +
label_scheme
The value indicates whether to treat a node whose name has the form |edgelabel|* as a special node representing an edge label. The default (0) produces no effect. @@ -953,8 +953,8 @@ This field indicates which graph component uses the attribute. close to the old center of its neighbor. Finally, a value of 3 invokes a two-step process of overlap removal and straightening. -
labelangle -
This, along with labeldistance, determine +
labelangle +
This, along with labeldistance, determine where the headlabel (taillabel) are placed with respect to the head (tail) in polar coordinates. The origin in the coordinate system is @@ -966,32 +966,32 @@ This field indicates which graph component uses the attribute. with positive angles moving counterclockwise and negative angles moving clockwise. -
labeldistance +
labeldistance
Multiplicative scaling factor adjusting the distance that the headlabel(taillabel) is from the head(tail) node. - The default distance is 10 points. See labelangle + The default distance is 10 points. See labelangle for more details. -
labelfloat +
labelfloat
If true, allows edge labels to be less constrained in position. In particular, it may appear on top of other edges. -
labelfontcolor +
labelfontcolor
Color used for headlabel and taillabel. If not set, defaults to edge's fontcolor. -
labelfontname +
labelfontname
Font used for headlabel and taillabel. If not set, defaults to edge's fontname. -
labelfontsize +
labelfontsize
Font size, in points, used for headlabel and taillabel. If not set, defaults to edge's fontsize. -
labelhref -
Synonym for labelURL. +
labelhref +
Synonym for labelURL. -
labeljust +
labeljust
Justification for cluster labels. If "r", the label is right-justified within bounding rectangle; if "l", left-justified; else the label is centered. @@ -999,7 +999,7 @@ This field indicates which graph component uses the attribute. the root graph sets labeljust to "l", the subgraph inherits this value. -
labelloc +
labelloc
Vertical placement of labels for nodes, root graphs and clusters.

For graphs and clusters, only "t" and "b" are allowed, corresponding @@ -1016,39 +1016,39 @@ This field indicates which graph component uses the attribute. with the top, centered, or aligned with the bottom of the node, respectively. In the default case, the label is vertically centered. -

labeltarget -
If the edge has a URL or labelURL +
labeltarget +
If the edge has a URL or labelURL 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 target is used. + If undefined, the value of the target is used. -
labeltooltip +
labeltooltip
Tooltip annotation attached to label of an edge. - This is used only if the edge has a URL - or labelURL attribute. + This is used only if the edge has a URL + or labelURL attribute. -
landscape +
landscape
If true, the graph is rendered in landscape mode. Synonymous with - rotate=90 or - orientation=landscape. + rotate=90 or + orientation=landscape. -
layer +
layer
Specifies layers in which the node or edge is present. -
layers +
layers
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 How to use drawing layers (overlays). -
layersep +
layersep
Specifies the separator characters used to split the - layers attribute into a list of layer names. + layers attribute into a list of layer names. -
layout +
layout
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 @@ -1057,47 +1057,47 @@ This field indicates which graph component uses the attribute. associated layout algorithm was.

This attribute takes precedence over - the -K flag + the -K flag or the actual command name used. -

len +
len
Preferred edge length, in inches. -
levels +
levels
Number of levels allowed in the multilevel scheme. -
levelsgap +
levelsgap
Specifies strictness of level constraints in neato - when mode="ipsep" or "hier". + when mode="ipsep" or "hier". 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. -
lhead -
Logical head of an edge. When compound is true, +
lhead +
Logical head of an edge. When compound is true, if lhead is defined and is the name of a cluster containing the real head, the edge is clipped to the boundary of the cluster. - See limitation. + See limitation. -
lheight +
lheight
Height of graph or cluster label, in inches. -
lp +
lp
Label position, in points. The position indicates the center of the label. -
ltail -
Logical tail of an edge. When compound is true, +
ltail +
Logical tail of an edge. When compound is true, if ltail is defined and is the name of a cluster containing the real tail, the edge is clipped to the boundary of the cluster. - See limitation. + See limitation. -
lwidth +
lwidth
Width of graph or cluster label, in inches. -
margin +
margin
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.

@@ -1105,28 +1105,28 @@ This field indicates which graph component uses the attribute. 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 pad attribute. + a drawing, see the pad attribute.

For nodes, this attribute specifies space left around the node's label. By default, the value is 0.11,0.055. -

maxiter +
maxiter
Sets the number of iterations used. -
mclimit +
mclimit
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. -
mindist +
mindist
Specifies the minimum separation between all nodes. -
minlen +
minlen
Minimum edge length (rank difference between head and tail). -
mode +
mode
Technique for optimizing the layout. For neato, if mode is "major", neato uses stress majorization. If mode is "KK", neato uses a version of the gradient descent method. The only advantage @@ -1137,19 +1137,19 @@ This field indicates which graph component uses the attribute. There are two experimental modes in neato, "hier", which adds a top-down directionality similar to the layout used in dot, and "ipsep", which allows the graph to specify minimum vertical and horizontal distances - between nodes. (See the sep attribute.) + between nodes. (See the sep attribute.)

For sfdp, the default mode is "spring", which corresponds to using a spring-electrical model. Setting mode to "maxent" causes a similar model to be run but one that also takes into account edge lengths specified by a the "len" attribute. -

model +
model
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 len + where the length of each edge is given by its len attribute. If model is "circuit", neato uses the circuit resistance model to compute the distances. This tends to emphasize clusters. If @@ -1159,23 +1159,23 @@ This field indicates which graph component uses the attribute. to separate nodes with high degree.

For more control of distances, one can use model=mds. In this - case, the len of an edge is used as the ideal distance + case, the len of an edge is used as the ideal distance between its vertices. A shortest path calculation is only used for pairs of nodes not connected by an edge. Thus, by supplying a complete graph, the input can specify all of the relevant distances. -

mosek +
mosek
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. -
nodesep +
nodesep
Minimum space between two adjacent nodes in the same rank, in inches. -
nojustify +
nojustify
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 margin). + (shifted by the prescribed margin). In record nodes, left-justified line will line up with the left side of the enclosing column of fields. If nojustify is "true", multi-line labels will be justified @@ -1184,20 +1184,20 @@ This field indicates which graph component uses the attribute. the second will align with the left-most character in the first line, regardless of how large the node might be. -
normalize +
normalize
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. -
nslimit -,
nslimit1 +
nslimit +,
nslimit1
Used to set number of iterations in network simplex applications. nslimit is used in computing node x coordinates, nslimit1 for ranking nodes. If defined, # iterations = nslimit(1) * # nodes; otherwise, # iterations = MAXINT. -
ordering +
ordering
If the value of the attribute is "out", then the outedges of a node, that is, edges with the node as its tail node, must appear @@ -1211,19 +1211,19 @@ This field indicates which graph component uses the attribute. in the graph or subgraph. Note that the graph attribute takes precedence over the node attribute. -
orientation +
orientation
Angle, in degrees, used to rotate polygon node shapes. For any number of polygon sides, 0 degrees rotation results in a flat base. -
orientation +
orientation
If "[lL]*", set graph orientation to landscape - Used only if rotate is not defined. + Used only if rotate is not defined. -
outputorder +
outputorder
Specify order in which nodes and edges are drawn. -
overlap +
overlap
Determines if and how node overlaps should be removed. Nodes are first - enlarged using the sep attribute. + enlarged using the sep attribute. If "true" , overlaps are retained. If the value is "scale", overlaps are removed by uniformly scaling in x and y. If the value converts to "false", and it is available, Prism, a proximity graph-based algorithm, is @@ -1231,7 +1231,7 @@ This field indicates which graph component uses the attribute. This can also be invoked explicitly with "overlap=prism". This technique starts with a small scaling up, controlled by the - overlap_scaling attribute, + overlap_scaling 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 @@ -1268,7 +1268,7 @@ This field indicates which graph component uses the attribute. to the previous four, except only pseudo-orthogonal ordering is enforced.

- If the layout is done by neato with mode="ipsep", + If the layout is done by neato with mode="ipsep", then one can use overlap=ipsep. In this case, the overlap removal constraints are incorporated into the layout algorithm itself. @@ -1295,7 +1295,7 @@ This field indicates which graph component uses the attribute. This is not quite true for the "porth*" cases. For these, orthogonal ordering is only preserved among nodes related by an edge. -

overlap_scaling +
overlap_scaling
When overlap=prism, 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. @@ -1306,7 +1306,7 @@ This field indicates which graph component uses the attribute. overlap_scaling. If overlap_scaling is zero, no scaling is done. -
pack +
pack
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. @@ -1315,18 +1315,18 @@ This field indicates which graph component uses the attribute. 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 - packmode attribute. + packmode attribute.

For layouts which always do packing, such a twopi, the pack attribute is just used to set the margin. -

packmode +
packmode
This indicates how connected components should be packed - (cf. packMode). Note that defining + (cf. packMode). Note that defining packmode will automatically turn on packing as though one had set pack=true. -
pad +
pad
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 @@ -1337,7 +1337,7 @@ This field indicates which graph component uses the attribute. a background color is used, to avoid having nodes and edges abutting the boundary of the drawn region. -
page +
page
Width and height of output pages, in inches. If only a single value is given, this is used for both the width and height.

@@ -1346,29 +1346,29 @@ This field indicates which graph component uses the attribute. 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 - pagedir order. + pagedir order.

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 viewport to generate + output files. Or use the viewport to generate multiple files. -

pagedir -
If the page attribute is set and applicable, +
pagedir +
If the page 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. -
pencolor +
pencolor
Color used to draw the bounding box around a cluster. - If pencolor is not defined, color is - used. If this is not defined, bgcolor is used. + If pencolor is not defined, color is + used. If this is not defined, bgcolor is used. If this is not defined, the default is used.

Note that a cluster inherits the root graph's attributes if defined. Thus, if the root graph has defined a pencolor, this will override a color or bgcolor attribute set for the cluster. -

penwidth +
penwidth
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. @@ -1376,22 +1376,22 @@ This field indicates which graph component uses the attribute.

Previous to 31 January 2008, the effect of penwidth=W was achieved by including setlinewidth(W) - as part of a style specification. + as part of a style specification. If both are used, penwidth will be used. -

peripheries +
peripheries
Set number of peripheries used in polygonal shapes and cluster boundaries. Note that - user-defined shapes are treated as a + user-defined shapes 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 peripheries=0 will turn this off. Also, 1 is the maximum peripheries value for clusters. -
pin +
pin
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 point type). + in the pos attribute itself (cf. the point type).

Note: Due to an artifact of the implementation, final coordinates are translated to the origin. Thus, if you look at the output coordinates @@ -1401,25 +1401,25 @@ This field indicates which graph component uses the attribute. difference between the old and new coordinates will give the translation, which can then be subtracted from all of the appropriate coordinates. -

pos +
pos
Position of node, or spline control points. For nodes, the position indicates the center of the node. On output, the coordinates are in points.

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 - -s command line flag can be used to specify + -s 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.

- When the -n command line flag is used with + When the -n 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, neato -n can accept input correctly without requiring a -s flag and, in fact, ignores any such flag. -

quadtree +
quadtree
Quadtree scheme to use.

A TRUE bool value corresponds to "normal"; @@ -1427,11 +1427,11 @@ This field indicates which graph component uses the attribute. As a slight exception to the normal interpretation of bool, a value of "2" corresponds to "fast". -

quantum +
quantum
If quantum > 0.0, node label dimensions will be rounded to integral multiples of the quantum. -
rank +
rank
Rank constraints on the nodes in a subgraph. If rank="same", all nodes are placed on the same rank. If rank="min", all nodes are placed on the minimum rank. @@ -1443,15 +1443,15 @@ This field indicates which graph component uses the attribute. minimum rank is topmost or leftmost, and the maximum rank is bottommost or rightmost.) -
rankdir +
rankdir
Sets direction of graph layout. For example, if rankdir="LR", and barring cycles, an edge T -> H; will go from left to right. By default, graphs are laid out from top to bottom.

This attribute also has a side-effect in determining how record nodes - are interpreted. See record shapes. + are interpreted. See record shapes. -

ranksep +
ranksep
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 @@ -1465,10 +1465,10 @@ This field indicates which graph component uses the attribute. radius from the first circle to the second; etc. If there are more circles than numbers, the last number is used as the increment for the remainder. -
ratio +
ratio
Sets the aspect ratio (drawing height/drawing width) for the drawing. Note that this is adjusted before - the size attribute constraints are enforced. + the size attribute constraints are enforced. In addition, the calculations usually ignore the node sizes, so the final drawing size may only approximate what is desired.

@@ -1478,64 +1478,64 @@ This field indicates which graph component uses the attribute. desired ratio; if the actual ratio is greater than that desired ratio, the drawing width is scaled up.

- If ratio = "fill" and the size + If ratio = "fill" and the size attribute is set, node positions are scaled, separately in both x and y, so that the final drawing exactly fills the specified size. - If both size values exceed the width + If both size values exceed the width and height of the drawing, then both coordinate values of each node are scaled up accordingly. However, if either size dimension is smaller than the corresponding dimension in the drawing, one dimension is scaled up so that the final drawing has the same aspect - ratio as specified by size. + ratio as specified by size. Then, when rendered, the layout will be scaled down uniformly in both dimensions to fit the given - size, which may cause nodes and text + size, which may cause nodes and text to shrink as well. This may not be what the user wants, but it avoids the hard problem of how to reposition the nodes in an acceptable fashion to reduce the drawing size.

- If ratio = "compress" and the size + If ratio = "compress" and the size 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.

- If ratio = "expand", the size + If ratio = "expand", the size attribute is set, and both the width and the height of the graph are - less than the value in size, node positions are scaled + less than the value in size, node positions are scaled uniformly until at least - one dimension fits size exactly. - Note that this is distinct from using size as the + one dimension fits size exactly. + Note that this is distinct from using size as the desired size, as here the drawing is expanded before edges are generated and all node and text sizes remain unchanged.

- If ratio = "auto", the page + If ratio = "auto", the page attribute is set and the graph cannot be drawn on a single page, - then size is set to an ``ideal'' value. + then size 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. -

rects +
rects
Rectangles for fields of records, in points. -
regular +
regular
If true, force polygon to be regular, i.e., the vertices of the polygon will lie on a circle whose center is the center of the node. -
remincross +
remincross
If true and there are multiple clusters, run cross minimization a second time. -
repulsiveforce +
repulsiveforce
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. -
resolution -
This is a synonym for the dpi attribute. +
resolution +
This is a synonym for the dpi attribute. -
root +
root
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 @@ -1548,39 +1548,39 @@ This field indicates which graph component uses the attribute. If the root attribute is defined as the empty string, twopi will reset it to name of the node picked as the root node. -
rotate +
rotate
If 90, set drawing orientation to landscape. -
rotation +
rotation
Causes the final layout to be rotated counter-clockwise by the specified number of degrees. -
samehead +
samehead
Edges with the same head and the same samehead value are aimed at the same point on the head. - See limitation. + See limitation. -
sametail +
sametail
Edges with the same tail and the same sametail value are aimed at the same point on the tail. - See limitation. + See limitation. -
samplepoints -
If the input graph defines the vertices +
samplepoints +
If the input graph defines the vertices 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. -
scale +
scale
If set, after the initial layout, twopi will scale the layout by the given factors. The scaling uses the root node of each component as the center of the scaling. If only a single number is given, this is used for both factors. -
searchsize +
searchsize
During network simplex, maximum number of edges with negative cut values to search when looking for one with minimum cut value. -
sep +
sep
Specifies margin to leave around nodes when removing node overlap. This guarantees a minimal non-zero distance between nodes.

@@ -1593,22 +1593,22 @@ This field indicates which graph component uses the attribute.

If only a single number is given, this is used for both dimensions.

- If unset but esep is defined, the sep values + If unset but esep is defined, the sep values will be set to the esep values divided by 0.8. If esep is unset, the default value is used. -

shape +
shape
Set the shape of a node. -
shapefile +
shapefile
(Deprecated) If defined, shapefile specifies a file containing user-supplied node content. - The shape of the node is set to box. + The shape 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 - output format. For further details, see - Image Formats and - External PostScript files. + output format. For further details, see + Image Formats and + External PostScript files.

There is one exception to this usage. If shape is set to "epsf", shapefile gives @@ -1616,17 +1616,17 @@ This field indicates which graph component uses the attribute. The graphics defined must be contain all of the node content, including any desired boundaries. For further details, see - + External PostScript files. -

showboxes +
showboxes
Print guide boxes in PostScript at the beginning of routesplines if 1, or at the end if 2. (Debugging) -
sides -
Number of sides if shape=polygon. +
sides +
Number of sides if shape=polygon. -
size +
size
Maximum width and height of drawing, in inches. If only a single number is given, this is used for both the width and the height. @@ -1642,22 +1642,22 @@ This field indicates which graph component uses the attribute. least one dimension equals its dimension in size.

Note that there is some interaction between the size and - ratio attributes. + ratio attributes. -

skew -
Skew factor for shape=polygon. Positive values +
skew +
Skew factor for shape=polygon. Positive values skew top of polygon to right; negative to left. -
smoothing +
smoothing
Specifies a post-processing step used to smooth out an uneven distribution of nodes. -
sortv -
If packmode indicates an array packing, +
sortv +
If packmode indicates an array packing, this attribute specifies an insertion order among the components, with smaller values inserted first. -
splines +
splines
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. @@ -1674,77 +1674,77 @@ This field indicates which graph component uses the attribute. 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 splines="true", this - requires non-overlapping nodes (cf. overlap). + requires non-overlapping nodes (cf. overlap). If fdp is used for layout and splines="compound", then the edges are drawn to avoid clusters as well as nodes. -
start +
start
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. -
style +
style
Set style for node or edge. For cluster subgraph, if "filled", the cluster box's background is filled. -
stylesheet +
stylesheet
A URL or pathname specifying an XML style sheet, used in SVG output. -
tailURL +
tailURL
If tailURL 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 - URL value. - See limitation. + URL value. + See limitation. -
tailclip +
tailclip
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. -
tailhref -
Synonym for tailURL. +
tailhref +
Synonym for tailURL. -
taillabel +
taillabel
Text label to be placed near tail of edge. - See limitation. + See limitation. -
tailport +
tailport
Indicates where on the tail node to attach the tail of the edge. - See limitation. + See limitation. -
tailtarget -
If the edge has a tailURL, +
tailtarget +
If the edge has a tailURL, 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 target is used. + If undefined, the value of the target is used. -
tailtooltip +
tailtooltip
Tooltip annotation attached to the tail of an edge. This is used only - if the edge has a tailURL attribute. + if the edge has a tailURL attribute. -
target +
target
If the object has a URL, this attribute determines which window of the browser is used for the URL. - See W3C documentation. + See W3C documentation. -
tooltip +
tooltip
Tooltip annotation attached to the node or edge. If unset, Graphviz - will use the object's label if defined. + will use the object's label 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 tooltip attribute explicitly. -
truecolor +
truecolor
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 shapefile property + unless there is a shapefile property for some node in the graph. The output model will use the input model when possible.

@@ -1753,35 +1753,35 @@ This field indicates which graph component uses the attribute.

Usually, the only time it is necessary to specify the truecolor model is if the graph uses more than 256 colors. - However, if one uses bgcolor=transparent with + However, if one uses bgcolor=transparent with a color palette, font antialiasing can show up as a fuzzy white area around characters. Using truecolor=true avoids this problem. -

vertices +
vertices
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 - samplepoints attribute affects + samplepoints attribute affects the output. -
viewport +
viewport
Clipping window on final drawing. Note that this attribute supersedes any - size attribute. The width and height of the viewport specify + size attribute. The width and height of the viewport specify precisely the final size of the output. -
voro_margin +
voro_margin
Factor to scale up drawing to allow margin for expansion in Voronoi technique. dim' = (1+2*margin)*dim. -
weight +
weight
Weight of edge. In dot, the heavier the weight, the shorter, straighter and more vertical the edge is. -
width +
width
Width of node, in inches. This is taken as the initial, minimum width - of the node. If fixedsize is true, this + of the node. If fixedsize 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 @@ -1795,16 +1795,16 @@ This field indicates which graph component uses the attribute. If neither is set explicitly, the minimum of the two default values is used. -
z -
Deprecated:Use pos attribute, along - with dimen and/or dim +
z +
Deprecated:Use pos attribute, along + with dimen and/or dim to specify dimensions.

Provides z coordinate value for 3D layouts and displays. If the - graph has dim set to 3 (or more), + graph has dim set to 3 (or more), neato will use a node's z value for the z coordinate of its initial position if - its pos attribute is also defined. + its pos attribute is also defined.

Even if no z values are specified in the input, it is necessary to declare a z attribute for nodes, e.g, using node[z=""] @@ -1821,7 +1821,7 @@ This field indicates which graph component uses the attribute. The following list gives the legal strings corresponding to values of the given types.

-
arrowType +
arrowType
@@ -1845,7 +1845,7 @@ the given types.
"normal" "inv"

These are the basic set of backward-compatible arrow shapes. In addition, - there is a grammar of arrow shapes + there is a grammar of arrow shapes 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 (box, crow, diamond, @@ -1858,20 +1858,20 @@ the given types. (ediamond, open, halfopen, empty, invempty). -

aspectType +
aspectType

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. -

clusterMode +
clusterMode
"local","global","none" -
color +
color
Colors can be specified using one of four formats. -
"#%2x%2x%2x"Red-Green-Blue (RGB)
"#%2x%2x%2x%2x"Red-Green-Blue-Alpha (RGBA)
H[, ]+S[, ]+VHue-Saturation-Value (HSV) 0.0 <= H,S,V <= 1.0
stringcolor name
+ stringcolor name The specification for the RGB and RGBA formats are the format strings used by sscanf 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 @@ -1880,7 +1880,7 @@ the given types.

String-valued color specifications are case-insensitive and interpreted in the context of the current color scheme, as specified by the - colorscheme attribute. If this is undefined, + colorscheme attribute. If this is undefined, the X11 naming scheme will be used. An initial "/" character can be used to override the use of the colorscheme attribute. In particular, a single initial @@ -1892,8 +1892,8 @@ the given types. Thus, the forms "yyyy" and "//yyyy" are equivalent.

At present, Graphviz recognizes the default color scheme X11, - and the Brewer color schemes (cf. ColorBrewer). Please note that Brewer - color schemes are covered by this license. + and the Brewer color schemes (cf. ColorBrewer). Please note that Brewer + color schemes are covered by this license.

Examples:
@@ -1909,15 +1909,15 @@ the given types. 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 bgcolor attribute. + the bgcolor attribute. Usually, the same effect can be achieved by setting - style to invis. + style to invis. -
colorList +
colorList
A colon-separated list of color values: C(:C)* - where each C is a color value. + where each C is a color value. -
dirType +
dirType
For an edge T -> H;
"forward" @@ -1934,11 +1934,11 @@ the given types. the righthand one, is treated as the head for the purpose of interpreting "forward" and "back". -
doubleList +
doubleList
A colon-separated list of doubles: d(:d)* where each d is a double. -
escString +
escString
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, @@ -1955,30 +1955,30 @@ the given types. In all cases, the substring "\L" is replaced by the object's label attribute.

In addition, if the associated attribute is - label, - headlabel or taillabel, + label, + headlabel or taillabel, the escape sequences "\n", "\l" and "\r" divide the label into lines, centered, left-justified, and right-justified, respectively. -

layerList +
layerList
list of strings separated by characters from the - layersep attribute (by default, colons, - tabs or spaces), defining layer + layersep attribute (by default, colons, + tabs or spaces), defining layer names and implicitly numbered 1,2,... -
layerRange +
layerRange
layerId or layerIdslayerId,
where layerId = "all", - a decimal integer or a layer name. + a decimal integer or a layer name. (An integer i corresponds to layer i.) The string s consists of 1 or more separator characters specified - by the layersep attribute. + by the layersep attribute. -
lblString -
an escString - or an HTML label. +
lblString +
an escString + or an HTML label. -
outputMode +
outputMode
"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 @@ -1991,7 +1991,7 @@ the given types. if the resulting drawing is ambiguous. This can be achieved by choosing "edgesfirst". -
packMode +
packMode
"node", "clust" , "graph" , "array[_flags][%d]"

The modes "node", "clust" or "graph" @@ -2028,12 +2028,12 @@ the given types. 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 sortv attribute. + non-negative integer using the sortv attribute. Components are inserted in order, starting with the one with the smallest sort value. If no sort value is specified, zero is used. -

pagedir +
pagedir
"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 @@ -2043,28 +2043,28 @@ the given types. to right, then the next row up, from left to right, and so on, until the topmost row is traversed. -
point +
point
"%f,%f"('!') representing the point (x,y). The optional '!' indicates the node position should not change (input-only).

- If dim is 3 or more, point may also have + If dim is 3 or more, point may also have the format "%f,%f,%f"('!') to represent the point (x,y,z). -

pointf +
pointf
"%lf,%lf" representing the point (x,y). -
pointfList +
pointfList
list of pointf, separated by spaces. -
portPos +
portPos
modifier indicating where on a node an edge should be aimed. It has the form portname[:compass_point] or compass_point. If the first form is used, the corresponding node must either have - record shape with one of its fields + record shape with one of its fields having the given portname, - or have an HTML-like label, one of + or have an HTML-like label, one of whose components has a PORT attribute set to portname.

If a compass point is used, it must have the form @@ -2079,8 +2079,8 @@ the given types.

This attribute can be attached to an edge using the - headport and - tailport attributes, or as part of the + headport and + tailport attributes, or as part of the edge description as in

node1:port1 -> node2:port5:nw; @@ -2093,42 +2093,42 @@ the given types. At present, in this case, there is no way to specify that the compass point should be used. -
quadType +
quadType
"normal", "fast", "none".

Using "fast" gives about a 2-4 times overall speedup compared with "normal", though layout quality can suffer a little. -

rankType +
rankType
"same", "min", "source", "max", "sink" -
rankdir +
rankdir
"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. -
rect +
rect
"%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). -
shape -
A string specifying the shape of a node. +
shape +
A string specifying the shape of a node. There are three main types of shapes : - polygon-based, - record-based and - user-defined. + polygon-based, + record-based and + user-defined. The record-based shape has largely been superseded and greatly generalized - by HTML-like labels. + by HTML-like labels. That is, instead of using shape=record, one might consider using shape=none and an HTML-like label. -
smoothType +
smoothType
Values are "none", "avg_dist", "graph_dist", "power_dist", "rng", "spring" and "triangle". -
splineType +
splineType
spline ( ';' spline )*
@@ -2142,7 +2142,7 @@ the given types. goes from p1 to startp. If startp is not given, p1 touches a node. Similarly for pn and endp. -
startType +
startType
has the syntax [style][seed].

If style is present, it must be one of the strings "regular", @@ -2161,10 +2161,10 @@ the given types. If the value is just "random", a time-based seed is chosen.

Note that input positions, specified by a node's - pos + pos attribute, are only used when the style is "random". -

style +
style
styleItem ( ',' styleItem )*
where spline=(endp)? (startp)? point (triple)+
@@ -2190,9 +2190,9 @@ the given types. width of the line in points. For example, style="bold" is equivalent to style="setlinewidth(2)". The use of setlinewidth is deprecated; one should use the - penwidth attribute instead. + penwidth attribute instead. -
viewPort +
viewPort
"%lf,%lf,%lf,%lf,%lf" or "%lf,%lf,%lf,'%s'"

The viewPort W,H,Z,x,y or W,H,Z,N @@ -2207,7 +2207,7 @@ the given types. 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 bb. + value of the bounding box attribute bb.

Sample values: 50,50,.5,'2.8 BSD' or 100,100,2,450,300. The first will take the 100x100 point square centered on the node 2.8 BSD

where styleItem=name or name'('args')'