本页对应的英文页面已更新,但尚未翻译。 若要查看最新内容,请点击此处访问英文页面。

line

创建基本线条

说明

示例

line(x,y) 使用向量 xy 中的数据在当前坐标区中绘制线条。如果 xy 中有一个是矩阵或两者都是矩阵,则 line 将绘制多个线条。与 plot 函数不同,line 会向当前坐标区添加线条,而不删除其他图形对象或重置坐标区属性。

示例

line(x,y,z) 在三维坐标中绘制线条。

line 使用默认属性设置绘制一条从点 (0,0)(1,1) 的线条。

示例

line('XData',x,'YData',y)line(x,y) 的低级版本。其行为与 line(x,y) 相同,只是该线条具有默认线条颜色。此外,您不能将 xy 设置为矩阵数据。

line('XData',x,'YData',y,'ZData',z)line(x,y,z) 的低级版本。其行为与 line(x,y,z) 相同,只是该线条具有默认线条颜色。此外,您不能将 xyz 设置为矩阵数据。

示例

line(___,Name,Value) 使用一个或多个名称-值对组参数修改线条的外观。例如,'LineWidth',3 将线宽设置为 3 磅。请在所有其他输入参数之后指定名称-值对组。

line(ax,___) 将在由 ax 指定的坐标区中,而不是在当前坐标区 (gca) 中创建线条。指定 ax 作为第一个输入参数。

示例

pl = line(___) 返回创建的所有基本 Line 对象。可在创建特定的 Line 对象后使用 pl 修改其属性。有关列表,请参阅 Line 属性

示例

全部折叠

以向量形式创建 xy。然后,绘制 yx 的图。

x = linspace(0,10);
y = sin(x);
line(x,y)

通过将 xy 指定为矩阵来绘制两个线条。使用 line 绘制 y 的列对 x 的列的单独线条。

x = linspace(0,10)';
y = [sin(x) cos(x)];
line(x,y)

通过指定 xyz 的值,在三维坐标中绘制线条。使用 view(3) 将坐标区更改为三维视图。

t = linspace(0,10*pi,200);
x = sin(t);
y = cos(t);
z = t;
line(x,y,z)
view(3)

以向量形式创建 xy。然后,使用 line 函数的低级版本绘制 yx 的图。

x = linspace(0,10);
y = sin(x);
line('XData',x,'YData',y)

在点 (1,2) 和 (9,12) 之间绘制一条红色虚线。将 ColorLineStyle 属性设置为名称-值对组。

x = [1 9];
y = [2 12];
line(x,y,'Color','red','LineStyle','--')

首先,绘制一条从点 (3,15) 到 (2,12) 的线条并返回 Line 对象。然后将线条更改为绿色虚线。

注意:从 R2014b 开始,您可以使用圆点表示法设置属性。如果您使用的是早期版本,请改用 set 函数。

x = [3 2];
y = [15 12];
pl = line(x,y);

pl.Color = 'green';
pl.LineStyle = '--';

输入参数

全部折叠

x 值,指定为向量或矩阵。

示例: x = linspace(0,10,25)

数据类型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | categorical | datetime | duration

y 值,指定为向量或矩阵:

  • 如果 xy 是具有相同长度的向量,则 line 将绘制单个线条。

  • 如果 xy 是具有相同大小的矩阵,则 line 将绘制多个线条。函数绘制 y 的列对 x 的图。

  • 如果 xy 的其中一个是向量,另一个是矩阵,则 line 将绘制多个线条。该向量的长度必须等于矩阵维度之一:

    • 如果向量长度等于矩阵行数,则 line 函数将绘制每一个矩阵列对向量的图。

    • 如果向量长度等于矩阵列数,则 line 函数将绘制每一个矩阵行对向量的图。

    • 如果矩阵为方阵,则 line 函数将绘制每一列对向量的图。

示例: y = sin(x)

数据类型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | categorical | datetime | duration

z 值,指定为向量或矩阵:

  • 如果 xyz 都是具有相同长度的向量,则 line 将绘制单个线条。

  • 如果 xyz 是具有相同大小的矩阵,则 line 将使用矩阵的列绘制多个线条。

  • 如果 xyz 中的一个或两个为向量,其余的是具有相同大小的矩阵,则 line 将绘制多个线条。该向量的长度必须等于矩阵维度之一。

示例: z = sin(x) + cos(y)

数据类型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | categorical | datetime | duration

目标坐标区,指定为 Axes 对象、PolarAxes 对象或 GeographicAxes 对象。如果未指定坐标区,line 函数将在当前坐标区中绘制线条。

名称-值对组参数

指定可选的、以逗号分隔的 Name,Value 对组参数。Name 为参数名称,Value 为对应的值。Name 必须放在引号中。您可采用任意顺序指定多个名称-值对组参数,如 Name1,Value1,...,NameN,ValueN 所示。

示例: line(x,y,'Color','red','LineWidth',3) 创建一个宽度为 3 磅的红色线条。

此处所列的属性只是一部分。有关完整列表,请参阅 Line 属性

线条颜色,指定为 RGB 三元组、十六进制颜色代码、颜色名称或短名称。

对于自定义颜色,请指定 RGB 三元组或十六进制颜色代码。

  • RGB 三元组是包含三个元素的行向量,其元素分别指定颜色中红、绿、蓝分量的强度。强度值必须位于 [0,1] 范围内,例如 [0.4 0.6 0.7]

  • 十六进制颜色代码是字符向量或字符串标量,以井号 (#) 开头,后跟三个或六个十六进制数字,范围可以是 0F。这些值不区分大小写。因此,颜色代码 '#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'不适用不适用不适用无颜色

以下是 MATLAB® 在许多类型的绘图中使用的默认颜色的 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'

示例: line(x,y,'Color','blue')

示例: line(x,y,'Color',[0.5 0.5 1])

示例: line(x,y,'Color','#D9A2E9')

线型,指定为下表中列出的选项之一。

线型说明表示的线条
'-'实线

'--'虚线

':'点线

'-.'点划线

'none'无线条无线条

线宽,指定为以磅为单位的正值,其中 1 磅 = 1/72 英寸。如果该线条具有标记,则线条宽度也会影响标记边。

标记符号,指定为下表中列出的值之一。默认情况下,对象不显示标记。指定标记符号可在每个数据点或顶点添加标记。

说明
'o'圆圈
'+'加号
'*'星号
'.'
'x'叉号
'square''s'方形
'diamond''d'菱形
'^'上三角
'v'下三角
'>'右三角
'<'左三角
'pentagram''p'五角星(五角形)
'hexagram''h'六角星(六角形)
'none'无标记

标记大小,指定为以磅为单位的正值,其中 1 磅 = 1/72 英寸。

输出参数

全部折叠

基本线条对象。可使用 pl 在创建线条后查询或修改其属性。有关列表,请参阅 Line 属性

提示

  • plot 函数不同,line 函数在绘制之前不会调用 newplot,也不使用图窗或坐标区的 NextPlot 属性值。它只向当前坐标区添加线条,而不删除其他图形对象或重置坐标区属性。但是,某些坐标区属性(如坐标轴范围)可能会更新以适应线条。

扩展功能

在 R2006a 之前推出