From b321a7270d391d188a4d553e38019622354c3a72 Mon Sep 17 00:00:00 2001
From: Luiz Henrique Cassettari <ricaun@gmail.com>
Date: Fri, 14 Jun 2024 16:12:10 -0300
Subject: [PATCH] Add `CreateLines` in `ShapeCreator`

---
 CHANGELOG.md                          |  1 +
 Directory.Build.props                 |  2 +-
 ricaun.Revit.DB.Shape/ShapeCreator.cs | 58 ++++++++++++++++++++++++++-
 3 files changed, 58 insertions(+), 3 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 50e3823..0967f6f 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -11,6 +11,7 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.
 - Add `ColorExtension` with `ColorEquals`, `Lerp`, `ToColor` and `ToColorWithTransparency`.
 - Add `ColorExtension` with `ToHex` for `Color` and `ColorWithTransparency`
 - Update `CreateBoxLines` with `graphicsStyleId`
+- Add `CreateLines` in `ShapeCreator`
 ### Tests
 - Test all color names in `System.Windows.Media.Colors` with `Colors`.
 - Test all 9 colors in `MaterialUtils` and `GraphicsStyleUtils`.
diff --git a/Directory.Build.props b/Directory.Build.props
index e576d89..35b57a8 100644
--- a/Directory.Build.props
+++ b/Directory.Build.props
@@ -1,6 +1,6 @@
 <Project>
 	<PropertyGroup>
-		<Version>0.3.2-rc.3</Version>
+		<Version>0.3.2-rc.4</Version>
     <RevitVersionTests>2024</RevitVersionTests>
     <RevitVersionCoreTests>2025</RevitVersionCoreTests>
     <RevitForceOpenClose>true</RevitForceOpenClose>
diff --git a/ricaun.Revit.DB.Shape/ShapeCreator.cs b/ricaun.Revit.DB.Shape/ShapeCreator.cs
index d7b2cf3..261387e 100644
--- a/ricaun.Revit.DB.Shape/ShapeCreator.cs
+++ b/ricaun.Revit.DB.Shape/ShapeCreator.cs
@@ -15,7 +15,59 @@ public static class ShapeCreator
         /// Default Sides for Prisms and Pyramids.
         /// </summary>
         internal const int Sides = 3;
-        #region Box
+
+        #region Lines
+        /// <summary>
+        /// Creates an array of <see cref="Line"/> objects from a collection of <see cref="Autodesk.Revit.DB.XYZ"/> points.
+        /// </summary>
+        /// <param name="points">A collection of <see cref="Autodesk.Revit.DB.XYZ"/> points to create lines from.</param>
+        /// <param name="closed">
+        /// A boolean value indicating whether the lines should form a closed loop.
+        /// If true, an additional line will be created from the last point back to the first point.
+        /// </param>
+        /// <returns>
+        /// An array of <see cref="Line"/> objects representing the lines created from the specified points.
+        /// </returns>
+        public static Line[] CreateLines(IEnumerable<XYZ> points, bool closed)
+        {
+            return CreateLines(points, null, closed);
+        }
+        /// <summary>
+        /// Creates an array of <see cref="Line"/> objects from a collection of <see cref="Autodesk.Revit.DB.XYZ"/> points.
+        /// </summary>
+        /// <param name="points">A collection of <see cref="Autodesk.Revit.DB.XYZ"/> points to create lines from.</param>
+        /// <param name="graphicsStyleId">
+        /// An optional <see cref="Autodesk.Revit.DB.ElementId"/> representing the graphics style to apply to the lines. 
+        /// If null, the default graphics style will be used.
+        /// </param>
+        /// <param name="closed">
+        /// A boolean value indicating whether the lines should form a closed loop.
+        /// If true, an additional line will be created from the last point back to the first point.
+        /// </param>
+        /// <returns>
+        /// An array of <see cref="Line"/> objects representing the lines created from the specified points.
+        /// </returns>
+        public static Line[] CreateLines(IEnumerable<XYZ> points, ElementId graphicsStyleId = null, bool closed = false)
+        {
+            var lines = new List<Line>();
+            var pointsArray = points.ToArray();
+
+            for (int i = 0; i < pointsArray.Length - 1; i++)
+            {
+                var line = CreateBound(pointsArray[i], pointsArray[i + 1], graphicsStyleId);
+                if (line is not null)
+                    lines.Add(line);
+            }
+
+            if (closed)
+            {
+                var line = CreateBound(pointsArray[0], pointsArray[pointsArray.Length - 1], graphicsStyleId);
+                if (line is not null)
+                    lines.Add(line);
+            }
+
+            return lines.ToArray();
+        }
         /// <summary>
         /// Creates an array of lines representing the edges of a 3D box with the specified minimum and maximum points.
         /// </summary>
@@ -64,7 +116,7 @@ public static Line[] CreateBoxLines(XYZ min, XYZ max, ElementId graphicsStyleId
 
             return lines.OfType<Line>().ToArray();
         }
-        private static Line CreateBound(XYZ point1, XYZ point2, ElementId graphicsStyleId = null)
+        internal static Line CreateBound(XYZ point1, XYZ point2, ElementId graphicsStyleId = null)
         {
             try
             {
@@ -78,6 +130,8 @@ private static Line CreateBound(XYZ point1, XYZ point2, ElementId graphicsStyleI
             catch { }
             return null;
         }
+        #endregion
+        #region Box
         /// <summary>
         /// Creates a 3D box with the specified center and size.
         /// </summary>