此函数可用于向绘图添加图例。请注意，可以使用对函数locator(1) 的调用来代替x 和y 参数。

用于定位图例的 x 和 y 坐标。它们可以通过关键字或 xy.coords 接受的任何方式指定：请参阅“详细信息”。

图例中出现的字符或长度为 \ge 1 的 expression 向量。其他对象将被 as.graphicsAnnot 强制。

如果指定，此参数将导致填充指定颜色(或以指定颜色着色)的框出现在图例文本旁边。

图例中出现的点或线的颜色。

框的边框颜色(仅在指定 fill 时使用)。

图例中出现的线条类型和宽度。必须指定这两者之一来绘制线条。

图例中出现的绘图符号，作为数值向量或 1 字符字符串向量(请参阅 points )。与 points 不同，这都可以指定为单个多字符字符串。必须指定符号绘制。

阴影线的角度。

阴影线的密度(如果为数字且为正值)。如果NULL或负数或NA颜色填充被假设。

要在图例周围绘制的框的类型。允许的值为 "o" (默认值)和 "n" 。

图例框的背景颜色。 (请注意，这仅在 bty != "n" 时使用。)

图例框的线条类型、宽度和颜色(如果 bty = "o" )。

points 的背景颜色，对应于其参数 bg 。

相对于当前 par("cex") 的字符扩展因子。用于文本，并提供 pt.cex 的默认值。

点的扩展因子。

点的线宽，默认为线的线宽，或者如果未设置，则为 par("lwd") 。

如何相对于图例 x 位置调整图例。值 0 表示左对齐，0.5 表示居中，1 表示右对齐。

与图例 y 位置的 xjust 相同。

符号和图例文本之间的水平 (x) 间距的字符间距因子。

垂直 (y) 距离(以每个图例条目上方/下方共享的文本行为单位)。可以使用图例的每一行具有一个元素的向量。

长度为 1 或 2 的数字；图例文本的字符串调整。当 labels 是 plotmath 表达式时，对于 y 调整很有用。

x ( "user" ) 坐标中图例文本的宽度。 (即使对于反向的 x 轴也应该为正。)可以是单个正数值(图例的每一列的宽度相同)、向量(图例的每一列一个元素)、NULL(默认)计算适当的最大值 strwidth(legend) )，或 NA 计算适当的列最大值 strwidth(legend) )。

用于图例文本的颜色。

用于图例文本的字体，请参阅 text 。

逻辑性；如果 TRUE ，则合并点和线，但不合并填充框。如果有点和线，则默认为TRUE。

逻辑性； if TRUE ，显示 legend 如何进行所有神奇的计算。

合乎逻辑的。如果 FALSE ，则不会绘制任何内容，但会返回大小。

设置图例项的列数(默认为 1，垂直图例)。

逻辑性；如果 TRUE ，则水平设置图例而不是垂直(指定 horiz 覆盖 ncol 规范)。

字符串或长度为 1 的表达式，给出要放置在图例顶部的标题。其他对象将被 as.graphicsAnnot 强制。

当通过关键字放置图例时，距边距的插入距离作为绘图区域的一部分。

如果提供，则绘制图例时要使用的 graphical parameter xpd 的值。

title 的颜色，默认为 text.col[1] 。

title 的水平调整：请参阅 par("adj") 的帮助。

标题的扩展因子，默认为 cex[1] 。

用于图例标题的字体，默认为 text.font[1] ，请参阅 text 。

用于说明 lty 和/或 lwd 的线条长度(以字符宽度为单位)。

参数 x 、 y 、 legend 以非标准方式解释，以允许通过一个或两个参数指定坐标。如果 legend 缺失且 y 不是数字，则假定第二个参数为 legend，并且第一个参数指定坐标。

坐标可以以 xy.coords 接受的任何方式指定。如果给出一个点的坐标，则将其用作包含图例的矩形的左上角坐标。如果它给出两个点的坐标，则这些点指定矩形的对角(任意一对角，顺序任意)。

还可以通过将x设置为列表"bottomright" , "bottom" , "bottomleft" , "left" , "topleft" , "top" , "topright" , "right"和"center"中的单个关键字来指定该位置。这会将图例放置在图框内部的给定位置。使用部分参数匹配。可选的 inset 参数指定图例距绘图边距的插入距离。如果给出单个值，则该值将用于两个边距；如果给出两个值，第一个值用于 x - 距离，第二个值用于 y - 距离。

如有必要，属性参数(例如 col 、 pch 、 lty 等)将被回收：merge 则不会。将lty条目设置为0或将lwd条目设置为NA以抑制相应图例条目中的行；将 pch 值设置为 NA 以抑制点。

点在线条之后绘制，以便它们可以用背景颜色 pt.bg 覆盖线条(如果适用)。

请参阅示例以了解如何右对齐标签。

由于它们不用于 Unicode 代码点，因此 -31:-1 值将被默默省略，NA 和 "" 值也是如此。

包含列表组件的列表

包含组件的列表

正数给出图例框的宽度和高度。

框左上角的 x 和 y 坐标。

包含组件的列表

长度为 length(legend) 的数值向量，给出图例文本的 x 和 y 坐标。

无形中返回了。