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