OpenNest/OpenNest.Core/Geometry/Entity.cs

using System;
using System.Collections.Generic;
using System.Drawing;
using OpenNest.Math;

namespace OpenNest.Geometry
{
    public abstract class Entity : IBoundable
    {
        protected Box boundingBox;

        protected Entity()
        {
            Id = Guid.NewGuid();
            Layer = OpenNest.Geometry.Layer.Default;
            boundingBox = new Box();
        }

        /// <summary>
        /// Unique identifier for this entity, stable across edit sessions.
        /// </summary>
        public Guid Id { get; set; }

        /// <summary>
        /// Entity color (resolved from DXF ByLayer/ByBlock to actual color).
        /// </summary>
        public Color Color { get; set; }

        /// <summary>
        /// Entity linetype name (e.g. "Continuous", "Center", "Dashed").
        /// </summary>
        public string LineTypeName { get; set; }

        /// <summary>
        /// Whether this entity is visible (used for color/linetype filtering).
        /// </summary>
        public bool IsVisible { get; set; } = true;

        /// <summary>
        /// Optional tag for identifying generated entities (e.g. bend etch marks).
        /// </summary>
        public string Tag { get; set; }

        /// <summary>
        /// Smallest box that contains the entity.
        /// </summary>
        public Box BoundingBox
        {
            get { return boundingBox; }
        }

        /// <summary>
        /// Entity layer type.
        /// </summary>
        public Layer Layer { get; set; }

        /// <summary>
        /// X-Coordinate of the left-most point.
        /// </summary>
        public virtual double Left
        {
            get { return boundingBox.Left; }
        }

        /// <summary>
        /// X-Coordinate of the right-most point.
        /// </summary>
        public virtual double Right
        {
            get { return boundingBox.Right; }
        }

        /// <summary>
        /// Y-Coordinate of the highest point.
        /// </summary>
        public virtual double Top
        {
            get { return boundingBox.Top; }
        }

        /// <summary>
        /// Y-Coordinate of the lowest point.
        /// </summary>
        public virtual double Bottom
        {
            get { return boundingBox.Bottom; }
        }

        /// <summary>
        /// Length of the entity.
        /// </summary>
        public abstract double Length { get; }

        /// <summary>
        /// Reverses the entity.
        /// </summary>
        public abstract void Reverse();

        /// <summary>
        /// Moves the entity location to the given coordinates.
        /// </summary>
        /// <param name="x"></param>
        /// <param name="y"></param>
        public abstract void MoveTo(double x, double y);

        /// <summary>
        /// Moves the entity location to the given point.
        /// </summary>
        /// <param name="pt"></param>
        public abstract void MoveTo(Vector pt);

        /// <summary>
        /// Offsets the entity location by the given distances.
        /// </summary>
        /// <param name="x"></param>
        /// <param name="y"></param>
        public abstract void Offset(double x, double y);

        /// <summary>
        /// Offsets the entity location by the given distances.
        /// </summary>
        /// <param name="voffset"></param>
        public abstract void Offset(Vector voffset);

        /// <summary>
        /// Scales the entity from the zero point.
        /// </summary>
        /// <param name="factor"></param>
        public abstract void Scale(double factor);

        /// <summary>
        /// Scales the entity from the origin.
        /// </summary>
        /// <param name="factor"></param>
        /// <param name="origin"></param>
        public abstract void Scale(double factor, Vector origin);

        /// <summary>
        /// Rotates the entity from the zero point.
        /// </summary>
        /// <param name="angle"></param>
        public abstract void Rotate(double angle);

        /// <summary>
        /// Rotates the entity from the origin.
        /// </summary>
        /// <param name="angle"></param>
        /// <param name="origin"></param>
        public abstract void Rotate(double angle, Vector origin);

        /// <summary>
        /// Updates the bounding box.
        /// </summary>
        public abstract void UpdateBounds();

        /// <summary>
        /// Gets a new entity offset the given distance from this entity.
        /// </summary>
        /// <param name="distance"></param>
        /// <param name="side"></param>
        /// <returns></returns>
        public abstract Entity OffsetEntity(double distance, OffsetSide side);

        /// <summary>
        /// Gets a new entity offset the given distance from this entity. Offset side determined by point.
        /// </summary>
        /// <param name="distance"></param>
        /// <param name="pt"></param>
        /// <returns></returns>
        public abstract Entity OffsetEntity(double distance, Vector pt);

        /// <summary>
        /// Gets the closest point on the entity to the given point.
        /// </summary>
        /// <param name="pt"></param>
        /// <returns></returns>
        public abstract Vector ClosestPointTo(Vector pt);

        /// <summary>
        /// Returns true if the given arc is intersecting this.
        /// </summary>
        /// <param name="arc"></param>
        /// <returns></returns>
        public abstract bool Intersects(Arc arc);

        /// <summary>
        /// Returns true if the given arc is intersecting this.
        /// </summary>
        /// <param name="arc"></param>
        /// <param name="pts">List to store the points of intersection.</param>
        /// <returns></returns>
        public abstract bool Intersects(Arc arc, out List<Vector> pts);

