R语言:grid.text()函数中文帮助文档(中英文对照)

loveR

grid.text(grid)
grid.text()所属R语言包：grid

                                        Draw Text
                                         绘制文本

                                         译者：生物统计家园网 机器人LoveR

描述----------Description----------

These functions create and draw text and plotmath expressions.
这些功能创建和绘制文本和plotmath表达的。


用法----------Usage----------


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)



参数----------Arguments----------

参数：label
A character or expression vector.  Other objects are coerced by as.graphicsAnnot.
字符或表达向量。其他对象被强制as.graphicsAnnot。


参数：x
A numeric vector or unit object specifying x-values.
一个数值向量或单位对象指定x值。


参数：y
A numeric vector or unit object specifying y-values.
一个数值向量或单位对象指定的y值。


参数：just
The justification of the text  relative to its (x, y) location.  If there are two values, the first value specifies horizontal justification and the second value specifies vertical justification.  Possible string values are: "left", "right", "centre", "center", "bottom", and "top".  For numeric values, 0 means left alignment and 1 means right alignment.  
其（X，Y）的位置相对文本的理由。如果有两个值，第一个值指定水平的理由，第二个值指定垂直对齐。可能的字符串值是："left"，"right"，"centre"，"center"，"bottom"，"top"。对于数值，0表示左对齐，右对齐1手段。


参数：hjust
A numeric vector specifying horizontal justification. If specified, overrides the just setting.
一个数值向量指定横向理由。如果指定，覆盖just设置。


参数：vjust
A numeric vector specifying vertical justification. If specified, overrides the just setting.
一个数值向量指定垂直理由。如果指定，覆盖just设置。


参数：rot
The angle to rotate the text.
角度旋转文本。


参数：check.overlap
A logical value to indicate whether to check for and omit overlapping text.
一个逻辑值，指示是否检查，省略重叠的文本。


参数：default.units
A string indicating the default units to use if x or y are only given as numeric vectors.   
一个字符串，指示的默认单位使用，如果x或y只为数字向量。


参数：name
A character identifier.  
字符识别。


参数：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.
一个类的对象gpar，通常从调用输出函数gpar。这基本上是一个图形参数设置列表。


参数：draw
A logical value indicating whether graphics output should be produced.
一个逻辑值，指示是否应当制作图形输出。


参数：vp
A Grid viewport object (or NULL).
一个网格视口对象（或NULL）。


Details

详情----------Details----------

Both functions create a text grob (a graphical object describing text), but only grid.text draws the text (and then only if draw is TRUE).
这两个函数创建一个文本格罗（图形对象描述文本），但只有grid.text绘制文本（然后只有draw是TRUE）。

If the label argument is an expression, the output is formatted as a mathematical annotation, as for base graphics text.
如果label参数是一个表达式，输出格式化为一个数学注释为基础的图形文字。


值----------Value----------

A text grob.  grid.text returns the value invisibly.
一个文本GROB。 grid.text返回无形的价值。


作者（S）----------Author(s)----------


Paul Murrell



参见----------See Also----------

Grid, viewport
电网，viewport


举例----------Examples----------


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=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)

转载请注明:出自 生物统计家园网(http://www.biostatistic.net)。


注：
注1：为了方便大家学习，本文档为生物统计家园网机器人LoveR翻译而成，仅供个人R语言学习参考使用，生物统计家园保留版权。
注2：由于是机器人自动翻译，难免有不准确之处，使用时仔细对照中、英文内容进行反复理解，可以帮助R语言的学习。
注3：如遇到不准确之处，请在本贴的后面进行回帖，我们会逐渐进行修订。