grid.grob                package:grid                R Documentation

_C_r_e_a_t_e _a _G_r_i_d _G_r_a_p_h_i_c_a_l _O_b_j_e_c_t

_D_e_s_c_r_i_p_t_i_o_n:

     These functions create grid graphical objects.

_U_s_a_g_e:

     grid.grob(list.struct, cl = NULL, draw = TRUE)
     grob(..., name = NULL, gp = NULL, vp = NULL, cl = NULL) 
     gTree(..., name = NULL, gp = NULL, vp = NULL, children = NULL, 
           childrenvp = NULL, cl = NULL)
     grobTree(..., name = NULL, gp = NULL, vp = NULL, 
              childrenvp = NULL, cl = NULL)
     childNames(gTree)
     gList(...)

_A_r_g_u_m_e_n_t_s:

     ...: For 'grob' and 'gTree', the named slots describing important
          features of the graphical object. For 'gList' and 'grobTree',
          a series of grob objects. 

list.struct: A list (preferably with each element named).

    name: A character identifier for the grob.  Used to find the grob
          on the display list and/or as a child of another grob. 

children: A gList object. 

childrenvp: A viewport object (or 'NULL').

      gp: A gpar object, typically the output from a call to the
          function 'gpar'.  This is basically a list of graphical
          parameter settings.

      vp: A viewport object (or 'NULL').

      cl: A string giving the class attribute for the 'list.struct'

    draw: A logical value to indicate whether to produce graphical
          output.

   gTree: A gTree object.

_D_e_t_a_i_l_s:

     These functions can be used to create a basic grob, gTree, or
     gList object, or a new class derived from one of these.

     A grid graphical object (grob) is a description of a graphical
     item.  These basic classes provide default behaviour for
     validating, drawing, and modifying graphical objects.  Both call
     the function 'validDetails' to check that the object returned is
     coherent.

     A gTree can have other grobs as children;  when a gTree is drawn,
     it draws all of its children.  Before drawing its children, a
     gTree pushes its childrenvp slot and then navigates back up (calls
     'upViewport') so that the children can specify their location
     within the childrenvp via a vpPath.

     Grob names need not be unique in general, but all children of a
     gTree must have different names.   A grob name can be any string,
     though it is not advisable to use the gPath separator  (currently
     '::') in grob names.

     The function 'childNames' returns the names of the grobs which are
     children of a gTree.

     All grid primitives ('grid.lines', 'grid.rect', ...) and some
     higher-level grid components (e.g., 'grid.xaxis' and 'grid.yaxis')
     are derived from these classes.

     'grobTree' is just a convenient wrapper for 'gTree' when the only
     components of the gTree are grobs (so all unnamed arguments become
     children of the gTree).

     'grid.grob' is deprecated.

_V_a_l_u_e:

     A grob object.

_A_u_t_h_o_r(_s):

     Paul Murrell

_S_e_e _A_l_s_o:

     'grid.draw', 'grid.edit', 'grid.get'.