        /// <summary>
        /// Returns true if the given circle is intersecting this.
        /// </summary>
        /// <param name="circle"></param>
        /// <returns></returns>
        public abstract bool Intersects(Circle circle);

        /// <summary>
        /// Returns true if the given circle is intersecting this.
        /// </summary>
        /// <param name="circle"></param>
        /// <param name="pts"></param>
        /// <returns></returns>
        public abstract bool Intersects(Circle circle, out List<Vector> pts);

        /// <summary>
        /// Returns true if the given line is intersecting this.
        /// </summary>
        /// <param name="line"></param>
        /// <returns></returns>
        public abstract bool Intersects(Line line);

        /// <summary>
        /// Returns true if the given line is intersecting this.
        /// </summary>
        /// <param name="line"></param>
        /// <param name="pts"></param>
        /// <returns></returns>
        public abstract bool Intersects(Line line, out List<Vector> pts);

        /// <summary>
        /// Returns true if the given polygon is intersecting this.
        /// </summary>
        /// <param name="polygon"></param>
        /// <returns></returns>
        public abstract bool Intersects(Polygon polygon);

        /// <summary>
        /// Returns true if the given polygon is intersecting this.
        /// </summary>
        /// <param name="polygon"></param>
        /// <param name="pts"></param>
        /// <returns></returns>
        public abstract bool Intersects(Polygon polygon, out List<Vector> pts);

        /// <summary>
        /// Returns true if the given shape is intersecting this.
        /// </summary>
        /// <param name="shape"></param>
        /// <returns></returns>
        public abstract bool Intersects(Shape shape);

        /// <summary>
        /// Returns true if the given shape is intersecting this.
        /// </summary>
        /// <param name="shape"></param>
        /// <param name="pts"></param>
        /// <returns></returns>
        public abstract bool Intersects(Shape shape, out List<Vector> pts);

        /// <summary>
        /// Creates a deep copy of the entity with a new Id.
        /// </summary>
        public abstract Entity Clone();

        /// <summary>
        /// Copies common Entity properties from this instance to the target.
        /// </summary>
        protected void CopyBaseTo(Entity target)
        {
            target.Color = Color;
            target.Layer = Layer;
            target.LineTypeName = LineTypeName;
            target.IsVisible = IsVisible;
            target.Tag = Tag;
        }

        /// <summary>
        /// Type of entity.
        /// </summary>
        public abstract EntityType Type { get; }
    }

    public static class EntityExtensions
    {
        public static List<Entity> CloneAll(this IEnumerable<Entity> entities)
        {
            var result = new List<Entity>();
            foreach (var e in entities)
                result.Add(e.Clone());
            return result;
        }

        public static List<Vector> CollectPoints(this IEnumerable<Entity> entities)
        {
            var points = new List<Vector>();

            foreach (var entity in entities)
            {
                switch (entity.Type)
                {
                    case EntityType.Line:
                        var line = (Line)entity;
                        points.Add(line.StartPoint);
                        points.Add(line.EndPoint);
                        break;

                    case EntityType.Arc:
                        var arc = (Arc)entity;
                        points.Add(arc.StartPoint());
                        points.Add(arc.EndPoint());
                        points.Add(arc.Center.Offset(arc.Radius, 0));
                        points.Add(arc.Center.Offset(-arc.Radius, 0));
                        points.Add(arc.Center.Offset(0, arc.Radius));
                        points.Add(arc.Center.Offset(0, -arc.Radius));
                        break;

                    case EntityType.Circle:
                        var circle = (Circle)entity;
                        points.Add(circle.Center.Offset(circle.Radius, 0));
                        points.Add(circle.Center.Offset(-circle.Radius, 0));
                        points.Add(circle.Center.Offset(0, circle.Radius));
                        points.Add(circle.Center.Offset(0, -circle.Radius));
                        break;

                    case EntityType.Polygon:
                        var polygon = (Polygon)entity;
                        points.AddRange(polygon.Vertices);
                        break;

                    case EntityType.Shape:
                        var shape = (Shape)entity;
                        points.AddRange(shape.Entities.CollectPoints());
                        break;
                }
            }

            return points;
        }

        public static BoundingRectangleResult FindBestRotation(
            this List<Entity> entities,
            double startAngle = 0,
            double endAngle = Angle.TwoPI
        )
        {
            // Check for Shape entity first (recursive case returns early)
            foreach (var entity in entities)
            {
                if (entity.Type == EntityType.Shape)
                {
                    var shape = (Shape)entity;
                    var subResult = shape.Entities.FindBestRotation(startAngle, endAngle);
                    return subResult;
                }
            }

            var points = entities.CollectPoints();

            if (points.Count == 0)
                return new BoundingRectangleResult(startAngle, 0, 0);

            var hull = ConvexHull.Compute(points);

            var constrained = !startAngle.IsEqualTo(0) || !endAngle.IsEqualTo(Angle.TwoPI);

            return constrained
                ? RotatingCalipers.MinimumBoundingRectangle(hull, startAngle, endAngle)
                : RotatingCalipers.MinimumBoundingRectangle(hull);
        }
    }
}