R grid.text 绘制文字

说明

这些函数创建并绘制文本和plotmath表达式。

用法

grid.text(label, x = unit(0.5, "npc"), y = unit(0.5, "npc"),
          just = "centre", hjust = NULL, vjust = NULL, rot = 0,
          check.overlap = FALSE, default.units = "npc",
          name = NULL, gp = gpar(), draw = TRUE, vp = NULL)

textGrob(label, x = unit(0.5, "npc"), y = unit(0.5, "npc"),
          just = "centre", hjust = NULL, vjust = NULL, rot = 0,
          check.overlap = FALSE, default.units = "npc",
          name = NULL, gp = gpar(), vp = NULL)

参数

label	字符或expression向量。其他对象由 as.graphicsAnnot 强制。
x	指定 x-values 的数值向量或单位对象。
y	指定 y-values 的数值向量或单位对象。
just	文本相对于其 (x, y) 位置的对齐方式。如果有两个值，则第一个值指定水平对齐方式，第二个值指定垂直对齐方式。可能的字符串值为： "left" 、 "right" 、 "centre" 、 "center" 、 "bottom" 和 "top" 。对于数值，0 表示左(下)对齐，1 表示右(上)对齐。
hjust	指定水平对齐的数值向量。如果指定，则覆盖 just 设置。
vjust	指定垂直对齐的数值向量。如果指定，则覆盖 just 设置。
rot	旋转文本的角度。
check.overlap	一个逻辑值，指示是否检查和省略重叠文本(在该 grob 内)。
default.units	指示 x 或 y 仅作为数值向量给出时使用的默认单位的字符串。
name	字符标识符。
gp	类 "gpar" 的对象，通常是调用函数 gpar 的输出。这本质上是图形参数设置的列表。
draw	指示是否应生成图形输出的逻辑值。
vp	网格视口对象(或 NULL)。

细节

这两个函数都会创建一个文本对象(说明文本的图形对象)，但只有 grid.text 绘制文本(并且仅当 draw 是 TRUE 时)。

如果 label 参数是表达式，则输出格式为数学注释，就像基本图形文本一样。

值

一个文本集。 grid.text() 以不可见方式返回值。

例子

grid.newpage()
x <- stats::runif(20)
y <- stats::runif(20)
rot <- stats::runif(20, 0, 360)
grid.text("SOMETHING NICE AND BIG", x=x, y=y, rot=rot,
          gp=gpar(fontsize=20, col="grey"))
grid.text("SOMETHING NICE AND BIG", x=x, y=y, rot=rot,
          gp=gpar(fontsize=20), check.overlap=TRUE)

grid.newpage() ## plotmath example
grid.text(quote(frac(e^{-x^2/2}, sqrt(2*pi))), x=x, y=y, rot=stats::runif(20, -45,45),
          gp=gpar(fontsize=17, col=4), check.overlap=TRUE)

grid.newpage()
draw.text <- function(just, i, j) {
  grid.text("ABCD", x=x[j], y=y[i], just=just)
  grid.text(deparse(substitute(just)), x=x[j], y=y[i] + unit(2, "lines"),
            gp=gpar(col="grey", fontsize=8))
}
x <- unit(1:4/5, "npc")
y <- unit(1:4/5, "npc")
grid.grill(h=y, v=x, gp=gpar(col="grey"))
draw.text(c("bottom"), 1, 1)
draw.text(c("left", "bottom"), 2, 1)
draw.text(c("right", "bottom"), 3, 1)
draw.text(c("centre", "bottom"), 4, 1)
draw.text(c("centre"), 1, 2)
draw.text(c("left", "centre"), 2, 2)
draw.text(c("right", "centre"), 3, 2)
draw.text(c("centre", "centre"), 4, 2)
draw.text(c("top"), 1, 3)
draw.text(c("left", "top"), 2, 3)
draw.text(c("right", "top"), 3, 3)
draw.text(c("centre", "top"), 4, 3)
draw.text(c(), 1, 4)
draw.text(c("left"), 2, 4)
draw.text(c("right"), 3, 4)
draw.text(c("centre"), 4, 4)

作者

Paul Murrell

也可以看看

Grid、viewport