polyshape
二维多边形形状
说明
polyshape 函数基于二维顶点创建类似多边形的形状。然而，与多边形不同，polyshape 可以有不连续的区域和孔洞。polyshape 对象的属性描述其顶点、实心区域和孔洞。
例如，pgon = polyshape([0 0 1 1],[1 0 0 1]) 将创建由四个点 (0,1)、(0,0)、(1,0) 和 (1,1) 定义的实心正方形。
>> pgon = polyshape([0 0 1 1],[1 0 0 1])
pgon =
polyshape with properties:
Vertices: [4×2 double]
NumRegions: 1
NumHoles: 0>> plot(pgon)
创建对象
创建 polyshape 对象时，输入顶点应定义多边形的一个或多个边界，这些边界没有交集并且嵌套正确。否则，polyshape 函数将根据需要自动更改输入顶点，以创建明确定义的多边形。
如果要创建正多边形，还可以使用 nsidedpoly 函数。nsidedpoly 使您能够选择指定多边形的中心点和边长等参数。
语法
描述
pgon = polyshape() 创建一个空 polyshape 对象。
pgon = polyshape(___, 为上述任意语法指定创建 Name,Value)polyshape 对象的其他参数。
输入参量
名称-值参数
属性
对象函数
示例
创建并绘制由四个点形成的多边形，并计算其面积、周长和矩心坐标。
pgon = polyshape([0 0 1 3], [0 3 3 0]); plot(pgon)
A = area(pgon)
A = 6
P = perimeter(pgon)
P = 10.6056
[Cx Cy] = centroid(pgon)
Cx = 1.0833
Cy = 1.2500
分析具有相交边界的多边形。
创建包含自相交边界的多边形。默认情况下，polyshape 函数将边界分成两段不同的边界，以创建明确定义的多边形。
P = [0 0; 1 1; 1 0; 0 1; 0 0]; pgon = polyshape(P)
Warning: Polyshape has duplicate vertices, intersections, or other inconsistencies that may produce inaccurate or unexpected results. Input data has been modified to create a well-defined polyshape.
pgon =
polyshape with properties:
Vertices: [7×2 double]
NumRegions: 2
NumHoles: 0
绘制多边形并计算面积。
plot(pgon)
A = area(pgon)
A = 0.5000
如果不简化原始输入顶点，则构成多边形的两个三角形区域的面积相互抵消。
pgon2 = polyshape(P,'Simplify',false)pgon2 =
polyshape with properties:
Vertices: [4×2 double]
NumRegions: 1
NumHoles: 0
A2 = area(pgon2)
A2 = 0
分析具有嵌套边界的多边形。
创建一个多边形，里面包含两条正确嵌套的边界。polyshape 将最外侧边界定义为实心区域的外边界。从外往内，下一个边界定义孔的开始。
t = 0.05:0.5:2*pi;
x1 = cos(t);
y1 = sin(t);
x2 = 0.5*cos(t);
y2 = 0.5*sin(t);
pgon = polyshape({x1,x2},{y1,y2})pgon =
polyshape with properties:
Vertices: [27×2 double]
NumRegions: 1
NumHoles: 1
plot(pgon)
使用 addboundary 函数再创建一个多边形，为 pgon 添加第三条外边界。
x3 = 2*cos(t); y3 = 2*sin(t); pgon2 = addboundary(pgon,x3,y3)
pgon2 =
polyshape with properties:
Vertices: [41×2 double]
NumRegions: 2
NumHoles: 1
plot(pgon2)
添加第三条外边界后，polyshape 需要根据新的嵌套模式重新组织实心区域的边界和孔的边界。polyshape 仍然从最外侧边界（指示实心区域的开始）向内进行，里面的每一条嵌套边界交替作为孔的边界和实心区域的边界。新的多边形现在有两个实心区域和一个孔。
