Main Content

本页翻译不是最新的。点击此处可查看最新英文版本。

rectangle

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

说明

示例

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

示例

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.

输入参数

全部折叠

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

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

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

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

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

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

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

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

示例: [0.5 0.6]

示例: 0.75

数据类型: double

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

名称-值参数

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

  • 十六进制颜色代码是字符向量或字符串标量,以井号 (#) 开头,后跟三个或六个十六进制数字,范围可以是 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

示例: 'blue'

示例: [0 0 1]

示例: '#0000FF'

轮廓颜色,指定为 RGB 三元组、十六进制颜色代码、颜色名称或短名称。默认的 RGB 三元组值 [0 0 0] 与黑色对应。

对于自定义颜色,请指定 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

示例: 'blue'

示例: [0 0 1]

示例: '#0000FF'

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

示例: 0.75

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

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

Sample of solid line

'--'虚线

Sample of dashed line

':'点线

Sample of dotted line

'-.'点划线

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

'none'无线条无线条

版本历史记录

在 R2006a 之前推出

另请参阅

函数

属性