NAME

graph-easy - render/convert graphs in/from various formats

SYNOPSIS

Convert between graph formats and layout/render graphs:

        graph-easy [options] [inputfile [outputfile]]
        graph-easy --input=graph.dot --as_ascii
        graph-easy --as_html --output=graph.html graph.txt
        graph-easy graph.txt graph.svg
        graph-easy graph.txt --as_dot | dot -Tpng -o graph.png
        echo "[ Bonn ] - car -> [ Berlin ]" | graph-easy --ascii

ARGUMENTS

--help

Print the full documentation, not just a short overview.

--input

Specify the input file name.

--output

Specify the output file name.

--as

Specify the output format. Valid formats are:

        ascii
        boxart
        html
        svg
        graphviz        the DOT language
        dot             an alias for "graphviz"
        txt             Graph::Easy text

If unspecified, the default format will be determined by the output filename extension, and is ascii, if the output filename was not set.

Note that you can also use ONE argument of the form --as_ascii, --as_svg and so on.

--from

Specify the input format. Valid formats are:

        graphviz        the DOT language
        txt             Graph::Easy text

If not specified, the input format is auto-detected.

Note that you can also use ONE argument of the form --from_graphviz or --from_txt,

--verbose

Write info regarding the conversion process to STDERR.

--debug=N

Write debugging info to STDERR. Warning, this can create huge amounts of hard-to-understand output!

Example:

        graph-easy input.txt --output=test.html --debug=1

--parse

When true, will only parse the input file and not output anything. This is usefull in combination with --debug=1.

--timeout

Set the timeout in seconds for the layouter. If the layout does not finish in this time, it will be aborted.

DESCRIPTION

graph-easy reads descriptions of graphs and then converts them to the desired output format.

By default, the input will be read from STDIN, and the output will go to STDOUT.

It understands the following formats as input:

        Graph::Easy     http://bloodgate.com/perl/graph/manual/
        DOT             http://www.graphviz.org/

The formats are automatically detected, regardless of the input file name, but you can also explicitely declare your input to be in one specific format.

The output can either be a dump of the graph in one of the two input formats, or a layout (rendering) of the graph in one of the output formats implemented by Graph::Easy:

        HTML    SVG     ASCII   BOXART

LICENSE

This library is free software; you can redistribute it and/or modify it under the terms of the GPL version 2.

See the LICENSE file of Graph::Easy for a copy of the GPL.

This product includes color specifications and designs developed by Cynthia Brewer (http://colorbrewer.org/). See the LICENSE file for the full license text that applies to these color schemes.

AUTHOR

Copyright (C) 2004 - 2007 by Tels http://bloodgate.com