rectangle
创建带有尖角或圆角的矩形
语法
说明
rectangle('Position', 在二维坐标中创建一个矩形。将 pos)pos 指定为 [x y w h] 形式的四元素向量（以数据单位表示）。x 和 y 元素确定位置，w 和 h 元素确定大小。函数在当前坐标区中绘制图形，而不清空坐标区中的现有内容。
rectangle(___, 使用一个或多个名称-值对组参量指定矩形的属性。例如，Name,Value)'FaceColor','red' 指定红色填充颜色。您可以使用上述语法中的任意输入参量组合指定矩形的属性。
rectangle( 将在由 ax,___)ax 指定的坐标区中，而不是在当前坐标区 (gca) 中创建矩形。选项 ax 可以位于上述语法中的任何输入参量组合之前。
r = rectangle(___)r 修改其属性。有关属性列表，请参阅 Rectangle 属性。可以使用任意上述语法返回一个输出参量。
示例
绘制一个左下角位于点 (1,2) 位置处的矩形。将矩形的宽度设置为 5 个单位，将高度设置为 6 个单位。然后，更改坐标轴范围。
rectangle('Position',[1 2 5 6])
axis([0 10 0 10])
绘制一个矩形，其左下角位于点 (0,0) 位置处，右上角位于点 (2,4) 位置处。通过将曲率指定为标量值 0.2 创建具有圆角的矩形。要沿 x 轴和 y 轴使用长度相等的数据单位，请使用 axis equal。
figure rectangle('Position',[0 0 2 4],'Curvature',0.2) axis equal
通过将曲率指定为标量值 1，添加最短边完全弯曲的另一个矩形。
rectangle('Position',[3 0 2 4],'Curvature',1)
添加第三个矩形，对其水平边和垂直边使用不同的曲率。使用水平曲率 0.5 以使每个水平边具有 50% 的弯曲。使用垂直曲率 1 以使两个垂直边完全弯曲。
rectangle('Position',[6 0 2 4],'Curvature',[0.5,1])
通过将 Curvature 属性设置为 [1 1] 绘制一个圆。绘制一个圆形，用它来填充点 (2,4) 与 (4,6) 之间的圆形区域。Position 属性定义包含该圆形的最小矩形。
pos = [2 4 2 2]; rectangle('Position',pos,'Curvature',[1 1]) axis equal
使用相同的位置值绘制一个红色的矩形，以显示圆形如何填充矩形区域。
rectangle('Position',pos,'EdgeColor','r')
绘制一个矩形并指定其填充颜色、轮廓颜色和轮廓宽度。
rectangle('Position',[1,2,5,10],'FaceColor',[0 .5 .5],'EdgeColor','b',... 'LineWidth',3)
将矩形添加到当前坐标区，并返回矩形对象 r。
r = rectangle('Position',[0 0 1 1]')
r =
Rectangle with properties:
FaceColor: 'none'
EdgeColor: [0.1294 0.1294 0.1294]
LineWidth: 0.5000
LineStyle: '-'
Curvature: [0 0]
Position: [0 0 1 1]
Show all properties
在创建矩形后使用 r 对其进行修改。更改填充颜色、轮廓颜色和轮廓宽度。
r.FaceColor = [0 .5 .5];
r.EdgeColor = 'b';
r.LineWidth = 3;
输入参数
名称-值参数
以 Name1=Value1,...,NameN=ValueN 的形式指定可选参量对组，其中 Name 是参量名称，Value 是对应的值。名称-值参量必须出现在其他参量之后，但对各个参量对组的顺序没有要求。
在 R2021a 之前，使用逗号分隔每个名称和值，并用引号将 Name 引起来。
示例: rectangle('Position',[0 0 1 1],'EdgeColor','k','FaceColor',[0 .5 .5])
填充颜色，指定为 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)) 获取十六进制颜色代码。
示例: "blue"
示例: [0 0 1]
示例: "#0000FF"
轮廓颜色，指定为 RGB 三元组、十六进制颜色代码、颜色名称或短名称。默认的 RGB 三元组值 [0 0 0] 与黑色对应。
对于自定义颜色，请指定 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)) 获取十六进制颜色代码。
示例: 'blue'
示例: [0 0 1]
示例: '#0000FF'
线条宽度，指定为以磅为单位的正值。
示例: 0.75
线型，指定为下表中列出的选项之一。
| 线型 | 描述 | 表示的线条 |
|---|---|---|
"-" | 实线 |
|
"--" | 虚线 |
|
":" | 点线 |
|
"-." | 点划线 |
|
"none" | 无线条 | 无线条 |
版本历史记录
在 R2006a 之前推出
