/** * The MIT License (MIT) * * Copyright (c) 2012-2017 DragonBones team and other contributors * * Permission is hereby granted, free of charge, to any person obtaining a copy of * this software and associated documentation files (the "Software"), to deal in * the Software without restriction, including without limitation the rights to * use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of * the Software, and to permit persons to whom the Software is furnished to do so, * subject to the following conditions: * * The above copyright notice and this permission notice shall be included in all * copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS * FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR * COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER * IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */ using System; using System.Collections.Generic; namespace DragonBones { /// /// - The base class of bounding box data. /// /// /// /// /// DragonBones 5.0 /// en_US /// /// - 边界框数据基类。 /// /// /// /// /// DragonBones 5.0 /// zh_CN public abstract class BoundingBoxData : BaseObject { /// /// - The bounding box type. /// /// DragonBones 5.0 /// en_US /// /// - 边界框类型。 /// /// DragonBones 5.0 /// zh_CN public BoundingBoxType type; /// public uint color; /// public float width; /// public float height; /// protected override void _OnClear() { this.color = 0x000000; this.width = 0.0f; this.height = 0.0f; } /// /// - Check whether the bounding box contains a specific point. (Local coordinate system) /// /// DragonBones 5.0 /// en_US /// /// - 检查边界框是否包含特定点。(本地坐标系) /// /// DragonBones 5.0 /// zh_CN public abstract bool ContainsPoint(float pX, float pY); /// /// - Check whether the bounding box intersects a specific segment. (Local coordinate system) /// /// DragonBones 5.0 /// en_US /// /// - 检查边界框是否与特定线段相交。(本地坐标系) /// /// DragonBones 5.0 /// zh_CN public abstract int IntersectsSegment(float xA, float yA, float xB, float yB, Point intersectionPointA = null, Point intersectionPointB = null, Point normalRadians = null); } /// /// - Cohen–Sutherland algorithm https://en.wikipedia.org/wiki/Cohen%E2%80%93Sutherland_algorithm /// ---------------------- /// | 0101 | 0100 | 0110 | /// ---------------------- /// | 0001 | 0000 | 0010 | /// ---------------------- /// | 1001 | 1000 | 1010 | /// ---------------------- /// enum OutCode { InSide = 0, // 0000 Left = 1, // 0001 Right = 2, // 0010 Top = 4, // 0100 Bottom = 8 // 1000 } /// /// - The rectangle bounding box data. /// /// DragonBones 5.1 /// en_US /// /// - 矩形边界框数据。 /// /// DragonBones 5.1 /// zh_CN public class RectangleBoundingBoxData : BoundingBoxData { /// /// - Compute the bit code for a point (x, y) using the clip rectangle /// private static int _ComputeOutCode(float x, float y, float xMin, float yMin, float xMax, float yMax) { var code = OutCode.InSide; // initialised as being inside of [[clip window]] if (x < xMin) { // to the left of clip window code |= OutCode.Left; } else if (x > xMax) { // to the right of clip window code |= OutCode.Right; } if (y < yMin) { // below the clip window code |= OutCode.Top; } else if (y > yMax) { // above the clip window code |= OutCode.Bottom; } return (int)code; } /// public static int RectangleIntersectsSegment(float xA, float yA, float xB, float yB, float xMin, float yMin, float xMax, float yMax, Point intersectionPointA = null, Point intersectionPointB = null, Point normalRadians = null) { var inSideA = xA > xMin && xA < xMax && yA > yMin && yA < yMax; var inSideB = xB > xMin && xB < xMax && yB > yMin && yB < yMax; if (inSideA && inSideB) { return -1; } var intersectionCount = 0; var outcode0 = RectangleBoundingBoxData._ComputeOutCode(xA, yA, xMin, yMin, xMax, yMax); var outcode1 = RectangleBoundingBoxData._ComputeOutCode(xB, yB, xMin, yMin, xMax, yMax); while (true) { if ((outcode0 | outcode1) == 0) { // Bitwise OR is 0. Trivially accept and get out of loop intersectionCount = 2; break; } else if ((outcode0 & outcode1) != 0) { // Bitwise AND is not 0. Trivially reject and get out of loop break; } // failed both tests, so calculate the line segment to clip // from an outside point to an intersection with clip edge var x = 0.0f; var y = 0.0f; var normalRadian = 0.0f; // At least one endpoint is outside the clip rectangle; pick it. var outcodeOut = outcode0 != 0 ? outcode0 : outcode1; // Now find the intersection point; if ((outcodeOut & (int)OutCode.Top) != 0) { // point is above the clip rectangle x = xA + (xB - xA) * (yMin - yA) / (yB - yA); y = yMin; if (normalRadians != null) { normalRadian = -(float)Math.PI * 0.5f; } } else if ((outcodeOut & (int)OutCode.Bottom) != 0) { // point is below the clip rectangle x = xA + (xB - xA) * (yMax - yA) / (yB - yA); y = yMax; if (normalRadians != null) { normalRadian = (float)Math.PI * 0.5f; } } else if ((outcodeOut & (int)OutCode.Right) != 0) { // point is to the right of clip rectangle y = yA + (yB - yA) * (xMax - xA) / (xB - xA); x = xMax; if (normalRadians != null) { normalRadian = 0; } } else if ((outcodeOut & (int)OutCode.Left) != 0) { // point is to the left of clip rectangle y = yA + (yB - yA) * (xMin - xA) / (xB - xA); x = xMin; if (normalRadians != null) { normalRadian = (float)Math.PI; } } // Now we move outside point to intersection point to clip // and get ready for next pass. if (outcodeOut == outcode0) { xA = x; yA = y; outcode0 = RectangleBoundingBoxData._ComputeOutCode(xA, yA, xMin, yMin, xMax, yMax); if (normalRadians != null) { normalRadians.x = normalRadian; } } else { xB = x; yB = y; outcode1 = RectangleBoundingBoxData._ComputeOutCode(xB, yB, xMin, yMin, xMax, yMax); if (normalRadians != null) { normalRadians.y = normalRadian; } } } if (intersectionCount > 0) { if (inSideA) { intersectionCount = 2; // 10 if (intersectionPointA != null) { intersectionPointA.x = xB; intersectionPointA.y = yB; } if (intersectionPointB != null) { intersectionPointB.x = xB; intersectionPointB.y = xB; } if (normalRadians != null) { normalRadians.x = normalRadians.y + (float)Math.PI; } } else if (inSideB) { intersectionCount = 1; // 01 if (intersectionPointA != null) { intersectionPointA.x = xA; intersectionPointA.y = yA; } if (intersectionPointB != null) { intersectionPointB.x = xA; intersectionPointB.y = yA; } if (normalRadians != null) { normalRadians.y = normalRadians.x + (float)Math.PI; } } else { intersectionCount = 3; // 11 if (intersectionPointA != null) { intersectionPointA.x = xA; intersectionPointA.y = yA; } if (intersectionPointB != null) { intersectionPointB.x = xB; intersectionPointB.y = yB; } } } return intersectionCount; } /// /// protected override void _OnClear() { base._OnClear(); this.type = BoundingBoxType.Rectangle; } /// public override bool ContainsPoint(float pX, float pY) { var widthH = this.width * 0.5f; if (pX >= -widthH && pX <= widthH) { var heightH = this.height * 0.5f; if (pY >= -heightH && pY <= heightH) { return true; } } return false; } /// public override int IntersectsSegment(float xA, float yA, float xB, float yB, Point intersectionPointA = null, Point intersectionPointB = null, Point normalRadians = null) { var widthH = this.width * 0.5f; var heightH = this.height * 0.5f; var intersectionCount = RectangleBoundingBoxData.RectangleIntersectsSegment ( xA, yA, xB, yB, -widthH, -heightH, widthH, heightH, intersectionPointA, intersectionPointB, normalRadians ); return intersectionCount; } } /// /// - The ellipse bounding box data. /// /// DragonBones 5.1 /// en_US /// /// - 椭圆边界框数据。 /// /// DragonBones 5.1 /// zh_CN public class EllipseBoundingBoxData : BoundingBoxData { /// public static int EllipseIntersectsSegment(float xA, float yA, float xB, float yB, float xC, float yC, float widthH, float heightH, Point intersectionPointA = null, Point intersectionPointB = null, Point normalRadians = null) { var d = widthH / heightH; var dd = d * d; yA *= d; yB *= d; var dX = xB - xA; var dY = yB - yA; var lAB = (float)Math.Sqrt(dX * dX + dY * dY); var xD = dX / lAB; var yD = dY / lAB; var a = (xC - xA) * xD + (yC - yA) * yD; var aa = a * a; var ee = xA * xA + yA * yA; var rr = widthH * widthH; var dR = rr - ee + aa; var intersectionCount = 0; if (dR >= 0.0f) { var dT = (float)Math.Sqrt(dR); var sA = a - dT; var sB = a + dT; var inSideA = sA < 0.0 ? -1 : (sA <= lAB ? 0 : 1); var inSideB = sB < 0.0 ? -1 : (sB <= lAB ? 0 : 1); var sideAB = inSideA * inSideB; if (sideAB < 0) { return -1; } else if (sideAB == 0) { if (inSideA == -1) { intersectionCount = 2; // 10 xB = xA + sB * xD; yB = (yA + sB * yD) / d; if (intersectionPointA != null) { intersectionPointA.x = xB; intersectionPointA.y = yB; } if (intersectionPointB != null) { intersectionPointB.x = xB; intersectionPointB.y = yB; } if (normalRadians != null) { normalRadians.x = (float)Math.Atan2(yB / rr * dd, xB / rr); normalRadians.y = normalRadians.x + (float)Math.PI; } } else if (inSideB == 1) { intersectionCount = 1; // 01 xA = xA + sA * xD; yA = (yA + sA * yD) / d; if (intersectionPointA != null) { intersectionPointA.x = xA; intersectionPointA.y = yA; } if (intersectionPointB != null) { intersectionPointB.x = xA; intersectionPointB.y = yA; } if (normalRadians != null) { normalRadians.x = (float)Math.Atan2(yA / rr * dd, xA / rr); normalRadians.y = normalRadians.x + (float)Math.PI; } } else { intersectionCount = 3; // 11 if (intersectionPointA != null) { intersectionPointA.x = xA + sA * xD; intersectionPointA.y = (yA + sA * yD) / d; if (normalRadians != null) { normalRadians.x = (float)Math.Atan2(intersectionPointA.y / rr * dd, intersectionPointA.x / rr); } } if (intersectionPointB != null) { intersectionPointB.x = xA + sB * xD; intersectionPointB.y = (yA + sB * yD) / d; if (normalRadians != null) { normalRadians.y = (float)Math.Atan2(intersectionPointB.y / rr * dd, intersectionPointB.x / rr); } } } } } return intersectionCount; } /// /// protected override void _OnClear() { base._OnClear(); this.type = BoundingBoxType.Ellipse; } /// public override bool ContainsPoint(float pX, float pY) { var widthH = this.width * 0.5f; if (pX >= -widthH && pX <= widthH) { var heightH = this.height * 0.5f; if (pY >= -heightH && pY <= heightH) { pY *= widthH / heightH; return Math.Sqrt(pX * pX + pY * pY) <= widthH; } } return false; } /// public override int IntersectsSegment(float xA, float yA, float xB, float yB, Point intersectionPointA, Point intersectionPointB, Point normalRadians) { var intersectionCount = EllipseBoundingBoxData.EllipseIntersectsSegment(xA, yA, xB, yB, 0.0f, 0.0f, this.width * 0.5f, this.height * 0.5f, intersectionPointA, intersectionPointB, normalRadians); return intersectionCount; } } /// /// - The polygon bounding box data. /// /// DragonBones 5.1 /// en_US /// /// - 多边形边界框数据。 /// /// DragonBones 5.1 /// zh_CN public class PolygonBoundingBoxData : BoundingBoxData { /// public static int PolygonIntersectsSegment(float xA, float yA, float xB, float yB, List vertices, Point intersectionPointA = null, Point intersectionPointB = null, Point normalRadians = null) { if (xA == xB) { xA = xB + 0.01f; } if (yA == yB) { yA = yB + 0.01f; } var l = vertices.Count; var dXAB = xA - xB; var dYAB = yA - yB; var llAB = xA * yB - yA * xB; int intersectionCount = 0; var xC = vertices[l - 2]; var yC = vertices[l - 1]; var dMin = 0.0f; var dMax = 0.0f; var xMin = 0.0f; var yMin = 0.0f; var xMax = 0.0f; var yMax = 0.0f; for (int i = 0; i < l; i += 2) { var xD = vertices[i]; var yD = vertices[i + 1]; if (xC == xD) { xC = xD + 0.01f; } if (yC == yD) { yC = yD + 0.01f; } var dXCD = xC - xD; var dYCD = yC - yD; var llCD = xC * yD - yC * xD; var ll = dXAB * dYCD - dYAB * dXCD; var x = (llAB * dXCD - dXAB * llCD) / ll; if (((x >= xC && x <= xD) || (x >= xD && x <= xC)) && (dXAB == 0 || (x >= xA && x <= xB) || (x >= xB && x <= xA))) { var y = (llAB * dYCD - dYAB * llCD) / ll; if (((y >= yC && y <= yD) || (y >= yD && y <= yC)) && (dYAB == 0 || (y >= yA && y <= yB) || (y >= yB && y <= yA))) { if (intersectionPointB != null) { var d = x - xA; if (d < 0.0f) { d = -d; } if (intersectionCount == 0) { dMin = d; dMax = d; xMin = x; yMin = y; xMax = x; yMax = y; if (normalRadians != null) { normalRadians.x = (float)Math.Atan2(yD - yC, xD - xC) - (float)Math.PI * 0.5f; normalRadians.y = normalRadians.x; } } else { if (d < dMin) { dMin = d; xMin = x; yMin = y; if (normalRadians != null) { normalRadians.x = (float)Math.Atan2(yD - yC, xD - xC) - (float)Math.PI * 0.5f; } } if (d > dMax) { dMax = d; xMax = x; yMax = y; if (normalRadians != null) { normalRadians.y = (float)Math.Atan2(yD - yC, xD - xC) - (float)Math.PI * 0.5f; } } } intersectionCount++; } else { xMin = x; yMin = y; xMax = x; yMax = y; intersectionCount++; if (normalRadians != null) { normalRadians.x = (float)Math.Atan2(yD - yC, xD - xC) - (float)Math.PI * 0.5f; normalRadians.y = normalRadians.x; } break; } } } xC = xD; yC = yD; } if (intersectionCount == 1) { if (intersectionPointA != null) { intersectionPointA.x = xMin; intersectionPointA.y = yMin; } if (intersectionPointB != null) { intersectionPointB.x = xMin; intersectionPointB.y = yMin; } if (normalRadians != null) { normalRadians.y = normalRadians.x + (float)Math.PI; } } else if (intersectionCount > 1) { intersectionCount++; if (intersectionPointA != null) { intersectionPointA.x = xMin; intersectionPointA.y = yMin; } if (intersectionPointB != null) { intersectionPointB.x = xMax; intersectionPointB.y = yMax; } } return intersectionCount; } /// public float x; /// public float y; /// /// - The polygon vertices. /// /// DragonBones 5.1 /// en_US /// /// - 多边形顶点。 /// /// DragonBones 5.1 /// zh_CN public readonly List vertices = new List(); /// /// protected override void _OnClear() { base._OnClear(); this.type = BoundingBoxType.Polygon; this.x = 0.0f; this.y = 0.0f; this.vertices.Clear(); } /// public override bool ContainsPoint(float pX, float pY) { var isInSide = false; if (pX >= this.x && pX <= this.width && pY >= this.y && pY <= this.height) { for (int i = 0, l = this.vertices.Count, iP = l - 2; i < l; i += 2) { var yA = this.vertices[iP + 1]; var yB = this.vertices[i + 1]; if ((yB < pY && yA >= pY) || (yA < pY && yB >= pY)) { var xA = this.vertices[iP]; var xB = this.vertices[i]; if ((pY - yB) * (xA - xB) / (yA - yB) + xB < pX) { isInSide = !isInSide; } } iP = i; } } return isInSide; } /// public override int IntersectsSegment(float xA, float yA, float xB, float yB, Point intersectionPointA = null, Point intersectionPointB = null, Point normalRadians = null) { var intersectionCount = 0; if (RectangleBoundingBoxData.RectangleIntersectsSegment(xA, yA, xB, yB, this.x, this.y, this.x + this.width, this.y + this.height, null, null, null) != 0) { intersectionCount = PolygonBoundingBoxData.PolygonIntersectsSegment ( xA, yA, xB, yB, this.vertices, intersectionPointA, intersectionPointB, normalRadians ); } return intersectionCount; } } }