


GRAPHEDITOR(1)            User Commands            GRAPHEDITOR(1)



NAME
     grapheditor - graph editor application for daVinci

SYNOPSIS
     daVinci -_g_r_a_p_h_e_d_i_t

     daVinci -_s_t_a_r_t_a_p_p_l <directory_of_grapheditor> _g_r_a_p_h_e_d_i_t_o_r

DESCRIPTION
     This  little  program   is   only   usable   together   with
     daVinci V1.4.  It can be connected to daVinci via the appli-
     cation 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:

          _N_o_d_e
               In this menu you  will  find  all  commands,  that
               manipulate nodes.


               _I_n_s_e_r_t _C_h_i_l_d...
                    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  automati-
                    cally created and starts with the character '
                    @'. Don't use edge labels starting with  this
                    character when you specify a label yourself.



daVinci-Project   Last change: 1 December 1994                  1






GRAPHEDITOR(1)            User Commands            GRAPHEDITOR(1)



               _I_n_s_e_r_t _R_o_o_t...
                    This  command  is  active,  if   nothing   is
                    selected.  If  you choose it, a subframe will
                    appear, in which you can specify  the  attri-
                    butes 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.

               _D_e_l_e_t_e _N_o_d_e
                    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 after-
                    wards.

               _D_e_l_e_t_e _S_u_b_g_r_a_p_h
                    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.

               _A_t_t_r_i_b_u_t_e_s...
                    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).

               _C_e_n_t_e_r _s_e_l_e_c_t_e_d _N_o_d_e
                    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 cen-
                    tered in the window, if possible.

          _E_d_g_e
               In this menu you  will  find  all  commands,  that
               manipulate edges.

               _I_n_s_e_r_t _E_d_g_e...



daVinci-Project   Last change: 1 December 1994                  2






GRAPHEDITOR(1)            User Commands            GRAPHEDITOR(1)



                    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.

               _D_e_l_e_t_e _E_d_g_e
                    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.

               _A_t_t_r_i_b_u_t_e_s...
                    This  command  is  active,  if  an  edge   is
                    selected.  If  you choose it, a subframe will
                    appear, in which you can  change  the  attri-
                    butes of the selected edge (see below).

          _N_e_w _G_r_a_p_h
               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.

          _L_o_a_d _G_r_a_p_h...
               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.

          _S_a_v_e _G_r_a_p_h...
               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.

          _N_o_d_e _a_t_t_r_i_b_u_t_e_s
               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').



daVinci-Project   Last change: 1 December 1994                  3






GRAPHEDITOR(1)            User Commands            GRAPHEDITOR(1)



               _L_a_b_e_l
                    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  speci-
                    fied  label  is  ambiguous,  you  will  see a
                    notice. The attributes can be applied only if
                    you specify a unique label for the node.

               _I_n_f_o
                    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.

               _G_r_a_p_h_i_c_a_l _O_b_j_e_c_t
                    Here you can choose one of the six  currently
                    available  graphical objects for the visuali-
                    zation 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.

               _C_o_l_o_r
                    Here you can choose the  color  of  the  node
                    visualization.  On  black and white machines,
                    you will see only black or white squares.

               _F_o_n_t _F_a_m_i_l_y
                    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).

               _F_o_n_t _S_t_y_l_e
                    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.

               _H_i_d_d_e_n
                    With this check-box you can  specify  whether
                    the node is initially hidden or not.

          _E_d_g_e _a_t_t_r_i_b_u_t_e_s
               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



daVinci-Project   Last change: 1 December 1994                  4






GRAPHEDITOR(1)            User Commands            GRAPHEDITOR(1)



               of an existing edge (buttons 'Apply' and 'Reset').

               _L_a_b_e_l
                    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  speci-
                    fied  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.

               _D_i_r_e_c_t_i_o_n
                    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.

               _P_a_t_t_e_r_n
                    Here you can choose the the  pattern  of  the
                    edge, as it will appear in the visualization.
                    Currently  these  are:  solid,   dotted   and
                    dashed.

               _C_o_l_o_r
                    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.

     -_g_r_a_p_h_e_d_i_t
          This option connects daVinci with the  grapheditor,  if
          the  environment  variable GRAPHEDITOR_DIRECTORY is set
          correctly to the directory, where the program 'graphed-
          itor' 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.

     -_s_t_a_r_t_a_p_p_l <_d_i_r_e_c_t_o_r_y__o_f__g_r_a_p_h_e_d_i_t_o_r> <_g_r_a_p_h_e_d_i_t_o_r>
          This is the normal option for connecting an application



daVinci-Project   Last change: 1 December 1994                  5






GRAPHEDITOR(1)            User Commands            GRAPHEDITOR(1)



          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 'graphedi-
          tor' 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
     _G_R_A_P_H_E_D_I_T_O_R__D_I_R_E_C_T_O_R_Y
          If you want to start the grapheditor by the option  ' -
          graphedit '  of daVinci, you have to specify the direc-
          tory, where daVinci can find the program 'grapheditor '
          in this environment variable.

     _D_A_V_I_N_C_I__I_C_O_N_D_I_R
          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
     _d_a_V_i_n_c_i _V_1._4 _U_s_e_r _M_a_n_u_a_l , daVinci(1)




























daVinci-Project   Last change: 1 December 1994                  6



