文档

补丁

创建一个或多个填充多边形

语法

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

描述

例子

补丁(X,Y,C)使用的元素创建一个或多个填充多边形XY作为每个顶点的坐标。补丁以您指定它们的顺序连接顶点。要创建一个多边形,请指定XY作为向量。要创建多个多边形,请指定XY作为每列对应于多边形的矩阵。C确定多边形颜色。

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

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

补丁(“XData”,X“YData”,Y“ZData”,Z)类似于补丁(X, Y, Z, C),但不必为三维坐标指定颜色数据。

例子

面片('面',F“顶点”,v)创建一个或多个多边形,其中v指定顶点值F定义要连接的顶点。当存在多个多边形时,仅指定唯一的顶点及其连接矩阵可以减小数据的大小。请在中为每行指定一个顶点v.要创建一个多边形,请指定F作为一个向量。要创建多个多边形,请指定F作为每个多边形一行的矩阵。每个面不必具有相同数量的顶点。指定不同数量的顶点,垫F具有价值观。

例子

补丁(s)使用结构创建一个或多个多边形s.结构字段对应补丁属性名称,字段值对应属性值。例如,s可以包含字段顶点

例子

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

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

用角落创造一个红场(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,“脸色”,“红色”)

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

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

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

使用矩阵创建多边形xY具体说明C作为两个元素的列向量,因为有两个多边形面,并添加一个颜色栏。

x = [2 5;2 5;8 8];Y = [4 0;8 2;4 0];c = [0;1];图形补丁(x,y,c)颜色栏

或者,您可以在使用时得到相同的结果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”上校,“脸色”,“平坦”);色条

通过在每个多边形顶点指定颜色,使用颜色键来插入多边形面的颜色,并使用颜色键来显示颜色如何映射到Colormap中。

使用矩阵创建多边形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)颜色栏

或者,您可以使用相同的结果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”上校,“脸色”,的插值函数);色条

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

v=[0;10;11];f=[1 2 3];图形补丁(“脸”f'顶点'v,......“EdgeColor”,“绿色”,“脸色”,“没有”,'行宽'2);

通过为每个顶点指定颜色和设置,为每个边使用不同的颜色边色“平坦”

v=[20;30;31];f=[123];c=[100;%红色的0 1 0;% 绿色0 0 1);% 蓝色补丁(“脸”f'顶点'v,“FaceVertexCData”c......“EdgeColor”,“平坦”,“脸色”,“没有”,'行宽'2);

使用结构创建两个多边形。首先,创建一个结构,其中字段名与修补程序属性名匹配。然后,使用该结构创建多边形。

清晰的sS.顶点=[2 4;2 8;8 4;5 0;5 2;8 0];S.面=[1 2 3;4 5 6];S.FaceVertexCData=[0;1];S.FaceColor=“平坦”;S.EdgeColor=“红色”;S.LineWidth = 2;图形补丁

通过设置制造两个半透明多边形脸阿尔法属性设置为介于01.

V1 = [2 4;2 8;8 4];F1 = [1 2 3];图块(“脸”f1,'顶点', v1,“脸色”,“红色”,“FaceAlpha”,.3); v2=[24;28;88];f2=[1 2 3];补丁(“脸”f2,'顶点'v2,“脸色”,'蓝色',“FaceAlpha”5);

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

创建数据。设置的最后一项Y补丁创建一行而不是封闭的多边形。使用该顶点定义颜色Y值。中的值C映射到颜色图中的颜色。

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

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

图形补丁(x,y,c,“EdgeColor”,的插值函数,“标记”,“o”,“MarkerFaceColor”,“平坦”);色条;

输入参数

全部折叠

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

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

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

如果数据没有定义闭合多边形,那么补丁关闭多边形。如果单个多边形的边与其相交,则生成的多边形可能会部分填充。在这种情况下,最好将面片对象分割为较小的多边形。

当您指定时X这个补丁功能设置扩展属性属性设置为相同的值。面片对象自动计算面和顶点数据并设置顶点属性设置为适当的值。

数据类型:单身的|双倍的|int8|int16|INT32.|INT64.|uint8.|uint16|UINT32|uint64

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

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

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

如果数据没有定义闭合多边形,那么补丁关闭多边形。如果单个多边形的边与其相交,则生成的多边形可能会部分填充。在这种情况下,最好将面片对象分割为较小的多边形。

当您指定时Y这个补丁功能设置ydata.属性设置为相同的值。面片对象自动计算面和顶点数据并设置顶点属性设置为适当的值。

数据类型:单身的|双倍的|int8|int16|INT32.|INT64.|uint8.|uint16|UINT32|uint64

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

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

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

