grid.picture            package:grImport            R Documentation

_D_r_a_w _a _P_i_c_t_u_r_e _O_b_j_e_c_t

_D_e_s_c_r_i_p_t_i_o_n:

     These function take a '"Picture"' object and either draw the
     picture or create a grid graphical object representing the
     picture.

_U_s_a_g_e:

     grid.picture(...)
     pictureGrob(picture, x = 0.5, y = 0.5,
                 width = 1, height = 1, just = "centre",
                 exp = 0.05, xscale = NULL, yscale = NULL,
                 distort = FALSE,
                 FUN = grobify, ..., name = NULL, gp = gpar())

_A_r_g_u_m_e_n_t_s:

 picture: A '"Picture"' object.

       x: A single numeric value or unit object specifying an x-value.

       y: A single numeric value or unit object specifying a y-value.

   width: A single numeric value or unit object specifying a width.

  height: A single numeric value or unit object specifying a height.

    just: The justification of the picture relative to its (x, y)
          location.  If there are two values, the first value specifes
          horizontal justification and the second value specifies
          vertical justification.  Possible string values are:
          '"left"', '"right"', '"centre"', '"center"', '"bottom"', and
          '"top"'.  For numeric values, 0 means left alignment and 1
          means right alignment. 

     exp: An expansion factor;  determines whether any space is left
          between the extent of the picture and the bounding rectangle
          it is drawn within.

  xscale: A numeric vector of length two indicating the minimum and
          maximum on the x-scale.

  yscale: A numeric vector of length two indicating the minimum and
          maximum on the y-scale.

 distort: A logical value indicating whether the image should preserve
          its aspect ratio or distort to fit the area it is being drawn
          within. 

     FUN: The function used to convert paths within the picture to grid
          grobs.

     ...: For 'grid.picture' arguments to be passed to 'pictureGrob'. 
          For 'pictureGrob', arguments to be passed to 'grobify'.

    name: A character identifier. 

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

_V_a_l_u_e:

     A grid gTree.

_A_u_t_h_o_r(_s):

     Paul Murrell

_S_e_e _A_l_s_o:

     'grobify' and  'grid.symbols'

