Mercurial > hg > camir-aes2014

annotate toolboxes/graph_visualisation/share/man/man1/osage.1 @ 0:e9a9cd732c1e tip

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
first hg version after svn
author wolffd
date Tue, 10 Feb 2015 15:05:51 +0000
parents
children
rev   line source
wolffd@0 1 .TH OSAGE 1 "27 May 2009" \*(eX
wolffd@0 2 .SH NAME
wolffd@0 3 osage \- filter for drawing clustered graphs
wolffd@0 4 .SH SYNOPSIS
wolffd@0 5 \fBosage\fR
wolffd@0 6 [\fB\-\fR(\fBG\fR|\fBN\fR|\fBE\fR)\fIname=value\fR]
wolffd@0 7 [\fB\-T\fIlang\fR]
wolffd@0 8 [\fB\-l\fIlibfile\fR]
wolffd@0 9 [\fB\-o\fIoutfile\fR]
wolffd@0 10 [\fB\-O\fR]
wolffd@0 11 [\fB\-P\fR]
wolffd@0 12 [\fB\-v\fR]
wolffd@0 13 [\fB\-V\fR]
wolffd@0 14 [files]
wolffd@0 15 .SH DESCRIPTION
wolffd@0 16 .I osage
wolffd@0 17 draws clustered graphs. As input, it takes any graph in the
wolffd@0 18 .I dot
wolffd@0 19 format. It draws the graph recursively. At each level, there will
wolffd@0 20 be a collection of nodes and a collection of cluster subgraphs.
wolffd@0 21 The internals of each cluster subgraph are laid out, then the
wolffd@0 22 cluster subgraphs and nodes at the current level are positioned
wolffd@0 23 relative to each other, treating each cluster subgraph as a node.
wolffd@0 24 .P
wolffd@0 25 At each level, the nodes and cluster subgraphs are viewed as rectangles
wolffd@0 26 to be packed together. At present, edges are ignored during packing.
wolffd@0 27 Packing is done using the standard packing functions. In particular,
wolffd@0 28 the graph attributes \fBpack\fP and \fBpackmode\fP control the layout.
wolffd@0 29 Each graph and cluster can specify its own values for these attributes.
wolffd@0 30 Remember also that a cluster inherits its attribute values from
wolffd@0 31 its parent graph.
wolffd@0 32 .P
wolffd@0 33 After all nodes and clusters, edges are routed based on the value of
wolffd@0 34 the \fBsplines\fP attribute.
wolffd@0 35 .SH OUTPUT FORMATS
wolffd@0 36 Osage uses an extensible plugin mechanism for its output renderers,
wolffd@0 37 so to see what output formats your installation of osage supports
wolffd@0 38 you can use ``osage \-Txxx'' (where xxx is an unlikely format)
wolffd@0 39 and check the warning message.
wolffd@0 40 Also, The plugin mechanism supports multiple implementations
wolffd@0 41 of the output formats.
wolffd@0 42 To see what variants are available, use, for example: ``osage \-Tpng:''
wolffd@0 43 and to force a particular variant, use, for example: ``osage \-Tpng:gd''
wolffd@0 44 .P
wolffd@0 45 Traditionally, osage supports the following:
wolffd@0 46 \fB\-Tps\fP (PostScript),
wolffd@0 47 \fB\-Tsvg\fP \fB\-Tsvgz\fP (Structured Vector Graphics),
wolffd@0 48 \fB\-Tfig\fP (XFIG graphics),
wolffd@0 49 \fB\-Tmif\fP (FrameMaker graphics),
wolffd@0 50 \fB\-Thpgl\fP (HP pen plotters), and \fB\-Tpcl\fP (Laserjet printers),
wolffd@0 51 \fB\-Tpng\fP \fB\-Tgif\fP (bitmap graphics),
wolffd@0 52 \fB\-Tdia\fP (GTK+ based diagrams),
wolffd@0 53 \fB\-Timap\fP (imagemap files for httpd servers for each node or edge
wolffd@0 54 that has a non\(hynull "href" attribute.),
wolffd@0 55 \fB\-Tcmapx\fP (client\(hyside imagemap for use in html and xhtml).
wolffd@0 56 Additional less common or more special\(hypurpose output formats
wolffd@0 57 can be found at http://www.graphviz.org/cvs/doc/info/output.html.)
wolffd@0 58 .P
wolffd@0 59 Alternative plugins providing support for a given output format
wolffd@0 60 can be found from the error message resulting from appending a ':' to the format. e.g. \fB-Tpng:\fP
wolffd@0 61 The first plugin listed is always the default.
wolffd@0 62 .SH GRAPH FILE LANGUAGE
wolffd@0 63 Here is a synopsis of the graph file language, traditionally using the extension \fB.gv\fR or \fB.dot\fR, for graphs:
wolffd@0 64 .PP
wolffd@0 65 [\fBstrict\fR] (\fBgraph\fR|\fBdigraph\fR) \fIname\fP { \fIstatement\(hylist\fP }\fR
wolffd@0 66 .br
wolffd@0 67 Is the top level graph. If the graph is \fBstrict\fR then multiple edges are
wolffd@0 68 not allowed between the same pairs of nodes.
wolffd@0 69 If it is a directed graph, indicated by \fBdigraph\fR,
wolffd@0 70 then the \fIedgeop\fR must be "\->". If it is an undirected \fBgraph\fR
wolffd@0 71 then the \fIedgeop\fR must be "\-\-".
wolffd@0 72 Statements may be:
wolffd@0 73 .PP
wolffd@0 74 \fIname\fB=\fIval\fB;\fR
wolffd@0 75 .br
wolffd@0 76 \fBnode [\fIname\fB=\fIval\fB];\fR
wolffd@0 77 .br
wolffd@0 78 \fBedge [\fIname\fB=\fIval\fB];\fR
wolffd@0 79 .br
wolffd@0 80 Set default graph, node, or edge attribute \fIname\fP to \fIval\fP.
wolffd@0 81 Any subgraph, node, or edge appearing after this inherits the new
wolffd@0 82 default attributes.
wolffd@0 83 .PP
wolffd@0 84 \fBn0 [\fIname0=val0,name1=val1,...\fB];\fR
wolffd@0 85 Creates node \fBn0\fP (if it does not already exist)
wolffd@0 86 and sets its attributes according to the optional list.
wolffd@0 87 .PP
wolffd@0 88 \fBn0 \fIedgeop\fR n1 \fIedgeop\fR \fI...\fB \fIedgeop\fR nn [\fIname0=val0,name1=val1,...\fB];\fR
wolffd@0 89 .br
wolffd@0 90 Creates edges between nodes \fBn0\fP, \fBn1\fP, ..., \fBnn\fP and sets
wolffd@0 91 their attributes according to the optional list.
wolffd@0 92 Creates nodes as necessary.
wolffd@0 93 .PP
wolffd@0 94 [\fBsubgraph \fIname\fB] { \fIstatement\(hylist \fB}\fR
wolffd@0 95 .br
wolffd@0 96 Creates a subgraph. Subgraphs may be used in place
wolffd@0 97 of \fBn0\fP, ..., \fBnn\fP in the above statements to create edges.
wolffd@0 98 [\fBsubgraph \fIname\fR] is optional;
wolffd@0 99 if missing, the subgraph is assigned an internal name.
wolffd@0 100 .PP
wolffd@0 101 Comments may be /*C\(hylike*/ or //C++\(hylike.
wolffd@0 102
wolffd@0 103 .PP
wolffd@0 104 Attribute names and values are ordinary (C\(hystyle) strings.
wolffd@0 105 The following sections describe attributes that control graph layout.
wolffd@0 106
wolffd@0 107 .SH "GRAPH ATTRIBUTES"
wolffd@0 108 .PP
wolffd@0 109 \fBsize="\fIx,y\fP"\fR sets bounding box of drawing in inches.
wolffd@0 110 .PP
wolffd@0 111 \fBpage="\fIx,y\fP"\fR sets the PostScript pagination unit.
wolffd@0 112 .PP
wolffd@0 113 \fBratio=\fIf\fR sets the aspect ratio to \fIf\fP which may be
wolffd@0 114 a floating point number, or one of the keywords \fBfill\fP,
wolffd@0 115 \fBcompress\fP, or \fBauto\fP.
wolffd@0 116 .PP
wolffd@0 117 \fBpagedir=\fR[TBLR][TBLR] sets the major and minor order of pagination.
wolffd@0 118 .PP
wolffd@0 119 \fBrotate=90\fR sets landscape mode.
wolffd@0 120 (\fBorientation=land\fR is backward compatible but obsolete.)
wolffd@0 121 .PP
wolffd@0 122 \fBcenter=\fIn\fR a non\(hyzero value centers the drawing on the page.
wolffd@0 123 .PP
wolffd@0 124 \fBlayers="\fIid:id:id:id\fR" is a sequence of layer identifiers for
wolffd@0 125 overlay diagrams. The PostScript array variable \fIlayercolorseq\fR
wolffd@0 126 sets the assignment of colors to layers. The least index is 1 and
wolffd@0 127 each element must be a 3\(hyelement array to be interpreted as a color coordinate.
wolffd@0 128 .PP
wolffd@0 129 \fBcolor=\fIcolorvalue\fR sets foreground color (\fBbgcolor\fP for background).
wolffd@0 130 .PP
wolffd@0 131 \fBhref=\fI"url"\fR the default url for image map files; in PostScript files,
wolffd@0 132 the base URL for all relative URLs, as recognized by Acrobat Distiller
wolffd@0 133 3.0 and up.
wolffd@0 134 .PP
wolffd@0 135 \fBURL=\fI"url"\fR ("URL" is a synonym for "href".)
wolffd@0 136 .PP
wolffd@0 137 \fBstylesheet=\fI"file.css"\fR includes a reference to a stylesheet
wolffd@0 138 in \-Tsvg and \-Tsvgz outputs. Ignored by other formats.
wolffd@0 139 .PP
wolffd@0 140 \fBsplines\fR. If set to \fItrue\fR, edges are
wolffd@0 141 drawn as splines.
wolffd@0 142 If set to \fIpolyline\fR, edges are
wolffd@0 143 drawn as polylines.
wolffd@0 144 If set to \fIortho\fR, edges are
wolffd@0 145 drawn as orthogonal polylines.
wolffd@0 146 In all of these cases, the nodes may not overlap.
wolffd@0 147 If \fBsplines=\fIfalse\fR or \fBsplines=\fIline\fR, edges are
wolffd@0 148 drawn as line segments.
wolffd@0 149 The default is \fIfalse\fR.
wolffd@0 150
wolffd@0 151 .SH "NODE ATTRIBUTES"
wolffd@0 152 .PP
wolffd@0 153 \fBheight=\fId\fR or \fBwidth=\fId\fR sets minimum height or width.
wolffd@0 154 Adding \fBfixedsize=true\fP forces these to be the actual size
wolffd@0 155 (text labels are ignored).
wolffd@0 156 .PP
wolffd@0 157 \fBshape=record polygon epsf \fIbuiltin_polygon\fR
wolffd@0 158 .br
wolffd@0 159 \fIbuiltin_polygon\fR is one of: \fBplaintext ellipse oval circle egg
wolffd@0 160 triangle box diamond trapezium parallelogram house hexagon octagon
wolffd@0 161 note tab box3d component.\fR
wolffd@0 162 (Polygons are defined or modified by the following node attributes:
wolffd@0 163 \fBregular\fR, \fBperipheries\fR, \fBsides\fR, \fBorientation\fR,
wolffd@0 164 \fBdistortion\fR and \fBskew\fR.) \fBepsf\fR uses the node's
wolffd@0 165 \fBshapefile\fR attribute as the path name of an external
wolffd@0 166 EPSF file to be automatically loaded for the node shape.
wolffd@0 167 .PP
wolffd@0 168 \fBlabel=\fItext\fR where \fItext\fP may include escaped newlines
wolffd@0 169 \\\|n, \\\|l, or \\\|r for center, left, and right justified lines.
wolffd@0 170 The string '\\N' value will be replaced by the node name.
wolffd@0 171 The string '\\G' value will be replaced by the graph name.
wolffd@0 172 Record labels may contain recursive box lists delimited by { | }.
wolffd@0 173 Port identifiers in labels are set off by angle brackets < >.
wolffd@0 174 In the graph file, use colon (such as, \fBnode0:port28\fR).
wolffd@0 175 .PP
wolffd@0 176 \fBfontsize=\fIn\fR sets the label type size to \fIn\fP points.
wolffd@0 177 .PP
wolffd@0 178 \fBfontname=\fIname\fR sets the label font family name.
wolffd@0 179 .PP
wolffd@0 180 \fBcolor=\fIcolorvalue\fR sets the outline color, and the default fill color
wolffd@0 181 if style=filled and \fBfillcolor\fR is not specified.
wolffd@0 182 .PP
wolffd@0 183 \fBfillcolor=\fIcolorvalue\fR sets the fill color
wolffd@0 184 when style=filled. If not specified, the fillcolor when style=filled defaults
wolffd@0 185 to be the same as the outline color.
wolffd@0 186 .PP
wolffd@0 187 \fBfontcolor=\fIcolorvalue\fR sets the label text color.
wolffd@0 188 .PP
wolffd@0 189 A \fIcolorvalue\fP may be "\fIh,s,v\fB"\fR (hue, saturation, brightness)
wolffd@0 190 floating point numbers between 0 and 1, or an X11 color name such as
wolffd@0 191 \fBwhite black red green blue yellow magenta cyan\fR or \fBburlywood\fR,
wolffd@0 192 or a "\fI#rrggbb" (red, green, blue, 2 hex characters each) value.
wolffd@0 193 .PP
wolffd@0 194 \fBstyle=filled solid dashed dotted bold invis\fP or any Postscript code.
wolffd@0 195 .PP
wolffd@0 196 \fBlayer=\fIid\fR or \fIid:id\fR or "all" sets the node's active layers.
wolffd@0 197 The empty string means no layers (invisible).
wolffd@0 198 .PP
wolffd@0 199 The following attributes apply only to polygon shape nodes:
wolffd@0 200 .PP
wolffd@0 201 \fBregular=\fIn\fR if \fIn\fR is non\(hyzero then the polygon is made
wolffd@0 202 regular, i.e. symmetric about the x and y axis, otherwise the
wolffd@0 203 polygon takes on the aspect ratio of the label.
wolffd@0 204 \fIbuiltin_polygons\fR that are not already regular are made regular
wolffd@0 205 by this attribute.
wolffd@0 206 \fIbuiltin_polygons\fR that are already regular are not affected (i.e.
wolffd@0 207 they cannot be made asymmetric).
wolffd@0 208 .PP
wolffd@0 209 \fBperipheries=\fIn\fR sets the number of periphery lines drawn around
wolffd@0 210 the polygon. This value supersedes the number of periphery lines
wolffd@0 211 of \fIbuiltin_polygons\fR.
wolffd@0 212 .PP
wolffd@0 213 \fBsides=\fIn\fR sets the number of sides to the polygon. \fIn\fR<3
wolffd@0 214 results in an ellipse.
wolffd@0 215 This attribute is ignored by \fIbuiltin_polygons\fR.
wolffd@0 216 .PP
wolffd@0 217 \fBorientation=\fIf\fR sets the orientation of the first apex of the
wolffd@0 218 polygon counterclockwise from the vertical, in degrees.
wolffd@0 219 \fIf\fR may be a floating point number.
wolffd@0 220 The orientation of labels is not affected by this attribute.
wolffd@0 221 This attribute is added to the initial orientation of \fIbuiltin_polygons.\fR
wolffd@0 222 .PP
wolffd@0 223 \fBdistortion=\fIf\fR sets the amount of broadening of the top and
wolffd@0 224 narrowing of the bottom of the polygon (relative to its orientation).
wolffd@0 225 Floating point values between \-1 and +1 are suggested.
wolffd@0 226 This attribute is ignored by \fIbuiltin_polygons\fR.
wolffd@0 227 .PP
wolffd@0 228 \fBskew=\fIf\fR sets the amount of right\(hydisplacement of the top and
wolffd@0 229 left\(hydisplacement of the bottom of the polygon (relative to its
wolffd@0 230 orientation).
wolffd@0 231 Floating point values between \-1 and +1 are suggested.
wolffd@0 232 This attribute is ignored by \fIbuiltin_polygons\fR.
wolffd@0 233 .PP
wolffd@0 234 \fBhref=\fI"url"\fR sets the url for the node in imagemap, PostScript and SVG
wolffd@0 235 files.
wolffd@0 236 The substrings '\\N' and '\\G' are substituted in the same manner as
wolffd@0 237 for the node label attribute.
wolffd@0 238 Additionally the substring '\\L' is substituted with the node label string.
wolffd@0 239 .PP
wolffd@0 240 \fBURL=\fI"url"\fR ("URL" is a synonym for "href".)
wolffd@0 241 .PP
wolffd@0 242 \fBtarget=\fI"target"\fR is a target string for client\(hyside imagemaps
wolffd@0 243 and SVG, effective when nodes have a URL.
wolffd@0 244 The target string is used to determine which window of the browser is used
wolffd@0 245 for the URL. Setting it to "_graphviz" will open a new window if it doesn't
wolffd@0 246 already exist, or reuse it if it does.
wolffd@0 247 If the target string is empty, the default,
wolffd@0 248 then no target attribute is included in the output.
wolffd@0 249 The substrings '\\N' and '\\G' are substituted in the same manner as
wolffd@0 250 for the node label attribute.
wolffd@0 251 Additionally the substring '\\L' is substituted with the node label string.
wolffd@0 252 .PP
wolffd@0 253 \fBtooltip=\fI"tooltip"\fR is a tooltip string for client\(hyside imagemaps
wolffd@0 254 and SVG, effective when nodes have a URL. The tooltip string defaults to be the
wolffd@0 255 same as the label string, but this attribute permits nodes without
wolffd@0 256 labels to still have tooltips thus permitting denser graphs.
wolffd@0 257 The substrings '\\N' and '\\G' are substituted in the same manner as
wolffd@0 258 for the node label attribute.
wolffd@0 259 Additionally the substring '\\L' is substituted with the node label string.
wolffd@0 260
wolffd@0 261
wolffd@0 262 .SH "EDGE ATTRIBUTES"
wolffd@0 263 .PP
wolffd@0 264 \fBlabel=\fItext\fR where \fItext\fR may include escaped newlines
wolffd@0 265 \\\|n, \\\|l, or \\\|r for centered, left, or right justified lines.
wolffd@0 266 If the substring '\\T' is found in a label it will be replaced by the tail_node name.
wolffd@0 267 If the substring '\\H' is found in a label it will be replaced by the head_node name.
wolffd@0 268 If the substring '\\E' value is found in a label it will be replaced by: tail_node_name\->head_node_name
wolffd@0 269 If the substring '\\G' is found in a label it will be replaced by the graph name.
wolffd@0 270 or by: tail_node_name\-\-head_node_name for undirected graphs.
wolffd@0 271 .PP
wolffd@0 272 \fBfontsize=\fIn\fR sets the label type size to \fIn\fP points.
wolffd@0 273 .PP
wolffd@0 274 \fBfontname=\fIname\fR sets the label font family name.
wolffd@0 275 .PP
wolffd@0 276 \fBfontcolor=\fIcolorvalue\fR sets the label text color.
wolffd@0 277 .PP
wolffd@0 278 \fBstyle=solid dashed dotted bold invis\fP
wolffd@0 279 .PP
wolffd@0 280 \fBcolor=\fIcolorvalue\fR sets the line color for edges.
wolffd@0 281 .PP
wolffd@0 282 \fBcolor=\fIcolorvaluelist\fR a ':' separated list of \fIcolorvalue\fR creates
wolffd@0 283 parallel edges, one edge for each color.
wolffd@0 284 .PP
wolffd@0 285 \fBdir=forward back both none\fP controls arrow direction.
wolffd@0 286 .PP
wolffd@0 287 \fBtailclip,headclip=false\fP disables endpoint shape clipping.
wolffd@0 288 .PP
wolffd@0 289 \fBhref=\fI"url"\fR sets the url for the node in imagemap, PostScript and SVG
wolffd@0 290 files.
wolffd@0 291 The substrings '\\T', '\\H', '\\E' and '\\G' are substituted in the same manner as
wolffd@0 292 for the edge label attribute.
wolffd@0 293 Additionally the substring '\\L' is substituted with the edge label string.
wolffd@0 294 .PP
wolffd@0 295 \fBURL=\fI"url"\fR ("URL" is a synonym for "href".)
wolffd@0 296 .PP
wolffd@0 297 \fBtarget=\fI"target"\fR is a target string for client\(hyside imagemaps
wolffd@0 298 and SVG, effective when edges have a URL.
wolffd@0 299 If the target string is empty, the default,
wolffd@0 300 then no target attribute is included in the output.
wolffd@0 301 The substrings '\\T', '\\H', '\\E' and '\\G' are substituted in the same manner as
wolffd@0 302 for the edge label attribute.
wolffd@0 303 Additionally the substring '\\L' is substituted with the edge label string.
wolffd@0 304 .PP
wolffd@0 305 \fBtooltip=\fI"tooltip"\fR is a tooltip string for client\(hyside imagemaps
wolffd@0 306 effective when edges have a URL. The tooltip string defaults to be the
wolffd@0 307 same as the edge label string.
wolffd@0 308 The substrings '\\T', '\\H', '\\E' and '\\G' are substituted in the same manner as
wolffd@0 309 for the edge label attribute.
wolffd@0 310 Additionally the substring '\\L' is substituted with the edge label string.
wolffd@0 311 .PP
wolffd@0 312 \fBarrowhead,arrowtail=none, normal, inv, dot, odot, invdot, invodot,
wolffd@0 313 tee, empty, invempty, open, halfopen, diamond, odiamond, box, obox, crow\fP.
wolffd@0 314 .PP
wolffd@0 315 \fBarrowsize\fP (norm_length=10,norm_width=5,
wolffd@0 316 inv_length=6,inv_width=7,dot_radius=2)
wolffd@0 317 .PP
wolffd@0 318 \fBheadlabel,taillabel=string\fP for port labels.
wolffd@0 319 \fBlabelfontcolor\fP,\fBlabelfontname\fP,\fBlabelfontsize\fP
wolffd@0 320 for head and tail labels.
wolffd@0 321 The substrings '\\T', '\\H', '\\E' and '\\G' are substituted in the same manner as
wolffd@0 322 for the edge label attribute.
wolffd@0 323 Additionally the substring '\\L' is substituted with the edge label string.
wolffd@0 324 .PP
wolffd@0 325 \fBheadhref=\fI"url"\fR sets the url for the head port in imagemap, PostScript and SVG files.
wolffd@0 326 The substrings '\\T', '\\H', '\\E' and '\\G' are substituted in the same manner as
wolffd@0 327 for the edge label attribute.
wolffd@0 328 Additionally the substring '\\L' is substituted with the edge label string.
wolffd@0 329 .PP
wolffd@0 330 \fBheadURL=\fI"url"\fR ("headURL" is a synonym for "headhref".)
wolffd@0 331 .PP
wolffd@0 332 \fBheadtarget=\fI"headtarget"\fR is a target string for client\(hyside imagemaps
wolffd@0 333 and SVG, effective when edge heads have a URL.
wolffd@0 334 The headtarget string is used to determine which window of the browser is used
wolffd@0 335 for the URL. If the headtarget string is empty, the default,
wolffd@0 336 then headtarget defaults to the same value as target for the edge.
wolffd@0 337 The substrings '\\T', '\\H', '\\E' and '\\G' are substituted in the same manner as
wolffd@0 338 for the edge label attribute.
wolffd@0 339 Additionally the substring '\\L' is substituted with the edge label string.
wolffd@0 340 .PP
wolffd@0 341 \fBheadtooltip=\fI"tooltip"\fR is a tooltip string for client\(hyside imagemaps
wolffd@0 342 effective when head ports have a URL. The tooltip string defaults to be the
wolffd@0 343 same as the headlabel string.
wolffd@0 344 The substrings '\\T', '\\H', and '\\E' are substituted in the same manner as
wolffd@0 345 for the edge label attribute.
wolffd@0 346 Additionally the substring '\\L' is substituted with the edge label string.
wolffd@0 347 .PP
wolffd@0 348 \fBtailhref=\fI"url"\fR sets the url for the tail port in imagemap, PostScript and SVG files.
wolffd@0 349 The substrings '\\T', '\\H', '\\E' and '\\G' are substituted in the same manner as
wolffd@0 350 for the edge label attribute.
wolffd@0 351 Additionally the substring '\\L' is substituted with the edge label string.
wolffd@0 352 .PP
wolffd@0 353 \fBtailURL=\fI"url"\fR ("tailURL" is a synonym for "tailhref".)
wolffd@0 354 .PP
wolffd@0 355 \fBtailtarget=\fI"tailtarget"\fR is a target string for client\(hyside imagemaps
wolffd@0 356 and SVG, effective when edge tails have a URL.
wolffd@0 357 The tailtarget string is used to determine which window of the browser is used
wolffd@0 358 for the URL. If the tailtarget string is empty, the default,
wolffd@0 359 then tailtarget defaults to the same value as target for the edge.
wolffd@0 360 The substrings '\\T', '\\H', '\\E' and '\\G' are substituted in the same manner as
wolffd@0 361 for the edge label attribute.
wolffd@0 362 Additionally the substring '\\L' is substituted with the edge label string.
wolffd@0 363 .PP
wolffd@0 364 \fBtailtooltip=\fI"tooltip"\fR is a tooltip string for client\(hyside imagemaps
wolffd@0 365 effective when tail ports have a URL. The tooltip string defaults to be the
wolffd@0 366 same as the taillabel string.
wolffd@0 367 The substrings '\\T', '\\H', '\\E' and '\\G' are substituted in the same manner as
wolffd@0 368 for the edge label attribute.
wolffd@0 369 Additionally the substring '\\L' is substituted with the edge label string.
wolffd@0 370 .PP
wolffd@0 371 \fBlabeldistance\fP and \fPport_label_distance\fP set distance; also
wolffd@0 372 \fBlabelangle\fP (in degrees CCW)
wolffd@0 373 .PP
wolffd@0 374 \fBdecorate\fP draws line from edge to label.
wolffd@0 375 .PP
wolffd@0 376 \fBsamehead,sametail\fP aim edges having the same value to the
wolffd@0 377 same port, using the average landing point.
wolffd@0 378 .PP
wolffd@0 379 \fBlayer=\fIid\fR or \fIid:id\fR or "all" sets the edge's active layers.
wolffd@0 380 The empty string means no layers (invisible).
wolffd@0 381
wolffd@0 382 .PP
wolffd@0 383 \fB(neato\(hyspecific attributes)\fR
wolffd@0 384 .br
wolffd@0 385 \fBw=\fIf\fR sets the weight (spring constant) of an edge
wolffd@0 386 to the given floating point value. The default is 1.0;
wolffd@0 387 greater values make the edge tend more toward its optimal length.
wolffd@0 388 .PP
wolffd@0 389 \fBlen=\fIf\fR sets the optimal length of an edge.
wolffd@0 390 The default is 1.0.
wolffd@0 391 .SH "COMMAND LINE OPTIONS"
wolffd@0 392 \fB\-G\fP sets a default graph attribute.
wolffd@0 393 .br
wolffd@0 394 \fB\-N\fP sets a default node attribute.
wolffd@0 395 .br
wolffd@0 396 \fB\-E\fP sets a default edge attribute.
wolffd@0 397 Example: \fB\-Gsize="7,8" \-Nshape=box \-Efontsize=8\fR
wolffd@0 398 .PP
wolffd@0 399 \fB\-l\fIfile\fR loads custom PostScript library files.
wolffd@0 400 Usually these define custom shapes or styles.
wolffd@0 401 If \fB\-l\fP is given by itself, the standard library is omitted.
wolffd@0 402 .PP
wolffd@0 403 \fB\-T\fIlang\fR sets the output language as described above.
wolffd@0 404 .PP
wolffd@0 405 \fB\-O\fP automatically generate output filenames based on the input filename and the -T format.
wolffd@0 406 .PP
wolffd@0 407 \fB\-v\fP (verbose) prints various information useful for debugging.
wolffd@0 408 .PP
wolffd@0 409 \fB\-V\fP (version) prints version information and exits.
wolffd@0 410 .PP
wolffd@0 411 \fB\-?\fP prints the usage and exits.
wolffd@0 412 .SH "EXAMPLES"
wolffd@0 413 .nf
wolffd@0 414 digraph test123 {
wolffd@0 415 pack=8
wolffd@0 416 subgraph cluster0 {
wolffd@0 417 packmode=array
wolffd@0 418 x y x0 y0 x1
wolffd@0 419 subgraph cluster1 {
wolffd@0 420 m n
wolffd@0 421 }
wolffd@0 422 }
wolffd@0 423 b [shape=box];
wolffd@0 424 c [label="hello\\\nworld",color=blue,fontsize=24,
wolffd@0 425 fontname="Palatino\-Italic",fontcolor=red,style=filled];
wolffd@0 426 a \-> z
wolffd@0 427 x \-> z
wolffd@0 428 a \-> b \-> c;
wolffd@0 429 a \-> {x y};
wolffd@0 430 edge [style=dashed,color=red];
wolffd@0 431 b \-> x;
wolffd@0 432 }
wolffd@0 433 .fi
wolffd@0 434 .SH AUTHORS
wolffd@0 435 Emden R. Gansner <erg@research.att.com>
wolffd@0 436 .SH "SEE ALSO"
wolffd@0 437 This man page contains only a small amount of the information related
wolffd@0 438 to the Graphviz layout programs. The most complete information can be
wolffd@0 439 found at http://www.graphviz.org/Documentation.php, especially in the
wolffd@0 440 on\(hyline reference pages. Most of these documents are also available in the
wolffd@0 441 \fIdoc\fP and \fIdoc/info\fP subtrees in the source and binary distributions.
wolffd@0 442 .PP
wolffd@0 443 dot(1)