R mtext 将文本写入绘图的边距

说明

文本写入当前图形区域的四个边距之一或设备区域的外边距之一。

用法

mtext(text, side = 3, line = 0, outer = FALSE, at = NA,
      adj = NA, padj = NA, cex = NA, col = NA, font = NA, ...)

参数

text	指定要写入的文本的字符或expression向量。其他对象由 as.graphicsAnnot 强制。
side	在图的哪一侧(1=底部，2=左侧，3=顶部，4=右侧)。
line	在哪一条 MARgin 线上，从 0 开始向外计数。
outer	如果可用，请使用外边距。
at	给出每个字符串在用户坐标中的位置。如果 at 对应于特定文本项的分量不是有限值(默认值)，则位置将由 adj 确定。
adj	调整每根弦的读取方向。对于与轴平行的字符串，adj = 0 表示左对齐或下对齐，adj = 1 表示右对齐或上对齐。 如果 adj 不是有限值(默认值)，则 par("las") 的值决定调整。对于平行于轴绘制的字符串，默认是将字符串居中。
padj	垂直于读取方向的每个字符串的调整(由 adj 控制)。对于与轴平行的字符串，padj = 0 表示左对齐或底部对齐，padj = 1 表示右对齐或顶部对齐(相对于线)。 如果 padj 不是有限值(默认值)，则 par("las") 的值决定调整。对于垂直于轴绘制的字符串，默认是将字符串居中。
cex	字符扩展因子。 NULL 和 NA 相当于 1.0 。这是绝对测量，未按 par("cex") 或设置 par("mfrow") 或 par("mfcol") 进行缩放。可以是一个向量。
col	使用的颜色。可以是一个向量。 NA 值(默认)意味着使用 par("col") 。
font	文本的字体。可以是一个向量。 NA 值(默认)意味着使用 par("font") 。
...	更多图形参数(参见 par )，包括 family 、 las 和 xpd 。 (后者默认为图形区域，除非 outer = TRUE ，否则为设备区域。只能增加。)

细节

外边距中的用户坐标始终在 0 到 1 的范围内，并且不受图形区域中的用户坐标的影响 —R这里与 S 的其他实现不同。

所有命名参数都可以是向量，并且将进行回收以绘制与向量参数中最长的字符串一样多的字符串。

请注意，向量 adj 与 text 具有不同的含义。 adj = 0.5 将使字符串居中，但 outer = TRUE 位于设备区域而不是绘图区域。

参数las将确定字符串的方向。对于垂直于轴绘制的字符串，默认对齐方式是将字符串的末尾放置在指定线上最靠近轴的位置。 (请注意，这与 S 不同，S 使用srt如果at被提供并且las如果不是。范围srt被忽略在R.)

请注意，如果要垂直于轴绘制文本，则 adj 确定字符串的对齐方式以及沿轴的位置，除非指定了 at。

图形参数"ylbias"(请参阅par)确定文本基线相对于标称线的放置方式。

副作用

给定的文本将写入当前绘图。

例子

plot(1:10, (-4:5)^2, main = "Parabola Points", xlab = "xlab")
mtext("10 of them")
for(s in 1:4)
    mtext(paste("mtext(..., line= -1, {side, col, font} = ", s,
          ", cex = ", (1+s)/2, ")"), line = -1,
          side = s, col = s, font = s, cex = (1+s)/2)
mtext("mtext(..., line= -2)", line = -2)
mtext("mtext(..., line= -2, adj = 0)", line = -2, adj = 0)
##--- log axis :
plot(1:10, exp(1:10), log = "y", main = "log =\"y\"", xlab = "xlab")
for(s in 1:4) mtext(paste("mtext(...,side=", s ,")"), side = s)

参考

Becker, R. A., Chambers, J. M. and Wilks, A. R. (1988) The New S Language. Wadsworth & Brooks/Cole.

也可以看看

title、text、plot、par； plotmath 了解数学注释的详细信息。