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 了解數學注釋的詳細信息。