帮助中心帮助中心
两个 polyshape 对象的差集
polyshape
polyout = subtract(poly1,poly2)
[polyout,shapeID,vertexID] = subtract(poly1,poly2)
___ = subtract(poly1,poly2,'KeepCollinearPoints',TF)
示例
polyout = subtract(poly1,poly2) 返回一个 polyshape 对象,它的区域是两个 polyshape 对象的几何差集。输出 polyout 包含 poly1 的区域减去 poly2 中与 poly1 重叠的部分。输入参量 poly1 和 poly2 必须具有兼容的数组大小。
poly1
poly2
polyout
[polyout,shapeID,vertexID] = subtract(poly1,poly2) 还会返回从 polyout 中的顶点到 poly1 和 poly2 中的顶点的顶点映射信息。仅当 poly1 和 poly2 是标量 polyshape 对象时,subtract 函数才支持此语法。
shapeID
vertexID
subtract
shapeID 元素标识 polyout 中对应的顶点是源于 poly1、poly2,还是因差集而产生的。vertexID 将 polyout 的顶点映射到 poly1、poly2 或差集的顶点。
___ = subtract(poly1,poly2,'KeepCollinearPoints',TF) 指定在上述任一语法的基础上是保留还是删除 polyout 中的共线点。
TF
全部折叠
创建并绘制部分重叠的两个多边形 poly1 和 poly2。
poly1 = polyshape([0 0 1 1],[1 0 0 1]); poly2 = polyshape([0.75 1.25 1.25 0.75],[0.25 0.25 0.75 0.75]); plot(poly1) hold on plot(poly2)
figure
用 poly1 减去 poly2。得到的多边形是 poly1 减去 poly2 中与 poly1 重叠的部分。
polyout1 = subtract(poly1,poly2)
polyout1 = polyshape with properties: Vertices: [8x2 double] NumRegions: 1 NumHoles: 0
plot(polyout1)
现在将两个多边形反过来相减,即用 poly2 减去 poly1。得到的多边形是 poly2 减去 poly1 中与 poly2 重叠的部分。
polyout2 = subtract(poly2,poly1)
polyout2 = polyshape with properties: Vertices: [4x2 double] NumRegions: 1 NumHoles: 0
plot(polyout2) xlim([-0.2 1.4]); ylim([-0.2 1.2]);
创建两个多边形,计算并绘制其差集。显示差集的顶点坐标和对应的顶点映射信息。
poly1 = polyshape([0 0 1 1],[1 0 0 1]); poly2 = translate(poly1,[0.5 0.5]); [polyout,shapeID,vertexID] = subtract(poly1,poly2); plot(polyout) axis equal
[polyout.Vertices shapeID vertexID]
ans = 6×4 0 1.0000 1.0000 1.0000 0.5000 1.0000 0 0 0.5000 0.5000 2.0000 4.0000 1.0000 0.5000 0 0 1.0000 0 1.0000 3.0000 0 0 1.0000 4.0000
差集的第一个、第五个和第六个顶点源于 poly1,因为 shapeID 中的对应值为 1。这些顶点分别是属性 poly1.Vertices 中的第一个、第三个和第四个顶点,因为 vertexID 中的对应值分别为 1、3 和 4。同样,差集的第三个顶点源于 poly2,并且是属性 poly2.Vertices 中的第四个顶点。差集的第二个和第四个顶点是因相减而产生的,因为 shapeID 和 vertexID 的对应值为 0。
poly1.Vertices
poly2.Vertices
第一个输入 polyshape,指定为标量、向量、矩阵或多维数组。
第二个输入 polyshape,指定为标量、向量、矩阵或多维数组。
false
true
共线顶点指示符,指定为 false 或 true:
false - 删除共线点,使输出 polyshape 包含定义边界所需的最少顶点。
true - 保留所有共线点作为顶点。
如果未指定 'KeepCollinearPoints' 参数,则根据创建输入 polyshape 对象时使用的值为该参数赋值:
'KeepCollinearPoints'
如果每个输入 polyshape 在创建时的值为 true,则输出 polyshape 的值设置为 true。
如果每个输入 polyshape 在创建时的值为 false,则输出 polyshape 的值设置为 false。
如果输入 polyshape 对象的值不匹配,则输出 polyshape 的值设置为 false。
数据类型: logical
logical
输出 polyshape,以标量、向量、矩阵或多维数组形式返回。
两个输入 polyshape 参量必须具有兼容的大小。例如,如果两个输入 polyshape 向量具有不同的长度 M 和 N,则它们必须有不同的方向(一个必须是行向量,一个必须是列向量)。polyout 则是 M×N 或 N×M,具体取决于每个输入向量的方向。有关兼容的数组大小的详细信息,请参阅基本运算的兼容数组大小。
形状 ID,以列向量形式返回,其各个元素表示差集中顶点的来源。如果输出 polyshape 的顶点是因相减而产生的,则 shapeID 中的对应元素的值为 0。当顶点源于 poly1 时,对应元素为 1,当顶点源于 poly2 时,对应元素为 2。
shapeID 的长度等于输出 polyshape 的 Vertices 属性中的行数。仅当输入 polyshape 对象是标量时,xor 函数才支持此输出参量。
Vertices
xor
数据类型: double
double
顶点 ID,以列向量形式返回,其元素将输出 polyshape 中的顶点映射到来源的 polyshape 中的顶点。vertexID 的元素包含输入 polyshape 的 Vertices 属性中对应顶点的行号。如果输出 polyshape 的顶点是因差集而产生的,则对应元素为 0。
vertexID 的长度等于输出 polyshape 的 Vertices 属性中的行数。仅当输入 polyshape 对象是标量时,subtract 函数才支持此输出参量。
用法说明和限制:
必须启用动态内存分配才能进行代码生成。
名称-值对组必须为编译时常量。
在 R2017b 中推出
polyshape | xor | union | intersect
union
intersect
您点击的链接对应于以下 MATLAB 命令:
请在 MATLAB 命令行窗口中直接输入以执行命令。Web 浏览器不支持 MATLAB 命令。
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list:
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Contact your local office