From: erg Date: Sun, 17 May 2009 04:24:30 +0000 (+0000) Subject: Update packMode information X-Git-Tag: LAST_LIBGRAPH~32^2~2063 X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=957d0825effc45ab276097355b598e23d572e4e5;p=graphviz Update packMode information --- diff --git a/doc/info/attrs.html b/doc/info/attrs.html index 65e7ea09f..4253657a9 100644 --- a/doc/info/attrs.html +++ b/doc/info/attrs.html @@ -1232,7 +1232,7 @@ This field indicates which graph component uses the attribute.
pack
This is true if the value of pack is "true" (case-insensitive) or a non-negative integer. If true, each connected component of the graph is - laid out separately, and then the graphs are packed tightly. + laid out separately, and then the graphs are packed together. If pack has an integral value, this is used as the size, in points, of a margin around each part; otherwise, a default margin of 8 is used. @@ -1244,7 +1244,7 @@ This field indicates which graph component uses the attribute. attribute is just used to set the margin.
packmode -
This indicates the granularity and method used for packing +
This indicates how connected components should be packed (cf. packMode). Note that defining packmode will automatically turn on packing as though one had set pack=true. @@ -1851,10 +1851,13 @@ the given types. "edgesfirst".
packMode -
"node","clust","graph" - These specify the granularity of packing connected components when - the pack attribute is true. A value of "node" causes - packing at the node and edge label, with no overlapping of these objects. +
"node", "clust" , "graph" , "array{_flags][%d]" +

+ The modes "node", "clust" or "graph" + specify that the components should be packed together tightly, using + the specified granularity. + A value of "node" causes + packing at the node and edge level, with no overlapping of these objects. This produces a layout with the least area, but it also allows interleaving, where a node of one component may lie between two nodes in another component. A value of "graph" does a packing using the bounding box of the @@ -1864,6 +1867,18 @@ the given types. What effect a value has also depends on the layout algorithm. For example, neato does not support clusters, so a value of "clust" will have the same effect as the default "node" value. +

+ The mode "array{_flags][%d]" + indicates that the components should be packed at the + graph level into an array of graphs. By default, the components + are in row-major order, with the number of columns roughly the + square root of the number of components. If the optional flags + contains "c", then column-major order is used. Finally, if the + optional integer suffix is used, this specifies the number of + columns for row-major or the number of rows for column-major. + Thus, the mode "array_c4" indicates array packing, with 4 rows, + starting in the upper left and going down the first column, then + down the second column, etc., until all components are used.

pagedir
"BL", "BR", "TL", "TR", "RB", "RT", "LB", "LT". diff --git a/doc/infosrc/attrs b/doc/infosrc/attrs index 812e569a0..ff8746f41 100644 --- a/doc/infosrc/attrs +++ b/doc/infosrc/attrs @@ -717,7 +717,7 @@ If overlap_scaling is positive, the layout is scaled by :pack:G:bool/int:false; notdot This is true if the value of pack is "true" (case-insensitive) or a non-negative integer. If true, each connected component of the graph is -laid out separately, and then the graphs are packed tightly. +laid out separately, and then the graphs are packed together. If pack has an integral value, this is used as the size, in points, of a margin around each part; otherwise, a default margin of 8 is used. @@ -728,7 +728,7 @@ The granularity and method of packing is influenced by the For layouts which always do packing, such a twopi, the pack attribute is just used to set the margin. :packmode:G:packMode:node; notdot -This indicates the granularity and method used for packing +This indicates how connected components should be packed (cf. packMode). Note that defining packmode will automatically turn on packing as though one had set pack=true. diff --git a/doc/infosrc/types b/doc/infosrc/types index 98880ec6b..0d773bfd4 100644 --- a/doc/infosrc/types +++ b/doc/infosrc/types @@ -159,10 +159,13 @@ reasons, it may be desirable that all edges appear beneath nodes, even if the resulting drawing is ambiguous. This can be achieved by choosing "edgesfirst". :packMode -"node","clust","graph" -These specify the granularity of packing connected components when -the pack attribute is true. A value of "node" causes -packing at the node and edge label, with no overlapping of these objects. +"node", "clust" , "graph" , "array{_flags][%d]" +

+The modes "node", "clust" or "graph" +specify that the components should be packed together tightly, using +the specified granularity. +A value of "node" causes +packing at the node and edge level, with no overlapping of these objects. This produces a layout with the least area, but it also allows interleaving, where a node of one component may lie between two nodes in another component. A value of "graph" does a packing using the bounding box of the @@ -172,6 +175,18 @@ A value of "clust" guarantees that top-level clusters are kept intact. What effect a value has also depends on the layout algorithm. For example, neato does not support clusters, so a value of "clust" will have the same effect as the default "node" value. +

+The mode "array{_flags][%d]" +indicates that the components should be packed at the +graph level into an array of graphs. By default, the components +are in row-major order, with the number of columns roughly the +square root of the number of components. If the optional flags +contains "c", then column-major order is used. Finally, if the +optional integer suffix is used, this specifies the number of +columns for row-major or the number of rows for column-major. +Thus, the mode "array_c4" indicates array packing, with 4 rows, +starting in the upper left and going down the first column, then +down the second column, etc., until all components are used. :pagedir "BL", "BR", "TL", "TR", "RB", "RT", "LB", "LT". These specify the 8 row or column major orders for traversing a