当您指定时Z这个补丁功能设置ZData属性设置为相同的值。面片对象自动计算面和顶点数据并设置顶点属性设置为适当的值。

数据类型:单身的|双倍的|int8|int16|INT32.|INT64.|uint8.|uint16|UINT32|uint64

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

预期的效果 使用这些格式之一 结果
所有面均为单色
  • 例如,颜色名称,“r”红色。

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

  • 例如,标量值,2..的CDATA映射属性确定值如何映射到colormap。

例如,请参见指定坐标

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

每张脸一种颜色
  • N-By-1 ColorMap颜色矢量,在哪里N是面数。面数CDATA映射属性确定值如何映射到colormap。

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

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

内插面色彩
  • M-经过-N颜色映射值矩阵,其中[m,n]=尺寸(X)具体说明one color per vertex.

  • M-经过-N-经过-3.RGB值数组。

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

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

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

  • 三列矩阵 - 每行包含(x,Y,Z)顶点的坐标。

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

当您指定时v这个补丁功能设置顶点属性为相同的值。patch对象自动计算坐标数据并设置扩展属性,ydata.,ZData设置为适当的值。

数据类型:单身的|双倍的|int8|int16|INT32.|INT64.|uint8.|uint16|UINT32|uint64

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

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

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

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

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

当您指定时F这个补丁功能设置属性为相同的值。patch对象自动计算坐标数据并设置扩展属性,ydata.,ZData设置为适当的值。

数据类型:单身的|双倍的|int8|int16|INT32.|INT64.|uint8.|uint16|UINT32|uint64

补丁定义,指定为具有字段的结构,该字段对应于与修补程序属性值对应的域和字段值。

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

名称-值对的观点

指定可选的逗号分隔的字符对名称、值论点。姓名是参数名和价值为对应值。姓名必须出现在单引号内('').您可以以任何顺序指定多个名称和值对参数Name1, Value1,…,的家

例子:补丁(x,y,c,'facealpha',。5,'linestyle',':')创建带点边的半透明多边形。

此处列出的属性仅是修补程序属性的子集。有关完整列表,请参阅补丁属性

全部折叠

面部颜色,指定为以下值之一:

  • RGB三重态或颜色名称的字符向量 - 所有面孔的单色。有关详细信息,请参阅下表。

  • “平坦”- 均匀的脸色。首先,指定CDataFaceVertexCData每个面包含一种颜色或每个顶点包含一种颜色的数组。如果为每个顶点指定一种颜色,则指定的第一个顶点的颜色将决定面颜色。

  • 的插值函数-在每个面上插值颜色。首先,说明CDataFaceVertexCData每个顶点包含一个值的数组。通过使用每个顶点的值的双线性插值来确定脸的颜色。

  • “没有”-没有显示任何面。

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

长名字 简称 RGB三重态
'黄色' “y” [1 1 0]
“红色” “米” (1 0 1)
“青色” 'C' [0 1 1]
“红色” “r” (1 0 0)
“绿色” 'G' [0 1 0]
'蓝色' 'B' (0 0 1)
“白色” “w” [1 1 1]
'黑色的' 'K' (0 0 0)

面透明度,指定为以下值之一:

  • 范围内的标量[0, 1]-在所有面上使用统一的透明度。价值1.是完全不透明的0是完全透明的。此选项不使用透明度值FacevertexalPhadata.财产。

  • “平坦”-使用不同的透明度为每个面基于值FacevertexalPhadata.属性。首先必须指定FacevertexalPhadata.属性作为载体,其中每个面或顶点的一个透明度值。第一个顶点的透明度值确定整个面的透明度。

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

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

价值 描述 结果

RGB三元组或颜色名称的字符向量

所有边缘的单色。有关详细信息,请参阅下表。

“平坦”

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

的插值函数

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

“没有” 没有显示任何边。

没有显示任何边。

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

长名字 简称 RGB三重态
'黄色' “y” [1 1 0]
“红色” “米” (1 0 1)
“青色” 'C' [0 1 1]
“红色” “r” (1 0 0)
“绿色” 'G' [0 1 0]
'蓝色' 'B' (0 0 1)
“白色” “w” [1 1 1]
'黑色的' 'K' (0 0 0)

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

线型 描述 结果线
'-' 实线

'--' 虚线

“:” 虚线

'-.' 虚线

“没有” 没有行 没有行

输出参数

全部折叠

Patch对象,作为标量返回。每个面片对象可以由一个或多个多边形组成。使用P创建面片对象后查询或更改其属性的步骤。

之前介绍过的R2006a

这个话题有用吗?