命令行调用

所有的Graphviz程序都具有相似的命令行调用方式:

cmd [ flags] [input files]

如果没有指定输入文件路径,程序从标准输入(stdin)中读取。

参数设置:

-Gname[=value]

设置图的属性,缺省值 value = true

-Nname[=value]

设置默认的节点属性,缺省值 value = ture

-Ename[=value]

设置默认的边属性,缺省值 value = ture

-Klayout

设置缺省使用的布局算法,会覆盖掉缺省的调用程序名,如运行dot –Kneato和运行neato是一样的

-Tformat[:renderer[:formatter]]

设置输出文件的格式。默认的格式是dot

此选项依赖于Graphviz所编译的方式,可能通过多种渲染程序或者格式化程序生成最终的输出。举例来说,依据安装的不同,生成的PNG格式输出可以使用Cairo或者GD库。所指定的渲染引擎可以以紧跟一个冒号来指明。如果多个格式化程序,则可以通过多个相连的相似格式连接在渲染引擎后。比如,-Tpng:carro表明使用的Cairo来生成PNG,-Tpng:cairo:gd表明使用GD库Cairo格式生成PNG。

如果没有设置渲染程序,或者一个渲染程序没有格式化程序,缺省值则会被调用。参数-Tformat:生成一系列和format相关的渲染程序列表,具有format前缀的第一个作为缺省值。使用-v 参数(下面会说到),会显示哪种输出格式、渲染程序和格式化程序被使用。

-V

输出版本信息,并退出

-llibrary

用户指定的,设备依赖的库文本信息,可以是多个参数,这些文本会位于输出代码的开头。对于PostScript输出格式,这些内容会位于标准序言之后,如果library是空字符串,标准序言不会被输出。

-n[num]

设置neato中的no-op参数。如果设置了,neato假设所有的节点的位置已经确定,并且都具有pos属性(提供了位置信息)。

Num = 1和-n等价

Num > 1

-ooutfile

输出文件的文件名,缺省标准输出(stdout)

-O

使用输出文件相同的文件名作为输出文件的文件名,输出的格式在-T参数中指定。

-P

生成一张描述当前布局程序的设置。例如 dot –P –Tpng –O”test.png”

-q

不输出警告信息

-s[scale]

设置布局尺度的单位。

-v

详细模式

-x

在neato中,移除单独的节点和半岛,这可以去掉网络的细枝末节,生成一个不繁琐的图。

-y

缺省下,输出格式中使用直角坐标系的原点在图片的左下角,如果指定了-y,则原点在图片的左上角。

-?

打印出使用信息,退出。

如果-T参数指定了,则每一个指定的格式都会被生成。多个-o参数用来生成对应于不同输出格式的文件,如果输出的格式大于设定的文件数,则剩下的咋标准输出中输出。

注意-G, -N和-E参数会覆盖掉其他初始化的设置。

环境变量

GDFONTPATH

存放字体的路径,被DOTFONTPATH所覆盖,只有当Graphviz没有编译fontconfig库时才会被使用。

DOTFONTPATH

存放字体的路径,被fontpath所覆盖,只有当Graphviz没有编译fontconfig库时才会被使用。

SERVER_NAME

如果被定义,则表示程序运行在服务器上,可以访问图片

GV_FILE_PATH

GVBINDIR Graphviz程序所在的目录