主要内容

补丁

绘制一个或多个填充多边形区域

在页面中全部折叠

语法

补丁(X, Y, C)
补丁(X, Y, Z, C)
补丁(“XData”X“YData”,Y)
补丁(“XData”X“YData”,Y, ZData, Z)
补丁('脸' F“顶点”,V)
补丁(S)
补丁(___、名称、值)
补丁(ax,___）
P = patch(___）

描述

例子

补丁(X，Y，C）的元素绘制一个或多个填充多边形区域X而且Y作为每个顶点的坐标。补丁按指定的顺序连接顶点。要创建一个多边形，请指定X而且Y向量。要创建多个多边形，请指定X而且Y作为矩阵，其中每列对应一个多边形。C确定多边形的颜色。

补丁(X，Y，Z，C）在3-D坐标中创建多边形X，Y,Z．要在3-D视图中查看多边形，请使用视图(3)命令。C确定多边形的颜色。

补丁(“XData”,X“YData”,Y）类似于补丁(X, Y, C)，只不过您不必为二维坐标指定颜色数据。

补丁(“XData”,X“YData”,Y“ZData”,Z）类似于补丁(X, Y, Z, C)，只不过您不必为3d坐标指定颜色数据。

请注意

方法指定数据时“XData”，“YData”,或“ZData”名称-值参数时，数据必须具有数值类型，例如双，单，或整数类型。指定分类，datetime,或持续时间数据，使用x，y,z参数。

例子

补丁(“脸”,F“顶点”,V）创建一个或多个多边形V指定顶点值和F定义要连接的顶点。当有很多多边形时，只指定唯一的顶点及其连接矩阵可以减少数据的大小。中每一行指定一个顶点V．要创建一个多边形，请指定F作为一个向量。要创建多个多边形，请指定F作为一个矩阵，每个多边形有一行。每个面不必有相同数量的顶点。要指定不同数量的顶点，请使用padF与南值。

例子

补丁(年代）使用结构创建一个或多个多边形年代．结构字段对应补丁属性名称，字段值对应属性值。例如,年代可以包含以下字段脸而且顶点．

例子

补丁(___，名称,值）创建多边形并使用名称-值对参数指定一个或多个补丁属性。补丁是包含创建的所有多边形的数据的对象。您可以使用前面语法中的任何输入参数组合来指定补丁属性。例如,“线宽”,2将所有多边形的轮廓宽度设置为2点。

补丁(斧头，___）在指定的坐标轴上创建补丁斧头而不是在当前的坐标轴(gca)．的选项斧头可以放在前面语法中任何输入参数组合的前面。

p=补丁(___）返回包含所有多边形数据的补丁对象。使用p查询和修改补丁对象创建后的属性。有关属性和描述的列表，请参见块的属性．

例子

全部折叠

打开实时脚本

通过指定(来创建单个多边形x, y)每个顶点的坐标。然后，向图中添加另外两个多边形。

创建一个顶点为的红色正方形(0,0)，(1,0)，(1,1),(0,1)．指定x随着x-坐标的顶点和y随着y坐标。补丁自动连接最后一个(x, y与第一个协调(x, y)坐标。

X = [0 1 1 0];Y = [0 0 1 1];补丁(x, y,“红色”）

图中包含一个axes对象。axes对象包含一个patch类型的对象。

通过指定创建两个多边形x而且y作为两列矩阵。每一列定义一个多边形的坐标。补丁将多边形添加到当前坐标轴，但不清除坐标轴。

X2 = [2 5;2 5;8 8];Y2 = [4 0;8 2;4 0];补丁(x2, y2,“绿色”）

图中包含一个axes对象。axis对象包含两个patch类型的对象。

打开实时脚本

定义X作为向量的分类值，并定义Y作为持续时间值的向量。的补丁函数使用已排序的类别列表，因此x-axis可能会以不同于您预期的顺序显示它们。要指定顺序，请调用reordercats函数。然后，创建一个红色补丁来可视化数据。

X =绝对的({“冻结”，“冷”，“温暖”，“热”，“沸腾”，“沸腾”，“冻结”});X = reordercats(X，{“冻结”，“冷”，“温暖”，“热”，“沸腾”});Y = minutes([0 15 20 47 50 0 0]);补丁(X, Y,“红色”）

图中包含一个axes对象。axes对象包含一个patch类型的对象。

打开实时脚本

通过指定每个唯一顶点的坐标和定义如何连接它们的矩阵来创建单个多边形。然后，向图中添加另外两个多边形。

创建一个红色正方形和角在(0,0)，(1,0)，(1,1),(0,1)．指定v每一行都定义了(x, y)为一个顶点的坐标。然后,指定f作为连接的顶点。属性来设置颜色FaceColor财产。

V = [0 0;1 0;1 1;0 1];F = [1 2 3 4];补丁(“脸”f“顶点”v,“FaceColor”，“红色”）

图中包含一个axes对象。axes对象包含一个patch类型的对象。

通过指定创建两个多边形f作为一个两行矩阵。每一行定义一个补丁的脸。

V2 = [2 4;2 8;8 4;5 0;5 - 2;8 0];F2 = [1 2 3;4 5 6];补丁(“脸”f2,“顶点”v2,“FaceColor”，“绿色”）

图中包含一个axes对象。axis对象包含两个patch类型的对象。

打开实时脚本

创建两个多边形，并为每个多边形面使用不同的颜色。使用颜色条来显示颜色如何映射到色彩图中。

使用矩阵创建多边形x而且y．指定c作为有两个元素的列向量，因为有两个多边形面，并添加一个颜色条。

X = [2 5;2 5;8 8];Y = [4 0;8 2;4 0];C = [0;1);图补丁(x,y,c)色彩条

图中包含一个axes对象。axes对象包含一个patch类型的对象。

或者，在使用时也可以得到相同的结果f而且v代替。当您创建多边形时，设置FaceVertexCData到一个有两个元素的列向量，因为有两个多边形面。集FaceColor来“平”．

V = [2 4;2 8;8 4;5 0;5 - 2;8 0];F = [1 2 3;4 5 6];Col = [0;1); figure patch(“脸”f“顶点”v,“FaceVertexCData”上校,“FaceColor”，“平”）;colorbar

图中包含一个axes对象。axes对象包含一个patch类型的对象。

打开实时脚本

通过在每个多边形顶点指定一种颜色来跨多边形面插值颜色，并使用颜色条来显示颜色如何映射到色彩图中。

使用矩阵创建多边形x而且y．指定c矩阵的大小和x而且y每个顶点定义一个颜色，并添加一个颜色条。

X = [2 5;2 5;8 8];Y = [4 0;8 2;4 0];C = [0 3;6 4;4 6];图补丁(x,y,c)色彩条

图中包含一个axes对象。axes对象包含一个patch类型的对象。

或者，您也可以使用f而且v代替。当您创建多边形时，设置FaceVertexCData到每个顶点和集合都有一个值的列向量FaceColor来的插值函数．

V = [2 4;2 8;8 4;5 0;5 - 2;8 0];F = [1 2 3;4 5 6];Col = [0;6; 4; 3; 4; 6]; figure patch(“脸”f“顶点”v,“FaceVertexCData”上校,“FaceColor”，的插值函数）;colorbar

图中包含一个axes对象。axes对象包含一个patch类型的对象。

打开实时脚本

创建一个绿色边的多边形，不显示面。然后，为每条边创建另一个不同颜色的多边形。

V = [0 0;1 0;1 1];F = [1 2 3];图块(“脸”f“顶点”v,.．.“EdgeColor”，“绿色”，“FaceColor”，“没有”，“线宽”2);

图中包含一个axes对象。axes对象包含一个patch类型的对象。

通过为每个顶点和设置指定颜色，为每条边使用不同的颜色EdgeColor来“平”．

V = [2 0;3 0;3 1];F = [1 2 3];C = [1 0 0;%的红色0 1 0;%绿色0 0 1];%的蓝色补丁(“脸”f“顶点”v,“FaceVertexCData”c.．.“EdgeColor”，“平”，“FaceColor”，“没有”，“线宽”2);

图中包含一个axes对象。axis对象包含两个patch类型的对象。

打开实时脚本

使用一个结构创建两个多边形。首先，创建一个具有与补丁属性名称匹配的字段名的结构。然后，使用该结构创建多边形。

清晰的年代S.Vertices = [2 4;2 8;8 4;5 0;5 - 2;8 0];S.Faces = [1 2 3;4 5 6];S.FaceVertexCData = [0;1); S.FaceColor =“平”；S.EdgeColor =“红色”；S.LineWidth = 2;图块(年代)

图中包含一个axes对象。axes对象包含一个patch类型的对象。

打开实时脚本

创建两个半透明多边形FaceAlpha属性设置为之间的值0而且1．

V1 = [2 4;2 8;8 4];F1 = [1 2 3];图块(“脸”f1,“顶点”, v1,“FaceColor”，“红色”，“FaceAlpha”3);V2 = [2 4;2 8;8 8];F2 = [1 2 3];补丁(“脸”f2,“顶点”v2,“FaceColor”，“蓝”，“FaceAlpha”5);

图中包含一个axes对象。axis对象包含两个patch类型的对象。

打开实时脚本

在每个顶点上用标记创建一条多色线。插值颜色并使用颜色条来显示值如何映射到色彩图。

创建数据。设置的最后一个条目y来南这补丁创建一条直线而不是一个闭合多边形。属性为每个顶点定义颜色y值。中的值c映射到colormap中的颜色。

X = linspace(1,10,15);Y = sin(x);y(end) = NaN;C = y;

创建直线。在每个顶点上显示标记并设置EdgeColor来的插值函数在顶点之间插入颜色。添加一个颜色条。

图块(x, y, c,“EdgeColor”，的插值函数，“标记”，“o”，“MarkerFaceColor”，“平”）;colorbar;

图中包含一个axes对象。axes对象包含一个patch类型的对象。

输入参数

全部折叠

x-坐标的顶点，指定在以下形式之一:

  • 矢量-创建一个多边形。

  • 矩阵-创建n多边形与米每个顶点，其中[m,n] = size(X)．矩阵中的每一列对应一个多边形。

如果数据没有定义闭合多边形，那么补丁关闭多边形。如果单个多边形的边缘彼此相交，生成的多边形可能是部分填充的。在这种情况下，最好将补丁对象划分为更小的多边形。

当你指定X,补丁函数设置XData属性设置为相同的值。patch对象自动计算面和顶点数据并设置脸而且顶点属性设置为适当的值。

数据类型:单|双|int8|int16|int32|int64|uint8|uint16|uint32|uint64|分类|datetime|持续时间

y-坐标的顶点，指定在以下形式之一:

  • 矢量-创建一个多边形。

  • 矩阵-创建n多边形与米每个顶点，其中[m,n] = size(Y)．矩阵中的每一列对应一个多边形。

如果数据没有定义闭合多边形，那么补丁关闭多边形。如果单个多边形的边缘彼此相交，生成的多边形可能是部分填充的。在这种情况下，最好将补丁对象划分为更小的多边形。

当你指定Y,补丁函数设置YData属性设置为相同的值。patch对象自动计算面和顶点数据并设置脸而且顶点属性设置为适当的值。

数据类型:单|双|int8|int16|int32|int64|uint8|uint16|uint32|uint64|分类|datetime|持续时间

z-坐标的顶点，指定在以下形式之一:

  • 矢量-创建一个多边形。

  • 矩阵-创建米多边形与n每个顶点，其中[m,n] = size(Z)．矩阵中的每一列对应一个多边形。

当你指定Z,补丁函数设置ZData属性设置为相同的值。patch对象自动计算面和顶点数据并设置脸而且顶点属性设置为适当的值。

数据类型:单|双|int8|int16|int32|int64|uint8|uint16|uint32|uint64|分类|datetime|持续时间

多边形颜色，指定为标量、向量、矩阵或颜色名称。输入的格式决定了所有多边形的颜色是相同的、每个面有一种颜色还是内插的面颜色。

预期的效果 使用这些格式中的一种 结果
所有脸部都使用单一颜色

  • 例如，颜色名称，“r”为红色。

  • 比如RGB三联体，[0 .5 .5]．

  • 标量值，例如，2．的CDataMapping属性确定值如何映射到色彩图。

示例请参见指定坐标．

由两个红色三角形面组成的一块

  • 设置FaceColor属性设置为指定的颜色。
每张脸一种颜色

  • n-by-1的colormap颜色向量，其中n是面的数量。的CDataMapping属性确定值如何映射到色彩图中。

  • n——- - - - - -1——- - - - - -3.RGB值数组。数组的第一页定义颜色的红色组件，第二页定义蓝色组件，第三页定义绿色组件。

示例请参见不同的多边形面部颜色．

由一个蓝色和一个黄色三角形面组成的补丁
脸部颜色插值

  • 米——- - - - - -n色彩图值的矩阵，其中[m,n] = size(X)．每个顶点指定一种颜色。

  • 米——- - - - - -n——- - - - - -3.RGB值数组。

示例请参见插值多边形面部颜色．

由两个三角形面组成的一块。每个面都用插值颜色的渐变填充

RGB三元组是一个三元素行向量，其元素指定颜色的红、绿、蓝成分的强度。强度必须在这个范围内[0, 1]；例如,[0.4 0.6 0.7]．或者，您也可以通过名称指定一些常用颜色。这个表列出了长颜色和短颜色名称选项以及等效的RGB三元组值。

选项 描述 等效RGB三元组
“红色”或“r” 红色的 [10 0 0]
“绿色”或‘g’ 绿色 [0 1 0]
“蓝”或“b” 蓝色的 [0 0 1]
“黄色”或“y” 黄色的 [1 1 0]
“红色”或“米” 品红色的 [10 0 1]
“青色”或“c” 青色 [0 1 1]
“白色”或' w ' 白色 [1,1 1]
“黑”或“k” 黑色的 [0 0 0]

多边形顶点，以以下形式之一指定:

  • 双列矩阵——每一行包含(x，y)一个顶点的坐标。

  • 三列矩阵——每一行包含(x，y，Z)一个顶点的坐标。

只指定唯一的顶点。中定义面定义时，可以多次引用一个顶点F．

当你指定V,补丁函数设置顶点属性设置为相同的值。补丁对象自动计算坐标数据并设置XData，YData,ZData到适当的值。

数据类型:单|双|int8|int16|int32|int64|uint8|uint16|uint32|uint64

脸的定义，以下列形式之一指定:

  • 行向量-创建单个多边形。

  • 矩阵-创建多个多边形，其中每一行对应一个多边形。

例如，此代码在中定义了三个顶点V并通过连接顶点1到2，顶点2到3，顶点3到1来创建一个多边形。

V = [1 1;2 1;2 2];F = [1 2 3 1];补丁(“脸”F“顶点”, V)

当你指定F,补丁函数设置脸属性设置为相同的值。补丁对象自动计算坐标数据并设置XData，YData,ZData到适当的值。

数据类型:单|双|int8|int16|int32|int64|uint8|uint16|uint32|uint64

补丁定义，指定为一个结构，其中字段对应补丁属性名称，字段值对应补丁属性值。

坐标轴对象。如果没有指定axis对象，则补丁使用当前轴。

名称-值参数

指定可选参数对为Name1 = Value1,…,以=家,在那里的名字参数名称和价值对应的值。名-值参数必须出现在其他参数之后，但对的顺序并不重要。

在R2021a之前，名称和值之间用逗号隔开，并括起来的名字在报价。

例子:补丁(x, y, c, FaceAlpha, 5,“线型”,“:”)创建带有虚线边缘的半透明多边形。

这里列出的属性只是补丁属性的一个子集。有关完整列表，请参见块的属性．

脸部颜色，指定为的插值函数，“平”RGB三元组、十六进制颜色编码、颜色名称或短名称。

要为每个面创建不同的颜色，请指定CData或FaceVertexCData属性作为每个面包含一种颜色或每个顶点包含一种颜色的数组。颜色可以从每个面周围顶点的颜色中插值出来，也可以是统一的。对于内插颜色，将此属性指定为的插值函数．对于统一的颜色，将此属性指定为“平”．如果你指定“平”每个顶点都有不同的颜色，你指定的第一个顶点的颜色决定了脸的颜色。

若要为所有面指定单一颜色，请将此属性指定为RGB三元组、十六进制颜色编码、颜色名称或短名称。

  • RGB三元组是一个三元素行向量，其元素指定颜色的红、绿、蓝成分的强度。强度必须在这个范围内[0, 1]；例如,[0.4 0.6 0.7]．

  • 十六进制颜色码是字符向量或以散列符号(＃)之后是三个或六个十六进制数字，取值范围从0来F．这些值不区分大小写。因此，颜色编码“# FF8800”，“# ff8800”，“# F80”,“# f80”是等价的。

颜色名称 短名称 RGB值 十六进制色码 外观
“红色” “r” [10 0 0] “# FF0000”

样品的颜色为红色
“绿色” “g” [0 1 0] “# 00 ff00”

样品的颜色为绿色
“蓝色” “b” [0 0 1] “# 0000 ff”

蓝色的样品
“青色” “c” [0 1 1] “# 00飞行符”

样品的颜色为青色
“红色” “m” [10 0 1] “#”就

洋红色的样品
“黄色” “y” [1 1 0] “# FFFF00”

样品的颜色为黄色
“黑色” “k” [0 0 0] “000000 #”

样品的颜色为黑色
“白色” “w” [1,1 1] “# FFFFFF”

样品的颜色为白色
“没有” 不适用 不适用 不适用 没有颜色

这里是RGB三组和十六进制颜色编码的默认颜色MATLAB®在许多类型的情节中使用。

RGB值 十六进制色码 外观
[0 0.4470 0.7410] “# 0072 bd”

RGB三联体样本[0 0.4470 0.7410]，显示为深蓝色
[0.8500 0.3250 0.0980] “# D95319”

RGB三联体样本[0.8500 0.3250 0.0980]，呈暗橙色
[0.9290 0.6940 0.1250] “# EDB120”

RGB三联体样品[0.9290 0.6940 0.1250]，呈暗黄色
[0.4940 0.1840 0.5560] “# 7 e2f8e”

RGB三联体样本[0.4940 0.1840 0.5560]，呈深紫色
[0.4660 0.6740 0.1880] “# 77 ac30”

RGB三联体样本[0.4660 0.6740 0.1880]，呈现中绿色
[0.3010 0.7450 0.9330] “# 4 dbeee”

RGB三联体样本[0.3010 0.7450 0.9330]，显示为浅蓝色
[0.6350 0.0780 0.1840] “# A2142F”

RGB三联体样品[0.6350 0.0780 0.1840]，呈暗红色

脸部透明度，指定为以下值之一:

  • 范围内的标量[0, 1]-使用统一的透明度在所有的脸。的值1完全不透明0是完全透明的。的透明度值FaceVertexAlphaData财产。

  • “平”的值为每个面使用不同的透明度FaceVertexAlphaData财产。首先，您必须指定FaceVertexAlphaData属性作为每个面或顶点包含一个透明度值的向量。第一个顶点的透明度值决定了整个面的透明度。

  • 的插值函数-使用插值的透明度为每个面基于的值FaceVertexAlphaData财产。首先，您必须指定FaceVertexAlphaData属性作为每个顶点包含一个透明度值的向量。通过在顶点处插入值，每个面的透明度都不同。

边缘颜色，指定为该表中的值之一。默认的边缘颜色是黑色，值为[0 0 0]．如果多个多边形共享一条边，则绘制的第一个多边形控制显示的边颜色。

价值 描述 结果

RGB三元组、十六进制颜色编码或颜色名称

所有的边都是单色的。有关详细信息，请参见下表。

带红边的矩形补丁
“平”

每条边都有不同的颜色。使用顶点颜色来设置它后面的边的颜色。您必须首先指定CData或FaceVertexCData作为每个顶点包含一种颜色的数组。边缘颜色取决于指定顶点的顺序。

矩形补丁，其中右上顶点为中绿色，上边缘为中绿色，左上顶点为黄色，左边缘为黄色，左下顶点为深蓝色，下边缘为深蓝色，右下顶点为浅蓝色，右边缘为浅蓝色
的插值函数

插值的边缘颜色。您必须首先指定CData或FaceVertexCData作为每个顶点包含一种颜色的数组。通过对两个边界顶点处的值进行线性插值来确定边缘颜色。

带有内插边缘颜色的矩形补丁。最上面的两个顶点分别是中绿色和黄色。底部的两个顶点分别是深蓝色和浅蓝色。每条边的颜色都是边界顶点上颜色的渐变。
“没有” 没有显示边。

没有显示边。

RGB三联色和十六进制色码用于指定自定义颜色。

  • RGB三元组是一个三元素行向量，其元素指定颜色的红、绿、蓝成分的强度。强度必须在这个范围内[0, 1]；例如,[0.4 0.6 0.7]．

  • 十六进制颜色码是字符向量或以散列符号(＃)之后是三个或六个十六进制数字，取值范围从0来F．这些值不区分大小写。因此，颜色编码“# FF8800”，“# ff8800”，“# F80”,“# f80”是等价的。

或者，您也可以通过名称指定一些常用颜色。该表列出了已命名的颜色选项、等效的RGB三组和十六进制颜色编码。

颜色名称 短名称 RGB值 十六进制色码 外观
“红色” “r” [10 0 0] “# FF0000”

样品的颜色为红色
“绿色” “g” [0 1 0] “# 00 ff00”

样品的颜色为绿色
“蓝色” “b” [0 0 1] “# 0000 ff”

蓝色的样品
“青色” “c” [0 1 1] “# 00飞行符”

样品的颜色为青色
“红色” “m” [10 0 1] “#”就

洋红色的样品
“黄色” “y” [1 1 0] “# FFFF00”

样品的颜色为黄色
“黑色” “k” [0 0 0] “000000 #”

样品的颜色为黑色
“白色” “w” [1,1 1] “# FFFFFF”

样品的颜色为白色

下面是MATLAB在许多类型的图中使用的默认颜色的RGB三组和十六进制颜色代码。

RGB值 十六进制色码 外观
[0 0.4470 0.7410] “# 0072 bd”

RGB三联体样本[0 0.4470 0.7410]，显示为深蓝色
[0.8500 0.3250 0.0980] “# D95319”

RGB三联体样本[0.8500 0.3250 0.0980]，呈暗橙色
[0.9290 0.6940 0.1250] “# EDB120”

RGB三联体样品[0.9290 0.6940 0.1250]，呈暗黄色
[0.4940 0.1840 0.5560] “# 7 e2f8e”

RGB三联体样本[0.4940 0.1840 0.5560]，呈深紫色
[0.4660 0.6740 0.1880] “# 77 ac30”

RGB三联体样本[0.4660 0.6740 0.1880]，呈现中绿色
[0.3010 0.7450 0.9330] “# 4 dbeee”

RGB三联体样本[0.3010 0.7450 0.9330]，显示为浅蓝色
[0.6350 0.0780 0.1840] “# A2142F”

RGB三联体样品[0.6350 0.0780 0.1840]，呈暗红色

线条样式，指定为该表中列出的选项之一。

线条样式 描述 产生的线
“-” 实线

实线样品
”——“ 虚线

虚线样本
”:“ 虚线

虚线样本
“-”。 Dash-dotted线

虚线-虚线样本，虚线和点交替使用
“没有” 没有线 没有线

输出参数

全部折叠

补丁对象，作为标量返回。每个补丁对象可以由一个或多个多边形组成。使用p查询或修改补丁对象创建后的属性。

扩展功能

版本历史

R2006a之前介绍过

另请参阅

功能

属性

主题

Baidu
map