主要内容

补丁

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

描述

例子

修补(XyC使用元素绘制一个或多个填充的多边形区域Xy作为每个顶点的坐标。补丁按照指定的顺序连接顶点。要创建一个多边形,请指定Xy作为载体。要创建多个多边形,请指定Xy矩阵,其中每一列对应一个多边形。C确定多边形颜色。

修补(XyZ.C使用。创建三维坐标中的多边形Xy,Z..要在三维视图中查看多边形,请使用查看(3)命令。C确定多边形颜色。

补丁(“XData”,X“YData”,y类似于补丁(x,y,c),除非您不必为2d坐标指定颜色数据。

补丁(“XData”,X“YData”,y,'zdata',Z.类似于补丁(X, Y, Z, C),除了您不必为三维坐标指定颜色数据。

笔记

属性指定数据时“XData”“YData”,或'Zdata'名称-值参数,数据必须具有数字类型,例如,或整数类型。指定分类datetime,或期间数据,使用Xy,Z.参数。

例子

补丁('面部',F“顶点”,V.创建一个或多个多边形在哪里V.指定顶点值F定义要连接的顶点。仅在有许多多边形时,仅指定唯一顶点及其连接矩阵可以减小数据的大小。每行指定一个顶点V..要创建一个多边形,请指定F作为一个向量。要创建多个多边形,请指定F每个多边形有一行的矩阵。每个面不需要有相同数量的顶点。要指定不同数量的顶点,填充F价值观。

例子

修补(S.使用结构创建一个或多个多边形S..结构字段对应于Patch属性名称和与属性值对应的字段值。例如,S.可以包含字段顶点

例子

修补(___名称,值创建多边形并使用名称-值对参数指定一个或多个补丁属性。补丁是包含所有创建多边形数据的对象。您可以使用前面语法中的任何输入参数组合指定补丁属性。例如,“线宽”,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,'红色的'

图包含轴。轴包含类型贴片的对象。

通过指定创建两个多边形Xy当两列矩阵。每一列定义一个多边形的坐标。补丁将多边形添加到当前的坐标轴上而不清除坐标轴。

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

图包含轴。轴包含2个类型的贴片物体。

定义X作为分类值的矢量,并定义y作为持续时间值的向量。这补丁函数使用分类的排序列表,因此X-AXIS可能会以不同的顺序显示它们的顺序。要指定订单,请致电reordercats函数。然后,创建一个红色的补丁来可视化数据。

X =分类({“冻结”“冷”“温暖”'热的''沸腾''沸腾'“冻结”});X = reordercats (X, {“冻结”“冷”“温暖”'热的''沸腾'});Y =分钟([0 15 20 47 50 0 0]);补丁(x,y,'红色的'

图包含轴。轴包含类型贴片的对象。

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

创建一个红色正方形的角在(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”'红色的'

图包含轴。轴包含类型贴片的对象。

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

V2 = [2 4;2 8;8 4;5 0;5 - 2;8 0];F2 = [1 2 3;4 5 6];修补(“面孔”f2,“顶点”v2,“FaceColor”“绿色”

图包含轴。轴包含2个类型的贴片物体。

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

使用矩阵创建多边形Xy.指定C作为两个元素的列向量,因为有两个多边形面,并添加一个颜色栏。

X = [2 5;2 5;8 8];Y = [4 0;8 2;4 0];c = [0;1);图块(x, y, c) colorbar

图包含轴。轴包含类型贴片的对象。

或者,您可以在使用时得到相同的结果FV.代替。当你创建多边形时,设置FaceVertexCData到有两个元素的列向量,因为有两个多边形面。集FaceColor'平坦的'

V = [2 4;2 8;8 4;5 0;5 - 2;8 0];F = [1 2 3;4 5 6];坳= [0;1); figure patch(“面孔”f“顶点”v,'facevertexcdata'上校,“FaceColor”'平坦的');彩色栏

图包含轴。轴包含类型贴片的对象。

通过在每个多边形顶点指定颜色,在多边形表面上插入颜色,并使用颜色条显示颜色如何映射到颜色映射。

使用矩阵创建多边形Xy.指定C作为矩阵相同的尺寸Xy每个顶点定义一个颜色,然后添加彩色键。

X = [2 5;2 5;8 8];Y = [4 0;8 2;4 0];C = [0 3;6 4;4 6];图块(x, y, c) colorbar

图包含轴。轴包含类型贴片的对象。

或者,您可以使用相同的结果FV.代替。当你创建多边形时,设置FaceVertexCData到每个顶点和集合都有一个值的列向量FaceColor的插值函数

V = [2 4;2 8;8 4;5 0;5 - 2;8 0];F = [1 2 3;4 5 6];坳= [0;6; 4; 3; 4; 6]; figure patch(“面孔”f“顶点”v,'facevertexcdata'上校,“FaceColor”的插值函数);彩色栏

图包含轴。轴包含类型贴片的对象。

创建一个绿色边的多边形,不显示面。然后,创建第二个多边形,每个边用不同的颜色。

V = [0 0;1 0;1 1];F = [1 2 3];图形补丁(“面孔”f“顶点”v,...'Edgecolor'“绿色”“FaceColor”'没有任何'“线宽”2);

图包含轴。轴包含类型贴片的对象。

通过为每个顶点和设置指定颜色,为每个边缘使用不同颜色EdgeColor.'平坦的'

V = [20 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);

图包含轴。轴包含2个类型的贴片物体。

使用结构来创建两个多边形。首先,创建一个具有匹配修补程序属性名称的字段名称的结构。然后,使用该结构创建多边形。

清晰的S.s.vortices = [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;图块(年代)

图包含轴。轴包含类型贴片的对象。

创建两个半透明的多边形通过设置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);

图包含轴。轴包含2个类型的贴片物体。

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

创建数据。设置的最后一项y补丁创建一条直线而不是一个封闭的多边形。属性定义每个顶点的颜色y价值观。价值C映射到颜色图中的颜色。

x = linspace(1、10、15);y = sin (x);y(结束)=南;c = y;

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

图块(x, y, c,'Edgecolor'的插值函数“标记”“o”'markerfacecolor''平坦的');colorbar;

图包含轴。轴包含类型贴片的对象。

输入参数

全部折叠

X-顶点的坐标,以以下形式之一指定:

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

  • 矩阵-创建N多边形与m每个顶点,[m,n] = size(x).矩阵中的每一列对应一个多边形。

如果数据没有定义封闭多边形,则补丁关闭多边形。如果单个多边形的边缘相交,则可能部分地填充所得到的多边形。在这种情况下,最好将贴片对象划分为较小的多边形。

当你指定X, 这补丁函数设置xdata.属性为相同的值。Patch对象会自动计算面部和顶点数据并设置顶点属性设置为适当的值。

数据类型:||int8|int16|int32|int64|uint8|uint16|uint32|uint64|分类|datetime|期间

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

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

  • 矩阵-创建N多边形与m每个顶点,[m,n] =尺寸(y).矩阵中的每一列对应一个多边形。

如果数据没有定义封闭多边形,则补丁关闭多边形。如果单个多边形的边缘相交,则可能部分地填充所得到的多边形。在这种情况下,最好将贴片对象划分为较小的多边形。

当你指定y, 这补丁函数设置YData属性为相同的值。Patch对象会自动计算面部和顶点数据并设置顶点属性设置为适当的值。

数据类型:||int8|int16|int32|int64|uint8|uint16|uint32|uint64|分类|datetime|期间

Z.-顶点的坐标,以以下形式之一指定:

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

  • 矩阵-创建m多边形与N每个顶点,[m,n] =尺寸(z).矩阵中的每一列对应一个多边形。

当你指定Z., 这补丁函数设置ZData属性为相同的值。Patch对象会自动计算面部和顶点数据并设置顶点属性设置为适当的值。

数据类型:||int8|int16|int32|int64|uint8|uint16|uint32|uint64|分类|datetime|期间

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

预期的效果 使用这些格式之一 结果
所有面孔的单色

  • 例如,颜色名称,'r'为红色。

  • 例如RGB三联体,[0 .5 .5]

  • 例如,标量值,2.这Cdatampapping.属性确定值如何映射到ColorMap中。

例如,请参见指定坐标

  • 设置FaceColor属性设置为指定的颜色。

每张脸上的一种颜色

  • N颜色映射颜色的-乘1向量,其中N是面孔的数量。这Cdatampapping.属性确定值如何映射到Colormap中。

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

例如,请参见不同的多边形面颜色

内插的脸的颜色

  • m——- - - - - -NColorMap值矩阵,其中[m,n] = size(x).为每个顶点指定一个颜色。

  • m——- - - - - -N——- - - - - -3.RGB值数组。

例如,请参见插值多边形面颜色

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

选项 描述 等价的RGB值
'红色的''r' 红色的 (1 0 0)
“绿色”‘g’ 绿色 (0 1 0)
“蓝”“b” 蓝色 (0 0 1)
“黄色”“y” 黄色的 [1 1 0]
“红色”“米” 品红 (1 0 1)
“青色”“c” 青色 (0 1 1)
'白色的''W' 白色的 [1 1]
“黑”“k” 黑色的 (0 0 0)

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

  • 两列矩阵-每行包含Xy)顶点的坐标。

  • 三列矩阵-每行包含XyZ.)顶点的坐标。

仅指定唯一顶点。在定义面部定义时,您可以在多次上引用顶点F

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

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

Face定义,以以下形式之一指定:

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

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

例如,这段代码在V.通过连接顶点1和2 2和3 3和1来创建一个多边形。

V = [1 1;2 1;2 2];F = [1 2 3 1];修补(“面孔”F“顶点”, V)

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

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

补丁定义,指定为具有与补丁属性名称对应的字段和与补丁属性值对应的字段值的结构。

坐标轴对象。如果不指定坐标轴对象,则补丁使用当前轴。

名称-值对的观点

指定可选的逗号分离对名称,值参数。的名字是参数名称和价值为对应值。的名字必须出现在引号内。可以以任意顺序指定多个名称和值对参数Name1, Value1,…,的家

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

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

面色,指定为的插值函数'平坦的'RGB三联网,十六进制颜色代码,颜色名称或短名称。

要为每个面创建不同的颜色,请指定CDataFaceVertexCData属性为每个面或每个顶点包含一种颜色的数组。颜色可以从每个面周围顶点的颜色插值,或者它们可以是统一的。对于插值颜色,指定此属性为的插值函数.对于统一颜色,将此属性指定为'平坦的'.如果您指定'平坦的'每个顶点都有不同的颜色,你指定的第一个顶点的颜色决定了脸的颜色。

要为所有的面指定一种颜色,请将此属性指定为RGB三元组、十六进制颜色代码、颜色名称或简短名称。

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

  • 十六进制颜色代码是以哈希符号开头的字符向量或字符串标量(),然后是3个或6个十六进制数字,其范围可以是0.F.这些值不区分大小写。因此,颜色是代码“# FF8800”“# ff8800”“# F80”,'#f80'是等同的。

颜色名称 短名称 RGB三重态 十六进制颜色代码 外观
'红色的' 'r' (1 0 0) '#ff0000'

“绿色” ‘g’ (0 1 0) '#00ff00'

“蓝” “b” (0 0 1) “# 0000 ff”

“青色” “c” (0 1 1) “# 00飞行符”

“红色” “米” (1 0 1) “#就”

“黄色” “y” [1 1 0] '#ffff00'

“黑” “k” (0 0 0) # 000000的

'白色的' 'W' [1 1] “# FFFFFF”

'没有任何' 不适用 不适用 不适用 没有颜色

这里是RGB三联体和十六进制颜色代码的默认颜色MATLAB®用于许多类型的情节。

RGB三重态 十六进制颜色代码 外观
[0 0.4470 0.7410] “# 0072 bd”

(0.8500 0.3250 0.0980) '#d95319'

(0.9290 0.6940 0.1250) “# EDB120”

(0.4940 0.1840 0.5560) “# 7 e2f8e”

(0.4660 0.6740 0.1880) “# 77 ac30”

(0.3010 0.7450 0.9330) “# 4 dbeee”

(0.6350 0.0780 0.1840) “# A2142F”

面部透明度,指定为其中一个值:

  • 标量在范围内[0, 1]- 在所有面上使用均匀的透明度。价值1是完全不透明的0.是完全透明的。属性中的透明度值不使用FaceVertexAlphaData财产。

  • '平坦的'-使用不同的透明度为每个面基于值FaceVertexAlphaData财产。首先,您必须指定FaceVertexAlphaData属性为每个面或顶点包含一个透明度值的向量。第一个顶点的透明度值决定了整个脸的透明度。

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

边缘颜色,指定为此表中的值之一。默认的边缘颜色是黑色,值为(0 0 0).如果多个多边形共享一条边,则绘制的第一个多边形将控制显示的边颜色。

价值 描述 结果

RGB三元组,十六进制颜色代码,或颜色名称

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

'平坦的'

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

的插值函数

插值边缘颜色。您必须先指定CDataFaceVertexCData每个顶点包含一种颜色的数组。通过线性插值两个边界顶点的值来确定边缘颜色。

'没有任何' 没有显示边缘。

没有显示边缘。

RGB三联体和十六进制颜色代码在指定自定义颜色时很有用。

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

  • 十六进制颜色代码是以哈希符号开头的字符向量或字符串标量(),然后是3个或6个十六进制数字,其范围可以是0.F.这些值不区分大小写。因此,颜色是代码“# FF8800”“# ff8800”“# F80”,'#f80'是等同的。

或者,您可以通过名称指定一些常见的颜色。该表列出了已命名的颜色选项、等价的RGB三联体和十六进制颜色代码。

颜色名称 短名称 RGB三重态 十六进制颜色代码 外观
'红色的' 'r' (1 0 0) '#ff0000'

“绿色” ‘g’ (0 1 0) '#00ff00'

“蓝” “b” (0 0 1) “# 0000 ff”

“青色” “c” (0 1 1) “# 00飞行符”

“红色” “米” (1 0 1) “#就”

“黄色” “y” [1 1 0] '#ffff00'

“黑” “k” (0 0 0) # 000000的

'白色的' 'W' [1 1] “# FFFFFF”

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

RGB三重态 十六进制颜色代码 外观
[0 0.4470 0.7410] “# 0072 bd”

(0.8500 0.3250 0.0980) '#d95319'

(0.9290 0.6940 0.1250) “# EDB120”

(0.4940 0.1840 0.5560) “# 7 e2f8e”

(0.4660 0.6740 0.1880) “# 77 ac30”

(0.3010 0.7450 0.9330) “# 4 dbeee”

(0.6350 0.0780 0.1840) “# A2142F”

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

线条风格 描述 产生的线
' - ' 实线

“——” 虚线

“:” 虚线

“-”。 划线

'没有任何' 没有线 没有线

输出参数

全部折叠

patch对象,作为标量返回。每个补丁对象都可以包括一个或多个多边形。用P.在创建它之后查询或更改修补物对象的属性。

扩展功能

之前介绍过的R2006a