grid.collection {grid}R Documentation

Create a Coherent Group of Grid Graphical Objects

Description

This function creates a graphical object which contains several other graphical objects. When it is drawn, it draws all of its children.

It may be convenient to name the elements of the collection.

Usage

grid.collection(..., gp=gpar(), draw=T, vp=NULL)

Arguments

... Zero or more objects of class "grob".
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.
draw A logical value to indicate whether to produce graphical output.
vp A Grid viewport object (or NULL).

Value

An object of class "grob" containing a list structure of class "collection".

Author(s)

Paul Murrell

See Also

grid.grob.

Examples

grid.newpage()
lc <- grid.collection(l1=grid.lines(draw=FALSE),
                      l2=grid.lines(c(.5, .5), draw=FALSE))
grid.edit(lc, gp=gpar(col="blue"))
grid.edit(lc, "children", "l2", gp=gpar(col="red"))

[Package Contents]