feat: offset faces set radius implementation + testing (#1769)

Co-authored-by: jkerstet <[email protected]>
Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Co-authored-by: pyansys-ci-bot <[email protected]>
Co-authored-by: Roberto Pastor Muela <[email protected]>

Author: 4 people

doc/changelog.d/1769.added.md

@@ -0,0 +1 @@
+offset faces set radius implementation + testing

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

@@ -37,6 +37,7 @@
     FullFilletRequest,
     ModifyCircularPatternRequest,
     ModifyLinearPatternRequest,
+    OffsetFacesSetRadiusRequest,
     PatternRequest,
     RenameObjectRequest,
     ReplaceFaceRequest,
@@ -1212,3 +1213,55 @@ def get_round_info(self, face: "Face") -> tuple[bool, Real]:
         result = self._commands_stub.GetRoundInfo(RoundInfoRequest(face=face._grpc_id))
 
         return (result.along_u, result.radius)
+
+    @protect_grpc
+    @min_backend_version(25, 2, 0)
+    def offset_faces_set_radius(
+        self,
+        faces: Union["Face", list["Face"]],
+        radius: Real,
+        copy: bool = False,
+        offset_mode: OffsetMode = OffsetMode.IGNORE_RELATIONSHIPS,
+        extrude_type: ExtrudeType = ExtrudeType.FORCE_INDEPENDENT,
+    ) -> bool:
+        """Offset faces with a radius.
+
+        Parameters
+        ----------
+        faces : Face | list[Face]
+            Faces to offset.
+        radius : Real
+            Radius of the offset.
+        copy : bool, default: False
+            Copy the face and move it instead of offsetting the original face if ``True``.
+        offset_mode : OffsetMode, default: OffsetMode.MOVE_FACES_TOGETHER
+            Mode of how to handle offset relationships.
+        extrude_type : ExtrudeType, default: ExtrudeType.FORCE_INDEPENDENT
+            Type of extrusion to be performed.
+
+        Returns
+        -------
+        bool
+            ``True`` when successful, ``False`` when failed.
+        """
+        from ansys.geometry.core.designer.face import Face
+
+        faces: list[Face] = faces if isinstance(faces, list) else [faces]
+
+        check_type_all_elements_in_iterable(faces, Face)
+        check_is_float_int(radius, "radius")
+
+        for face in faces:
+            face.body._reset_tessellation_cache()
+
+        result = self._commands_stub.OffsetFacesSetRadius(
+            OffsetFacesSetRadiusRequest(
+                faces=[face._grpc_id for face in faces],
+                radius=radius,
+                copy=copy,
+                offset_mode=offset_mode.value,
+                extrude_type=extrude_type.value,
+            )
+        )
+
+        return result.success

tests/integration/test_geometry_commands.py

@@ -990,3 +990,22 @@ def test_update_fill_pattern_on_imported_geometry_faces(modeler: Modeler):
     assert design.bodies[0].volume.m == pytest.approx(
         Quantity(4.70663693e-6, UNITS.m**3).m, rel=1e-6, abs=1e-8
     )
+
+
+def test_offset_face_set_radius(modeler: Modeler):
+    """Test offsetting a face with a set radius"""
+    design = modeler.create_design("offset_face_set_radius")
+    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)
+
+    # Add a hole to a box
+    hole = design.extrude_sketch("hole", Sketch().circle(Point2D([0, 0]), 0.5), 2)
+    box.subtract(hole)
+    assert box.volume.m == pytest.approx(Quantity(6.4292, UNITS.m**3).m, rel=1e-6, abs=1e-8)
+
+    # Change radius of hole
+    success = modeler.geometry_commands.offset_faces_set_radius(box.faces[6], 0.25)
+    assert success
+
+    assert box.volume.m == pytest.approx(Quantity(7.6073, UNITS.m**3).m, rel=1e-6, abs=1e-8)