grid.grob {grid} | R Documentation |
These functions create grid graphical objects.
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) childNames(gTree) gList(...)
... |
For grob and gTree , the
named slots describing important features of
the graphical object. For gList , 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. |
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.
grid.grob
is deprecated.
A grob object.
Paul Murrell
grid.draw
,
grid.edit
,
grid.get
.