drawModel            package:dynamicGraph            R Documentation

_D_E_P_R_E_C_A_T_E_D: _D_r_a_w _t_h_e _d_y_n_a_m_i_c_G_r_a_p_h _w_i_n_d_o_w _a_n_d _s_l_a_v_e_s

_D_e_s_c_r_i_p_t_i_o_n:

     The functions 'drawModel' and 'redrawView' within 'dynamicGraph'
     is for adding models to 'dynamicGraph', for adding new views of a
     model, and for overwriting an existing view with an other model.

     The functions can not be found at top level.

     The functions are called by the methods 'addModel', 'addView',
     'replaceModel', and 'replaceView'.

_A_r_g_u_m_e_n_t_s:

frameModels: An object of class 'DynamicGraph-class'. NULL, or
          'frameModels' of 'list(...)$Arguments'. 

frameViews: An object of class 'DynamicGraphModel-class'. NULL, or
          'frameViews' of 'list(...)$Arguments'. If 'frameViews' is set
          to 'NULL',  the default value, then a new model frame will be
          created by 'drawModel'. 

graphWindow: An object of class 'DynamicGraphView-class'. If
          'graphWindow' is set to the value of 
          'list(...)$Arguments$graphWindow' then the calling graph
          window will be redrawn. If 'graphWindow' is set to 'NULL', 
          the default value, then a new slave graph window will be
          drawn. 

      dg: As for 'dynamicGraphMain'. If 'dg' is given (set to a value
          different from NULL) then this value is used, else the value
          extracted from 'list(...)$Arguments' is used. 

  object: As for 'dynamicGraphMain'. If 'object' is given then this
          value is used, else the value extracted from
          'list(...)$Arguments' is used. 

frameModelsEnv: 'frameModelsEnv' is then environment for storing hidden
          values of the 'frameModels'. Extracted from 'frameModels' by
          default. 

initialWindow: Logical, if 'initialWindow' is TRUE then the labels of
          the edges are updated. 

returnNewMaster: Logical, if 'returnNewMaster' is TRUE then .... 

  redraw: Logical, if 'redraw' is TRUE then .... 

setUpdateCountModelMain: Logical. If 'setUpdateCountModelMain' is TRUE
          then views of the same model will be updated. 

returnFrameModel: Logical, if 'returnFrameModel' is TRUE then .... 

 control: Options for 'dynamicGraphMain', see 'dg.control'. 

     ...: Used to porting 'list(...)$Arguments'. 

_D_e_t_a_i_l_s:

     The 'drawModel' and 'redrawView' functions can be called from the
     functions of menus (main menu and pop up menus) of 
     'dynamicGraphMain', from .GlobalEnv in  'DynamicGraph') via
     returned values from 'dynamicGraphMain' (and from the methods of
     the model object in the scope of the function 'dynamicGraphMain').
     As a result the graph window will be redrawn with an other view of
     the model, possible with, e.g., other edges, an other model is
     drawn, or a new slave graph window will appear.

     If the value of a argument to 'drawModel' or 'redrawView' is set,
     then this value is used, else the value from the calling window is
     used. The value of the calling window is given in the argument
     'Arguments' in the call of the function of the menu item.

     Below is an example, where items for labeling all the edges of the
     graph are added to the menu. The edges are visited, a test is
     computed for each edge, the label and width of the edge is
     updated, and the graph is drawn with the updated edge list.

_V_a_l_u_e:

     The returned value from 'dynamicGraphMain'.

_N_o_t_e:

     The functions can not be called from top level, that is, the
     functions does not exists at .GlobalEnv, but only in returned
     values from 'dynamicGraphMain'.

     It is recommended that the functions not are called, but that
     'DynamicGraph' is used with the arguments 'frameModels',
     'frameViews', 'graphWindow', 'addModel', 'addView', and/or
     'overwrite' to call the functions.

_A_u_t_h_o_r(_s):

     Jens Henrik Badsberg

_S_e_e _A_l_s_o:

     See also 'dynamicGraphMain', 'DynamicGraph' 'DynamicGraph-class',
     and 'DynamicGraphModel-class'.

