soot.util.dot

Class DotGraph

java.lang.Object

soot.util.dot.DotGraph

All Implemented Interfaces:

Renderable

public class DotGraph
extends java.lang.Object
implements Renderable

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	DOT_EXTENSION The extension added to output files, exported so that clients can search for the filenames.

Constructor Summary

Constructors

Constructor and Description
DotGraph(java.lang.String graphname) Creates a new graph for drawing.

Method Summary

Modifier and Type	Method and Description
DotGraph	createSubGraph(java.lang.String label) creates a sub graph.
DotGraphEdge	drawEdge(java.lang.String from, java.lang.String to) Draws a directed edge (including the source and end nodes, if they have not already been drawn).
DotGraphNode	drawNode(java.lang.String name) Draws a node.
void	drawUndirectedEdge(java.lang.String label1, java.lang.String label2) draws an undirected edge
DotGraphNode	getNode(java.lang.String name) Gets the graph node by name.
void	plot(java.lang.String filename) Generates the drawing on canvas to the dot file.
void	render(java.io.OutputStream out, int indent)
void	setGraphAttribute(DotGraphAttribute attr) sets any general attributes
void	setGraphAttribute(java.lang.String id, java.lang.String value) sets any general attributes
void	setGraphLabel(java.lang.String label) sets the graph label
void	setGraphName(java.lang.String name) sets the graph name
void	setGraphSize(double width, double height) sets the size of drawing area, in inches
void	setNodeShape(java.lang.String shape) Sets all node shapes, see the list of node shapes in DotGraphConstants.
void	setNodeStyle(java.lang.String style) Sets all node styles
void	setOrientation(java.lang.String orientation) sets the graph rotation angles
void	setPageSize(double width, double height) sets the pages size, once this is set, the generated graph will be broken into several pages.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

DOT_EXTENSION

public static final java.lang.String DOT_EXTENSION

The extension added to output files, exported so that clients can search for the filenames.

See Also:

Constant Field Values

Constructor Detail

DotGraph

public DotGraph(java.lang.String graphname)

Creates a new graph for drawing.

Parameters:

graphname, - the name used to identify the graph in the dot source.

Method Detail

plot

public void plot(java.lang.String filename)

Generates the drawing on canvas to the dot file.

Parameters:

filename - the name for the output file. By convention, it should end with DOT_EXTENSION, but this is not enforced.

drawEdge

public DotGraphEdge drawEdge(java.lang.String from,
                             java.lang.String to)

Draws a directed edge (including the source and end nodes, if they have not already been drawn).

Parameters:

from, - the source node

to, - the end node

Returns:

a graph edge

drawNode

public DotGraphNode drawNode(java.lang.String name)

Draws a node.

Parameters:

name, - the node to draw.

Returns:

the DotGraphNode corresponding to the specified name.

getNode

public DotGraphNode getNode(java.lang.String name)

Gets the graph node by name.

Parameters:

name, - unique name of the node.

Returns:

the node with the specified name, adding a new node to the graph if there is no such node.

setNodeShape

public void setNodeShape(java.lang.String shape)

Sets all node shapes, see the list of node shapes in DotGraphConstants.

Parameters:

shape, - the node shape

setNodeStyle

public void setNodeStyle(java.lang.String style)

Sets all node styles

Parameters:

style, - the node style

setGraphSize

public void setGraphSize(double width,
                         double height)

sets the size of drawing area, in inches

setPageSize

public void setPageSize(double width,
                        double height)

sets the pages size, once this is set, the generated graph will be broken into several pages.

setOrientation

public void setOrientation(java.lang.String orientation)

sets the graph rotation angles

setGraphName

public void setGraphName(java.lang.String name)

sets the graph name

setGraphLabel

public void setGraphLabel(java.lang.String label)

sets the graph label

setGraphAttribute

public void setGraphAttribute(java.lang.String id,
                              java.lang.String value)

sets any general attributes

Parameters:

id - is the attribute name.

value - is the attribute value.

setGraphAttribute

public void setGraphAttribute(DotGraphAttribute attr)

sets any general attributes

Parameters:

attr - a DotGraphAttribute specifying the attribute name and value.

drawUndirectedEdge

public void drawUndirectedEdge(java.lang.String label1,
                               java.lang.String label2)

draws an undirected edge

Parameters:

label1, - label2

createSubGraph

public DotGraph createSubGraph(java.lang.String label)

creates a sub graph.

Returns:

the newly created sub graph.

render

public void render(java.io.OutputStream out,
                   int indent)
            throws java.io.IOException

Specified by:

render in interface Renderable

Throws:

java.io.IOException