# showViewport

0th

Percentile

##### Display grid viewports.

Produces a graphical display of (by default) the current grid viewport tree. It is also possible to display only specific viewports. Each viewport is drawn as a rectangle and the leaf viewports are labelled with the viewport name.

Keywords
dplot
##### Usage
showViewport(vp = NULL, recurse = TRUE, depth = NULL,
newpage = FALSE, leaves = FALSE,
col = rgb(0, 0, 1, 0.2), fill = rgb(0, 0, 1, 0.1),
label = TRUE, nrow = 3, ncol = nrow)
##### Arguments
vp

If NULL, the current viewport tree is displayed. Otherwise, a viewport (or vpList, or vpStack, or vpTree) or a vpPath that specifies which viewport to display.

recurse

Should the children of the specified viewport also be displayed?

depth

Only display viewports at the specified depth (may be a vector of depths).

newpage

Start a new page for the display? Otherwise, the viewports are displayed on top of the current plot.

leaves

Produce a matrix of smaller displays, with each leaf viewport in its own display.

col

The colour used to draw the border of the rectangle for each viewport and to draw the label for each viewport. If a vector, then the first colour is used for the top-level viewport, the second colour is used for its children, the third colour for their children, and so on.

fill

The colour used to fill each viewport. May be a vector as per col.

label

Should the viewports be labelled (with the viewport name)?

nrow, ncol

The number of rows and columns when leaves is TRUE. Otherwise ignored.

viewport and grid.show.viewport
library(grid) showViewport(viewport(width=.5, height=.5, name="vp")) grid.newpage() pushViewport(viewport(width=.5, height=.5, name="vp")) upViewport() showViewport(vpPath("vp")) showViewport(vpStack(viewport(width=.5, height=.5, name="vp1"), viewport(width=.5, height=.5, name="vp2")), newpage=TRUE) showViewport(vpStack(viewport(width=.5, height=.5, name="vp1"), viewport(width=.5, height=.5, name="vp2")), fill=rgb(1:0, 0:1, 0, .1), newpage=TRUE)