latest polyhedron implementations

src/compas/geometry/polyhedron.py

@@ -578,8 +578,8 @@ def boolean_union(self, other):
         Examples
         --------
         >>> from compas.geometry import Box, Sphere
-        >>> A = Box(2).to_polyhedron()
-        >>> B = Sphere(point=[1, 1, 1], radius=1.0).to_polyhedron(u=16)
+        >>> A = Box(2).to_polyhedron(triangulated=True)
+        >>> B = Sphere(point=[1, 1, 1], radius=1.0).to_polyhedron(triangulated=True)
         >>> C = A.boolean_union(B)
 
         """
@@ -607,8 +607,8 @@ def boolean_difference(self, other):
         Examples
         --------
         >>> from compas.geometry import Box, Sphere
-        >>> A = Box(2).to_polyhedron()
-        >>> B = Sphere(point=[1, 1, 1], radius=1.0).to_polyhedron(u=16)
+        >>> A = Box(2).to_polyhedron(triangulated=True)
+        >>> B = Sphere(point=[1, 1, 1], radius=1.0).to_polyhedron(triangulated=True)
         >>> C = A.boolean_difference(B)
 
         """
@@ -636,8 +636,8 @@ def boolean_intersection(self, other):
         Examples
         --------
         >>> from compas.geometry import Box, Sphere
-        >>> A = Box(2).to_polyhedron()
-        >>> B = Sphere(point=[1, 1, 1], radius=1.0).to_polyhedron(u=16)
+        >>> A = Box(2).to_polyhedron(triangulated=True)
+        >>> B = Sphere(point=[1, 1, 1], radius=1.0).to_polyhedron(triangulated=True)
         >>> C = A.boolean_intersection(B)
 
         """

src/compas/geometry/shapes/shape.py

@@ -82,7 +82,7 @@ def frame(self):  # type: () -> Frame
         return self._frame
 
     @frame.setter
-    def frame(self, frame):  # type: (Frame) -> None
+    def frame(self, frame):  # type: (Frame | None) -> None
         if not frame:
             self._frame = None
         else:
@@ -167,7 +167,7 @@ def lines(self):  # type: () -> list[Line]
     @property
     def polygons(self):  # type: () -> list[Polygon]
         vertices = self.compute_vertices()
-        return [[Polygon([vertices[v] for v in face])] for face in self.faces]
+        return [Polygon([vertices[v] for v in face]) for face in self.faces]
 
     # =============================================================================
     # Constructors
@@ -225,7 +225,7 @@ def compute_triangles(self):  # type: () -> list[tuple[int, int, int]]
     # =============================================================================
 
     def to_vertices_and_faces(self, triangulated=False, u=None, v=None):
-        # type: (bool, int | None, int | None) -> tuple[list[list[float]], list[list[int]]]
+        # type: (bool, int | None, int | None) -> tuple[list[list[float]], list[list[int]] | list[tuple[int, int, int]]]
         """Convert the shape to a list of vertices and faces.
 
         Parameters