Files
make-cad/docs/api/shell_rsolid.md
T
倪旌哲 b80a323445 feat: Add automation scripts for updating API exports and syncing documentation
- Introduced `make_export.py` to automate the update of `__init__.py` with new API functions from `operations.py` and `evolve.py`.
- Implemented function extraction, categorization, and generation of import statements and aliases.
- Added `ragflow_sync.py` for synchronizing SimpleCADAPI documentation with RAGFlow database, including chunking markdown files and managing dataset.
- Updated package version to 1.0.5 in `uv.lock`.
2025-07-24 02:11:44 +08:00

1.4 KiB

shell_rsolid

API定义

def shell_rsolid(solid: Solid, faces_to_remove: List[Face], thickness: float) -> Solid

来源文件: operations.py

API作用

将实体转换为空心结构,常用于创建容器、外壳等。通过移除指定面 创建开口,壁厚决定了外壳的厚度。如果不移除任何面则创建闭合空心体。

API参数说明

solid

  • 类型: Solid
  • 说明: 要抽壳的实体对象

faces_to_remove

  • 类型: List[Face]
  • 说明: 要移除的面列表,这些面将被开口, 如果为空列表则不移除任何面(闭合抽壳)

thickness

  • 类型: float
  • 说明: 壁厚,必须为正数,定义抽壳后的壁厚度

返回值说明

Solid: 抽壳后的实体对象,内部为空心结构

异常

  • ValueError: 当壁厚小于等于0或抽壳操作失败时抛出异常

API使用例子

# 创建空心立方体容器
box = make_box_rsolid(4, 4, 4)
top_faces = [f for f in box.get_faces() if f.has_tag("top")]
container = shell_rsolid(box, top_faces, 0.2)
# 创建空心球体
sphere = make_sphere_rsolid(3.0)
# 不移除任何面,创建闭合空心球
hollow_sphere = shell_rsolid(sphere, [], 0.3)
# 创建有开口的圆柱体容器
cylinder = make_cylinder_rsolid(2.0, 5.0)
top_faces = [f for f in cylinder.get_faces() if f.has_tag("top")]
cup = shell_rsolid(cylinder, top_faces, 0.1)