Added Maker Coin example

docs/examples_1.rst

@@ -49,9 +49,9 @@ Most of the examples show the builder and algebra modes.
             :link: examples-circuit_board
             :link-type: ref
 
-    .. grid-item-card:: Stud Wall |Algebra| 
+    .. grid-item-card:: Maker Coin |Builder| 
-            :img-top: assets/examples/stud_wall.png
+            :img-top: assets/examples/maker_coin.png
-            :link: stud_wall
+            :link: maker_coin
             :link-type: ref
 
     .. grid-item-card:: Platonic Solids |Algebra| 
@@ -59,6 +59,12 @@ Most of the examples show the builder and algebra modes.
             :link: platonic_solids
             :link-type: ref
 
+    .. grid-item-card:: Stud Wall |Algebra| 
+            :img-top: assets/examples/stud_wall.png
+            :link: stud_wall
+            :link-type: ref
+
+
 .. NOTE 01: insert new example thumbnails above this line
 
 .. TODO: Copy this block to add the example thumbnails here
@@ -249,22 +255,27 @@ This example demonstrates placing holes around a part.
         :start-after: [Code]
         :end-before: [End]
 
-.. _stud_wall:
 
-Stud Wall
+.. _maker_coin:
----------
+
-.. image:: assets/examples/stud_wall.png
+Maker Coin
+----------
+.. image:: assets/examples/maker_coin.png
     :align: center
 
-This example demonstrates creatings custom `Part` objects and putting them into
+This example creates the maker coin as defined by Angus on the Maker's Muse
-assemblies. The custom object is a `Stud` used in the building industry while
+YouTube channel. There are two key features:
-the assembly is a `StudWall` created from copies of `Stud` objects for efficiency.
-Both the `Stud` and `StudWall` objects use `RigidJoints` to define snap points which
-are used to position all of objects.   
 
-.. dropdown:: |Algebra| Reference Implementation (Algebra Mode) 
+#. the use of :class:`~objects_curve.DoubleTangentArc` to create a smooth 
+   transition from the central dish to the outside arc, and
 
-    .. literalinclude:: ../examples/stud_wall.py
+#. embossing the text into the top of the coin not just as a simple
+   extrude but from a projection which results in text with even depth.
+
+
+.. dropdown:: |Builder| Reference Implementation (Builder Mode) 
+
+    .. literalinclude:: ../examples/maker_coin.py
         :start-after: [Code]
         :end-before: [End]
 
@@ -293,6 +304,27 @@ embodying ideals of symmetry and balance.
         :start-after: [Code]
         :end-before: [End]
 
+.. _stud_wall:
+
+Stud Wall
+---------
+.. image:: assets/examples/stud_wall.png
+    :align: center
+
+This example demonstrates creatings custom `Part` objects and putting them into
+assemblies. The custom object is a `Stud` used in the building industry while
+the assembly is a `StudWall` created from copies of `Stud` objects for efficiency.
+Both the `Stud` and `StudWall` objects use `RigidJoints` to define snap points which
+are used to position all of objects.   
+
+.. dropdown:: |Algebra| Reference Implementation (Algebra Mode) 
+
+    .. literalinclude:: ../examples/stud_wall.py
+        :start-after: [Code]
+        :end-before: [End]
+    
+
+
 .. NOTE 02: insert new example thumbnails above this line
     
 

examples/maker_coin.py

@@ -0,0 +1,68 @@
+"""
+Maker Coin
+
+name: maker_coin.py
+by:   Gumyr
+date: Febrary 27, 2024
+
+desc:
+    This example creates the maker coin as defined by Angus on the Maker's Muse
+    YouTube channel. There are two key features:
+    1) the use of DoubleTangentArc to create a smooth transition from the
+       central dish to the external arc.
+    2) embossing the text into the top of the coin not just as a simple
+       extrude but from a projection which results in text with even depth.
+
+license:
+
+    Copyright 2023 Gumyr
+
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+
+        http://www.apache.org/licenses/LICENSE-2.0
+
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
+"""
+
+from build123d import *
+from ocp_vscode import *
+
+# [Code]
+# Coin Parameters
+diameter, thickness = 50 * MM, 10 * MM
+
+with BuildPart() as maker_coin:
+    # On XZ plane draw the profile of half the coin
+    with BuildSketch(Plane.XZ) as profile:
+        with BuildLine() as outline:
+            l1 = Polyline((0, thickness * 0.6), (0, 0), ((diameter - thickness) / 2, 0))
+            l2 = JernArc(
+                start=l1 @ 1, tangent=l1 % 1, radius=thickness / 2, arc_size=300
+            )  # extend the arc beyond the intersection but not closed
+            l3 = DoubleTangentArc(l1 @ 0, tangent=(1, 0), other=l2)
+        make_face()  # make it a 2D shape
+    revolve()  # revolve 360°
+
+    # Pattern the detents around the coin
+    with BuildSketch() as detents:
+        with PolarLocations(radius=(diameter + 5) / 2, count=8):
+            Circle(thickness * 1.4 / 2)
+    extrude(amount=thickness, mode=Mode.SUBTRACT)  # cut away the detents
+
+    fillet(maker_coin.edges(Select.NEW), 2)  # fillet the cut edges
+
+    # Add an embossed label
+    with BuildSketch(Plane.XY.offset(thickness)) as label:  # above coin
+        Text("OS", font_size=15)
+    project()  # label on top of coin
+    extrude(amount=-thickness / 5, mode=Mode.SUBTRACT)  # emboss label
+
+show(maker_coin)
+# [End]