area
填充区二维绘图
说明
area( 绘制 Y)Y 对一组隐式 x 坐标的图，并填充曲线之间的区域。
如果
Y是向量，则 x 坐标范围从 1 到length(Y)。如果
Y是矩阵，则 x 坐标的范围是从 1 到Y中的行数。
area(___, 使用一个或多个名称-值对组参量修改区域图的属性。这些属性适用于所有显示区域。例如，Name,Value)'LineStyle','--' 为绘图指定虚线线型。需要在上述任一语法中的所有参量之后指定名称-值对组。有关属性列表，请参阅 Area 属性。
示例
创建一个包含四个值的向量。在区域图中显示这些值。
y = [1 5 6 3]; area(y)
创建矩阵 Y。然后将 Y 中的值显示为一个区域图。由于 Y 包含三列，area 绘制三条曲线并将其堆叠。
Y = [1 5 3; 3 2 7; 1 5 3; 2 6 1]; area(Y)
将 x 定义为一个包含三个汽车经销商 ID 的向量。将 Y 定义为矩阵，其中包含每个车型售出的汽车数量。在区域图中显示矩阵中的值。然后添加轴标签和图例。
x = [10 11 12]; Y = [21.6 25.4; 70.8 66.1; 58.0 43.6]; area(x,Y) xlabel('Dealership ID') ylabel('Sales') legend({'Model A','Model B'})
沿 x 轴设置对应 x 中各值的刻度线。
ax = gca; % current axes
ax.XTick = x;
创建矩阵 Y。然后在基线值为 -4 的区域图中显示 Y 的值。area 填充由曲线和直线 y = -4 指定的区域。
Y = [1 5 3; 3 2 7; 1 5 3; 2 6 1]; basevalue = -4; area(Y,basevalue)
创建矩阵 Y。在使用点线样式的区域图中显示 Y 的值。
Y = [1 3 5; 3 2 7; 3 4 2]; area(Y,'LineStyle',':')
创建一个采用 'flow' 图块排列方式的分块图布局，以便坐标区填充布局中的可用空间。接下来，调用 nexttile 函数创建一个 Axes 对象，并返回它作为 ax1。通过将 ax1 传递给 area 函数来显示区域图。
tiledlayout('flow')
ax1 = nexttile;
Y1 = [3 6; 1 5; 7 2; 5 9];
area(ax1,Y1)
重复该过程以创建第二个 Axes 对象和第二个区域图。
ax2 = nexttile; Y2 = [4 2 11; 5 6 0; 1 7 2; 9 5 9]; area(ax2,Y2)
创建矩阵 Y。然后创建一个区域图，在调用 area 函数时指定输出参量。在本例中，area 返回包含三个 Area 对象的向量。每个对象对应于 Y 的一个不同列。
Y = [2 3 4; 6 1 5; 7 4 9]; a = area(Y);
将第二个区域改为绿色，并使用加粗的红边。
a(2).FaceColor = [0.2 0.6 0.5]; a(2).EdgeColor = [0.63 0.08 0.18]; a(2).LineWidth = 2;
显示一个具有三条曲线的区域图。
area([1 5 3; 3 2 7; 1 5 3; 2 6 1])
将色序设置为蓝色、紫色和灰色。
newcolors = [0 0.5 1; 0.5 0 1; 0.7 0.7 0.7]; colororder(newcolors)
输入参数
名称-值参数
以 Name1=Value1,...,NameN=ValueN 的形式指定可选参量对组，其中 Name 是参量名称，Value 是对应的值。名称-值参量必须出现在其他参量之后，但对各个参量对组的顺序没有要求。
在 R2021a 之前，使用逗号分隔每个名称和值，并用引号将 Name 引起来。
示例: area([1 2 3],'FaceColor','r') 为区域指定红色填充颜色。
注意
此处所列的属性只是一部分。有关完整列表，请参阅 Area 属性。
区域填充颜色，指定为 RGB 三元组、十六进制颜色代码、颜色名称或 'flat'。
从 R2017b 开始，默认值是来自坐标区的 ColorOrder 属性的一个 RGB 三元组。在以前的版本中，默认值为 'flat'，且颜色基于颜色图。
对于自定义颜色，请指定 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)) 获取十六进制颜色代码。
区域轮廓颜色，指定为 RGB 三元组、十六进制颜色代码、颜色名称或 'flat'。将此属性指定为 'flat' 将使用颜色图的颜色。
对于自定义颜色，请指定 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)) 获取十六进制颜色代码。
线型，指定为下表中列出的选项之一。
| 线型 | 描述 | 表示的线条 |
|---|---|---|
"-" | 实线 |
|
"--" | 虚线 |
|
":" | 点线 |
|
"-." | 点划线 |
|
"none" | 无线条 | 无线条 |
区域轮廓宽度，指定为数值标量（以磅为单位）。一磅等于 1/72 英寸。
示例: 1.5
数据类型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64
提示
area使用基于坐标区的ColorOrder属性的颜色。它循环使用所有颜色，如果绘制的填充区域数大于颜色数，它就会重复此循环。从 R2019b 开始，通过在坐标区中设置
ColorOrder属性，可以在绘图后更改颜色。您也可以调用colororder函数来更改图窗中所有坐标区的色序。
扩展功能
版本历史记录
在 R2006a 之前推出
