# xline
具有常量 x 值的垂直线
函数库: TyPlot
# 语法
xline(xvalue)
xline(xvalue,linespec)
xline(___,Key=Value)
xline(ax,___)
xl = xline(___)
# 说明
xline(xvalue) 在当前坐标区中的指定 x 值处创建一条常量垂直线。例如，xline(2) 在 x=2 处创建一条线。示例
xline(xvalue,linespec) 指定线型、线条颜色或同时指定两者。例如，"-." 创建点划线，"b" 创建蓝线，"-.b" 创建蓝色点划线。示例
xline(___,Key=Value) 使用一个或多个名称-值对组参数指定常量线属性。有关属性列表，请参阅 line 属性。请在所有其他输入参数之后指定名称-值对组。示例
xline(ax,___) 在指定的坐标区（而不是当前坐标区）中创建线条。要确定当前坐标区，请使用 gca。示例
xl = xline(___) 返回创建的 Line 对象。使用 xl 修改或查询所创建的线条的属性。示例
# 示例
创建垂直线
在 x = 3 处创建一条垂直线。
using TyPlot
xline(3);
指定垂直线的线型和颜色
在 x = 5 处创建一条红色虚线。
using TyPlot
xline(5,"--r");
创建具有标签的垂直线
要创建一条具有标签的线条，还必须指定线型。默认线型是实线 "-"。
using TyPlot
x = LinRange(0, 6, 100);
y = exp.(x);
plot(x, y)
xline(4.5; linestyle="-");
text(4.5 * 1.02, 340, "Acceptable\nLimit"; rotation=90)
指定垂直线属性
为图例创建一条既具有标签又具有显示名称的垂直点划线。
using TyPlot
y = [3187 2693 1771 1826 1958 3222 1645];
barh(y)
xl = xline(2328, linestyle="-.");
text(2328, 3.5, "Average", rotation=90)
调整该线条的垂直和水平对齐，然后显示图例。
barh(y, labels=["Daily Sales"])
xl = xline(2328, linestyle="-.", label="Average Sales");
legend()
在特定坐标区中绘制垂直线
调用 subplot 函数以创建一个 2×1 分块图布局和一个坐标区对象，创建坐标区对象 ax1 和 ax2。然后在每个坐标区中绘图。通过将坐标区传递给 xline 函数，为每个图添加一条垂直虚线和标签。
using TyPlot
ax1 = subplot(2, 1, 1);
x = LinRange(0, 2 * pi, 200);
y1 = cos.(x);
plot(ax1, x, y1)
ax2 = subplot(2, 1, 2);
x = LinRange(0, 2 * pi, 200);
y2 = sin.(x);
plot(ax2, x, y2)
xlcosine = xline(ax1, pi / 2; linestyle=":");
xlsine = xline(ax2, pi; linestyle=":");
text(ax1, pi / 2 * 1.05, 0.2, "cos(π/2)=0"; rotation=90)
text(ax2, pi * 1.05, 0.4, "sin(π)=0"; rotation=90)
# 输入参数
xvalue - 垂直线的位置标量
垂直线在 x 轴上的位置，指定为标量。您可以将 xvalue 指定为数值、DateTime 或持续时间值。但是，您指定的值的类型必须与沿 x 轴的值的数据类型匹配。
示例： xline(12.4) 在 x = 12.4 处绘制线条。
linespec - 线型和颜色字符串标量
线型和颜色，指定为包含符号的字符向量或字符串标量。字符和符号可以按任意顺序显示。您可以指定线型、线条颜色或同时指定两者。您不能指定标记符号。
示例： "--" 表示虚线。
示例： "--g" 表示绿色虚线。
| 线型 | 说明 |
|---|---|
| "-" | 实线 (默认) |
| "--" | 虚线 |
| ":" | 点线 |
| "-." | 点划线 |
| 颜色 | 说明 |
|---|---|
| "y" | 黄色 |
| "m" | 品红色 |
| "c" | 青蓝色 |
| "r" | 红色 |
| "g" | 绿色 |
| "b" | 蓝色 |
| "w" | 白色 |
| "k" | 黑色 |
ax - 目标坐标区当前坐标区 （默认） | Axes 对象
目标坐标区，指定为 Axes 对象。如果希望 xline 在当前坐标区以外的坐标区中绘图，请使用此参数。
# 名称-值对组参数
指定可选的、以逗号分隔的 Key=Value 对组参数。Key 为参数名称，Value 为对应的值。您可采用任意顺序指定多个名称-值对组参数，如 Key1=Value1,...,KeyN=ValueN 所示。
示例： xline(3,color="red");
提示
此处所列的属性只是一部分。有关完整列表，请参阅 line 属性。
label - 行标签"" （默认） | 字符串
行标签，指定为字符串。要创建一个多行标签，请使用"\n"。
示例： xline(-pi/2, label="Lower\nBound")
color - 文本颜色RGB 三元组 | 十六进制颜色代码 | "r" | "g" | "b" | ...
线条颜色，指定为 RGB 三元组、十六进制颜色代码、颜色名称或短名称。
对于自定义颜色，请指定 RGB 三元组或十六进制颜色代码。
- RGB 三元组是包含三个元素的行向量，其元素分别指定颜色中红、绿、蓝分量的强度。强度值必须位于 [0,1] 范围内，例如 [0.4, 0.6, 0.7]。
- 十六进制颜色代码是字符向量或字符串标量，以井号 (#) 开头，后跟三个或六个十六进制数字，范围可以是 0 到 F。这些值不区分大小写。因此，颜色代码 "#FF8800" 与 "#ff8800"、"#F80" 与 "#f80" 是等效的。
此外，还可以按名称指定一些常见的颜色。下表列出了命名颜色选项、等效 RGB 三元组和十六进制颜色代码。
| 颜色名称 | 短名称 | RGB 三元组 | 十六进制颜色代码 | 外观 |
|---|---|---|---|---|
| "red" | "r" | [1, 0, 0] | "#FF0000" |  |
| "green" | 不适用 | [0, 0.5019607843137255, 0] | "#008000" |  |
| 不适用 | "g" | [0, 0.5, 0] | "#007F00" | |
| 不适用 | 不适用 | [0, 1, 0] | "#00FF00" |  |
| "blue" | "b" | [0, 0, 1] | "#0000FF" |  |
| "cyan" | 不适用 | [0, 1, 1] | "#00FFFF" |  |
| 不适用 | "c" | [0, 0.75, 0.75] | "#00BFBF" |  |
| "magenta" | 不适用 | [1, 0, 1] | "#FF00FF" |  |
| 不适用 | "m" | [0.75, 0, 0.75] | "#BF00BF" |  |
| "yellow" | 不适用 | [1, 1, 0] | "#FFFF00" |  |
| 不适用 | "y" | [0.75, 0.75, 0] | "#BFBF00" |  |
| "black" | "k" | [0, 0, 0] | "#000000" |  |
| "white" | "w" | [1, 1, 1] | "#FFFFFF" |  |
| "none" | 不适用 | 不适用 | 不适用 | 无颜色 |
以下是 Syslab 在许多类型的绘图中使用的默认颜色的 RGB 三元组和十六进制颜色代码。
| RGB 三元组 | 十六进制颜色代码 | 外观 |
|---|---|---|
| [0, 0.4470, 0.7410] | "#0072BD" |  |
| [0.8500, 0.3250, 0.0980] | "#D95319" |  |
| [0.9290, 0.6940, 0.1250] | "#EDB120" |  |
| [0.4940, 0.1840, 0.5560] | "#7E2F8E" |  |
| [0.4660, 0.6740, 0.1880] | "#77AC30" |  |
| [0.3010, 0.7450, 0.9330] | "#4DBEEE" |  |
| [0.6350, 0.0780, 0.1840] | "#A2142F" |  |
示例： "g"
示例： [0.6, 0.2, 0.5]
示例： "#D2F9A7"
linewidth - 线条宽度0.5 （默认） | 正值
线宽，指定为以磅为单位的正值。