gtable_col: Create a single column gtable

View source: R/gtable-layouts.R

gtable_colR Documentation

Create a single column gtable

Description

This function stacks a list of grobs into a single column gtable of the given width and heights.

Usage

gtable_col(
  name,
  grobs,
  width = NULL,
  heights = NULL,
  z = NULL,
  vp = NULL,
  clip = "inherit"
)

Arguments

name

a string giving the name of the table. This is used to name the layout viewport

grobs

a single grob or a list of grobs

width

a unit vector giving the width of this column

heights

a unit vector giving the height of each row

z

a numeric vector giving the order in which the grobs should be plotted. Use Inf (the default) to plot above or -Inf below all existing grobs. By default positions are on the integers, giving plenty of room to insert new grobs between existing grobs.

vp

a grid viewport object (or NULL).

clip

should drawing be clipped to the specified cells ("on"), the entire table ("inherit"), or not at all ("off")

Value

A gtable with one column and as many rows as elements in the grobs list.

See Also

Other gtable construction: gtable(), gtable_matrix(), gtable_row(), gtable_spacer

Examples

library(grid)
a <- rectGrob(gp = gpar(fill = "red"))
b <- circleGrob()
c <- linesGrob()
gt <- gtable_col("demo", list(a, b, c))
gt
plot(gt)
gtable_show_layout(gt)

gtable documentation built on Oct. 30, 2024, 9:29 a.m.