offset_faces tested and working

Author: jacobrkerstetter

src/ansys/geometry/core/_grpc/_services/base/faces.py

@@ -148,3 +148,8 @@ def draft_faces(self, **kwargs) -> dict:
     def get_round_info(self, **kwargs) -> dict:
         """Get round information for a selection of faces."""
         pass
+
+    @abstractmethod
+    def offset_faces(self, **kwargs) -> dict:
+        """Offset a selection of faces."""
+        pass

src/ansys/geometry/core/_grpc/_services/v0/faces.py

@@ -520,3 +520,28 @@ def get_round_info(self, **kwargs):  # noqa: D102
             "along_u": response.along_u,
             "radius": response.radius,
         }
+
+    @protect_grpc
+    def offset_faces(self, **kwargs) -> dict:  # noqa: D102
+        from ansys.api.dbu.v0.dbumodels_pb2 import EntityIdentifier
+        from ansys.api.geometry.v0.faces_pb2 import OffsetFacesRequest, OffsetFacesRequestData
+
+        # Create the request - assumes all inputs are valid and of the proper type
+        request = OffsetFacesRequest(
+            request_data=[OffsetFacesRequestData(
+                faces=[EntityIdentifier(id=face_id) for face_id in kwargs["face_ids"]],
+                offset=from_measurement_to_server_length(kwargs["distance"]),
+                direction=from_unit_vector_to_grpc_direction(kwargs["direction"]),
+                extrude_type=kwargs["extrude_type"].value,
+            )]
+        )
+
+        # Call the gRPC service
+        response = self.stub.OffsetFaces(request=request)
+
+        # Return the response - formatted as a dictionary
+        return {
+            "results": [
+                [face.id for face in response_data.new_faces]
+            for response_data in response.response_data]
+        }

src/ansys/geometry/core/_grpc/_services/v1/faces.py

@@ -134,3 +134,7 @@ def draft_faces(self, **kwargs) -> dict:  # noqa: D102
     @protect_grpc
     def get_round_info(self, **kwargs):  # noqa: D102
         raise NotImplementedError
+    
+    @protect_grpc
+    def offset_faces(self, **kwargs):  # noqa: D102
+        raise NotImplementedError

src/ansys/geometry/core/designer/geometry_commands.py

@@ -1763,3 +1763,33 @@ def thicken_faces(
 
         # Return success flag
         return result.get("success")
+
+    @min_backend_version(26, 1, 0)
+    def offset_faces(
+        self,
+        faces: list["Face"],
+        distance: Distance | Quantity | Real,
+        direction: UnitVector3D,
+        extrude_type: ExtrudeType,
+    ) -> None:
+        """Offset the specified faces by the specified distance in the specified direction.
+
+        Parameters
+        ----------
+        faces : list[Face]
+            The faces to offset.
+        distance : Distance | Quantity | Real
+            The distance to offset the faces.
+        direction : UnitVector3D
+            The direction to offset the faces.
+        extrude_type : ExtrudeType
+            The type of extrusion to use.
+        """
+        distance = distance if isinstance(distance, Distance) else Distance(distance)
+
+        _ = self._grpc_client._services.faces.offset_faces(
+            face_ids=[face.id for face in faces],
+            distance=distance,
+            direction=direction,
+            extrude_type=extrude_type,
+        )

tests/integration/test_geometry_commands.py

@@ -1405,3 +1405,30 @@ def test_thicken_surface_body(modeler: Modeler):
     assert design.bodies[0].volume.m == pytest.approx(
         Quantity(0.4, UNITS.m**3).m, rel=1e-6, abs=1e-8
     )
+
+def test_offset_faces(modeler: Modeler):
+    """Test offsetting faces."""
+    design = modeler.create_design("offset_faces")
+    box = design.extrude_sketch("box", Sketch().box(Point2D([0, 0]), 2, 2), 2)
+
+    assert len(box.faces) == 6
+    assert box.volume.m == pytest.approx(Quantity(8, UNITS.m**3).m, rel=1e-6, abs=1e-8)
+
+    # Offset the top face
+    modeler.geometry_commands.offset_faces([box.faces[1]], 0.1, UNITVECTOR3D_Z, ExtrudeType.ADD)
+
+    assert box.volume.m == pytest.approx(Quantity(8.4, UNITS.m**3).m, rel=1e-6, abs=1e-8)
+
+    # Test with two boxes
+    box2 = design.extrude_sketch("box2", Sketch().box(Point2D([3, 0]), 2, 2), 2)
+
+    assert len(box2.faces) == 6
+    assert box2.volume.m == pytest.approx(Quantity(8, UNITS.m**3).m, rel=1e-6, abs=1e-8)
+
+    # Offset the top face of both boxes
+    modeler.geometry_commands.offset_faces(
+        [box.faces[1], box2.faces[1]], 0.1, UNITVECTOR3D_Z, ExtrudeType.ADD
+    )
+
+    assert box.volume.m == pytest.approx(Quantity(8.8, UNITS.m**3).m, rel=1e-6, abs=1e-8)
+    assert box2.volume.m == pytest.approx(Quantity(8.4, UNITS.m**3).m, rel=1e-6, abs=1e-8)