subtract
2 つの polyshape オブジェクトの差
構文
説明
[ は、polyout,shapeID,vertexID] = subtract(poly1,poly2)polyout の頂点から poly1 と poly2 の頂点への、頂点のマッピング情報も返します。関数 subtract がこの構文をサポートするのは、poly1 と poly2 がスカラー polyshape オブジェクトである場合のみです。
shapeID 要素は、polyout の対応する頂点が poly1 または poly2 に由来するか、あるいは差により作成されたかを識別します。vertexID は polyout の頂点を poly1、poly2、または差の頂点にマッピングします。
___ = subtract(___, は、前述の構文の入力引数の任意の組み合わせに加え、1 つ以上の名前と値の引数を使用してオプションを指定します。前述の構文にある任意の出力引数の組み合わせが使用できます。たとえば、Name=Value)polyout = subtract(poly1,poly2,Simplify=false) は、交差や適切でない入れ子が発生しても頂点を変更していない polyshape オブジェクトを返します。
例
部分的にオーバーラップしている 2 つの多角形 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
poly2 を poly1 から引きます。この結果得られる多角形は、poly1 から、poly1 とオーバーラップしている poly2 の部分を差し引いたものとなります。
polyout1 = subtract(poly1,poly2)
polyout1 =
polyshape with properties:
Vertices: [8×2 double]
NumRegions: 1
NumHoles: 0
plot(polyout1)
次に、2 つの多角形の減算を逆の順序で行います。すなわち、poly1 を poly2 から引きます。この結果得られる多角形は、poly2 から、poly2 とオーバーラップしている poly1 の部分を差し引いたものとなります。
polyout2 = subtract(poly2,poly1)
polyout2 =
polyshape with properties:
Vertices: [4×2 double]
NumRegions: 1
NumHoles: 0
plot(polyout2) xlim([-0.2 1.4]); ylim([-0.2 1.2]);
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
差の 1 番目、5 番目、6 番目の頂点は poly1 に由来します。これは、対応する shapeID の値が 1 であることからわかります。これらの頂点はそれぞれプロパティ poly1.Vertices の 1 番目、3 番目、4 番目の頂点です。これは、vertexID の対応する値が 1、3、4 であることからわかります。同様に、差の 3 番目の頂点は poly2 に由来し、プロパティ poly2.Vertices の 4 番目の頂点です。差の 2 番目と 4 番目の頂点は差し引きの計算により作成されています。これは、対応する shapeID と vertexID の値が 0 であることからわかります。
