rectangle

创建带有尖角或圆角的矩形

全页折叠

语法

rectangle('Position',pos)

rectangle('Position',pos,'Curvature',cur)

rectangle(___,Name,Value)

rectangle(ax,___)

r = rectangle(___)

说明

示例

rectangle('Position',pos) 在二维坐标中创建一个矩形。将 pos 指定为 [x y w h] 形式的四元素向量（以数据单位表示）。x 和 y 元素确定位置，w 和 h 元素确定大小。函数在当前坐标区中绘制图形，而不清除坐标区中的现有内容。

示例

rectangle('Position',pos,'Curvature',cur) 为矩形的边添加曲率。要沿水平边和垂直边使用不同的曲率，请将 cur 指定为 [horizontal vertical] 形式的二元素向量。要沿所有边使用相同的曲率，请将 cur 指定为一个标量值。请将值指定为 0（无曲率）和 1（最大曲率）之间的值。使用 [1 1] 创建一个椭圆形或圆形。

示例

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])

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

用曲线边绘制矩形

打开实时脚本

绘制一个矩形，其左下角位于点 (0,0) 位置处，右上角位于点 (2,4) 位置处。通过将曲率指定为标量值 0.2 创建具有圆角的矩形。要沿 x 轴和 y 轴使用长度相等的数据单位，请使用 axis equal。

figure
rectangle('Position',[0 0 2 4],'Curvature',0.2)
axis equal

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

通过将曲率指定为标量值 1，添加最短边完全弯曲的另一个矩形。

rectangle('Position',[3 0 2 4],'Curvature',1)

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

添加第三个矩形，对其水平边和垂直边使用不同的曲率。使用水平曲率 0.5 以使每个水平边具有 50% 的弯曲。使用垂直曲率 1 以使两个垂直边完全弯曲。

rectangle('Position',[6 0 2 4],'Curvature',[0.5,1])

Figure contains an axes object. The axes object contains 3 objects of type rectangle.

绘制圆形

打开实时脚本

通过将 Curvature 属性设置为 [1 1] 绘制一个圆。绘制一个圆形，用它来填充点 (2,4) 与 (4,6) 之间的圆形区域。Position 属性定义包含该圆形的最小矩形。

pos = [2 4 2 2]; 
rectangle('Position',pos,'Curvature',[1 1])
axis equal

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

使用相同的位置值绘制一个红色的矩形，以显示圆形如何填充矩形区域。

rectangle('Position',pos,'EdgeColor','r')

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

指定矩形轮廓和填充颜色

打开实时脚本

绘制一个矩形并指定其填充颜色、轮廓颜色和轮廓宽度。

rectangle('Position',[1,2,5,10],'FaceColor',[0 .5 .5],'EdgeColor','b',...
    'LineWidth',3)

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

创建并修改矩形

打开实时脚本

将矩形添加到当前坐标区，并返回矩形对象 r。

r = rectangle('Position',[0 0 1 1]')

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

r = 
  Rectangle with properties:

    FaceColor: 'none'
    EdgeColor: [0 0 0]
    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;

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

输入参数

全部折叠

`pos` — 矩形的大小和位置
`[x y w h]` 形式的四元素向量

矩形的大小和位置，指定为 [x y w h] 形式的四元素向量。x 和 y 元素定义矩形的左下角的坐标。w 和 h 元素定义矩形的维度。

所有值都以数据单位表示。

示例： rectangle('Position',[0.5 0.5 0.3 0.4])

`cur` — 水平和垂直曲率的量
`[0 0]` （默认） | 二元素向量 | 标量

水平和垂直曲率的量，指定为二元素向量或标量值。使用此属性将矩形的形状从矩形改变为椭圆形。

水平曲率是沿上下边缘弯曲的宽度比率。垂直曲率是沿左右边缘弯曲的高度比率。

要使用不同的水平和垂直曲率，请指定 [horizontal vertical] 形式的二元素向量。horizontal 元素确定水平曲率，vertical 元素确定垂直曲率。请将值指定为 0（无曲率）和 1（最大曲率）之间的值。例如，值 [0 0] 创建一个具有方形边缘的矩形，值 [1 1] 创建一个椭圆。
要对水平和垂直边使用相同的曲率，请指定一个介于 0 和 1（包含这两个边界值）之间的标量值。较短的维度确定曲率的长度。

示例： [0.5 0.6]

示例： 0.75

数据类型： double

`ax` — 坐标区对象
坐标区对象

坐标区对象。如果您不指定坐标区对象，则 rectangle 使用当前坐标区。

名称-值参数

将可选的参数对组指定为 Name1=Value1,...,NameN=ValueN，其中 Name 是参数名称，Value 是对应的值。名称-值参数必须出现在其他参数之后，但参数对组的顺序无关紧要。

在 R2021a 之前，使用逗号分隔每个名称和值，并用引号将 Name 引起来。

示例： rectangle('Position',[0 0 1 1],'EdgeColor','k','FaceColor',[0 .5 .5])

`FaceColor` — 填充颜色
`'none'` （默认） | RGB 三元组 | 十六进制颜色代码 | `'r'` | `'g'` | `'b'` | ...

填充颜色，指定为 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"`	不适用	不适用	不适用	无颜色

以下是 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"`

示例： 'blue'

示例： [0 0 1]

示例： '#0000FF'

`EdgeColor` — 轮廓颜色
`[0 0 0]` （默认） | RGB 三元组 | 十六进制颜色代码 | `'r'` | `'g'` | `'b'` | ...

轮廓颜色，指定为 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"`	不适用	不适用	不适用	无颜色

以下是 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"`