Main Content

line

创建基本线条

说明

示例

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

示例

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

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

示例

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

line(ax,___) 将在由 ax 指定的笛卡尔坐标区、极坐标区或地理坐标区中创建线条,而不是在当前坐标区 (gca) 中创建线条。指定 ax 作为第一个输入参量。

示例

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

示例

全部折叠

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

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

Figure contains an axes object. The axes object contains an object of type line.

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

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

Figure contains an axes object. The axes object contains 2 objects of type line.

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

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

Figure contains an axes object. The axes object contains an object of type line.

以向量形式创建 xy。然后通过将数据指定为名称-值对组参量来调用 line 函数的低级版本。以这种方式调用该函数时,生成的线条为黑色。

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

Figure contains an axes object. The axes object contains an object of type line.

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

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

Figure contains an axes object. The axes object contains an object of type line.

首先,绘制一条从点 (3,15) 到 (2,12) 的线条并返回 Line 对象。然后将线条更改为绿色虚线。使用圆点表示法设置属性。

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

Figure contains an axes object. The axes object contains an object of type line.

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

Figure contains an axes object. The axes object contains an object of type line.

输入参数

全部折叠

第一个坐标,指定为向量或矩阵。仅笛卡尔坐标区支持矩阵输入。

第一个坐标的解释取决于坐标区的类型。对于笛卡尔坐标区,第一个坐标是以数据单位表示的 x 轴上的位置。

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

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

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

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

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

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

对于极坐标区,第一个坐标是以弧度表示的极坐标角 θ。对于地理坐标区,第一个坐标是纬度(以度为单位)。要在这些类型的坐标区中绘制线条,xy 必须大小相同。

示例: 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 函数将绘制每一列对向量的图。

对于极坐标区,第二个坐标是以数据单位表示的半径。对于地理坐标区,第二个坐标是经度(以度为单位)。要在这些类型的坐标区中绘制线条,xy 必须大小相同。

示例: y = sin(x)

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

第三个坐标,指定为向量或矩阵。仅笛卡尔坐标区支持矩阵输入。

第三个坐标的解释取决于坐标区的类型。对于笛卡尔坐标区,第三个坐标是以数据单位表示的 z 轴上的位置。

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

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

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

对于极坐标区和地理坐标区,第三个坐标会影响坐标区中二维线条的分层。要在这些类型的坐标区中使用第三个坐标,xyz 的大小必须相同。

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

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

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

名称-值参数

将可选的参量对组指定为 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]

  • 十六进制颜色代码是字符串标量或字符向量,以井号 (#) 开头,后跟三个或六个十六进制数字,范围可以是 0F。这些值不区分大小写。因此,颜色代码 "#FF8800""#ff8800""#F80""#f80" 是等效的。

此外,还可以按名称指定一些常见的颜色。下表列出了命名颜色选项、等效 RGB 三元组和十六进制颜色代码。

颜色名称短名称RGB 三元组十六进制颜色代码外观
"red""r"[1 0 0]"#FF0000"

Sample of the color red

"green""g"[0 1 0]"#00FF00"

Sample of the color green

"blue""b"[0 0 1]"#0000FF"

Sample of the color blue

"cyan" "c"[0 1 1]"#00FFFF"

Sample of the color cyan

"magenta""m"[1 0 1]"#FF00FF"

Sample of the color magenta

"yellow""y"[1 1 0]"#FFFF00"

Sample of the color yellow

"black""k"[0 0 0]"#000000"

Sample of the color black

"white""w"[1 1 1]"#FFFFFF"

Sample of the color white

"none"不适用不适用不适用无颜色

以下是 MATLAB® 在许多类型的绘图中使用的默认颜色的 RGB 三元组和十六进制颜色代码。

RGB 三元组十六进制颜色代码外观
[0 0.4470 0.7410]"#0072BD"

Sample of RGB triplet [0 0.4470 0.7410], which appears as dark blue

[0.8500 0.3250 0.0980]"#D95319"

Sample of RGB triplet [0.8500 0.3250 0.0980], which appears as dark orange

[0.9290 0.6940 0.1250]"#EDB120"

Sample of RGB triplet [0.9290 0.6940 0.1250], which appears as dark yellow

[0.4940 0.1840 0.5560]"#7E2F8E"

Sample of RGB triplet [0.4940 0.1840 0.5560], which appears as dark purple

[0.4660 0.6740 0.1880]"#77AC30"

Sample of RGB triplet [0.4660 0.6740 0.1880], which appears as medium green

[0.3010 0.7450 0.9330]"#4DBEEE"

Sample of RGB triplet [0.3010 0.7450 0.9330], which appears as light blue

[0.6350 0.0780 0.1840]"#A2142F"

Sample of RGB triplet [0.6350 0.0780 0.1840], which appears as dark red

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

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

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

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

线型描述表示的线条
"-"实线

Sample of solid line

"--"虚线

Sample of dashed line

":"点线

Sample of dotted line

"-."点划线

Sample of dash-dotted line, with alternating dashes and dots

"none"无线条无线条

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

线宽不能小于像素的宽度。如果将线宽设置为小于系统上像素宽度的值,则线条显示为一个像素的宽度。

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

标记描述生成的标记
"o"圆圈

Sample of circle marker

"+"加号

Sample of plus sign marker

"*"星号

Sample of asterisk marker

"."

Sample of point marker

"x"叉号

Sample of cross marker

"_"水平线条

Sample of horizontal line marker

"|"垂直线条

Sample of vertical line marker

"square"方形

Sample of square marker

"diamond"菱形

Sample of diamond marker

"^"上三角

Sample of upward-pointing triangle marker

"v"下三角

Sample of downward-pointing triangle marker

">"右三角

Sample of right-pointing triangle marker

"<"左三角

Sample of left-pointing triangle marker

"pentagram"五角形

Sample of pentagram marker

"hexagram"六角形

Sample of hexagram marker

"none"无标记不适用

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

输出参量

全部折叠

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

提示

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

扩展功能

版本历史记录

在 R2006a 之前推出

全部展开