Merge pull request #198 from PowerShellWeb/turtles-in-shape

Turtle 0.1.10

Author: StartAutomating

CHANGELOG.md

@@ -1,3 +1,20 @@
+## Turtle 0.1.10:
+
+* Updated Methods
+  * `Turtle.Star` even point fix (#190)
+  * `Turtle.Polygon` partial polygon support (#194)
+* New Shapes
+  * `Turtle.Rectangle` (#192)
+  * `Turtle.StarFlower` (#191)
+  * `Turtle.GoldenFlower` (#193)
+  * `Turtle.HatMonotile` (#196)
+  * `Turtle.TurtleMonotile` (#195)
+  * `Turtle.BarGraph` (#173)
+* Added Demos
+   * Intro To Turtles (#197)
+   
+---
+
 ## Turtle 0.1.9:
 
 * Turtle Text Path Support

Commands/Get-Turtle.ps1

@@ -188,6 +188,54 @@ function Get-Turtle {
             $flowerPetals2,
             $flowerPetals
         )
+    .EXAMPLE
+        # We can create a Star with N points
+        turtle star 42 5
+
+        turtle star 42 6
+
+        turtle star 42 7
+
+        turtle star 42 8
+    .EXAMPLE
+        # Stars look spectacular when we rotate and repeat them 
+        turtle @('star',42,5,'rotate',72 * 5)
+
+        turtle @('star',42,6,'rotate',60 * 6)
+
+        turtle @('star',42,7,'rotate',(360/7) * 7)
+
+        turtle @('star',42,8,'rotate',45 * 8)
+    .EXAMPLE
+        # When we do this, we call it a Star Flower
+        turtle StarFlower 42
+    .EXAMPLE
+        turtle StarFlower 42 45 8 8
+    .EXAMPLE
+        turtle StarFlower 42 45 8 8
+    .EXAMPLE
+        # StarFlowers look spectacular when morphed
+        turtle StarFlower 42 45 8 24 morph @(
+            turtle StarFlower 42 45 8 24
+            turtle StarFlower 42 15 8 24
+            turtle StarFlower 42 45 8 24
+        )
+    .EXAMPLE
+        # We can rotate the points we morph into.
+        turtle StarFlower 42 45 8 24 morph @(
+            turtle StarFlower 42 45 8 24
+            turtle rotate (Get-Random -Max 360) StarFlower 42 15 8 24
+            turtle StarFlower 42 45 8 24
+        )
+    .EXAMPLE
+        # We can mix the number of points in a star flower morph
+        # 
+        # (as long as we're drawing the same number of points)        
+        turtle StarFlower 42 12 5 30 morph @(
+            turtle StarFlower 42 12 5 30
+            turtle rotate (Get-Random -Max 360) StarFlower 42 14.4 6 25
+            turtle StarFlower 42 12 5 30
+        )
     .EXAMPLE
         # We can construct a 'scissor' by drawing two lines at an angle
         turtle Scissor 42 60

Demos/Turtle_101-Intro-To-Turtles.demo.ps1

@@ -0,0 +1,37 @@
+# Turtle 101 - Intro to Turtles
+
+# Turtle is a groovy graphics system that dates back to 1966.
+
+# Imagine you are a turtle holding a pen.
+
+# You can:
+# * Turn
+# * Move Forward
+# * Pick up the pen
+
+# Using these fundamental basics, we can theoretically draw any shape.
+
+# Let's start simple, by drawing a line
+turtle forward 42 save ./line.svg
+
+# Let's draw a line and take a few turns
+turtle forward 42 rotate 120 forward 42 rotate 120 forward 42 rotate 120 stroke '#4488ff' save ./triangle.svg
+
+# Let's make a square
+turtle forward 42 rotate 90 forward 42 rotate 90 forward 42 rotate 90 forward 42 rotate 90 stroke '#4488ff' save ./square.svg
+
+# Now let's do it the easier way, with square
+turtle square 42 stroke '#4488ff' save ./square2.svg
+
+# Now let's do it the general way, with polygon
+turtle polygon 42 4 stroke '#4488ff' save ./square4.svg
+
+# Our turtle is pretty smart, and so it can draw a lot of shapes for us.
+
+# A classic example is a 'flower', which repeats many polygons
+turtle flower stroke '#4488ff' save ./flower.svg
+
+
+
+
+

Turtle.psd1

@@ -1,6 +1,6 @@
 @{    
     # Version number of this module.
-    ModuleVersion = '0.1.9'
+    ModuleVersion = '0.1.10'
     # Description of the module
     Description = "Turtles in a PowerShell"
     # Script module or binary module file associated with this manifest.
@@ -37,15 +37,21 @@
             # A URL to the license for this module.
             LicenseURI = 'https://github.com/PowerShellWeb/Turtle/blob/main/LICENSE'
             ReleaseNotes = @'
-## Turtle 0.1.9:
-
-* Turtle Text Path Support
-  * `Turtle.get/set_Text` controls the text (#167)
-  * `Turtle.get/set_TextAttribute` sets text attributes (#168)
-  * `Turtle.get/set_TextAnimation` animates text attributes (#171)
-* `Get-Turtle` parameter improvements (#169, #170)
-* `Get-Turtle` tracks invocation info (#157)
+## Turtle 0.1.10:
 
+* Updated Methods
+  * `Turtle.Star` even point fix (#190)
+  * `Turtle.Polygon` partial polygon support (#194)
+* New Shapes
+  * `Turtle.Rectangle` (#192)
+  * `Turtle.StarFlower` (#191)
+  * `Turtle.GoldenFlower` (#193)
+  * `Turtle.HatMonotile` (#196)
+  * `Turtle.TurtleMonotile` (#195)
+  * `Turtle.BarGraph` (#173)
+* Added Demos
+   * Intro To Turtles (#197)
+   
 ---
 
 Additional details available in the [CHANGELOG](https://github.com/PowerShellWeb/Turtle/blob/main/CHANGELOG.md)