命令行

DOT 渲染程序和实用程序。

所有 Graphviz 程序都有类似的调用方式

cmd [ flags ] [ input files ]

例如

$ dot -Tsvg input.dot

如果没有提供输入文件,程序将从 stdin 读取。例如

$ echo 'digraph { a -> b }' | dot -Tsvg > output.svg

生成

标志

-Gname[=value]

设置图属性,默认 value = true

例如,

$ echo 'digraph { a -> b }' | dot -Tsvg -Gfontcolor=red -Glabel="My favorite letters"

覆盖图的默认 fontcolorlabel 属性,生成红色图例

-Nname[=value]

设置默认节点属性,默认 value = true

例如,

$ echo 'digraph { a -> b }' | dot -Tsvg -Nfontcolor=red -Nshape=rect

覆盖默认节点 fontcolorshape 属性,生成带有红色文本的矩形节点

-Ename[=value]

设置默认边属性,默认 value = true

例如,

$ echo 'digraph { a -> b }' | dot -Tsvg -Ecolor=red -Earrowhead=diamond

覆盖默认边 colorarrowhead 属性,生成带有菱形箭头头的红色边

-Klayout

指定要使用的默认 布局引擎,覆盖命令名称中的默认值。例如,运行 dot -Kneato 等同于运行 neato

-Tformat[:renderer[:formatter]]

将输出语言设置为 支持的格式 之一。默认情况下,将生成 带属性的 dot

根据 Graphviz 的构建方式,可能存在多个用于生成特定输出格式的渲染器,以及多个用于创建最终输出的格式化程序。例如,典型的安装可以使用 Cairo 或 GD 库生成 PNG 输出。可以指定所需的渲染引擎,位于冒号之后。如果存在多个可用的格式化引擎,则可以在类似的方式中指定所需的引擎,位于渲染引擎之后。因此,-Tpng:cairo 指定由 Cairo 生成的 PNG 输出(使用 Cairo 的默认格式化程序),而 -Tpng:cairo:gd 指定由 Cairo 使用 GD 库格式化的 PNG 输出。

如果没有指定渲染器,或者指定了渲染器但没有格式化程序,则会调用默认的渲染器。标志 -Tformat: 将生成所有可用于指定 format 的渲染器的列表,其中第一个带有与 format 相匹配的前缀的渲染器是默认的渲染器。使用下面描述的 -v 标志将打印实际使用的格式、渲染器和格式化程序。

-V

发出版本信息并退出。例如

$ dot -V
dot - graphviz version 2.47.1 (20210417.1919)

-llibrary

用户提供的、与设备相关的库文本。可以给出多个标志。这些字符串在输出开始时传递给代码生成器。

对于 PostScript 输出,它们将被视为文件名,其内容将在标准序言之后包含在序言中。如果 library 为空字符串 "",则不会发出标准序言。

-n[num]

neato 中设置无操作标志。如果设置,neato 假设节点已经定位,并且所有节点都具有 pos 属性,该属性给出位置。然后,它根据 overlap 属性的值执行可选的调整以消除节点重叠,根据 splines 属性的值计算边布局,并以适当的格式发出图。如果提供 num,则会执行以下操作

num = 1
等同于 -n
num > 1
使用指定的节点位置,不进行任何调整以消除节点重叠,并使用 pos 属性已经指定的任何边布局。neato 为没有 pos 属性的任何边计算边布局。与往常一样,边布局受 splines 属性的指导。

-ooutfile

将输出写入文件 outfile。例如,

$ echo 'digraph { a -> b }' | dot -Tsvg -o output.svg

生成 output.svg

默认情况下,输出将写入 stdout

-O

根据输入文件名和 -T 标志指定的各种输出格式自动生成输出文件名。

例如,

$ dot -Tsvg -O ~/family.dot ~/debug.dot

生成 ~/family.dot.svg~/debug.dot.svg 文件。

-P

自动生成一个图,该图显示当前可执行文件的插件配置。例如:

$ dot -P -Tsvg -o plugins.svg

-q

抑制警告消息。

-s[scale]

将输入比例设置为 scale。如果省略此值,则使用 72.0。此数字用于将 pos 属性中使用的点坐标单位转换为英寸,这是 neato 和 fdp 所期望的。因此,将一个程序布局的图的输出馈送到 neato 或 fdp 通常需要此标志。如果使用 -n 标志,则会被忽略。

-v

详细模式

-x

neato 中,在输入时,修剪孤立节点和半岛。这将删除无关的图结构,并生成一个不太拥挤的图形。

-y

默认情况下,通用输出格式(例如 带属性的点扩展点普通普通-扩展)使用的坐标系是标准笛卡尔坐标系,原点位于左下角,y 坐标值随着点从下向上移动而增大。如果使用 -y 标志,则坐标系将被反转,因此 y 值的增大对应于点从上向下移动。

-?

打印使用信息,然后退出。

如果给出了多个 -T 标志,则以每个指定格式发出图的图形。可以使用多个 -o 标志为每个格式指定输出文件。如果格式数量多于文件数量,则其余格式将写入 stdout

请注意,-G-N-E 标志会覆盖输入图中任何初始属性声明,即出现在任何节点、边或子图定义之前的那些属性语句。此外,这些标志会导致相关属性永久附加到图上。因此,如果使用带属性的点作为输出,则图将具有这些属性。

环境变量

GDFONTPATH

路径名列表,给出程序应该搜索字体的目录。由 DOTFONTPATH 覆盖。仅在 Graphviz 未使用 fontconfig 库构建时使用

DOTFONTPATH

路径名列表,给出程序应该搜索字体的目录。由 fontpath 覆盖。仅在 Graphviz 未使用 fontconfig 库构建时使用

SERVER_NAME

如果已定义,则表示该软件正在作为 Web 应用程序运行,这限制了对图像文件的访问。

GVBINDIR

指示哪个目录包含 Graphviz 配置文件和插件库。如果它已定义,则该值将覆盖任何其他查找此目录的机制。如果 Graphviz 正确安装,则不需要它,尽管它可能在非 Linux 或 Windows 平台上的重新定位中很有用。


acyclic

使有向图无环。

bcomps

用于图的双连通分量过滤器。

ccomps

用于图的连通分量过滤器。

cluster

查找图中的簇并使用此信息来扩充图。

diffimg

计算两幅图像之间的交集。

dijkstra

单源距离过滤器。

dotty

可定制的图形编辑器。

edgepaint

边缘着色以消除交叉边缘的歧义。

gc

计算图组件的数量。

gml2gv

GML-DOT 转换器。

graphml2gv

GRAPHML-DOT 转换器。

gv2gxl

GXL-GV 转换器。

gvcolor

通过分级有向图流颜色。

gvedit

简单的图形编辑器和查看器。

gvgen

生成图形。

gvmap

查找簇并创建突出显示簇的地理地图。

gvpack

合并和打包不相交的图形。

gvpr

图形模式扫描和处理语言。

gxl2gv

GXL-GV 转换器。

lefty

可编程图形编辑器。

lneato

可定制的图形编辑器。

mingle

快速边缘捆绑。

mm2gv

Matrix Market-DOT 转换器。

nop

美化图形文件。

sccmap

提取有向图的强连通分量。

smyrna

交互式图形查看器。

tred

用于有向图的传递闭包过滤器。

unflatten

调整有向图以改善布局纵横比。

vimdot

组合文本编辑器和点查看器。

最后修改时间:2024 年 7 月 28 日:将所有 Hugo 'ref' 替换为 'relref'(bbef86a)