tlprender User Manual.
What is it?
tlprender is a command line renderer based on Tulip. Given a graph description, it can apply a layout algorithm on it and renders a picture of the graph an a html file with an imagemap.
tlprender render requires Mesa and OSMesa, the library that allows to do offscreen rendering. tlprender does not require to have a running X server.
Usage
Required parameters
tlprender uses GNU getopt to parse its arguments.
By default tlprender will assume input format is Tulip's tlp. This can be changed with the help of the command line option "-t" or "--type". The name specifying the import plugin to use instead of "tlp" is the name of the plugin as it can be found in Tulip's import menu; since it can contains spaces you may have to quote it (refer to your shell's documentation). Don't use plugin's file name, it won't work.
The second required parameter is the prefix of files to be produced. This can be set with "-o" or "--output" followed by the desired prefix.
The last parameter is the filename (or any string meaningful for the import plugin in use).
Optionnals parameters
The default image size is 640x480. This can be changed with "--width" and "--height".
The default image format is JPEG. This can be changed with "-f" or "--format".
To apply a layout before rendering use "-l" or "--layout" followed by the name of the layout.
A brief help can be obtained by specifying "--help" anywhere in the argument list.
Setting HREF target in the HTML file
The nodes'HREF field is get from their "href" property. This property is a simple string that should be placed. One can also set the "alt" property describing the content of ALT field.
Examples
To render graph1.tlp in 800x600 in graph1.jpg and graph1.html:
[shell]>tlprender -o graph1 --width=800 --height=600 graph1.tlp
To render a GML graph and apply a layout named "My layout":
[shell]>tlprender --output=fromGML --type="GML import" -l "My layout" graph.gml