line
创建基本线条
说明
line 使用默认属性设置绘制一条从点 (0,0) 到 (1,1) 的线条。
line(___, 使用一个或多个名称-值对组参量修改线条的外观。例如，Name,Value)'LineWidth',3 将线宽设置为 3 磅。请在所有其他输入参量之后指定名称-值对组。如果使用名称-值对组指定数据，例如 line('XData',x,'YData',y)，则必须指定向量数据。
line( 将在由 ax,___)ax 指定的笛卡尔坐标区、极坐标区或地理坐标区中创建线条，而不是在当前坐标区 (gca) 中创建线条。指定 ax 作为第一个输入参量。
示例
以向量形式创建 x 和 y。然后，绘制 y 对 x 的图。
x = linspace(0,10); y = sin(x); line(x,y)
通过将 x 和 y 指定为矩阵来绘制两个线条。使用 line 绘制 y 的列对 x 的列的单独线条。
x = linspace(0,10)'; y = [sin(x) cos(x)]; line(x,y)
通过指定 x、y 和 z 的值，在三维坐标中绘制线条。使用 view(3) 将坐标区更改为三维视图。
t = linspace(0,10*pi,200); x = sin(t); y = cos(t); z = t; line(x,y,z) view(3)
以向量形式创建 x 和 y。然后通过将数据指定为名称-值对组参量来调用 line 函数的低级版本。以这种方式调用该函数时，生成的线条为黑色。
x = linspace(0,10); y = sin(x); line('XData',x,'YData',y)
在点 (1,2) 和 (9,12) 之间绘制一条红色虚线。将 Color 和 LineStyle 属性设置为名称-值对组。
x = [1 9]; y = [2 12]; line(x,y,'Color','red','LineStyle','--')
首先，绘制一条从点 (3,15) 到 (2,12) 的线条并返回 Line 对象。然后将线条更改为绿色虚线。使用圆点表示法设置属性。
x = [3 2]; y = [15 12]; pl = line(x,y);
pl.Color = 'green'; pl.LineStyle = '--';
输入参数
名称-值参数
以 Name1=Value1,...,NameN=ValueN 的形式指定可选参量对组，其中 Name 是参量名称，Value 是对应的值。名称-值参量必须出现在其他参量之后，但对各个参量对组的顺序没有要求。
在 R2021a 之前，使用逗号分隔每个名称和值，并用引号将 Name 引起来。
示例: line(x,y,'Color','red','LineWidth',3) 创建一个宽度为 3 磅的红色线条。
此处所列的属性只是一部分。有关完整列表，请参阅 Line 属性。
线条颜色，指定为 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" | "g" | [0 1 0] | "#00FF00" |
|
"blue" | "b" | [0 0 1] | "#0000FF" |
|
"cyan" | "c" | [0 1 1] | "#00FFFF" |
|
"magenta" | "m" | [1 0 1] | "#FF00FF" |
|
"yellow" | "y" | [1 1 0] | "#FFFF00" |
|
"black" | "k" | [0 0 0] | "#000000" |
|
"white" | "w" | [1 1 1] | "#FFFFFF" |
|
"none" | 不适用 | 不适用 | 不适用 | 无颜色 |
下表列出了浅色和深色主题中绘图的默认调色板。
| 调色板 | 调色板颜色 |
|---|---|
在 R2025a 之前的版本中: 大多数绘图默认使用这些颜色。 |
|
|
|
您可以使用 orderedcolors 和 rgb2hex 函数获取这些调色板的 RGB 三元组和十六进制颜色代码。例如，获取 "gem" 调色板的 RGB 三元组并将其转换为十六进制颜色代码。
RGB = orderedcolors("gem");
H = rgb2hex(RGB);在 R2023b 之前的版本中: 使用 RGB = get(groot,"FactoryAxesColorOrder") 获取 RGB 三元组。
在 R2024a 之前的版本中: 使用 H = compose("#%02X%02X%02X",round(RGB*255)) 获取十六进制颜色代码。
示例: line(x,y,'Color','blue')
示例: line(x,y,'Color',[0.5 0.5 1])
示例: line(x,y,'Color','#D9A2E9')
线型，指定为下表中列出的选项之一。
| 线型 | 描述 | 表示的线条 |
|---|---|---|
"-" | 实线 |
|
"--" | 虚线 |
|
":" | 点线 |
|
"-." | 点划线 |
|
"none" | 无线条 | 无线条 |
标记符号，指定为下表中列出的值之一。默认情况下，对象不显示标记。指定标记符号可在每个数据点或顶点添加标记。
| 标记 | 描述 | 生成的标记 |
|---|---|---|
"o" | 圆圈 |
|
"+" | 加号 |
|
"*" | 星号 |
|
"." | 点 |
|
"x" | 叉号 |
|
"_" | 水平线条 |
|
"|" | 垂直线条 |
|
"square" | 方形 |
|
"diamond" | 菱形 |
|
"^" | 上三角 |
|
"v" | 下三角 |
|
">" | 右三角 |
|
"<" | 左三角 |
|
"pentagram" | 五角形 |
|
"hexagram" | 六角形 |
|
"none" | 无标记 | 不适用 |
输出参量
提示
与
plot函数不同，line函数在绘制之前不会调用newplot，也不使用图窗或坐标区的NextPlot属性值。它只向当前坐标区添加线条，而不删除其他图形对象或重置坐标区属性。但是，某些坐标区属性（如坐标轴范围）可能会更新以适应线条。
扩展功能
版本历史记录
在 R2006a 之前推出现在 SeriesIndex 属性可用于使用 line 函数创建的线条，这些线条与大多数其他绘图一样，循环使用相同的颜色（和可选的线型）。
当您指定 x、y 和可选的 z 参量时，默认颜色更改仅适用于您创建的线条。如果使用仅使用名称-值参量的语法创建线条，则绘图的外观与在以前版本中相同。
例如，用 x 和 y 输入参量创建两个线条。在 R2023b 中，第一个线条为蓝色，第二个线条为红橙色。在 R2023b 之前，两个线条均为蓝色。
line1 = line([0 1],[0 1]); line2 = line([0 1],[1 2]);
要保留以前版本的行为，请将这些线条的 SeriesIndex 属性设置为 1。您可以在调用 line 函数时使用名称-值参量设置该属性，也可以稍后使用圆点表示法设置 Line 对象的属性。
% Use a name-value argument line1 = line([0 1],[0 1],SeriesIndex=1); % Use dot notation line2 = line([0 1],[1 2]); line2.SeriesIndex = 1;
