Add a Mirror command

js/CADWorker/CascadeStudioStandardLibrary.js

@@ -400,6 +400,31 @@ function Rotate(axis, degrees, shapes, keepOriginal) {
   return rotated;
 }
 
+function Mirror(vector, shapes, keepOriginal) {
+  if (!vector) { vector = [1, 0, 0]; }
+  const mirrored = CacheOp(arguments, () => {
+    const mirrorTransform   = new oc.gp_Trsf();
+    const mirrorPlaneOrigin = new oc.gp_Pnt(0, 0, 0);
+    const mirrorPlaneNormal = new oc.gp_Dir(vector[0], vector[1], vector[2]);
+    mirrorTransform.SetMirror(new oc.gp_Ax2(mirrorPlaneOrigin, mirrorPlaneNormal));
+    const mirroring = new oc.TopLoc_Location(mirrorTransform);
+
+    if (!isArrayLike(shapes)) {
+      return new oc.TopoDS_Shape(shapes.Moved(mirroring).Reversed());
+    } else if (shapes.length >= 1) {
+      let newMirroring = [];
+      for (let shapeIndex = 0; shapeIndex < shapes.length; shapeIndex++) {
+        newMirroring.push(new oc.TopoDS_Shape(shapes[shapeIndex].Moved(mirroring).Reversed()));
+      }
+      return newMirroring;
+    }
+  })
+  if (!keepOriginal) { sceneShapes = Remove(sceneShapes, shapes); }
+  sceneShapes.push(mirrored);
+
+  return mirrored;
+}
+
 function Scale(scale, shapes, keepOriginal) {
   let scaled = CacheOp(arguments, () => {
     let transformation = new oc.gp_Trsf();

js/MainPage/CascadeMain.js

@@ -11,7 +11,7 @@ window.workerWorking = false;
 
 let starterCode = 
 `// Welcome to Cascade Studio!   Here are some useful functions:
-//  Translate(), Rotate(), Scale(), Union(), Difference(), Intersection()
+//  Translate(), Rotate(), Scale(), Mirror(), Union(), Difference(), Intersection()
 //  Box(), Sphere(), Cylinder(), Cone(), Text3D(), Polygon()
 //  Offset(), Extrude(), RotatedExtrude(), Revolve(), Pipe(), Loft(), 
 //  FilletEdges(), ChamferEdges(),

js/StandardLibraryIntellisense.ts

@@ -194,6 +194,11 @@ function Translate(offset: number[], shape: oc.TopoDS_Shape, keepOriginal?: bool
  * @example```let leaningCylinder = Rotate([0, 1, 0], 45, Cylinder(25, 50));```*/
 function Rotate(axis: number[], degrees: number, shape: oc.TopoDS_Shape, keepOriginal?: boolean): oc.TopoDS_Shape;
 
+/** Mirror this shape about 3-coordinate normal vector
+ * [Source](https://github.com/zalo/CascadeStudio/blob/master/js/CADWorker/CascadeStudioStandardLibrary.js)
+ * @example```let mirrored = Mirror([0, 0, 1] , Text3D("Hello!"));```*/
+function Mirror(vector: number[], shape: oc.TopoDS_Shape, keepShape?: boolean): oc.TopoDS_Shape;
+
 /** Scale a shape to be `scale` times its current size.
  * [Source](https://github.com/zalo/CascadeStudio/blob/master/js/CADWorker/CascadeStudioStandardLibrary.js)
  * @example```let scaledCylinder = Scale(50, Cylinder(0.5, 1));```*/