pythonocc基础：OCC.Core.BRepPrimAPI类介绍

OCC (Open CASCADE Technology) 是一个开源的三维几何建模内核，广泛应用于CAD/CAM/CAE软件开发。OCC.Core.BRepPrimAPI 模块是 OCC 库的一部分，专门用于创建各种基础的三维几何体（也称为“原始”或“基元”形状）。这些基元形状是构建更复杂几何模型的基本构建块。

BRepPrimAPI 的作用

• 快速原型：允许用户快速创建标准的几何形状，如球体、立方体、圆柱、圆锥等，便于初步设计或作为复杂几何体的组成部分。
• 参数化建模：提供的方法允许通过参数（如半径、高度、宽度等）精确控制基元形状的尺寸和位置。
• 集成性：作为 OCC 库的核心组件，BRepPrimAPI 创建的形状可以直接与其他高级建模功能（如布尔运算、变形、装配等）结合使用。

以下是BRepPrimAPI模块中包含的一些主要构造器类及其对应的几何实体：

1. BRepPrimAPI_MakeBox：创建立方体或矩形块，需要指定长度、宽度和高度。
2. BRepPrimAPI_MakeCylinder：创建圆柱体，需要指定半径和高度。
3. BRepPrimAPI_MakeCone：创建圆锥体，需要指定底面半径、顶面半径（可选，默认与底面相同）和高度。
4. BRepPrimAPI_MakeSphere：如之前所述，创建球体，仅需指定半径。
5. BRepPrimAPI_MakeTorus：创建环面（或 torus），需要指定主半径（从中心到管的中心）和次半径（管的半径）。
6. BRepPrimAPI_Make Prism：创建棱柱，需要一个二维轮廓和高度。
7. BRepPrimAPI_MakeRevolution：通过旋转二维轮廓来创建旋转体，需要轮廓和旋转轴以及旋转角度。

  8、BRepPrimAPI_MakePipe：创建管道，通常需要一个引导线（wire）和一个轮廓（profile）。

常用方法

以下是一些 BRepPrimAPI 中常用的方法及其简要说明：

1. BRepPrimAPI_MakeBox

   • 用于创建立方体。需要指定长、宽、高三个参数。
   Python

   1from OCC.Core.BRepPrimAPI import BRepPrimAPI_MakeBox
   2box = BRepPrimAPI_MakeBox(10., 10., 10.).Shape()

10., 10., 10.分别代表立方体沿X、Y、Z轴的尺寸。

1. BRepPrimAPI_MakeSphere

   • 用于创建球体。需要指定球的半径。
   Python

   1from OCC.Core.BRepPrimAPI import BRepPrimAPI_MakeSphere
   2sphere = BRepPrimAPI_MakeSphere(5.).Shape()

5.定义了球体的半径。你可以根据需要调整这个值来创建不同大小的球体。

1. BRepPrimAPI_MakeCylinder

   • 创建圆柱体。需要指定底面半径、高度和轴的方向（默认为Z轴）。
   Python

   1from OCC.Core.BRepPrimAPI import BRepPrimAPI_MakeCylinder
   2cylinder = BRepPrimAPI_MakeCylinder(3., 10.).Shape()

radius参数定义了圆柱底面的半径，height参数定义了圆柱的高度。BRepPrimAPI_MakeCylinder(radius, height)创建了一个圆柱构造器对象，通过调用其Shape()方法，我们可以获取到表示圆柱的TopoDS_Shape对象。

1. BRepPrimAPI_MakeCone

   • 创建圆锥体。需要指定底面半径、顶面半径（可以相同，形成直圆锥）、高度和轴的方向（默认为Z轴）。
   Python

   1from OCC.Core.BRepPrimAPI import BRepPrimAPI_MakeCone
   2cone = BRepPrimAPI_MakeCone(5., 2., 10.).Shape()

使用BRepPrimAPI_MakeCone，你可以通过设置几个基本参数来定义所需的圆锥形态：

• 底面半径（BottomRadius）：圆锥底部的半径。
• 顶面半径（TopRadius）：圆锥顶部的半径。如果不指定，默认情况下会创建一个直圆锥，即顶面半径为0。
• 高度（Height）：圆锥的高度，即从底面中心到顶面中心的距离。

1. BRepPrimAPI_MakeTorus

   • 创建环面（圆环体）。需要指定主半径（从中心到管的中心）和次半径（管的半径）。
   Python

   1from OCC.Core.BRepPrimAPI import BRepPrimAPI_MakeTorus
   2torus = BRepPrimAPI_MakeTorus(10., 3.).Shape()

圆环体是一种三维几何体，它有一个中心环状圆柱面，由一个大圆（称为外围圆）和围绕该圆均匀分布的小圆（横截面圆）组成。圆环体有两个主要参数：大圆的半径（外围半径）和小圆的半径（管状半径）。

每个 Make* 类都遵循类似的模式：通过构造函数指定必要的参数，然后调用 .Shape() 方法获取创建的 TopoDS_Shape 对象，该对象代表了在三维空间中的几何实体。

这些基元形状的创建方法为开发复杂的CAD应用提供了一个坚实的基础，并且由于它们是参数化的，因此非常灵活，易于在设计过程中调整。