目录

一.语法

1.输入参数

二.说明

三.示例

1.绘制矩形

2.用曲线边绘制矩形

3.绘制圆形

4.指定矩形轮廓和填充颜色

5.创建并修改矩形

---

rectangle函数是创建带有尖角或圆角的矩形。

一.语法

rectangle('Position',pos)

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

rectangle(___,Name,Value)

rectangle(ax,___)

r = rectangle(___)

1.输入参数

pos - 矩形的大小和位置

矩形的大小和位置，指定为 [x y w h] 形式的四元素向量。x 和 y 元素定义矩形的左下角的坐标。w 和 h 元素定义矩形的维度。所有值都以数据单位表示。

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

数据类型： double | single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

cur - 水平和垂直曲率的量

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

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

• 要使用不同的水平和垂直曲率，请指定 [horizontal vertical] 形式的二元素向量。horizontal 元素确定水平曲率，vertical 元素确定垂直曲率。请将值指定为 0（无曲率）和 1（最大曲率）之间的值。例如，值 [0 0] 创建一个具有方形边缘的矩形，值 [1 1] 创建一个椭圆。

• 要对水平和垂直边使用相同的曲率，请指定一个介于 0 和 1（包含这两个边界值）之间的标量值。较短的维度确定曲率的长度。

例如： [0.5 0.6]   0.75

数据类型： double

ax - 坐标区对象

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

名称-值对组参数

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

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

'FaceColor' - 填充颜色

填充颜色，指定为 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' - 轮廓颜色

轮廓颜色，指定为 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'

例如： 'blue'   [0 0 1]   '#0000FF'

'LineWidth' - 线条宽度

线条宽度，指定为以磅为单位的正值。

例如： 0.75

'LineStyle' - 线型

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

线型	说明	表示的线条
'-'	实线
'--'	虚线
':'	点线
'-.'	点划线
'none'	无线条	无线条

二.说明

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

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

rectangle(___,Name，Value) 使用一个或多个名称-值对组参数指定矩形的属性。例如，'FaceColor','red' 指定红色填充颜色。可以使用上述语法中的任意输入参数组合指定矩形的属性。

rectangle(ax,___) 将在由 ax 指定的坐标区中，而不是在当前坐标区 (gca) 中创建矩形。选项 ax 可以位于前面的语法中的任何输入参数组合之前。

r = rectangle(___) 返回矩形对象。在创建矩形后，可以使用 r 修改其属性。有关属性列表，参考Rectangle属性 。可以使用任意上述语法返回一个输出参数。

三.示例

1.绘制矩形

绘制一个左下角位于点 (1,2) 位置处的矩形。将矩形的宽度设置为 5 个单位，将高度设置为 6 个单位。然后，更改坐标轴范围。如下所示：

rectangle('Position',[1 2 5 6])
axis([0 10 0 10])

2.用曲线边绘制矩形

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

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

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

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

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

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

3.绘制圆形

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

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

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

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

4.指定矩形轮廓和填充颜色

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

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

5.创建并修改矩形

将矩形添加到当前坐标区，并返回矩形对象 r。如下所示：

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

r = 

  Rectangle - 属性:

    FaceColor: 'none'
    EdgeColor: [0 0 0]
    LineWidth: 0.5000
    LineStyle: '-'
    Curvature: [0 0]
     Position: [0 0 1 1]

  显示 所有属性

在创建矩形后使用 r 对其进行修改。更改填充颜色、轮廓颜色和轮廓宽度。

r = rectangle('Position',[0 0 1 1]')
r.FaceColor = [0 .5 .5];
r.EdgeColor = 'b';
r.LineWidth = 3;