attributes.xml 97 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474147514761477147814791480148114821483148414851486148714881489149014911492149314941495149614971498149915001501150215031504150515061507150815091510151115121513151415151516151715181519152015211522152315241525152615271528152915301531153215331534153515361537153815391540154115421543154415451546154715481549155015511552155315541555155615571558155915601561156215631564156515661567156815691570157115721573157415751576157715781579158015811582158315841585158615871588158915901591159215931594159515961597159815991600160116021603160416051606160716081609161016111612161316141615161616171618161916201621162216231624162516261627162816291630163116321633163416351636163716381639164016411642164316441645164616471648164916501651165216531654165516561657165816591660166116621663166416651666166716681669167016711672167316741675167616771678167916801681168216831684168516861687168816891690169116921693169416951696169716981699170017011702170317041705170617071708170917101711171217131714171517161717171817191720172117221723172417251726172717281729173017311732173317341735173617371738173917401741174217431744174517461747174817491750175117521753175417551756175717581759176017611762176317641765176617671768176917701771177217731774177517761777177817791780178117821783178417851786178717881789179017911792179317941795179617971798179918001801180218031804180518061807180818091810181118121813181418151816181718181819182018211822182318241825182618271828182918301831183218331834183518361837183818391840184118421843184418451846184718481849185018511852185318541855185618571858185918601861186218631864186518661867186818691870187118721873187418751876187718781879188018811882188318841885188618871888188918901891189218931894189518961897189818991900190119021903190419051906190719081909191019111912191319141915191619171918191919201921192219231924192519261927192819291930193119321933193419351936193719381939194019411942194319441945194619471948194919501951195219531954195519561957195819591960196119621963196419651966196719681969197019711972197319741975197619771978197919801981198219831984198519861987198819891990199119921993199419951996199719981999200020012002200320042005200620072008200920102011201220132014201520162017201820192020202120222023202420252026202720282029203020312032203320342035203620372038203920402041204220432044204520462047204820492050205120522053205420552056205720582059206020612062206320642065206620672068206920702071207220732074207520762077207820792080208120822083208420852086208720882089209020912092209320942095209620972098209921002101210221032104210521062107210821092110211121122113211421152116211721182119212021212122212321242125212621272128212921302131213221332134213521362137213821392140214121422143214421452146214721482149215021512152215321542155215621572158215921602161216221632164216521662167216821692170217121722173217421752176217721782179218021812182218321842185218621872188218921902191219221932194219521962197219821992200220122022203220422052206220722082209221022112212221322142215221622172218221922202221222222232224222522262227222822292230223122322233223422352236223722382239224022412242224322442245224622472248224922502251225222532254225522562257225822592260226122622263226422652266226722682269227022712272227322742275227622772278227922802281228222832284228522862287228822892290229122922293229422952296229722982299230023012302230323042305230623072308230923102311231223132314231523162317231823192320232123222323232423252326232723282329233023312332233323342335233623372338233923402341234223432344234523462347234823492350235123522353235423552356235723582359236023612362236323642365236623672368236923702371237223732374237523762377237823792380238123822383238423852386238723882389239023912392239323942395239623972398239924002401240224032404240524062407240824092410241124122413241424152416241724182419242024212422242324242425242624272428242924302431243224332434243524362437243824392440244124422443244424452446244724482449245024512452245324542455245624572458245924602461246224632464246524662467246824692470247124722473247424752476247724782479248024812482248324842485248624872488248924902491249224932494249524962497249824992500250125022503250425052506250725082509251025112512251325142515251625172518251925202521252225232524252525262527252825292530253125322533253425352536253725382539254025412542254325442545254625472548254925502551255225532554255525562557255825592560256125622563256425652566256725682569257025712572257325742575257625772578257925802581258225832584258525862587258825892590259125922593259425952596259725982599260026012602260326042605260626072608260926102611261226132614261526162617261826192620262126222623262426252626262726282629263026312632263326342635263626372638263926402641264226432644264526462647264826492650265126522653265426552656
  1. <?xml version="1.0"?>
  2. <?xml-stylesheet href="attributes.xslt" type="text/xsl"?>
  3. <xsd:schema
  4. xmlns:xsd="http://www.w3.org/2001/XMLSchema"
  5. xmlns:html="http://www.w3.org/1999/xhtml"
  6. xmlns:gv="urn:graphviz">
  7. <!--
  8. microformats in xsd:documentation
  9. ========================================
  10. class
  11. val: a value of the enclosing attribute
  12. rel
  13. attr: link to an attribute
  14. type: link to an attribute type
  15. -->
  16. <!-- NOTES -->
  17. <xsd:annotation id="introduction">
  18. <xsd:documentation>
  19. <html:p>
  20. All Graphviz attributes are specified by name-value pairs. Thus, to
  21. set the fillcolor of a node <html:code>abc</html:code>, one would use
  22. </html:p>
  23. <html:p>
  24. <html:code>abc [fillcolor = red]</html:code>
  25. </html:p>
  26. <html:p>
  27. Similarly, to set the arrowhead style of an edge <html:code>abc -> def</html:code>,
  28. one would use
  29. </html:p>
  30. <html:p>
  31. <html:code>abc -> def [arrowhead = diamond]</html:code>
  32. </html:p>
  33. <html:p>
  34. Further details concerning the setting of attributes can be found
  35. in the description of the
  36. <html:a href="http://www.graphviz.org/doc/info/lang.html">DOT language.</html:a>
  37. </html:p>
  38. </xsd:documentation> </xsd:annotation>
  39. <xsd:annotation id="points">
  40. <xsd:documentation>
  41. <html:p>
  42. At present, most device-independent units are either inches or
  43. <html:a href="http://en.wikipedia.org/wiki/Point_(typography)">points</html:a>,
  44. which we take as 72 points per inch.
  45. </html:p>
  46. </xsd:documentation>
  47. </xsd:annotation>
  48. <xsd:annotation id="undirected">
  49. <xsd:documentation>
  50. <html:p>
  51. Some attributes, such as
  52. <html:a rel="attr">dir</html:a> or <html:a rel="attr">arrowtail</html:a>, are
  53. ambiguous when used in
  54. <html:a href="http://www.graphviz.org/doc/info/lang.html">DOT</html:a>
  55. with an undirected graph since the head and tail of an edge are meaningless.
  56. As a convention, the first time an undirected edge appears, the
  57. <html:a href="http://www.graphviz.org/doc/info/lang.html">DOT</html:a>
  58. parser will assign the left node as the tail node and the right node as
  59. the head. For example, the edge <html:code>A -- B</html:code> will have tail <html:code>A</html:code>
  60. and head <html:code>B</html:code>. It is the user's responsibility to handle such
  61. edges consistently. If the edge appears later, in the format
  62. </html:p>
  63. <html:p>
  64. <html:code>B -- A [taillabel = "tail"]</html:code>
  65. </html:p>
  66. <html:p>
  67. the drawing will attach the tail label to node <html:code>A</html:code>.
  68. To avoid possible confusion when such attributes are required, the user
  69. is encouraged to use a directed graph.
  70. If it is important to make the graph appear undirected, this can be
  71. done using the <html:a rel="attr">dir</html:a>, <html:a rel="attr">arrowtail</html:a>
  72. or <html:a rel="attr">arrowhead</html:a> attributes.
  73. </html:p>
  74. </xsd:documentation>
  75. </xsd:annotation>
  76. <!-- ATTRIBUTE TYPES -->
  77. <!--
  78. <xsd:simpleType name="arrowType">
  79. </xsd:simpleType>
  80. -->
  81. <xsd:simpleType name="clusterMode">
  82. <xsd:restriction base="xsd:string">
  83. <xsd:enumeration value="local" />
  84. <xsd:enumeration value="global" />
  85. <xsd:enumeration value="none" />
  86. </xsd:restriction>
  87. </xsd:simpleType>
  88. <!--
  89. <xsd:simpleType name="color">
  90. </xsd:simpleType>
  91. -->
  92. <xsd:simpleType name="colorList">
  93. <xsd:list itemType="color" />
  94. </xsd:simpleType>
  95. <xsd:simpleType name="dirType">
  96. <xsd:annotation>
  97. <xsd:documentation>
  98. <html:p>
  99. For undirected edges <html:code>T -- H;</html:code>, one of the nodes, usually
  100. the righthand one, is treated as the head for the purpose of
  101. interpreting <html:span class="val">forward</html:span> and <html:span class="val">back</html:span>.
  102. </html:p>
  103. </xsd:documentation>
  104. </xsd:annotation>
  105. <xsd:restriction base="xsd:string">
  106. <xsd:enumeration value="forward" />
  107. <xsd:enumeration value="back" />
  108. <xsd:enumeration value="both" />
  109. <xsd:enumeration value="none" />
  110. </xsd:restriction>
  111. </xsd:simpleType>
  112. <xsd:simpleType name="escString">
  113. <xsd:annotation>
  114. <xsd:documentation>
  115. <html:p>
  116. String allowing escape sequences which are replaced according
  117. to the context.
  118. For node attributes, the substring <html:code>\N</html:code> is replaced by the name of the node,
  119. and the substring <html:code>\G</html:code> by the name of the graph.
  120. For graph or cluster attributes, the substring <html:code>\G</html:code> is replaced by the
  121. name of the graph or cluster.
  122. For edge attributes, the substring <html:code>\E</html:code> is replaced by the name of the edge,
  123. the substring <html:code>\G</html:code> is replaced by the name of the graph or cluster,
  124. and the substrings <html:code>\T</html:code> and <html:code>\H</html:code> by the names of
  125. the tail and head nodes, respectively.
  126. The name of an edge is the string formed from the name of the
  127. tail node, the appropriate edge operator (<html:code>--</html:code> or <html:code>-></html:code>) and the name of the
  128. head node.
  129. </html:p>
  130. <html:p>
  131. In addition, if the associated attribute is
  132. <html:a rel="attr">label</html:a>,
  133. <html:a rel="attr">headlabel</html:a> or <html:a rel="attr">taillabel</html:a>,
  134. the escape sequences <html:code>\n</html:code>, <html:code>\l</html:code> and <html:code>\r</html:code>
  135. divide the label into lines, centered, left-justified, and right-justified,
  136. respectively.
  137. </html:p>
  138. </xsd:documentation>
  139. </xsd:annotation>
  140. <xsd:restriction base="xsd:string" />
  141. </xsd:simpleType>
  142. <!--
  143. layerList
  144. layerRange
  145. lblString
  146. -->
  147. <xsd:simpleType name="outputMode">
  148. <xsd:annotation>
  149. <xsd:documentation>
  150. <html:p>
  151. These specify the order in which nodes and edges are drawn in concrete
  152. output. The default <html:span class="val">breadthfirst</html:span> is the simplest, but when the graph
  153. layout does not avoid edge-node overlap, this mode will sometimes have
  154. edges drawn over nodes and sometimes on top of nodes. If the mode
  155. <html:span class="val">nodesfirst</html:span> is chosen, all nodes are drawn first, followed by the
  156. edges. This guarantees an edge-node overlap will not be mistaken for
  157. an edge ending at a node. On the other hand, usually for aesthetic
  158. reasons, it may be desirable that all edges appear beneath nodes, even
  159. if the resulting drawing is ambiguous. This can be achieved by choosing
  160. <html:span class="val">edgesfirst</html:span>.
  161. </html:p>
  162. </xsd:documentation>
  163. </xsd:annotation>
  164. <xsd:restriction base="xsd:string">
  165. <xsd:enumeration value="breadthfirst" />
  166. <xsd:enumeration value="nodesfirst" />
  167. <xsd:enumeration value="edgesfirst" />
  168. </xsd:restriction>
  169. </xsd:simpleType>
  170. <xsd:simpleType name="packMode">
  171. <xsd:annotation>
  172. <xsd:documentation>
  173. <html:p>
  174. These specify the granularity of packing connected components when
  175. the <html:a rel="attr">pack</html:a> attribute is true. A value of <html:span class="val">node</html:span> causes
  176. packing at the node and edge label, with no overlapping of these objects.
  177. This produces a layout with the least area, but it also allows interleaving,
  178. where a node of one component may lie between two nodes in another
  179. component. A value of <html:span class="val">graph</html:span> does a packing using the bounding box of the
  180. component. Thus, there will be a rectangular region around a component
  181. free of elements of any other component.
  182. A value of <html:span class="val">clust</html:span> guarantees that top-level clusters are kept intact.
  183. What effect a value has also depends on the layout algorithm. For
  184. example, neato does not support clusters, so a value of <html:span class="val">clust</html:span> will
  185. have the same effect as the default <html:span class="val">node</html:span> value.
  186. </html:p>
  187. </xsd:documentation>
  188. </xsd:annotation>
  189. <xsd:restriction base="xsd:string">
  190. <xsd:enumeration value="node" />
  191. <xsd:enumeration value="clust" />
  192. <xsd:enumeration value="graph" />
  193. </xsd:restriction>
  194. </xsd:simpleType>
  195. <xsd:simpleType name="pagedir">
  196. <xsd:annotation>
  197. <xsd:documentation>
  198. <html:p>
  199. These specify the 8 row or column major orders for traversing a
  200. rectangular array, the first character corresponding to the major
  201. order and the second to the minor order. Thus, for "BL", the
  202. major order is from bottom to top, and the minor order is from left
  203. to right. This means the bottom row is traversed first, from left
  204. to right, then the next row up, from left to right, and so on,
  205. until the topmost row is traversed.
  206. </html:p>
  207. </xsd:documentation>
  208. </xsd:annotation>
  209. <xsd:restriction base="xsd:string">
  210. <xsd:enumeration value="BL" />
  211. <xsd:enumeration value="BR" />
  212. <xsd:enumeration value="TL" />
  213. <xsd:enumeration value="TR" />
  214. <xsd:enumeration value="RB" />
  215. <xsd:enumeration value="RT" />
  216. <xsd:enumeration value="LB" />
  217. <xsd:enumeration value="LT" />
  218. </xsd:restriction>
  219. </xsd:simpleType>
  220. <!--
  221. point
  222. pointf
  223. -->
  224. <xsd:simpleType name="pointfList">
  225. <xsd:annotation>
  226. <xsd:documentation>
  227. <html:p>
  228. List of <html:a rel="type">pointf</html:a>, separated by spaces.
  229. </html:p>
  230. </xsd:documentation>
  231. </xsd:annotation>
  232. <xsd:list itemType="pointf" />
  233. </xsd:simpleType>
  234. <!--
  235. portPos
  236. -->
  237. <xsd:simpleType name="rankType">
  238. <xsd:restriction base="xsd:string">
  239. <xsd:enumeration value="same" />
  240. <xsd:enumeration value="min" />
  241. <xsd:enumeration value="source" />
  242. <xsd:enumeration value="max" />
  243. <xsd:enumeration value="sink" />
  244. </xsd:restriction>
  245. </xsd:simpleType>
  246. <xsd:simpleType name="rankdir">
  247. <xsd:annotation>
  248. <xsd:documentation>
  249. <html:p>
  250. Corresponding to directed graphs drawn
  251. from top to bottom, from left to right, from bottom to top, and from
  252. right to left, respectively.
  253. </html:p>
  254. </xsd:documentation>
  255. </xsd:annotation>
  256. <xsd:restriction base="xsd:string">
  257. <xsd:enumeration value="TB" />
  258. <xsd:enumeration value="LR" />
  259. <xsd:enumeration value="BT" />
  260. <xsd:enumeration value="RL" />
  261. </xsd:restriction>
  262. </xsd:simpleType>
  263. <!--
  264. rect
  265. -->
  266. <xsd:simpleType name="shape">
  267. <xsd:restriction base="xsd:string">
  268. <xsd:enumeration value="box" />
  269. <xsd:enumeration value="polygon" />
  270. <xsd:enumeration value="ellipse" />
  271. <xsd:enumeration value="circle" />
  272. <xsd:enumeration value="point" />
  273. <xsd:enumeration value="egg" />
  274. <xsd:enumeration value="triangle" />
  275. <xsd:enumeration value="plaintext" />
  276. <xsd:enumeration value="diamond" />
  277. <xsd:enumeration value="trapezium" />
  278. <xsd:enumeration value="parallelogram" />
  279. <xsd:enumeration value="house" />
  280. <xsd:enumeration value="pentagon" />
  281. <xsd:enumeration value="hexagon" />
  282. <xsd:enumeration value="septagon" />
  283. <xsd:enumeration value="octagon" />
  284. <xsd:enumeration value="doublecircle" />
  285. <xsd:enumeration value="doubleoctagon" />
  286. <xsd:enumeration value="tripleoctagon" />
  287. <xsd:enumeration value="invtriangle" />
  288. <xsd:enumeration value="invtrapezium" />
  289. <xsd:enumeration value="invhouse" />
  290. <xsd:enumeration value="Mdiamond" />
  291. <xsd:enumeration value="Msquare" />
  292. <xsd:enumeration value="Mcircle" />
  293. <xsd:enumeration value="rect" />
  294. <xsd:enumeration value="rectangle" />
  295. <xsd:enumeration value="none" />
  296. <xsd:enumeration value="note" />
  297. <xsd:enumeration value="tab" />
  298. <xsd:enumeration value="box3d" />
  299. <xsd:enumeration value="component" />
  300. </xsd:restriction>
  301. </xsd:simpleType>
  302. <!--
  303. splineType
  304. startType
  305. style
  306. viewPort
  307. -->
  308. <!-- ATTRIBUTES -->
  309. <xsd:attribute name="imagepath" type="xsd:string" default="UTF-8">
  310. <xsd:annotation>
  311. <xsd:documentation>
  312. <html:p>
  313. Specifies the path to images referenced within the graph.
  314. </html:p>
  315. </xsd:documentation>
  316. </xsd:annotation>
  317. </xsd:attribute>
  318. <xsd:attribute name="Damping" type="xsd:decimal" default="0.99" gv:layouts="neato">
  319. <xsd:annotation>
  320. <xsd:documentation>
  321. <html:p>
  322. Factor damping force motions. On each iteration, a nodes movement
  323. is limited to this factor of its potential motion. By being less than
  324. 1.0, the system tends to "cool", thereby preventing cycling.
  325. </html:p>
  326. </xsd:documentation>
  327. </xsd:annotation>
  328. </xsd:attribute>
  329. <xsd:attribute name="K" type="xsd:decimal" default="0.3" gv:layouts="fdp">
  330. <xsd:annotation>
  331. <xsd:documentation>
  332. <html:p>
  333. Spring constant used in virtual physical model. It roughly corresponds
  334. to an ideal edge length (in inches), in that increasing K tends to
  335. increase the distance between nodes.
  336. Note that the edge attribute <html:a rel="attr">len</html:a> can be used to
  337. override this value for adjacent nodes.
  338. </html:p>
  339. </xsd:documentation>
  340. </xsd:annotation>
  341. </xsd:attribute>
  342. <xsd:attribute name="URL" type="xsd:anyURI" gv:formats="svg ps ps2 map">
  343. <xsd:annotation>
  344. <xsd:documentation>
  345. <html:p>
  346. Hyperlinks incorporated into device-dependent output.
  347. At present, used in ps2, cmap, i*map and svg formats.
  348. For all these formats, URLs can be attached to nodes, edges and
  349. clusters. URL attributes can also be attached to the root graph in ps2,
  350. cmap and i*map formats. This serves as the base URL for relative URLs in the
  351. former, and as the default image map file in the latter.
  352. </html:p>
  353. <html:p>
  354. For svg, cmapx and imap output, the active area for a node is its
  355. visible image.
  356. For example, an unfilled node with no drawn boundary will only be active on its label.
  357. For other output, the active area is its bounding box.
  358. The active area for a cluster is its bounding box.
  359. For edges, the active areas are small circles where the edge contacts its head
  360. and tail nodes. In addition, for svg, cmapx and imap, the active area
  361. includes a thin polygon approximating the edge. The circles may
  362. overlap the related node, and the edge URL dominates.
  363. If the edge has a label, this will also be active.
  364. Finally, if the edge has a head or tail label, this will also be active.
  365. </html:p>
  366. <html:p>
  367. Note that, for edges, the attributes <html:a rel="attr">headURL</html:a>,
  368. <html:a rel="attr">tailURL</html:a>, <html:a rel="attr">labelURL</html:a> and
  369. <html:a rel="attr">edgeURL</html:a> allow control of various parts of an
  370. edge. Also note that, if active areas of two edges overlap, it is unspecified
  371. which area dominates.
  372. </html:p>
  373. </xsd:documentation>
  374. </xsd:annotation>
  375. </xsd:attribute>
  376. <xsd:attribute name="arrowhead" type="arrowType" default="normal">
  377. <xsd:annotation>
  378. <xsd:documentation>
  379. <html:p>
  380. Style of arrowhead on the head node of an edge.
  381. See also the <html:a rel="attr">dir</html:a> attribute,
  382. and the <html:a rel="note">undirected</html:a> note.
  383. </html:p>
  384. </xsd:documentation>
  385. </xsd:annotation>
  386. </xsd:attribute>
  387. <xsd:attribute name="arrowsize" type="xsd:decimal" default="1.0">
  388. <xsd:annotation>
  389. <xsd:documentation>
  390. <html:p>
  391. Multiplicative scale factor for arrowheads.
  392. </html:p>
  393. </xsd:documentation>
  394. </xsd:annotation>
  395. </xsd:attribute>
  396. <xsd:attribute name="arrowtail" type="arrowType" default="normal">
  397. <xsd:annotation>
  398. <xsd:documentation>
  399. <html:p>
  400. Style of arrowhead on the tail node of an edge.
  401. See also the <html:a rel="attr">dir</html:a> attribute,
  402. and the <html:a rel="note">undirected</html:a> note.
  403. </html:p>
  404. </xsd:documentation>
  405. </xsd:annotation>
  406. </xsd:attribute>
  407. <xsd:attribute name="bb" type="rect">
  408. <xsd:annotation>
  409. <xsd:documentation>
  410. <html:p>
  411. Bounding box of drawing in integer points.
  412. </html:p>
  413. </xsd:documentation>
  414. </xsd:annotation>
  415. </xsd:attribute>
  416. <xsd:attribute name="bgcolor" type="color">
  417. <xsd:annotation>
  418. <xsd:documentation>
  419. <html:p>
  420. When attached to the root graph, this color is used as the background for
  421. entire canvas. When a cluster attribute, it is used as the initial
  422. background for the cluster. If a cluster has a filled
  423. <html:a rel="attr">style</html:a>, the
  424. cluster's <html:a rel="attr">fillcolor</html:a> will overlay the
  425. background color.
  426. </html:p>
  427. <html:p>
  428. If no background color is specified for the root graph, no graphics
  429. operation are performed on the background. This works fine for
  430. PostScript but for bitmap output, all bits are initialized to something.
  431. This means that when the bitmap output is included in some other
  432. document, all of the bits within the bitmap's bounding box will be
  433. set, overwriting whatever color or graphics where already on the page.
  434. If this effect is not desired, and you only want to set bits explicitly
  435. assigned in drawing the graph, set <html:a rel="attr">bgcolor</html:a>="transparent".
  436. </html:p>
  437. </xsd:documentation>
  438. </xsd:annotation>
  439. </xsd:attribute>
  440. <xsd:attribute name="center" type="xsd:boolean" default="false">
  441. <xsd:annotation>
  442. <xsd:documentation>
  443. <html:p>
  444. If true, the drawing is centered in the output canvas.
  445. </html:p>
  446. </xsd:documentation>
  447. </xsd:annotation>
  448. </xsd:attribute>
  449. <xsd:attribute name="charset" type="xsd:string" default="UTF-8">
  450. <xsd:annotation>
  451. <xsd:documentation>
  452. <html:p>
  453. Specifies the character encoding used when interpreting string input
  454. as a text label. The default value is <html:span class="val">UTF-8</html:span>.
  455. The other legal value is <html:span class="val">iso-8859-1</html:span> or,
  456. equivalently,
  457. <html:span class="val">Latin1</html:span>. The <html:a rel="attr">charset</html:a> attribute is case-insensitive.
  458. Note that if the character encoding used in the input does not
  459. match the <html:a rel="attr">charset</html:a> value, the resulting output may be very strange.
  460. </html:p>
  461. </xsd:documentation>
  462. </xsd:annotation>
  463. </xsd:attribute>
  464. <xsd:attribute name="clusterrank" type="clusterMode" default="local" gv:layouts="dot">
  465. <xsd:annotation>
  466. <xsd:documentation>
  467. <html:p>
  468. Mode used for handling clusters. If <html:a rel="attr">clusterrank</html:a> is <html:span class="val">local</html:span>, a
  469. subgraph whose name begins with "cluster" is given special treatment.
  470. The subgraph is laid out separately, and then integrated as a unit into
  471. its parent graph, with a bounding rectangle drawn about it.
  472. If the cluster has a <html:a rel="attr">label</html:a> parameter, this label
  473. is displayed within the rectangle.
  474. Note also that there can be clusters within clusters.
  475. At present, the modes <html:span class="val">global</html:span> and <html:span class="val">none</html:span>
  476. appear to be identical, both turning off the special cluster processing.
  477. </html:p>
  478. </xsd:documentation>
  479. </xsd:annotation>
  480. </xsd:attribute>
  481. <xsd:attribute name="color" type="colorList" default="black">
  482. <xsd:annotation>
  483. <xsd:documentation>
  484. <html:p>
  485. Basic drawing color for graphics, not text. For the latter, use the
  486. <html:a rel="attr">fontcolor</html:a> attribute.
  487. </html:p>
  488. <html:p>
  489. For edges, the value
  490. can either be a single <html:a rel="type">color</html:a> or a <html:a rel="type">colorList</html:a>.
  491. In the latter case, the edge is drawn using parallel splines or lines,
  492. one for each color in the list, in the order given.
  493. The head arrow, if any, is drawn using the first color in the list,
  494. and the tail arrow, if any, the second color. This supports the common
  495. case of drawing opposing edges, but using parallel splines instead of
  496. separately routed multiedges.
  497. </html:p>
  498. </xsd:documentation>
  499. </xsd:annotation>
  500. </xsd:attribute>
  501. <xsd:attribute name="colorscheme" type="xsd:string">
  502. <xsd:annotation>
  503. <xsd:documentation>
  504. <html:p>
  505. This attribute specifies a color scheme namespace. If defined, it specifies
  506. the context for interpreting color names. In particular, if a
  507. <html:a rel="type">color</html:a> value has form <html:code>xxx</html:code> or <html:code>//xxx</html:code>,
  508. then the color <html:code>xxx</html:code> will be evaluated according to the current color scheme.
  509. If no color scheme is set, the standard X11 naming is used.
  510. For example, if <html:code>colorscheme=bugn9</html:code>, then <html:code>color=7</html:code>
  511. is interpreted as <html:code>/bugn9/7</html:code>.
  512. </html:p>
  513. </xsd:documentation>
  514. </xsd:annotation>
  515. </xsd:attribute>
  516. <xsd:attribute name="comment" type="xsd:string">
  517. <xsd:annotation>
  518. <xsd:documentation>
  519. <html:p>
  520. Comments are inserted into output. Device-dependent.
  521. </html:p>
  522. </xsd:documentation>
  523. </xsd:annotation>
  524. </xsd:attribute>
  525. <xsd:attribute name="compound" type="xsd:boolean" default="false" gv:layouts="dot">
  526. <xsd:annotation>
  527. <xsd:documentation>
  528. <html:p>
  529. If <html:span class="val">true</html:span>, allow edges between clusters. (See <html:a rel="attr">lhead</html:a> and <html:a rel="attr">ltail</html:a> below.)
  530. </html:p>
  531. </xsd:documentation>
  532. </xsd:annotation>
  533. </xsd:attribute>
  534. <xsd:attribute name="concentrate" type="xsd:boolean" default="false" gv:layouts="dot">
  535. <xsd:annotation>
  536. <xsd:documentation>
  537. <html:p>
  538. If <html:span class="val">true</html:span>, use edge concentrators.
  539. </html:p>
  540. </xsd:documentation>
  541. </xsd:annotation>
  542. </xsd:attribute>
  543. <xsd:attribute name="constraint" type="xsd:boolean" default="true" gv:layouts="dot">
  544. <xsd:annotation>
  545. <xsd:documentation>
  546. <html:p>
  547. If <html:span class="val">false</html:span>, the edge is not used in ranking the nodes.
  548. </html:p>
  549. </xsd:documentation>
  550. </xsd:annotation>
  551. </xsd:attribute>
  552. <xsd:attribute name="decorate" type="xsd:boolean" default="false">
  553. <xsd:annotation>
  554. <xsd:documentation>
  555. <html:p>
  556. If <html:span class="val">true</html:span>, attach edge label to edge by a 2-segment
  557. polyline, underlining the label, then going to the closest point of spline.
  558. </html:p>
  559. </xsd:documentation>
  560. </xsd:annotation>
  561. </xsd:attribute>
  562. <xsd:attribute name="defaultdist" type="xsd:decimal" gv:layouts="neato">
  563. <xsd:annotation>
  564. <xsd:documentation>
  565. <html:p>
  566. This specifies the distance between nodes in separate connected
  567. components. If set too small, connected components may overlap.
  568. Only applicable if <html:a rel="attr">pack</html:a>=false.
  569. </html:p>
  570. </xsd:documentation>
  571. </xsd:annotation>
  572. </xsd:attribute>
  573. <xsd:attribute name="dim" type="xsd:integer" default="2" gv:layouts="fdp neato">
  574. <xsd:annotation>
  575. <xsd:documentation>
  576. <html:p>
  577. Set the number of dimensions used for the layout. The maximum value
  578. allowed is 10.
  579. </html:p>
  580. </xsd:documentation>
  581. </xsd:annotation>
  582. </xsd:attribute>
  583. <xsd:attribute name="dir" type="dirType">
  584. <xsd:annotation>
  585. <xsd:documentation>
  586. <html:p>
  587. Set edge type for drawing arrowheads. This indicates which ends of the
  588. edge should be decorated with an arrowhead. The actual style of the
  589. arrowhead can be specified using the <html:a rel="attr">arrowhead</html:a>
  590. and <html:a rel="attr">arrowtail</html:a> attributes.
  591. See <html:a rel="note">undirected</html:a>.
  592. </html:p>
  593. </xsd:documentation>
  594. </xsd:annotation>
  595. </xsd:attribute>
  596. <xsd:attribute name="diredgeconstraints" type="xsd:string" default="false" gv:layouts="neato">
  597. <xsd:annotation>
  598. <xsd:documentation>
  599. <html:p>
  600. Only valid when <html:a rel="attr">mode</html:a>="ipsep".
  601. If <html:span class="val">true</html:span>, constraints are generated for each edge in the largest (heuristic)
  602. directed acyclic subgraph such that the edge must point downwards.
  603. If <html:span class="val">hier</html:span>, generates level constraints similar to those used with
  604. <html:a rel="attr">mode</html:a>="hier". The main difference is that, in the latter
  605. case, only these constraints are involved, so a faster solver can be used.
  606. </html:p>
  607. </xsd:documentation>
  608. </xsd:annotation>
  609. </xsd:attribute>
  610. <xsd:attribute name="distortion" type="xsd:decimal" default="0.0">
  611. <xsd:annotation>
  612. <xsd:documentation>
  613. <html:p>
  614. Distortion factor for <html:a rel="attr">shape</html:a>=polygon.
  615. Positive values cause top part to
  616. be larger than bottom; negative values do the opposite.
  617. </html:p>
  618. </xsd:documentation>
  619. </xsd:annotation>
  620. </xsd:attribute>
  621. <xsd:attribute name="dpi" type="xsd:decimal" default="96.0">
  622. <xsd:annotation>
  623. <xsd:documentation>
  624. <html:p>
  625. This specifies the expected number of pixels per inch on a display device.
  626. For bitmap output, this guarantees that text rendering will be
  627. done more accurately, both in size and in placement. For SVG output,
  628. it is used to guarantee that the dimensions in the output correspond to
  629. the correct number of points or inches.
  630. </html:p>
  631. </xsd:documentation>
  632. </xsd:annotation>
  633. </xsd:attribute>
  634. <xsd:attribute name="edgeURL" type="xsd:anyURI" gv:formats="svg map">
  635. <xsd:annotation>
  636. <xsd:documentation>
  637. <html:p>
  638. If <html:a rel="attr">edgeURL</html:a> is defined, this is the link used for the non-label
  639. parts of an edge. This value overrides any <html:a rel="attr">URL</html:a>
  640. defined for the edge.
  641. Also, this value is used near the head or tail node unless overridden
  642. by a <html:a rel="attr">headURL</html:a> or <html:a rel="attr">tailURL</html:a> value,
  643. respectively.
  644. See <html:a rel="note">undirected</html:a>.
  645. </html:p>
  646. </xsd:documentation>
  647. </xsd:annotation>
  648. </xsd:attribute>
  649. <xsd:attribute name="edgehref" type="xsd:anyURI" gv:formats="svg map">
  650. <xsd:annotation>
  651. <xsd:documentation>
  652. <html:p>
  653. Synonym for <html:a rel="attr">edgeURL</html:a>.
  654. </html:p>
  655. </xsd:documentation>
  656. </xsd:annotation>
  657. </xsd:attribute>
  658. <xsd:attribute name="edgetarget" type="escString" gv:formats="svg map">
  659. <xsd:annotation>
  660. <xsd:documentation>
  661. <html:p>
  662. If the edge has a <html:a rel="attr">URL</html:a> or <html:a rel="attr">edgeURL</html:a>
  663. attribute, this attribute determines which window of the
  664. browser is used
  665. for the URL attached to the non-label part of the edge.
  666. Setting it to "_graphviz" will open a new window if it
  667. doesn't already exist, or reuse it if it does.
  668. If undefined, the value of the <html:a rel="attr">target</html:a> is used.
  669. </html:p>
  670. </xsd:documentation>
  671. </xsd:annotation>
  672. </xsd:attribute>
  673. <xsd:attribute name="edgetooltip" type="escString" gv:formats="svg cmap">
  674. <xsd:annotation>
  675. <xsd:documentation>
  676. <html:p>
  677. Tooltip annotation attached to the non-label part of an edge.
  678. This is used only if the edge has a <html:a rel="attr">URL</html:a>
  679. or <html:a rel="attr">edgeURL</html:a> attribute.
  680. </html:p>
  681. </xsd:documentation>
  682. </xsd:annotation>
  683. </xsd:attribute>
  684. <xsd:attribute name="epsilon" type="xsd:decimal" gv:layouts="neato">
  685. <xsd:annotation>
  686. <xsd:documentation>
  687. <html:p>
  688. Terminating condition. If the length squared of all energy gradients are
  689. &lt; <html:a rel="attr">epsilon</html:a>, the algorithm stops.
  690. </html:p>
  691. </xsd:documentation>
  692. </xsd:annotation>
  693. </xsd:attribute>
  694. <xsd:attribute name="esep" type="xsd:decimal" gv:layouts="neato circo fdp">
  695. <xsd:annotation>
  696. <xsd:documentation>
  697. <html:p>
  698. Fraction to increase polygons (multiply
  699. coordinates by 1 + esep) for purposes of spline edge routing.
  700. This should normally be strictly less than
  701. <html:a rel="attr">sep</html:a>.
  702. </html:p>
  703. </xsd:documentation>
  704. </xsd:annotation>
  705. </xsd:attribute>
  706. <xsd:attribute name="fillcolor" type="color">
  707. <xsd:annotation>
  708. <xsd:documentation>
  709. <html:p>
  710. Color used to fill the background of a node or cluster
  711. assuming <html:a rel="attr">style</html:a>=filled.
  712. If <html:a rel="attr">fillcolor</html:a> is not defined, <html:a rel="attr">color</html:a> is
  713. used. (For clusters, if <html:a rel="attr">color</html:a> is not defined,
  714. <html:a rel="attr">bgcolor</html:a> is used.) If this is not defined,
  715. the default is used, except for
  716. <html:a rel="attr">shape</html:a>=point or when the output
  717. format is MIF,
  718. which use black by default.
  719. </html:p>
  720. <html:p>
  721. Note that a cluster inherits the root graph's attributes if defined.
  722. Thus, if the root graph has defined a <html:a rel="attr">fillcolor</html:a>, this will override a
  723. <html:a rel="attr">color</html:a> or <html:a rel="attr">bgcolor</html:a> attribute set for the cluster.
  724. </html:p>
  725. </xsd:documentation>
  726. </xsd:annotation>
  727. </xsd:attribute>
  728. <xsd:attribute name="fixedsize" type="xsd:boolean" default="false">
  729. <xsd:annotation>
  730. <xsd:documentation>
  731. <html:p>
  732. If true, the node size is specified by the values of the
  733. <html:a rel="attr">width</html:a>
  734. and <html:a rel="attr">height</html:a> attributes only
  735. and is not expanded to contain the text label.
  736. </html:p>
  737. </xsd:documentation>
  738. </xsd:annotation>
  739. </xsd:attribute>
  740. <xsd:attribute name="fontcolor" type="color" default="black">
  741. <xsd:annotation>
  742. <xsd:documentation>
  743. <html:p>
  744. Color used for text.
  745. </html:p>
  746. </xsd:documentation>
  747. </xsd:annotation>
  748. </xsd:attribute>
  749. <xsd:attribute name="fontname" type="xsd:string" default="Times-Roman">
  750. <xsd:annotation>
  751. <xsd:documentation>
  752. <html:p>
  753. Font used for text. This very much depends on the output format and, for
  754. non-bitmap output such as PostScript or SVG, the availability of the font
  755. when the graph is displayed or printed. As such, it is best to rely on
  756. font faces that are generally available, such as Times-Roman, Helvetica or
  757. Courier.
  758. </html:p>
  759. <html:p>
  760. If Graphviz was built using the
  761. <html:a href="http://pdx.freedesktop.org/~fontconfig/fontconfig-user.html">fontconfig library</html:a>, the latter library
  762. will be used to search for the font. However, if the <html:a rel="attr">fontname</html:a> string
  763. contains a slash character "/", it is treated as a pathname for the font
  764. file, though font lookup will append the usual font suffixes.
  765. </html:p>
  766. <html:p>
  767. If Graphviz does not use fontconfig, <html:a rel="attr">fontname</html:a> will be
  768. considered the name of a Type 1 or True Type font file.
  769. If you specify <html:code>fontname=schlbk</html:code>, the tool will look for a
  770. file named <html:code>schlbk.ttf</html:code> or <html:code>schlbk.pfa</html:code> or <html:code>schlbk.pfb</html:code>
  771. in one of the directories specified by
  772. the <html:a rel="attr">fontpath</html:a> attribute.
  773. The lookup does support various aliases for the common fonts.
  774. </html:p>
  775. </xsd:documentation>
  776. </xsd:annotation>
  777. </xsd:attribute>
  778. <xsd:attribute name="fontnames" type="xsd:string" gv:formats="svg">
  779. <xsd:annotation>
  780. <xsd:documentation>
  781. <html:p>
  782. Allows user control of how basic fontnames are represented in SVG output.
  783. If <html:a rel="attr">fontnames</html:a> is undefined or <html:span class="val">svg</html:span>,
  784. the output will try to use known SVG fontnames. For example, the
  785. default font <html:code>Times-Roman</html:code> will be mapped to the
  786. basic SVG font <html:code>serif</html:code>. This can be overridden by setting
  787. <html:a rel="attr">fontnames</html:a> to <html:span class="val">ps</html:span> or <html:span class="val">gd</html:span>.
  788. In the former case, known PostScript font names such as
  789. <html:code>Times-Roman</html:code> will be used in the output.
  790. In the latter case, the fontconfig font conventions
  791. are used. Thus, <html:code>Times-Roman</html:code> would be treated as
  792. <html:code>Nimbus Roman No9 L</html:code>. These last two options are useful
  793. with SVG viewers that support these richer fontname spaces.
  794. </html:p>
  795. </xsd:documentation>
  796. </xsd:annotation>
  797. </xsd:attribute>
  798. <xsd:attribute name="fontpath" type="xsd:string">
  799. <xsd:annotation>
  800. <xsd:documentation>
  801. <html:p>
  802. Directory list used by libgd to search for bitmap fonts if Graphviz
  803. was not built with the fontconfig library.
  804. If <html:a rel="attr">fontpath</html:a> is not set, the environment
  805. variable <html:code>DOTFONTPATH</html:code> is checked.
  806. If that is not set, <html:code>GDFONTPATH</html:code> is checked.
  807. If not set, libgd uses its compiled-in font path.
  808. Note that fontpath is an attribute of the root graph.
  809. </html:p>
  810. </xsd:documentation>
  811. </xsd:annotation>
  812. </xsd:attribute>
  813. <xsd:attribute name="fontsize" type="xsd:decimal" default="14.0">
  814. <xsd:annotation>
  815. <xsd:documentation>
  816. <html:p>
  817. Font size, in <html:a rel="note">points</html:a>, used for text.
  818. </html:p>
  819. </xsd:documentation>
  820. </xsd:annotation>
  821. </xsd:attribute>
  822. <xsd:attribute name="group" type="xsd:string" gv:layouts="dot">
  823. <xsd:annotation>
  824. <xsd:documentation>
  825. <html:p>
  826. If the end points of an edge belong to the same group, i.e., have the
  827. same group attribute, parameters are set to avoid crossings and keep
  828. the edges straight.
  829. </html:p>
  830. </xsd:documentation>
  831. </xsd:annotation>
  832. </xsd:attribute>
  833. <xsd:attribute name="headURL" type="xsd:anyURI" gv:formats="svg map">
  834. <xsd:annotation>
  835. <xsd:documentation>
  836. <html:p>
  837. If <html:a rel="attr">headURL</html:a> is defined, it is
  838. output as part of the head label of the edge.
  839. Also, this value is used near the head node, overriding any
  840. <html:a rel="attr">URL</html:a> value.
  841. See <html:a rel="note">undirected</html:a>.
  842. </html:p>
  843. </xsd:documentation>
  844. </xsd:annotation>
  845. </xsd:attribute>
  846. <xsd:attribute name="headclip" type="xsd:boolean" default="true">
  847. <xsd:annotation>
  848. <xsd:documentation>
  849. <html:p>
  850. If <html:span class="val">true</html:span>, the head of an edge is clipped to the boundary of the head node;
  851. otherwise, the end of the edge goes to the center of the node, or the
  852. center of a port, if applicable.
  853. </html:p>
  854. </xsd:documentation>
  855. </xsd:annotation>
  856. </xsd:attribute>
  857. <xsd:attribute name="headhref" type="xsd:anyURI" gv:formats="svg map">
  858. <xsd:annotation>
  859. <xsd:documentation>
  860. <html:p>
  861. Synonym for <html:a rel="attr">headURL</html:a>.
  862. </html:p>
  863. </xsd:documentation>
  864. </xsd:annotation>
  865. </xsd:attribute>
  866. <xsd:attribute name="headlabel" type="lblString">
  867. <xsd:annotation>
  868. <xsd:documentation>
  869. <html:p>
  870. Text label to be placed near head of edge.
  871. See <html:a rel="note">undirected</html:a>.
  872. </html:p>
  873. </xsd:documentation>
  874. </xsd:annotation>
  875. </xsd:attribute>
  876. <xsd:attribute name="headport" type="portPos" default="center">
  877. <xsd:annotation>
  878. <xsd:documentation>
  879. <html:p>
  880. Indicates where on the head node to attach the head of the edge.
  881. In the default case, the edge is aimed towards the center of the node,
  882. and then clipped at the node boundary.
  883. See <html:a rel="note">undirected</html:a>.
  884. </html:p>
  885. </xsd:documentation>
  886. </xsd:annotation>
  887. </xsd:attribute>
  888. <xsd:attribute name="headtarget" type="escString" gv:formats="svg map">
  889. <xsd:annotation>
  890. <xsd:documentation>
  891. <html:p>
  892. If the edge has a <html:a rel="attr">headURL</html:a>,
  893. this attribute determines which window of the
  894. browser is used
  895. for the URL. Setting it to "_graphviz" will open a new window if it
  896. doesn't already exist, or reuse it if it does.
  897. If undefined, the value of the <html:a rel="attr">target</html:a> is used.
  898. </html:p>
  899. </xsd:documentation>
  900. </xsd:annotation>
  901. </xsd:attribute>
  902. <xsd:attribute name="headtooltip" type="escString" gv:formats="svg cmap">
  903. <xsd:annotation>
  904. <xsd:documentation>
  905. <html:p>
  906. Tooltip annotation attached to the head of an edge. This is used only
  907. if the edge has a <html:a rel="attr">headURL</html:a> attribute.
  908. </html:p>
  909. </xsd:documentation>
  910. </xsd:annotation>
  911. </xsd:attribute>
  912. <xsd:attribute name="height" type="xsd:decimal" default="0.5">
  913. <xsd:annotation>
  914. <xsd:documentation>
  915. <html:p>
  916. Height of node, in inches. This is taken as the initial, minimum height
  917. of the node. If <html:a rel="attr">fixedsize</html:a> is true, this
  918. will be the final height of the node. Otherwise, if the node label
  919. requires more height to fit, the node's height will be increased to
  920. contain the label. Note also that, if the output format is dot, the
  921. value given to <html:a rel="attr">height</html:a> will be the final value.
  922. </html:p>
  923. </xsd:documentation>
  924. </xsd:annotation>
  925. </xsd:attribute>
  926. <xsd:attribute name="href" type="xsd:anyURI" gv:formats="svg ps ps2 map">
  927. <xsd:annotation>
  928. <xsd:documentation>
  929. <html:p>
  930. Synonym for <html:a rel="attr">URL</html:a>.
  931. </html:p>
  932. </xsd:documentation>
  933. </xsd:annotation>
  934. </xsd:attribute>
  935. <xsd:attribute name="image" type="xsd:string">
  936. <xsd:annotation>
  937. <xsd:documentation>
  938. <html:p>
  939. Gives the name of a file containing an image to be displayed inside
  940. a node. The image file must be in one of the recognized formats,
  941. typically JPEG, PNG, GIF or Postscript, and be able to be converted
  942. into the desired output format.
  943. </html:p>
  944. <html:p>
  945. Unlike with the <html:a rel="attr">shapefile</html:a> attribute,
  946. the image is treated as node
  947. content rather than the entire node. In particular, an image can
  948. be contained in a node of any shape, not just a rectangle.
  949. </html:p>
  950. </xsd:documentation>
  951. </xsd:annotation>
  952. </xsd:attribute>
  953. <xsd:attribute name="imagescale" type="xsd:string" default="false">
  954. <xsd:annotation>
  955. <xsd:documentation>
  956. <html:p>
  957. Attribute controlling how an image fills its
  958. containing node. In general, the image is given its natural size,
  959. (cf. <html:a rel="attr">dpi</html:a>),
  960. and the node size is made large enough to contain its image, its
  961. label, its margin, and its peripheries.
  962. Its width and height will also be at least as large as its
  963. minimum <html:a rel="attr">width</html:a> and <html:a rel="attr">height</html:a>.
  964. If, however, <html:code>fixedsize=true</html:code>,
  965. the width and height attributes specify the exact size of the node.
  966. </html:p>
  967. <html:p>
  968. During rendering, in the default case (<html:code>imagescale=false</html:code>),
  969. the image retains its natural size.
  970. If <html:span class="val">true</html:span>,
  971. the image is uniformly scaled (i.e., its aspect ratio is
  972. preserved) to fit inside the node.
  973. At least one dimension of the image will be as large as possible
  974. given the size of the node.
  975. When <html:span class="val">width</html:span>,
  976. the width of the image is scaled to fill the node width.
  977. The corresponding property holds when <html:tt>imagescale=height</html:tt>.
  978. When <html:span class="val">both</html:span>,
  979. both the height and the width are scaled separately to fill the node.
  980. </html:p>
  981. <html:p>
  982. In all cases, if a dimension of the image is larger than the
  983. corresponding dimension of the node, that dimension of the
  984. image is scaled down to fit the node. As with the case of
  985. expansion, if <html:code>imagescale=true</html:code>, width and height are
  986. scaled uniformly.
  987. </html:p>
  988. </xsd:documentation>
  989. </xsd:annotation>
  990. </xsd:attribute>
  991. <xsd:attribute name="label" type="lblString">
  992. <xsd:annotation>
  993. <xsd:documentation>
  994. <html:p>
  995. Text label attached to objects.
  996. If a node's <html:a rel="attr">shape</html:a> is record, then the label can
  997. have a <html:a href="http://www.graphviz.org/doc/info/shapes.html#record">special format</html:a>
  998. which describes the record layout.
  999. </html:p>
  1000. </xsd:documentation>
  1001. </xsd:annotation>
  1002. </xsd:attribute>
  1003. <xsd:attribute name="labelURL" type="xsd:anyURI">
  1004. <xsd:annotation>
  1005. <xsd:documentation>
  1006. <html:p>
  1007. If <html:a rel="attr">labelURL</html:a> is defined, this is the link used for the label
  1008. of an edge. This value overrides any <html:a rel="attr">URL</html:a>
  1009. defined for the edge.
  1010. </html:p>
  1011. </xsd:documentation>
  1012. </xsd:annotation>
  1013. </xsd:attribute>
  1014. <xsd:attribute name="labelangle" type="xsd:decimal">
  1015. <xsd:annotation>
  1016. <xsd:documentation>
  1017. <html:p>
  1018. This, along with <html:a rel="attr">labeldistance</html:a>, determine
  1019. where the
  1020. headlabel (taillabel) are placed with respect to the head (tail)
  1021. in polar coordinates. The origin in the coordinate system is
  1022. the point where the edge touches the node. The ray of 0 degrees
  1023. goes from the origin back along the edge, parallel to the edge
  1024. at the origin.
  1025. </html:p>
  1026. <html:p>
  1027. The angle, in degrees, specifies the rotation from the 0 degree ray,
  1028. with positive angles moving counterclockwise and negative angles
  1029. moving clockwise.
  1030. </html:p>
  1031. </xsd:documentation>
  1032. </xsd:annotation>
  1033. </xsd:attribute>
  1034. <xsd:attribute name="labeldistance" type="xsd:decimal">
  1035. <xsd:annotation>
  1036. <xsd:documentation>
  1037. <html:p>
  1038. Multiplicative scaling factor adjusting the distance that
  1039. the headlabel (taillabel) is from the head (tail) node.
  1040. The default distance is 10 points. See <html:a rel="attr">labelangle</html:a>
  1041. for more details.
  1042. </html:p>
  1043. </xsd:documentation>
  1044. </xsd:annotation>
  1045. </xsd:attribute>
  1046. <xsd:attribute name="labelfloat" type="xsd:boolean">
  1047. <xsd:annotation>
  1048. <xsd:documentation>
  1049. <html:p>
  1050. If true, allows edge labels to be less constrained in position.
  1051. In particular, it may appear on top of other edges.
  1052. </html:p>
  1053. </xsd:documentation>
  1054. </xsd:annotation>
  1055. </xsd:attribute>
  1056. <xsd:attribute name="labelfontcolor" type="color">
  1057. <xsd:annotation>
  1058. <xsd:documentation>
  1059. <html:p>
  1060. Color used for headlabel and taillabel.
  1061. If not set, defaults to edge's fontcolor.
  1062. </html:p>
  1063. </xsd:documentation>
  1064. </xsd:annotation>
  1065. </xsd:attribute>
  1066. <xsd:attribute name="labelfontname" type="xsd:string">
  1067. <xsd:annotation>
  1068. <xsd:documentation>
  1069. <html:p>
  1070. Font used for headlabel and taillabel.
  1071. If not set, defaults to edge's fontname.
  1072. </html:p>
  1073. </xsd:documentation>
  1074. </xsd:annotation>
  1075. </xsd:attribute>
  1076. <xsd:attribute name="labelfontsize" type="xsd:decimal">
  1077. <xsd:annotation>
  1078. <xsd:documentation>
  1079. <html:p>
  1080. Font size, in <html:a rel="note">points</html:a>, used for headlabel and taillabel.
  1081. If not set, defaults to edge's fontsize.
  1082. </html:p>
  1083. </xsd:documentation>
  1084. </xsd:annotation>
  1085. </xsd:attribute>
  1086. <xsd:attribute name="labelhref" type="xsd:anyURI">
  1087. <xsd:annotation>
  1088. <xsd:documentation>
  1089. <html:p>
  1090. Synonym for <html:a rel="attr">labelURL</html:a>.
  1091. </html:p>
  1092. </xsd:documentation>
  1093. </xsd:annotation>
  1094. </xsd:attribute>
  1095. <xsd:attribute name="labeljust" type="xsd:string">
  1096. <xsd:annotation>
  1097. <xsd:documentation>
  1098. <html:p>
  1099. Justification for cluster labels. If <html:span class="val">r</html:span>, the label
  1100. is right-justified within bounding rectangle; if <html:span class="val">l</html:span>, left-justified;
  1101. else the label is centered.
  1102. Note that a subgraph inherits attributes from its parent. Thus, if
  1103. the root graph sets <html:a rel="attr">labeljust</html:a> to <html:span class="val">l</html:span>, the subgraph inherits
  1104. this value.
  1105. </html:p>
  1106. </xsd:documentation>
  1107. </xsd:annotation>
  1108. </xsd:attribute>
  1109. <xsd:attribute name="labelloc" type="xsd:string">
  1110. <xsd:annotation>
  1111. <xsd:documentation>
  1112. <html:p>
  1113. Top/bottom placement of graph and cluster labels.
  1114. If the attribute is <html:span class="val">t</html:span>, place label at the top;
  1115. if the attribute is <html:span class="val">b</html:span>, place label at the bottom.
  1116. By default, root
  1117. graph labels go on the bottom and cluster labels go on the top.
  1118. Note that a subgraph inherits attributes from its parent. Thus, if
  1119. the root graph sets <html:a rel="attr">labelloc</html:a> to <html:span class="val">b</html:span>, the subgraph inherits
  1120. this value.
  1121. </html:p>
  1122. </xsd:documentation>
  1123. </xsd:annotation>
  1124. </xsd:attribute>
  1125. <xsd:attribute name="labeltarget" type="escString">
  1126. <xsd:annotation>
  1127. <xsd:documentation>
  1128. <html:p>
  1129. If the edge has a <html:a rel="attr">URL</html:a> or <html:a rel="attr">labelURL</html:a>
  1130. attribute, this attribute determines which window of the
  1131. browser is used
  1132. for the URL attached to the label.
  1133. Setting it to "_graphviz" will open a new window if it
  1134. doesn't already exist, or reuse it if it does.
  1135. If undefined, the value of the <html:a rel="attr">target</html:a> is used.
  1136. </html:p>
  1137. </xsd:documentation>
  1138. </xsd:annotation>
  1139. </xsd:attribute>
  1140. <xsd:attribute name="labeltooltip" type="escString">
  1141. <xsd:annotation>
  1142. <xsd:documentation>
  1143. <html:p>
  1144. Tooltip annotation attached to label of an edge.
  1145. This is used only if the edge has a <html:a rel="attr">URL</html:a>
  1146. or <html:a rel="attr">labelURL</html:a> attribute.
  1147. </html:p>
  1148. </xsd:documentation>
  1149. </xsd:annotation>
  1150. </xsd:attribute>
  1151. <xsd:attribute name="landscape" type="xsd:boolean">
  1152. <xsd:annotation>
  1153. <xsd:documentation>
  1154. <html:p>
  1155. If true, the graph is rendered in landscape mode. Synonymous with
  1156. <html:code><html:a rel="attr">rotate</html:a>=90</html:code> or
  1157. <html:code><html:a rel="attr">orientation</html:a>=landscape</html:code>.
  1158. </html:p>
  1159. </xsd:documentation>
  1160. </xsd:annotation>
  1161. </xsd:attribute>
  1162. <xsd:attribute name="layer" type="layerRange">
  1163. <xsd:annotation>
  1164. <xsd:documentation>
  1165. <html:p>
  1166. Specifies layers in which the node or edge is present.
  1167. </html:p>
  1168. </xsd:documentation>
  1169. </xsd:annotation>
  1170. </xsd:attribute>
  1171. <xsd:attribute name="layers" type="layerList">
  1172. <xsd:annotation>
  1173. <xsd:documentation>
  1174. <html:p>
  1175. Specifies a linearly ordered list of layer names attached to the graph
  1176. The graph is then output in separate layers. Only those components
  1177. belonging to the current output layer appear. For more information,
  1178. see the page <html:a href="http://www.graphviz.org/Documentation/html/layers/">How to use drawing layers (overlays)</html:a>.
  1179. </html:p>
  1180. </xsd:documentation>
  1181. </xsd:annotation>
  1182. </xsd:attribute>
  1183. <xsd:attribute name="layersep" type="xsd:string">
  1184. <xsd:annotation>
  1185. <xsd:documentation>
  1186. <html:p>
  1187. Specifies the separator characters used to split the
  1188. <html:a rel="attr">layers </html:a>attribute into a list of layer names.
  1189. </html:p>
  1190. </xsd:documentation>
  1191. </xsd:annotation>
  1192. </xsd:attribute>
  1193. <xsd:attribute name="layout" type="xsd:string">
  1194. <xsd:annotation>
  1195. <xsd:documentation>
  1196. <html:p>
  1197. Specifies the name of the layout algorithm to use, such as <html:span class="val">dot</html:span>
  1198. or <html:span class="val">neato</html:span>. Normally, graphs should be kept independent of a type of
  1199. layout. In some cases, however, it can be convenient to embed the type
  1200. of layout desired within the graph. For example, a graph containing
  1201. position information from a layout might want to record what the
  1202. associated layout algorithm was.
  1203. </html:p>
  1204. <html:p>
  1205. This attribute takes precedence over
  1206. the <html:a href="http://www.graphviz.org/doc/info/command.html#minusK">-K flag</html:a>
  1207. or the actual command name used.
  1208. </html:p>
  1209. </xsd:documentation>
  1210. </xsd:annotation>
  1211. </xsd:attribute>
  1212. <xsd:attribute name="len" type="xsd:decimal">
  1213. <xsd:annotation>
  1214. <xsd:documentation>
  1215. <html:p>
  1216. Preferred edge length, in inches.
  1217. </html:p>
  1218. </xsd:documentation>
  1219. </xsd:annotation>
  1220. </xsd:attribute>
  1221. <xsd:attribute name="levelsgap" type="xsd:decimal">
  1222. <xsd:annotation>
  1223. <xsd:documentation>
  1224. <html:p>
  1225. Specifies strictness of level constraints in neato
  1226. when <html:code><html:a rel="attr">mode</html:a>="ipsep" or "hier"</html:code>.
  1227. Larger positive values mean stricter constraints, which demand more
  1228. separation between levels. On the other hand, negative values will relax
  1229. the constraints by allowing some overlap between the levels.
  1230. </html:p>
  1231. </xsd:documentation>
  1232. </xsd:annotation>
  1233. </xsd:attribute>
  1234. <xsd:attribute name="lhead" type="xsd:string">
  1235. <xsd:annotation>
  1236. <xsd:documentation>
  1237. <html:p>
  1238. Logical head of an edge. When <html:a rel="attr">compound</html:a> is true,
  1239. if <html:a rel="attr">lhead</html:a> is defined and is the name of a cluster containing
  1240. the real head,
  1241. the edge is clipped to the boundary of the cluster.
  1242. See <html:a rel="note">undirected</html:a>.
  1243. </html:p>
  1244. </xsd:documentation>
  1245. </xsd:annotation>
  1246. </xsd:attribute>
  1247. <xsd:attribute name="lp" type="point">
  1248. <xsd:annotation>
  1249. <xsd:documentation>
  1250. <html:p>
  1251. Label position, in <html:a rel="note">points</html:a>.
  1252. The position indicates the center of the label.
  1253. </html:p>
  1254. </xsd:documentation>
  1255. </xsd:annotation>
  1256. </xsd:attribute>
  1257. <xsd:attribute name="ltail" type="xsd:string">
  1258. <xsd:annotation>
  1259. <xsd:documentation>
  1260. <html:p>
  1261. Logical tail of an edge. When <html:a rel="attr">compound</html:a> is true,
  1262. if <html:a rel="attr">ltail</html:a> is defined and is the name of a cluster
  1263. containing the real tail,
  1264. the edge is clipped to the boundary of the cluster.
  1265. See <html:a rel="note">undirected</html:a>.
  1266. </html:p>
  1267. </xsd:documentation>
  1268. </xsd:annotation>
  1269. </xsd:attribute>
  1270. <xsd:attribute name="margin" type="pointf">
  1271. <xsd:annotation>
  1272. <xsd:documentation>
  1273. <html:p>
  1274. For graphs, this sets x and y margins of canvas, in inches. If the margin
  1275. is a single double, both margins are set equal to the given value.
  1276. </html:p>
  1277. <html:p>
  1278. Note that the margin is not part of the drawing but just empty space
  1279. left around the drawing. It basically corresponds to a translation of
  1280. drawing, as would be necessary to center a drawing on a page. Nothing
  1281. is actually drawn in the margin. To actually extend the background of
  1282. a drawing, see the <html:a rel="attr">pad</html:a> attribute.
  1283. </html:p>
  1284. <html:p>
  1285. For nodes, this attribute specifies space left around the node's label.
  1286. By default, the value is <html:code>0.11,0.055</html:code>.
  1287. </html:p>
  1288. </xsd:documentation>
  1289. </xsd:annotation>
  1290. </xsd:attribute>
  1291. <xsd:attribute name="maxiter" type="xsd:integer">
  1292. <xsd:annotation>
  1293. <xsd:documentation>
  1294. <html:p>
  1295. Sets the number of iterations used.
  1296. </html:p>
  1297. </xsd:documentation>
  1298. </xsd:annotation>
  1299. </xsd:attribute>
  1300. <xsd:attribute name="mclimit" type="xsd:decimal">
  1301. <xsd:annotation>
  1302. <xsd:documentation>
  1303. <html:p>
  1304. Multiplicative scale factor used to alter the MinQuit (default = 8)
  1305. and MaxIter (default = 24) parameters used during crossing
  1306. minimization. These correspond to the
  1307. number of tries without improvement before quitting and the
  1308. maximum number of iterations in each pass.
  1309. </html:p>
  1310. </xsd:documentation>
  1311. </xsd:annotation>
  1312. </xsd:attribute>
  1313. <xsd:attribute name="mindist" type="xsd:decimal">
  1314. <xsd:annotation>
  1315. <xsd:documentation>
  1316. <html:p>
  1317. Specifies the minimum separation between all nodes.
  1318. </html:p>
  1319. </xsd:documentation>
  1320. </xsd:annotation>
  1321. </xsd:attribute>
  1322. <xsd:attribute name="minlen" type="xsd:integer">
  1323. <xsd:annotation>
  1324. <xsd:documentation>
  1325. <html:p>
  1326. Minimum edge length (rank difference between head and tail).
  1327. </html:p>
  1328. </xsd:documentation>
  1329. </xsd:annotation>
  1330. </xsd:attribute>
  1331. <xsd:attribute name="mode" type="xsd:string">
  1332. <xsd:annotation>
  1333. <xsd:documentation>
  1334. <html:p>
  1335. Technique for optimizing the layout. If <html:a rel="attr">mode</html:a> is <html:span class="val">major</html:span>,
  1336. neato uses stress majorization. If <html:a rel="attr">mode</html:a> is <html:span class="val">KK</html:span>,
  1337. neato uses a version of the gradient descent method. The only advantage
  1338. to the latter technique is that it is sometimes appreciably faster for
  1339. small (number of nodes &lt; 100) graphs. A significant disadvantage is that
  1340. it may cycle.
  1341. </html:p>
  1342. <html:p>
  1343. There are two new, experimental modes in neato, <html:span class="val">hier</html:span>, which adds a top-down
  1344. directionality similar to the layout used in dot, and <html:span class="val">ipsep</html:span>, which
  1345. allows the graph to specify minimum vertical and horizontal distances
  1346. between nodes. (See the <html:a rel="attr">sep</html:a> attribute.)
  1347. </html:p>
  1348. </xsd:documentation>
  1349. </xsd:annotation>
  1350. </xsd:attribute>
  1351. <xsd:attribute name="model" type="xsd:string">
  1352. <xsd:annotation>
  1353. <xsd:documentation>
  1354. <html:p>
  1355. This value specifies how the distance matrix is computed for the input
  1356. graph. The distance matrix specifies the ideal distance between every
  1357. pair of nodes. neato attemps to find a layout which best achieves
  1358. these distances. By default, it uses the length of the shortest path,
  1359. where the length of each edge is given by its <html:a rel="attr">len</html:a>
  1360. attribute. If <html:a rel="attr">model</html:a> is <html:span class="val">circuit</html:span>, neato uses the
  1361. circuit resistance
  1362. model to compute the distances. This tends to emphasize clusters. If
  1363. <html:a rel="attr">model</html:a> is <html:span class="val">subset</html:span>, neato uses the subset model. This sets the
  1364. edge length to be the number of nodes that are neighbors of exactly one
  1365. of the end points, and then calculates the shortest paths. This helps
  1366. to separate nodes with high degree.
  1367. </html:p>
  1368. </xsd:documentation>
  1369. </xsd:annotation>
  1370. </xsd:attribute>
  1371. <xsd:attribute name="mosek" type="xsd:boolean">
  1372. <xsd:annotation>
  1373. <xsd:documentation>
  1374. <html:p>
  1375. If Graphviz is built with MOSEK defined, mode=ipsep and mosek=true,
  1376. the Mosek software (www.mosek.com) is use to solve the ipsep constraints.
  1377. </html:p>
  1378. </xsd:documentation>
  1379. </xsd:annotation>
  1380. </xsd:attribute>
  1381. <xsd:attribute name="nodesep" type="xsd:decimal">
  1382. <xsd:annotation>
  1383. <xsd:documentation>
  1384. <html:p>
  1385. Minimum space between two adjacent nodes in the same rank, in inches.
  1386. </html:p>
  1387. </xsd:documentation>
  1388. </xsd:annotation>
  1389. </xsd:attribute>
  1390. <xsd:attribute name="nojustify" type="xsd:boolean">
  1391. <xsd:annotation>
  1392. <xsd:documentation>
  1393. <html:p>
  1394. By default, the justification of multi-line labels is done within the
  1395. largest context that makes sense. Thus, in the label of a polygonal
  1396. node, a left-justified line will align with the left side of the node
  1397. (shifted by the prescribed <html:a rel="attr">margin</html:a>).
  1398. In record nodes, left-justified
  1399. line will line up with the left side of the enclosing column of fields.
  1400. If <html:a rel="attr">nojustify</html:a> is <html:span class="val">true</html:span>, multi-line labels will be justified
  1401. in the context of itself. For example, if the attribute is set,
  1402. the first label line is long, and the second is shorter and left-justified,
  1403. the second will align with the left-most character in the first line,
  1404. regardless of how large the node might be.
  1405. </html:p>
  1406. </xsd:documentation>
  1407. </xsd:annotation>
  1408. </xsd:attribute>
  1409. <xsd:attribute name="normalize" type="xsd:boolean">
  1410. <xsd:annotation>
  1411. <xsd:documentation>
  1412. <html:p>
  1413. If set, normalize coordinates of final
  1414. layout so that the first point is at the origin, and then rotate the
  1415. layout so that the first edge is horizontal.
  1416. </html:p>
  1417. </xsd:documentation>
  1418. </xsd:annotation>
  1419. </xsd:attribute>
  1420. <xsd:attribute name="nslimit" type="xsd:decimal">
  1421. <xsd:annotation>
  1422. <xsd:documentation>
  1423. <html:p>
  1424. Used to set number of iterations in
  1425. network simplex applications, used in
  1426. computing node x coordinates.
  1427. If defined, # iterations = <html:a rel="attr">nslimit</html:a> * # nodes;
  1428. otherwise, # iterations = MAXINT.
  1429. </html:p>
  1430. </xsd:documentation>
  1431. </xsd:annotation>
  1432. </xsd:attribute>
  1433. <xsd:attribute name="nslimit1" type="xsd:decimal">
  1434. <xsd:annotation>
  1435. <xsd:documentation>
  1436. <html:p>
  1437. Used to set number of iterations in
  1438. network simplex applications, used for ranking nodes.
  1439. If defined, # iterations = <html:a rel="attr">nslimit1</html:a> * # nodes;
  1440. otherwise, # iterations = MAXINT.
  1441. </html:p>
  1442. </xsd:documentation>
  1443. </xsd:annotation>
  1444. </xsd:attribute>
  1445. <xsd:attribute name="ordering" type="xsd:string">
  1446. <xsd:annotation>
  1447. <xsd:documentation>
  1448. <html:p>
  1449. If "out" for a graph G, and n is a node in G, then edges n-&gt;* appear
  1450. left-to-right in the same order in which they are defined.
  1451. If "in", the edges *-&gt;n appear
  1452. left-to-right in the same order in which they are defined for all
  1453. nodes n.
  1454. </html:p>
  1455. </xsd:documentation>
  1456. </xsd:annotation>
  1457. </xsd:attribute>
  1458. <!--
  1459. <xsd:attribute name="orientation" type="xsd:decimal">
  1460. <xsd:annotation>
  1461. <xsd:documentation>
  1462. Angle, in degrees, used to rotate node shapes.
  1463. </xsd:documentation>
  1464. </xsd:annotation>
  1465. </xsd:attribute>
  1466. <xsd:attribute name="orientation" type="xsd:string">
  1467. <xsd:annotation>
  1468. <xsd:documentation>
  1469. If "[lL]*", set graph orientation to landscape
  1470. Used only if <html:a rel="attr">rotate</html:a> is not defined.
  1471. </xsd:documentation>
  1472. </xsd:annotation>
  1473. </xsd:attribute>
  1474. -->
  1475. <xsd:attribute name="outputorder" type="outputMode">
  1476. <xsd:annotation>
  1477. <xsd:documentation>
  1478. <html:p>
  1479. Specify order in which nodes and edges are drawn.
  1480. </html:p>
  1481. </xsd:documentation>
  1482. </xsd:annotation>
  1483. </xsd:attribute>
  1484. <xsd:attribute name="overlap" type="xsd:string">
  1485. <xsd:annotation>
  1486. <xsd:documentation>
  1487. <html:p>
  1488. Determines if and how node overlaps should be removed. Nodes are first
  1489. enlarged using the <html:a rel="attr">sep</html:a> attribute.
  1490. If <html:span class="val">true</html:span>, overlaps are retained.
  1491. If the value is <html:span class="val">scale</html:span>, overlaps are removed by uniformly scaling in x and y.
  1492. If the value converts to <html:span class="val">false</html:span>, node overlaps are removed by a
  1493. Voronoi-based technique.
  1494. If the value is <html:span class="val">scalexy</html:span>, x and y are separately
  1495. scaled to remove overlaps.
  1496. If the value is <html:span class="val">orthoxy</html:span> or <html:span class="val">orthoyx</html:span>, overlaps
  1497. are moved by optimizing two constraint problems, one for the x axis and
  1498. one for the y. The suffix indicates which axis is processed first.
  1499. If the value is <html:span class="val">ortho</html:span>, the technique is similar to <html:span class="val">orthoxy</html:span> except a
  1500. heuristic is used to reduce the bias between the two passes.
  1501. If the value is <html:span class="val">ortho_yx</html:span>, the technique is the same as <html:span class="val">ortho</html:span>, except
  1502. the roles of x and y are reversed.
  1503. The values <html:span class="val">portho</html:span>, <html:span class="val">porthoxy</html:span>, <html:span class="val">porthoxy</html:span>, and <html:span class="val">portho_yx</html:span> are similar
  1504. to the previous four, except only pseudo-orthogonal ordering is
  1505. enforced.
  1506. </html:p>
  1507. <html:p>
  1508. If the value is <html:span class="val">compress</html:span>, the layout will be scaled down as much as
  1509. possible without introducing any overlaps, obviously assuming there are
  1510. none to begin with.
  1511. </html:p>
  1512. <html:p>
  1513. If the value is <html:span class="val">ipsep</html:span>, and the layout is done by neato with
  1514. <html:a rel="attr">mode</html:a>="ipsep", the overlap removal constraints are
  1515. incorporated into the layout algorithm itself.
  1516. N.B. At present, this only supports one level of clustering.
  1517. </html:p>
  1518. <html:p>
  1519. If the value is <html:span class="val">vpsc</html:span>, overlap removal is similarly to <html:span class="val">ortho</html:span>, except
  1520. quadratic optimization is used to minimize node displacement.
  1521. N.B. At present, this mode only works when <html:a rel="attr">mode</html:a>="ipsep".
  1522. </html:p>
  1523. <html:p>
  1524. Except for fdp, the layouts assume <html:code>overlap="true"</html:code> as the default.
  1525. Fdp first uses a number of passes using built-in, force-directed technique
  1526. to remove overlaps. Thus, fdp accepts <html:a rel="attr">overlap</html:a> with an integer
  1527. prefix followed by a colon, specifying the number of tries. If there is
  1528. no prefix, no initial tries will be performed. If there is nothing following
  1529. a colon, none of the above methods will be attempted. By default, fdp
  1530. uses <html:code>overlap="9:portho"</html:code>. Note that <html:code>overlap="true"</html:code>,
  1531. <html:code>overlap="0:true"</html:code> and <html:code>overlap="0:"</html:code> all turn off all overlap
  1532. removal.
  1533. </html:p>
  1534. <html:p>
  1535. Except for the Voronoi method, all of these transforms preserve the
  1536. orthogonal ordering of the original layout. That is, if the x coordinates
  1537. of two nodes are originally the same, they will remain the same, and if
  1538. the x coordinate of one node is originally less than the x coordinate of
  1539. another, this relation will still hold in the transformed layout. The
  1540. similar properties hold for the y coordinates.
  1541. This is not quite true for the "porth*" cases. For these, orthogonal
  1542. ordering is only preserved among nodes related by an edge.
  1543. </html:p>
  1544. <html:p>
  1545. <html:b>NOTE</html:b>The methods <html:span class="val">orthoxy</html:span> and <html:span class="val">orthoyx</html:span> are still evolving. The semantics of these may change, or these methods may disappear altogether.
  1546. </html:p>
  1547. </xsd:documentation>
  1548. </xsd:annotation>
  1549. </xsd:attribute>
  1550. <xsd:attribute name="pack" type="xsd:string">
  1551. <xsd:annotation>
  1552. <xsd:documentation>
  1553. <html:p>
  1554. This is true if the value of pack is <html:span class="val">true</html:span> (case-insensitive) or a
  1555. non-negative integer. If true, each connected component of the graph is
  1556. laid out separately, and then the graphs are packed tightly.
  1557. If pack has an integral value, this is used as the size,
  1558. in <html:a href="#points">points</html:a>, of
  1559. a margin around each part; otherwise, a default margin of 8 is used.
  1560. If pack is interpreted as false, the entire graph is laid out together.
  1561. The granularity and method of packing is influenced by the
  1562. <html:a rel="attr">packmode</html:a> attribute.
  1563. </html:p>
  1564. <html:p>
  1565. For layouts which always do packing, such a twopi, the <html:a rel="attr">pack</html:a>
  1566. attribute is just used to set the margin.
  1567. </html:p>
  1568. </xsd:documentation>
  1569. </xsd:annotation>
  1570. </xsd:attribute>
  1571. <xsd:attribute name="packmode" type="packMode">
  1572. <xsd:annotation>
  1573. <xsd:documentation>
  1574. <html:p>
  1575. This indicates the granularity and method used for packing
  1576. (cf. <html:a rel="type">packMode</html:a>). Note that defining
  1577. <html:a rel="attr">packmode</html:a> will automatically turn on packing as though one had
  1578. set <html:code>pack=true</html:code>.
  1579. </html:p>
  1580. </xsd:documentation>
  1581. </xsd:annotation>
  1582. </xsd:attribute>
  1583. <xsd:attribute name="pad" type="pointf">
  1584. <xsd:annotation>
  1585. <xsd:documentation>
  1586. <html:p>
  1587. The pad attribute specifies how much, in inches, to extend the
  1588. drawing area around the minimal area needed to draw the graph.
  1589. If the pad is a single double, both the x and y pad values are set
  1590. equal to the given value. This area is part of the
  1591. drawing and will be filled with the background color, if appropriate.
  1592. </html:p>
  1593. <html:p>
  1594. Normally, a small pad is used for aesthetic reasons, especially when
  1595. a background color is used, to avoid having nodes and edges abutting
  1596. the boundary of the drawn region.
  1597. </html:p>
  1598. </xsd:documentation>
  1599. </xsd:annotation>
  1600. </xsd:attribute>
  1601. <xsd:attribute name="page" type="pointf">
  1602. <xsd:annotation>
  1603. <xsd:documentation>
  1604. <html:p>
  1605. Width and height of output pages, in inches. If this is set and is
  1606. smaller than the size of the layout, a rectangular array of pages of
  1607. the specified page size is overlaid on the layout, with origins
  1608. aligned in the lower-left corner, thereby partitioning the layout
  1609. into pages. The pages are then produced one at a time, in
  1610. <html:a rel="attr">pagedir</html:a> order.
  1611. </html:p>
  1612. <html:p>
  1613. At present, this only works for PostScript output. For other types of
  1614. output, one should use another tool to split the output into multiple
  1615. output files. Or use the <html:a rel="attr">viewport</html:a> to generate
  1616. multiple files.
  1617. </html:p>
  1618. </xsd:documentation>
  1619. </xsd:annotation>
  1620. </xsd:attribute>
  1621. <xsd:attribute name="pagedir" type="pagedir">
  1622. <xsd:annotation>
  1623. <xsd:documentation>
  1624. <html:p>
  1625. If the <html:a rel="attr">page</html:a> attribute is set and applicable,
  1626. this attribute specifies the order in which the pages are emitted.
  1627. This is limited to one of the 8 row or column major orders.
  1628. </html:p>
  1629. </xsd:documentation>
  1630. </xsd:annotation>
  1631. </xsd:attribute>
  1632. <xsd:attribute name="pencolor" type="color">
  1633. <xsd:annotation>
  1634. <xsd:documentation>
  1635. <html:p>
  1636. Color used to draw the bounding box around a cluster.
  1637. If <html:a rel="attr">pencolor</html:a> is not defined, <html:a rel="attr">color</html:a> is
  1638. used. If this is not defined, <html:a rel="attr">bgcolor</html:a> is used.
  1639. If this is not defined, the default is used.
  1640. </html:p>
  1641. <html:p>
  1642. Note that a cluster inherits the root graph's attributes if defined.
  1643. Thus, if the root graph has defined a <html:a rel="attr">pencolor</html:a>, this will override a
  1644. <html:a rel="attr">color</html:a> or <html:a rel="attr">bgcolor</html:a> attribute set for the cluster.
  1645. </html:p>
  1646. </xsd:documentation>
  1647. </xsd:annotation>
  1648. </xsd:attribute>
  1649. <xsd:attribute name="peripheries" type="xsd:integer">
  1650. <xsd:annotation>
  1651. <xsd:documentation>
  1652. <html:p>
  1653. Set number of peripheries used in polygonal shapes and cluster
  1654. boundaries. Note that
  1655. <html:a href="http://www.graphviz.org/doc/info/shapes.html#epsf">user-defined shapes</html:a> are treated as a
  1656. form of box shape, so the default
  1657. peripheries value is 1 and the user-defined shape will be drawn in
  1658. a bounding rectangle. Setting <html:code>peripheries=0</html:code> will turn this off.
  1659. Also, 1 is the maximum peripheries value for clusters.
  1660. </html:p>
  1661. </xsd:documentation>
  1662. </xsd:annotation>
  1663. </xsd:attribute>
  1664. <xsd:attribute name="pin" type="xsd:boolean">
  1665. <xsd:annotation>
  1666. <xsd:documentation>
  1667. <html:p>
  1668. If true and the node has a pos attribute on input, neato prevents the
  1669. node from moving from the input position. This property can also be specified
  1670. in the pos attribute itself (cf. the <html:a rel="attr">point</html:a> type).
  1671. </html:p>
  1672. </xsd:documentation>
  1673. </xsd:annotation>
  1674. </xsd:attribute>
  1675. <xsd:attribute name="pos" type="splineType">
  1676. <xsd:annotation>
  1677. <xsd:documentation>
  1678. <html:p>
  1679. Position of node, or spline control points.
  1680. For nodes, the position indicates the center of the node.
  1681. On output, the coordinates are in <html:a href="#points">points</html:a>.
  1682. </html:p>
  1683. <html:p>
  1684. In neato and fdp, pos can be used to set the initial position of a node.
  1685. By default, the coordinates are assumed to be in inches. However, the
  1686. <html:a href="http://www.graphviz.org/doc/info/command.html#d:s">-s</html:a> command line flag can be used to specify
  1687. different units.
  1688. </html:p>
  1689. <html:p>
  1690. When the <html:a href="http://www.graphviz.org/doc/info/command.html#d:n">-n</html:a> command line flag is used with
  1691. neato, it is assumed the positions have been set by one of the layout
  1692. programs, and are therefore in points. Thus, <html:code>neato -n</html:code> can accept
  1693. input correctly without requiring a <html:code>-s</html:code> flag and, in fact,
  1694. ignores any such flag.
  1695. </html:p>
  1696. </xsd:documentation>
  1697. </xsd:annotation>
  1698. </xsd:attribute>
  1699. <xsd:attribute name="quantum" type="xsd:decimal">
  1700. <xsd:annotation>
  1701. <xsd:documentation>
  1702. <html:p>
  1703. If <html:a rel="attr">quantum</html:a> &gt; 0.0, node label dimensions
  1704. will be rounded to integral multiples of the quantum.
  1705. </html:p>
  1706. </xsd:documentation>
  1707. </xsd:annotation>
  1708. </xsd:attribute>
  1709. <xsd:attribute name="rank" type="rankType">
  1710. <xsd:annotation>
  1711. <xsd:documentation>
  1712. <html:p>
  1713. Rank constraints on the nodes in a subgraph.
  1714. If <html:span class="val">same</html:span>, all nodes are placed on the same rank.
  1715. If <html:span class="val">min</html:span>, all nodes are placed on the minimum rank.
  1716. If <html:span class="val">source</html:span>, all nodes are placed on the minimum rank, and
  1717. the only nodes on the minimum rank belong to some subgraph whose
  1718. rank attribute is "source" or "min".
  1719. Analogous criteria hold for <html:a rel="attr">rank</html:a>=<html:span class="val">max</html:span> and <html:a rel="attr">rank</html:a>=<html:span class="val">sink</html:span>.
  1720. (Note: the
  1721. minimum rank is topmost or leftmost, and the maximum rank is bottommost
  1722. or rightmost.)
  1723. </html:p>
  1724. </xsd:documentation>
  1725. </xsd:annotation>
  1726. </xsd:attribute>
  1727. <xsd:attribute name="rankdir" type="rankdir">
  1728. <xsd:annotation>
  1729. <xsd:documentation>
  1730. <html:p>
  1731. Sets direction of graph layout. For example, if <html:a rel="attr">rankdir</html:a>="LR",
  1732. and barring cycles, an edge <html:code>T -&gt; H;</html:code> will go
  1733. from left to right. By default, graphs are laid out from top to bottom.
  1734. </html:p>
  1735. </xsd:documentation>
  1736. </xsd:annotation>
  1737. </xsd:attribute>
  1738. <xsd:attribute name="ranksep" type="xsd:decimal">
  1739. <xsd:annotation>
  1740. <xsd:documentation>
  1741. <html:p>
  1742. In dot, this gives the desired rank separation, in inches. This is
  1743. the minimum vertical distance between the bottom of the nodes in one
  1744. rank and the tops of nodes in the next. If the value
  1745. contains "equally", the centers of all ranks are spaced equally apart.
  1746. Note that both
  1747. settings are possible, e.g., ranksep = "1.2 equally".
  1748. In twopi, specifies radial separation of concentric circles.
  1749. </html:p>
  1750. </xsd:documentation>
  1751. </xsd:annotation>
  1752. </xsd:attribute>
  1753. <xsd:attribute name="ratio" type="xsd:string">
  1754. <xsd:annotation>
  1755. <xsd:documentation>
  1756. <html:p>
  1757. Sets the aspect ratio (drawing height/drawing width) for the drawing.
  1758. Note that this is adjusted before
  1759. the <html:a rel="attr">size</html:a> attribute constraints are enforced.
  1760. </html:p>
  1761. <html:p>
  1762. If <html:a rel="attr">ratio</html:a> is numeric, it is taken as the desired aspect ratio.
  1763. Then, if the actual aspect ratio is less than the desired ratio,
  1764. the drawing height is scaled up to achieve the
  1765. desired ratio; if the actual ratio is greater than that desired ratio,
  1766. the drawing width is scaled up.
  1767. </html:p>
  1768. <html:p>
  1769. If <html:a rel="attr">ratio</html:a> = <html:span class="val">fill</html:span> and the <html:a rel="attr">size</html:a>
  1770. attribute is set, node positions are scaled, separately in both x
  1771. and y, so that the final drawing exactly fills the specified size.
  1772. </html:p>
  1773. <html:p>
  1774. If <html:a rel="attr">ratio</html:a> = <html:span class="val">compress</html:span> and the <html:a rel="attr">size</html:a>
  1775. attribute is set, dot attempts to compress the initial layout to fit
  1776. in the given size. This achieves a tighter packing of nodes but
  1777. reduces the balance and symmetry. This feature only works in dot.
  1778. </html:p>
  1779. <html:p>
  1780. If <html:a rel="attr">ratio</html:a> = <html:span class="val">expand</html:span>, the <html:a rel="attr">size</html:a>
  1781. attribute is set, and both the width and the height of the graph are
  1782. less than the value in <html:a rel="attr">size</html:a>, node positions are scaled
  1783. uniformly until at least
  1784. one dimension fits <html:a rel="attr">size</html:a> exactly.
  1785. Note that this is distinct from using <html:a rel="attr">size</html:a> as the
  1786. desired size, as here the drawing is expanded before edges are generated and
  1787. all node and text sizes remain unchanged.
  1788. </html:p>
  1789. <html:p>
  1790. If <html:a rel="attr">ratio</html:a> = <html:span class="val">auto</html:span>, the <html:a rel="attr">page</html:a>
  1791. attribute is set and the graph cannot be drawn on a single page,
  1792. then <html:a rel="attr">size</html:a> is set to an ``ideal'' value.
  1793. In particular, the size in a given dimension will be the smallest integral
  1794. multiple of the page size in that dimension which is at least half the
  1795. current size. The two dimensions are then scaled independently to the
  1796. new size. This feature only works in dot.
  1797. </html:p>
  1798. </xsd:documentation>
  1799. </xsd:annotation>
  1800. </xsd:attribute>
  1801. <xsd:attribute name="rects" type="rect">
  1802. <xsd:annotation>
  1803. <xsd:documentation>
  1804. <html:p>
  1805. Rectangles for fields of records, in <html:a rel="note">points</html:a>.
  1806. </html:p>
  1807. </xsd:documentation>
  1808. </xsd:annotation>
  1809. </xsd:attribute>
  1810. <xsd:attribute name="regular" type="xsd:boolean">
  1811. <xsd:annotation>
  1812. <xsd:documentation>
  1813. <html:p>
  1814. If true, force polygon to be regular.
  1815. </html:p>
  1816. </xsd:documentation>
  1817. </xsd:annotation>
  1818. </xsd:attribute>
  1819. <xsd:attribute name="remincross" type="xsd:boolean">
  1820. <xsd:annotation>
  1821. <xsd:documentation>
  1822. <html:p>
  1823. If true and there are multiple clusters, run cross
  1824. minimization a second time.
  1825. </html:p>
  1826. </xsd:documentation>
  1827. </xsd:annotation>
  1828. </xsd:attribute>
  1829. <xsd:attribute name="resolution" type="xsd:decimal">
  1830. <xsd:annotation>
  1831. <xsd:documentation>
  1832. <html:p>
  1833. This is a synonym for the <html:a rel="attr">dpi</html:a> attribute.
  1834. </html:p>
  1835. </xsd:documentation>
  1836. </xsd:annotation>
  1837. </xsd:attribute>
  1838. <xsd:attribute name="root" type="xsd:string">
  1839. <xsd:annotation>
  1840. <xsd:documentation>
  1841. <html:p>
  1842. This specifies nodes to be used as the center of the
  1843. layout and the root of the generated spanning tree. As a graph attribute,
  1844. this gives the name of the node. As a node attribute (circo only), it
  1845. specifies that the node should be used as a central node. In twopi,
  1846. this will actually be the central node. In circo, the block containing
  1847. the node will be central in the drawing of its connected component.
  1848. If not defined,
  1849. twopi will pick a most central node, and circo will pick a random node.
  1850. </html:p>
  1851. </xsd:documentation>
  1852. </xsd:annotation>
  1853. </xsd:attribute>
  1854. <xsd:attribute name="rotate" type="xsd:integer">
  1855. <xsd:annotation>
  1856. <xsd:documentation>
  1857. <html:p>
  1858. If 90, set drawing orientation to landscape.
  1859. </html:p>
  1860. </xsd:documentation>
  1861. </xsd:annotation>
  1862. </xsd:attribute>
  1863. <xsd:attribute name="samehead" type="xsd:string">
  1864. <xsd:annotation>
  1865. <xsd:documentation>
  1866. <html:p>
  1867. Edges with the same head and the same <html:a rel="attr">samehead</html:a> value are aimed
  1868. at the same point on the head.
  1869. See <html:a rel="note">undirected</html:a>.
  1870. </html:p>
  1871. </xsd:documentation>
  1872. </xsd:annotation>
  1873. </xsd:attribute>
  1874. <xsd:attribute name="sametail" type="xsd:string">
  1875. <xsd:annotation>
  1876. <xsd:documentation>
  1877. <html:p>
  1878. Edges with the same tail and the same <html:a rel="attr">sametail</html:a> value are aimed
  1879. at the same point on the tail.
  1880. See <html:a rel="note">undirected</html:a>.
  1881. </html:p>
  1882. </xsd:documentation>
  1883. </xsd:annotation>
  1884. </xsd:attribute>
  1885. <xsd:attribute name="samplepoints" type="xsd:integer">
  1886. <xsd:annotation>
  1887. <xsd:documentation>
  1888. <html:p>
  1889. If the input graph defines the <html:a rel="attr"><html:a rel="attr">vertices</html:a></html:a>
  1890. attribute, and output is dot or xdot, this gives
  1891. the number of points used for a node whose shape is a circle or ellipse.
  1892. It plays the same role in neato, when adjusting the layout to avoid
  1893. overlapping nodes, and in image maps.
  1894. </html:p>
  1895. </xsd:documentation>
  1896. </xsd:annotation>
  1897. </xsd:attribute>
  1898. <xsd:attribute name="searchsize" type="xsd:integer">
  1899. <xsd:annotation>
  1900. <xsd:documentation>
  1901. <html:p>
  1902. During network simplex, maximum number of edges with negative cut values
  1903. to search when looking for one with minimum cut value.
  1904. </html:p>
  1905. </xsd:documentation>
  1906. </xsd:annotation>
  1907. </xsd:attribute>
  1908. <xsd:attribute name="sep" type="pointf">
  1909. <xsd:annotation>
  1910. <xsd:documentation>
  1911. <html:p>
  1912. Fraction to increase polygons (multiply
  1913. coordinates by 1 + sep) for purposes of determining overlap. Guarantees
  1914. a minimal non-zero distance between nodes.
  1915. If unset but <html:a rel="attr">esep</html:a> is defined, <html:a rel="attr">sep</html:a> will be
  1916. set to <html:code>esep/0.8</html:code>. If <html:a rel="attr">esep</html:a> is unset, the default value
  1917. is used.
  1918. </html:p>
  1919. <html:p>
  1920. When <html:a rel="attr">overlap</html:a>="ipsep" or "vpsc",
  1921. <html:a rel="attr">sep</html:a> gives a minimum distance, in inches, to be left between nodes.
  1922. In this case, if <html:a rel="attr">sep</html:a> is a pointf, the x and y separations can be
  1923. specified separately.
  1924. </html:p>
  1925. </xsd:documentation>
  1926. </xsd:annotation>
  1927. </xsd:attribute>
  1928. <xsd:attribute name="shape" type="shape">
  1929. <xsd:annotation>
  1930. <xsd:documentation>
  1931. <html:p>
  1932. Set the shape of a node.
  1933. </html:p>
  1934. </xsd:documentation>
  1935. </xsd:annotation>
  1936. </xsd:attribute>
  1937. <xsd:attribute name="shapefile" type="xsd:string">
  1938. <xsd:annotation>
  1939. <xsd:documentation>
  1940. <html:p>
  1941. (Deprecated) If defined, shapefile specifies a file containing user-supplied node content.
  1942. The <html:a rel="attr">shape</html:a> of the node is set to box.
  1943. The image in the shapefile must be
  1944. rectangular. The image formats supported as well as the precise semantics of
  1945. how the file is used depends on the
  1946. <html:a href="http://www.graphviz.org/doc/info/output.html">output format</html:a>. For further details, see
  1947. <html:a href="http://www.graphviz.org/Documentation/html/shapehowto.html#ext_image">External PostScript files</html:a>.
  1948. </html:p>
  1949. <html:p>
  1950. There is one exception to this usage.
  1951. If <html:a rel="attr">shape</html:a> is set to "epsf", shapefile gives
  1952. a filename containing a definition of the node in PostScript.
  1953. The graphics defined must be contain all of the
  1954. node content, including any desired boundaries.
  1955. For further details, see
  1956. <html:a href="http://www.graphviz.org/Documentation/html/shapehowto.html#ext_ps">
  1957. External PostScript files</html:a>.
  1958. </html:p>
  1959. </xsd:documentation>
  1960. </xsd:annotation>
  1961. </xsd:attribute>
  1962. <xsd:attribute name="showboxes" type="xsd:integer">
  1963. <xsd:annotation>
  1964. <xsd:documentation>
  1965. <html:p>
  1966. Print guide boxes in PostScript at the beginning of
  1967. routesplines if 1, or at the end if 2. (Debugging)
  1968. </html:p>
  1969. </xsd:documentation>
  1970. </xsd:annotation>
  1971. </xsd:attribute>
  1972. <xsd:attribute name="sides" type="xsd:integer">
  1973. <xsd:annotation>
  1974. <xsd:documentation>
  1975. <html:p>
  1976. Number of sides if <html:a rel="attr">shape</html:a>=polygon.
  1977. </html:p>
  1978. </xsd:documentation>
  1979. </xsd:annotation>
  1980. </xsd:attribute>
  1981. <xsd:attribute name="size" type="pointf">
  1982. <xsd:annotation>
  1983. <xsd:documentation>
  1984. <html:p>
  1985. Maximum width and height of drawing, in inches.
  1986. If defined and the drawing is too large, the drawing is uniformly
  1987. scaled down so that it fits within the given size.
  1988. </html:p>
  1989. <html:p>
  1990. If <html:a rel="attr">size</html:a> ends in an exclamation point (<html:tt>!</html:tt>),
  1991. then it is taken to be
  1992. the desired size. In this case, if both dimensions of the drawing are
  1993. less than <html:a rel="attr">size</html:a>, the drawing is scaled up uniformly until at
  1994. least one dimension equals its dimension in <html:a rel="attr">size</html:a>.
  1995. </html:p>
  1996. <html:p>
  1997. Note that there is some interaction between the <html:a rel="attr">size</html:a> and
  1998. <html:a rel="attr">ratio</html:a> attributes.
  1999. </html:p>
  2000. </xsd:documentation>
  2001. </xsd:annotation>
  2002. </xsd:attribute>
  2003. <xsd:attribute name="skew" type="xsd:decimal">
  2004. <xsd:annotation>
  2005. <xsd:documentation>
  2006. <html:p>
  2007. Skew factor for <html:a rel="attr">shape</html:a>=polygon. Positive values
  2008. skew top of polygon to right; negative to left.
  2009. </html:p>
  2010. </xsd:documentation>
  2011. </xsd:annotation>
  2012. </xsd:attribute>
  2013. <xsd:attribute name="splines" type="xsd:string">
  2014. <xsd:annotation>
  2015. <xsd:documentation>
  2016. <html:p>
  2017. Controls how, and if, edges are represented. If true, edges are drawn as
  2018. splines routed around nodes; if false, edges are drawn as line segments.
  2019. If set to "", no edges are drawn at all.
  2020. </html:p>
  2021. <html:p>
  2022. (1 March 2007) The values <html:span class="val">line</html:span> and <html:span class="val">spline</html:span> can be
  2023. used as synonyms for <html:span class="val">false</html:span> and <html:span class="val">true</html:span>, respectively.
  2024. In addition, the value <html:span class="val">polyline</html:span> specifies that edges should be
  2025. drawn as polylines.
  2026. </html:p>
  2027. <html:p>
  2028. By default, the attribute is unset. How this is interpreted depends on
  2029. the layout. For dot, the default is to draw edges as splines. For all
  2030. other layouts, the default is to draw edges as line segments. Note that
  2031. for these latter layouts, if <html:code>splines="true"</html:code>, this
  2032. requires non-overlapping nodes (cf. <html:a rel="attr">overlap</html:a>).
  2033. If fdp is used for layout and <html:tt>splines="compound"</html:tt>, then the edges are
  2034. drawn to avoid clusters as well as nodes.
  2035. </html:p>
  2036. </xsd:documentation>
  2037. </xsd:annotation>
  2038. </xsd:attribute>
  2039. <xsd:attribute name="start" type="startType">
  2040. <xsd:annotation>
  2041. <xsd:documentation>
  2042. <html:p>
  2043. Parameter used to determine the initial layout of nodes. If unset, the
  2044. nodes are randomly placed in a unit square with
  2045. the same seed is always used for the random number generator, so the
  2046. initial placement is repeatable.
  2047. </html:p>
  2048. </xsd:documentation>
  2049. </xsd:annotation>
  2050. </xsd:attribute>
  2051. <xsd:attribute name="style" type="style">
  2052. <xsd:annotation>
  2053. <xsd:documentation>
  2054. <html:p>
  2055. Set style for node or edge. For cluster subgraph, if "filled", the
  2056. cluster box's background is filled.
  2057. </html:p>
  2058. </xsd:documentation>
  2059. </xsd:annotation>
  2060. </xsd:attribute>
  2061. <xsd:attribute name="stylesheet" type="xsd:string">
  2062. <xsd:annotation>
  2063. <xsd:documentation>
  2064. <html:p>
  2065. A URL or pathname specifying an XML style sheet, used in SVG output.
  2066. </html:p>
  2067. </xsd:documentation>
  2068. </xsd:annotation>
  2069. </xsd:attribute>
  2070. <xsd:attribute name="tailURL" type="xsd:anyURI">
  2071. <xsd:annotation>
  2072. <xsd:documentation>
  2073. <html:p>
  2074. If <html:a rel="attr">tailURL</html:a> is defined, it is
  2075. output as part of the tail label of the edge.
  2076. Also, this value is used near the tail node, overriding any
  2077. <html:a rel="attr">URL</html:a> value.
  2078. See <html:a rel="note">undirected</html:a>.
  2079. </html:p>
  2080. </xsd:documentation>
  2081. </xsd:annotation>
  2082. </xsd:attribute>
  2083. <xsd:attribute name="tailclip" type="xsd:boolean">
  2084. <xsd:annotation>
  2085. <xsd:documentation>
  2086. <html:p>
  2087. If <html:span class="val">true</html:span>, the tail of an edge is clipped to the boundary of the tail node;
  2088. otherwise, the end of the edge goes to the center of the node, or the
  2089. center of a port, if applicable.
  2090. </html:p>
  2091. </xsd:documentation>
  2092. </xsd:annotation>
  2093. </xsd:attribute>
  2094. <xsd:attribute name="tailhref" type="xsd:anyURI">
  2095. <xsd:annotation>
  2096. <xsd:documentation>
  2097. <html:p>
  2098. Synonym for <html:a rel="attr">tailURL</html:a>.
  2099. </html:p>
  2100. </xsd:documentation>
  2101. </xsd:annotation>
  2102. </xsd:attribute>
  2103. <xsd:attribute name="taillabel" type="lblString">
  2104. <xsd:annotation>
  2105. <xsd:documentation>
  2106. <html:p>
  2107. Text label to be placed near tail of edge.
  2108. See <html:a rel="note">undirected</html:a>.
  2109. </html:p>
  2110. </xsd:documentation>
  2111. </xsd:annotation>
  2112. </xsd:attribute>
  2113. <xsd:attribute name="tailport" type="portPos">
  2114. <xsd:annotation>
  2115. <xsd:documentation>
  2116. <html:p>
  2117. Indicates where on the tail node to attach the tail of the edge.
  2118. See <html:a rel="note">undirected</html:a>.
  2119. </html:p>
  2120. </xsd:documentation>
  2121. </xsd:annotation>
  2122. </xsd:attribute>
  2123. <xsd:attribute name="tailtarget" type="escString">
  2124. <xsd:annotation>
  2125. <xsd:documentation>
  2126. <html:p>
  2127. If the edge has a <html:a rel="attr">tailURL</html:a>,
  2128. this attribute determines which window of the
  2129. browser is used
  2130. for the URL. Setting it to "_graphviz" will open a new window if it
  2131. doesn't already exist, or reuse it if it does.
  2132. If undefined, the value of the <html:a rel="attr">target</html:a> is used.
  2133. </html:p>
  2134. </xsd:documentation>
  2135. </xsd:annotation>
  2136. </xsd:attribute>
  2137. <xsd:attribute name="tailtooltip" type="escString">
  2138. <xsd:annotation>
  2139. <xsd:documentation>
  2140. <html:p>
  2141. Tooltip annotation attached to the tail of an edge. This is used only
  2142. if the edge has a <html:a rel="attr">tailURL</html:a> attribute.
  2143. </html:p>
  2144. </xsd:documentation>
  2145. </xsd:annotation>
  2146. </xsd:attribute>
  2147. <xsd:attribute name="target" type="escString">
  2148. <xsd:annotation>
  2149. <xsd:documentation>
  2150. <html:p>
  2151. If the object has a URL, this attribute determines which window
  2152. of the browser is used for the URL.
  2153. See <html:a href="http://www.w3.org/TR/html401/present/frames.html#adef-target">W3C documentation</html:a>.
  2154. </html:p>
  2155. </xsd:documentation>
  2156. </xsd:annotation>
  2157. </xsd:attribute>
  2158. <xsd:attribute name="tooltip" type="escString">
  2159. <xsd:annotation>
  2160. <xsd:documentation>
  2161. <html:p>
  2162. Tooltip annotation attached to the node or edge. If unset, Graphviz
  2163. will use the object's <html:a rel="attr">label</html:a> if defined.
  2164. Note that if the label is a record specification or an HTML-like
  2165. label, the resulting tooltip may be unhelpful. In this case, if
  2166. tooltips will be generated, the user should set a <html:tt>tooltip</html:tt>
  2167. attribute explicitly.
  2168. </html:p>
  2169. </xsd:documentation>
  2170. </xsd:annotation>
  2171. </xsd:attribute>
  2172. <xsd:attribute name="truecolor" type="xsd:boolean">
  2173. <xsd:annotation>
  2174. <xsd:documentation>
  2175. <html:p>
  2176. If set explicitly to true or false, the value determines whether or not
  2177. internal bitmap rendering relies on a truecolor color model or uses
  2178. a color palette.
  2179. If the attribute is unset, truecolor is not used
  2180. unless there is a <html:a rel="attr">shapefile</html:a> property
  2181. for some node in the graph.
  2182. The output model will use the input model when possible.
  2183. </html:p>
  2184. <html:p>
  2185. Use of color palettes results in less memory usage during creation of the
  2186. bitmaps and smaller output files.
  2187. </html:p>
  2188. <html:p>
  2189. Usually, the only time it is necessary to specify the truetype model
  2190. is if the graph uses more than 256 colors.
  2191. However, if one uses <html:a rel="attr">bgcolor</html:a>=transparent with
  2192. a color palette, font
  2193. antialiasing can show up as a fuzzy white area around characters.
  2194. Using <html:a rel="attr">truecolor</html:a>=true avoids this problem.
  2195. </html:p>
  2196. </xsd:documentation>
  2197. </xsd:annotation>
  2198. </xsd:attribute>
  2199. <xsd:attribute name="vertices" type="pointfList">
  2200. <xsd:annotation>
  2201. <xsd:documentation>
  2202. <html:p>
  2203. If the input graph defines this attribute, the node is polygonal,
  2204. and output is dot or xdot, this attribute provides the
  2205. coordinates of the vertices of the node's polygon, in inches.
  2206. If the node is an ellipse or circle, the
  2207. <html:a rel="attr">samplepoints</html:a> attribute affects
  2208. the output.
  2209. </html:p>
  2210. </xsd:documentation>
  2211. </xsd:annotation>
  2212. </xsd:attribute>
  2213. <xsd:attribute name="viewport" type="viewPort">
  2214. <xsd:annotation>
  2215. <xsd:documentation>
  2216. <html:p>
  2217. Clipping window on final drawing.
  2218. </html:p>
  2219. </xsd:documentation>
  2220. </xsd:annotation>
  2221. </xsd:attribute>
  2222. <xsd:attribute name="voro_margin" type="xsd:decimal">
  2223. <xsd:annotation>
  2224. <xsd:documentation>
  2225. <html:p>
  2226. Factor to scale up drawing to allow margin for expansion in
  2227. Voronoi technique. dim' = (1+2*margin)*dim.
  2228. </html:p>
  2229. </xsd:documentation>
  2230. </xsd:annotation>
  2231. </xsd:attribute>
  2232. <xsd:attribute name="weight" type="xsd:decimal">
  2233. <xsd:annotation>
  2234. <xsd:documentation>
  2235. <html:p>
  2236. Weight of edge. In dot, the heavier the weight, the shorter,
  2237. straighter and more vertical the edge is. In neato, the heavier the
  2238. weight, the more neato will try to place the end points so that the
  2239. length of the edge is <html:a rel="attr">len</html:a>.
  2240. </html:p>
  2241. </xsd:documentation>
  2242. </xsd:annotation>
  2243. </xsd:attribute>
  2244. <xsd:attribute name="width" type="xsd:decimal">
  2245. <xsd:annotation>
  2246. <xsd:documentation>
  2247. <html:p>
  2248. Width of node, in inches. This is taken as the initial, minimum width
  2249. of the node. If <html:a rel="attr">fixedsize</html:a> is true, this
  2250. will be the final width of the node. Otherwise, if the node label
  2251. requires more width to fit, the node's width will be increased to
  2252. contain the label. Note also that, if the output format is dot, the
  2253. value given to <html:a rel="attr">width</html:a> will be the final value.
  2254. </html:p>
  2255. </xsd:documentation>
  2256. </xsd:annotation>
  2257. </xsd:attribute>
  2258. <xsd:attribute name="z" type="xsd:decimal">
  2259. <xsd:annotation>
  2260. <xsd:documentation>
  2261. <html:p>
  2262. Provides z coordinate value for 3D layouts and displays. If the
  2263. graph has <html:a rel="attr">dim</html:a> set to 3 (or more),
  2264. neato will use a node's <html:a rel="attr">z</html:a> value
  2265. for the z coordinate of its initial position if
  2266. its <html:a rel="attr">pos</html:a> attribute is also defined.
  2267. </html:p>
  2268. <html:p>
  2269. Even if no <html:a rel="attr">z</html:a> values are specified in the input, it is necessary to
  2270. declare a <html:a rel="attr">z</html:a> attribute for nodes, e.g, using <html:tt>node[z=""]</html:tt>
  2271. in order to get z values on output.
  2272. Thus, setting <html:tt>dim=3</html:tt> but not declaring <html:a rel="attr">z</html:a> will
  2273. cause <html:tt>neato -Tvrml</html:tt> to
  2274. layout the graph in 3D but project the layout onto the xy-plane
  2275. for the rendering. If the <html:a rel="attr">z</html:a> attribute is declared, the final rendering
  2276. will be in 3D.
  2277. </html:p>
  2278. </xsd:documentation>
  2279. </xsd:annotation>
  2280. </xsd:attribute>
  2281. <!-- COMPONENTS -->
  2282. <xsd:complexType name="edge">
  2283. <xsd:attribute ref="URL" />
  2284. <xsd:attribute ref="arrowhead" default="normal" />
  2285. <xsd:attribute ref="arrowsize" default="1.0" />
  2286. <xsd:attribute ref="arrowtail" default="normal" />
  2287. <xsd:attribute ref="color" default="black" />
  2288. <xsd:attribute ref="colorscheme" />
  2289. <xsd:attribute ref="comment" />
  2290. <xsd:attribute ref="constraint" default="true" />
  2291. <xsd:attribute ref="decorate" default="false" />
  2292. <xsd:attribute ref="dir" />
  2293. <xsd:attribute ref="edgeURL" />
  2294. <xsd:attribute ref="edgehref"/>
  2295. <xsd:attribute ref="edgetarget" />
  2296. <xsd:attribute ref="edgetooltip" />
  2297. <xsd:attribute ref="fontcolor" default="black" />
  2298. <xsd:attribute ref="fontname" default="Times-Roman" />
  2299. <xsd:attribute ref="fontsize" default="14.0" />
  2300. <xsd:attribute ref="headURL" />
  2301. <xsd:attribute ref="headclip" default="true" />
  2302. <xsd:attribute ref="headhref"/>
  2303. <xsd:attribute ref="headlabel" />
  2304. <xsd:attribute ref="headport" default="center"/>
  2305. <xsd:attribute ref="headtarget" />
  2306. <xsd:attribute ref="headtooltip" />
  2307. <xsd:attribute ref="href" />
  2308. <xsd:attribute ref="label" />
  2309. <xsd:attribute ref="labelURL" />
  2310. <xsd:attribute ref="labelangle" default="-25.0" />
  2311. <xsd:attribute ref="labeldistance" default="1.0" />
  2312. <xsd:attribute ref="labelfloat" default="false" />
  2313. <xsd:attribute ref="labelfontcolor" default="black" />
  2314. <xsd:attribute ref="labelfontname" default="Times-Roman" />
  2315. <xsd:attribute ref="labelfontsize" default="14.0" />
  2316. <xsd:attribute ref="labelhref" />
  2317. <xsd:attribute ref="labeltarget" />
  2318. <xsd:attribute ref="labeltooltip" />
  2319. <xsd:attribute ref="layer" />
  2320. <xsd:attribute ref="len" />
  2321. <xsd:attribute ref="lhead" />
  2322. <xsd:attribute ref="lp" />
  2323. <xsd:attribute ref="ltail" />
  2324. <xsd:attribute ref="minlen" default="1" />
  2325. <xsd:attribute ref="nojustify" default="false" />
  2326. <xsd:attribute ref="pos" />
  2327. <xsd:attribute ref="samehead" />
  2328. <xsd:attribute ref="sametail" />
  2329. <xsd:attribute ref="showboxes" default="0" />
  2330. <xsd:attribute ref="style" />
  2331. <xsd:attribute ref="tailURL" />
  2332. <xsd:attribute ref="tailclip" default="true" />
  2333. <xsd:attribute ref="tailhref"/>
  2334. <xsd:attribute ref="taillabel" />
  2335. <xsd:attribute ref="tailport" default="center"/>
  2336. <xsd:attribute ref="tailtarget" />
  2337. <xsd:attribute ref="tailtooltip" />
  2338. <xsd:attribute ref="target" />
  2339. <xsd:attribute ref="tooltip" />
  2340. <xsd:attribute ref="weight" default="1.0" />
  2341. </xsd:complexType>
  2342. <xsd:complexType name="node">
  2343. <xsd:attribute ref="URL" />
  2344. <xsd:attribute ref="color" default="black" />
  2345. <xsd:attribute ref="colorscheme" />
  2346. <xsd:attribute ref="comment" />
  2347. <xsd:attribute ref="distortion" default="0.0" />
  2348. <xsd:attribute ref="fillcolor" default="lightgrey" />
  2349. <xsd:attribute ref="fixedsize" default="false" />
  2350. <xsd:attribute ref="fontcolor" default="black" />
  2351. <xsd:attribute ref="fontname" default="Times-Roman" />
  2352. <xsd:attribute ref="fontsize" default="14.0" />
  2353. <xsd:attribute ref="group" />
  2354. <xsd:attribute ref="height" default="0.5" />
  2355. <xsd:attribute ref="image" />
  2356. <xsd:attribute ref="imagescale" default="false" />
  2357. <xsd:attribute ref="label" default="\N" />
  2358. <xsd:attribute ref="layer" />
  2359. <xsd:attribute ref="margin" />
  2360. <xsd:attribute ref="nojustify" default="false" />
  2361. <!-- <xsd:attribute ref="orientation" default="0.0" /> -->
  2362. <xsd:attribute ref="peripheries" />
  2363. <xsd:attribute ref="pin" default="false" />
  2364. <xsd:attribute ref="pos" />
  2365. <xsd:attribute ref="rects" />
  2366. <xsd:attribute ref="regular" default="false" />
  2367. <xsd:attribute ref="root" default="false" />
  2368. <xsd:attribute ref="samplepoints" default="false" />
  2369. <xsd:attribute ref="shape" default="ellipse" />
  2370. <xsd:attribute ref="shapefile" />
  2371. <xsd:attribute ref="showboxes" default="0" />
  2372. <xsd:attribute ref="sides" default="4" />
  2373. <xsd:attribute ref="skew" default="0.0" />
  2374. <xsd:attribute ref="style" />
  2375. <xsd:attribute ref="target" />
  2376. <xsd:attribute ref="tooltip" />
  2377. <xsd:attribute ref="vertices" />
  2378. <xsd:attribute ref="width" default="0.75" />
  2379. <xsd:attribute ref="z" default="0.0" />
  2380. </xsd:complexType>
  2381. <xsd:complexType name="graph">
  2382. <xsd:attribute ref="imagepath" />
  2383. <xsd:attribute ref="Damping" default="0.99" />
  2384. <xsd:attribute ref="K" default="0.3" />
  2385. <xsd:attribute ref="URL" />
  2386. <xsd:attribute ref="bb" />
  2387. <xsd:attribute ref="bgcolor" />
  2388. <xsd:attribute ref="center" />
  2389. <xsd:attribute ref="charset" />
  2390. <xsd:attribute ref="clusterrank" default="local" />
  2391. <xsd:attribute ref="colorscheme" />
  2392. <xsd:attribute ref="comment" />
  2393. <xsd:attribute ref="compound" default="false" />
  2394. <xsd:attribute ref="concentrate" default="false" />
  2395. <xsd:attribute ref="defaultdist" />
  2396. <xsd:attribute ref="dim" default="2" />
  2397. <xsd:attribute ref="diredgeconstraints" default="false" />
  2398. <xsd:attribute ref="dpi" default="96.0" />
  2399. <xsd:attribute ref="epsilon" />
  2400. <xsd:attribute ref="esep" />
  2401. <xsd:attribute ref="fontcolor" default="black" />
  2402. <xsd:attribute ref="fontname" default="Times-Roman" />
  2403. <xsd:attribute ref="fontnames" />
  2404. <xsd:attribute ref="fontpath" />
  2405. <xsd:attribute ref="fontsize" default="14.0" />
  2406. <xsd:attribute ref="label" />
  2407. <xsd:attribute ref="labeljust" default="c" />
  2408. <xsd:attribute ref="labelloc" default="b" />
  2409. <xsd:attribute ref="landscape" default="false" />
  2410. <xsd:attribute ref="layers" default="false" />
  2411. <xsd:attribute ref="layersep" default=" : " />
  2412. <xsd:attribute ref="layout" />
  2413. <xsd:attribute ref="levelsgap" default="0.0" />
  2414. <xsd:attribute ref="lp" />
  2415. <xsd:attribute ref="margin" />
  2416. <xsd:attribute ref="maxiter" />
  2417. <xsd:attribute ref="mclimit" default="1.0" />
  2418. <xsd:attribute ref="mindist" default="1.0" />
  2419. <xsd:attribute ref="mode" default="major" />
  2420. <xsd:attribute ref="model" default="shortpath" />
  2421. <xsd:attribute ref="mosek" default="false" />
  2422. <xsd:attribute ref="nodesep" default="0.25" />
  2423. <xsd:attribute ref="nojustify" default="false" />
  2424. <xsd:attribute ref="normalize" default="false" />
  2425. <xsd:attribute ref="nslimit" />
  2426. <xsd:attribute ref="nslimit1" />
  2427. <xsd:attribute ref="ordering" />
  2428. <!-- <xsd:attribute ref="orientation" /> -->
  2429. <xsd:attribute ref="outputorder" default="breadthfirst" />
  2430. <xsd:attribute ref="overlap" default="true" />
  2431. <xsd:attribute ref="pack" default="false" />
  2432. <xsd:attribute ref="packmode" default="node" />
  2433. <xsd:attribute ref="pad" />
  2434. <xsd:attribute ref="page" />
  2435. <xsd:attribute ref="pagedir" />
  2436. <xsd:attribute ref="quantum" default="0.0" />
  2437. <xsd:attribute ref="rankdir" default="TB" />
  2438. <xsd:attribute ref="ranksep" />
  2439. <xsd:attribute ref="ratio" />
  2440. <xsd:attribute ref="remincross" default="false" />
  2441. <xsd:attribute ref="resolution" default="96.0" />
  2442. <xsd:attribute ref="root" />
  2443. <xsd:attribute ref="rotate" default="0" />
  2444. <xsd:attribute ref="searchsize" default="30" />
  2445. <xsd:attribute ref="sep" default="0.1" />
  2446. <xsd:attribute ref="showboxes" default="0" />
  2447. <xsd:attribute ref="size" />
  2448. <xsd:attribute ref="splines" />
  2449. <xsd:attribute ref="start" />
  2450. <xsd:attribute ref="stylesheet" />
  2451. <xsd:attribute ref="target" />
  2452. <xsd:attribute ref="truecolor" />
  2453. <xsd:attribute ref="viewport" />
  2454. <xsd:attribute ref="voro_margin" default="0.05" />
  2455. </xsd:complexType>
  2456. <xsd:complexType name="subgraph">
  2457. <xsd:attribute ref="rank" />
  2458. </xsd:complexType>
  2459. <xsd:complexType name="cluster">
  2460. <xsd:attribute ref="K" />
  2461. <xsd:attribute ref="URL" />
  2462. <xsd:attribute ref="bgcolor" />
  2463. <xsd:attribute ref="color" default="black" />
  2464. <xsd:attribute ref="colorscheme" />
  2465. <xsd:attribute ref="fillcolor" default="black" />
  2466. <xsd:attribute ref="fixedsize" default="false" />
  2467. <xsd:attribute ref="fontcolor" default="black" />
  2468. <xsd:attribute ref="fontname" default="Times-Roman" />
  2469. <xsd:attribute ref="fontsize" default="14.0" />
  2470. <xsd:attribute ref="label" />
  2471. <xsd:attribute ref="labeljust" default="c" />
  2472. <xsd:attribute ref="labelloc" default="t" />
  2473. <xsd:attribute ref="lp" />
  2474. <xsd:attribute ref="nojustify" default="false" />
  2475. <xsd:attribute ref="pencolor" default="black" />
  2476. <xsd:attribute ref="style" />
  2477. <xsd:attribute ref="target" />
  2478. <xsd:attribute ref="tooltip" />
  2479. </xsd:complexType>
  2480. </xsd:schema>