GRAPHEDITOR(1)

NAME
grapheditor - graph editor application for daVinci

SYNOPSIS
daVinci -graphedit daVinci -startappl <directory_of_grapheditor> grapheditor

DESCRIPTION
This little program is only usable together with daVinci V1.4. It can be connected to daVinci via the application interface. With the grapheditor graphs in the daVinci term-representation can be created interactively. It is possible to insert or delete nodes and edges and set all attributes like color, font, edge-pattern etc. The graph can be created from scratch or existing graphs in term-representation can be loaded into the grapheditor. It is strongly recommended, that labels are used for nodes and edges in the term-representation of the graph. This is checked when you create a graph in the grapheditor. Existing graphs loaded into the grapheditor from file must have a label for every node. Edge labels maybe omitted, but this can result in a strange behaviour for graphs with multiple edges. The grapheditor will not work together with the option '-selection paths' of daVinci. There is a GraphEditor sub-menu in the Edit menu of daVinci, if the grapheditor is connected:
    Node
        In this menu you will find all commands, that manipulate nodes. Insert Child...
            This command is active, if exactly one node is selected. If you choose it, a subframe will appear, in which you can specify the attributes of the node (see below). If you select the button 'Insert', the new node will be inserted as a child of the selected node with a default edge between them. The edge label for the new edge is automatically created and starts with the character '@'. Don't use edge labels starting with this character when you specify a label yourself.
        Insert Root...
            This command is active, if nothing is selected. If you choose it, a subframe will appear, in which you can specify the attributes of the node (see below). If you select the button 'Insert', the new node will be inserted as a root in the top level of the graph.
        Delete Node
            This command is active, if exactly one node is selected. If you choose it, the selected node is deleted without a warning. All edges leading to or starting from the deleted node, are deleted as well. Childs, that have no other parents are roots of the graph afterwards.
        Delete Subgraph
            This command is active, if exactly one node is selected. If you choose it, the selected node is deleted without a warning. All edges leading to or starting from the deleted node, are deleted as well. The operation continues recursively and removes all childs that are reachable from the deleted node and have no other parent. You should use this operation very carefully, if your graph is cyclic. It is possible, that in this case more parts of the graph than expected are removed. In some cases it could remove the whole graph.
        Attributes...
            This command is active, if exactly one node is selected. If you choose it, a subframe will appear, in which you can change the attributes of the selected node (see below).
        Center selected Node
            This command is active, if exactly one node is selected. If you choose it, the visible part of the graph in the window is moved, such that the currently selected node is centered in the window, if possible.
    Edge
        In this menu you will find all commands, that manipulate edges. Insert Edge...
            This command is active, if exactly two nodes are selected. If you choose it, a subframe will appear, in which you can specify the attributes of the edge (see below). If you select the button 'Insert', the new edge will be inserted between the selected nodes according to the specified direction.
        Delete Edge
            This command is active, if an edge is selected. If you choose it, the selected edge is deleted without a warning. If the child of the edge, has no other parents it will be a root of the graph afterwards.
        Attributes...
            This command is active, if an edge is selected. If you choose it, a subframe will appear, in which you can change the attributes of the selected edge (see below).
    New Graph
        With this command, you can clear the graph in the 'grapheditor' i.e. start the creation of a new graph. If you choose this command, it is executed without further warning.
    Load Graph...
        With this command, you can load a graph from a file. If you choose it, a subframe will appear, in which you can specify the directory and the name of the file you want to load. You will see a notice, if the file can't be found or loaded.
    Save Graph...
        With this command, you can save a graph in a file. If you choose it, a subframe will appear, in which you can specify the directory and the name of the file you want to save. If the file exists, you will be asked, if you want to overwrite it or not. You will see a notice, if the file can't be saved.

The subframes of the grapheditor:
    There are two subframes, that appear, if you have to specify the attributes for a node or an edge. Node attributes
        In this subframe you can specify all attributes for a node, that are currently understood by daVinci. It is used for the insertion of a node (button 'Insert') and for changing the attributes of an existing node (buttons 'Apply' and 'Reset'). Label
            You must specify a label for every node. If you press 'Insert' or 'Apply' to finish the frame and there is no label or if the specified label is ambiguous, you will see a notice. The attributes can be applied only if you specify a unique label for the node.
        Info
            In this field you can enter the string that should appear in the visualiziation of the node. Currently it is impossible to insert multiline strings here. You have to edit the ASCII representation of the graph to use this feature.
        Graphical Object
            Here you can choose one of the six currently available graphical objects for the visualization of a node (Box, Rhombus, Text, Circle, Ellipse, Icon). If you choose Icon, you need to specify an Icon File from which the icon can be loaded in XBM format. The file must be located in one of the directories specified in the environment variable DAVINCI_ICONDIR.
        Color
            Here you can choose the color of the node visualization. On black and white machines, you will see only black or white squares.
        Font Family
            Here you can choose the font family for Info, as it will appear in the visualization. Currently there are four font families (Lucida, Helvetica, Times, Courier).
        Font Style
            Here you can choose the font style for Info, as it will appear in the visualization. The four possible choices are: None, Bold, Italic, Bold and Italic.
        Hidden
            With this check-box you can specify whether the node is initially hidden or not.
    Edge attributes
        In this subframe you can specify all attributes for an edge, that are currently understood by daVinci. It is used for the insertion of an edge (button 'Insert') and for changing the attributes of an existing edge (buttons 'Apply' and 'Reset'). Label
            You must specify a label for every edge. If you press 'Insert' or 'Apply' to finish the frame and there is no label or if the specified label is ambiguous, you will see a notice. The attributes can be applied only if you specify a unique label for the edge. Don't use labels with the first character '@', because the grapheditor creates labels for the new edge in 'Insert Child...' starting with this character.
        Direction
            Here you can choose the direction of the edge. You see the Info-strings of the nodes, the edge connects, together with an arrow that shows the direction of the edge. You can specify that there should be one, two or no arrow at the ends of the edge.
        Pattern
            Here you can choose the the pattern of the edge, as it will appear in the visualization. Currently these are: solid, dotted and dashed.
        Color
            Here you can choose the color of the edge visualization. On black and white machines, you will see only black or white squares.

OPTIONS
The following options are options of daVinci, that are needed for starting the grapheditor. -graphedit
    This option connects daVinci with the grapheditor, if the environment variable GRAPHEDITOR_DIRECTORY is set correctly to the directory, where the program 'grapheditor' can be found. If the variable is not found, the '-graphedit' option will do nothing. You can see that the grapheditor is connected, if the 'Edit'-button is active and the string 'GraphEditor' appears in the right footer of the daVinci base-frame.
-startappl <directory_of_grapheditor> <grapheditor>
    This is the normal option for connecting an application to daVinci. If the directory where the program 'grapheditor' can be found is specified in the first parameter of the option and the name of the 'grapheditor' program in the second, the grapheditor will be started automatically. You can see that the grapheditor is connected, if the 'Edit'-button is active and the string 'GraphEditor' appears in the right footer of the daVinci base-frame.

ENVIRONMENT
GRAPHEDITOR_DIRECTORY
    If you want to start the grapheditor by the option '-graphedit' of daVinci, you have to specify the directory, where daVinci can find the program 'grapheditor' in this environment variable.
DAVINCI_ICONDIR
    If you want to use icons as graphical objects for nodes, you have to specify the directories, where daVinci can find the icon files, in this environment variable via the well known PATH format.

SEE ALSO
daVinci V1.4 User Manual , daVinci(1)