### 关于 PythonOCC 中 Manipulator 的用法 PythonOCC 是一个用于 CAD 开发的强大库，它允许开发者通过编程方式创建、操作几何模型。Manipulator（操纵器）通常被用来控制对象的空间变换，比如平移、旋转和缩放。 以下是有关 PythonOCC 中 `manipulator` 使用的一些核心概念以及示例： #### 什么是 Manipulator？ 在 PythonOCC 中，`AIS_Manipulator` 或类似的类提供了交互式的控件来调整显示的对象属性。这些控件可以绑定到 GUI 组件上，从而让用户能够直观地修改物体的位置或方向[^1]。 #### 基本使用方法 为了实现对几何体的操作，可以通过以下步骤完成设置： - 创建一个 AIS_InteractiveObject 对象表示要操控的目标。 - 初始化并附加一个合适的 manipulator 到该目标。 - 将其集成至图形场景中以便用户界面支持动态更新。 下面给出一段简单的代码片段展示如何配置基本的 transform manipulator: ```python from OCC.Core.AIS import AIS_Shape from OCC.Core.BRepPrimAPI import BRepPrimAPI_MakeBox from OCC.Display.SimpleGui import init_display from OCC.Extend.TopologyUtils import TopologyExplorer import OCC.Core.Quantity as Quantity from OCC.Core.Graphic3d import Graphic3d_NameOfMaterial, Graphic3d_NOM_DEFAULT from OCC.Core.V3d import V3d_Xpos, V3d_Ypos, V3d_Zpos from OCC.Core.Aspect import Aspect_TOL_SOLID, Aspect_FillMethod from OCC.Core.gp import gp_Ax2, gp_Pnt, gp_Dir from OCC.Core.PrsMgr import PrsMgr_PresentationManager3d from OCC.Core.Prs3d import Prs3d_Drawer from OCC.Core.AIS import AIS_TransientDrawer from OCC.Core quantity import Quantity_Color, Quantity_TOC_RGB from OCC.Core.TColgp import TColgp_Array1OfPnt from OCC.Core.GeomAPI import GeomAPI_Interpolate from OCC.Core.GeomAbs import GeomAbs_C0 from OCC.Core.Visualization import DisplayShape # Initialize the display display, start_display, add_menu, add_function_to_menu = init_display() # Create a box shape box_shape = BRepPrimAPI_MakeBox(10., 20., 30.).Shape() ais_box = AIS_Shape(box_shape) # Set color for better visibility color = Quantity_Color(Quantity_TOC_RGB, 0.8, 0.8, 0.) ais_box.SetColor(color) # Enable selection mode so that we can attach manipulators later. ais_box.SetSelectionPriority(True) # Add to context (this makes it visible within viewer). context = display.GetContext().GetObject() context.Display(ais_box.GetHandle(), True) # Now create an interactive manipulator associated with this object's transformation matrix. manip = ais_box.DynamicHilightStructure().GetObject().NewTransformPersistence(gp_Ax2()) if not manip.Nullify(): # Attach manipulator into scene graph structure under control of presentation manager. pmgr = PrsMgr_PresentationManager3d(context.PresentationManager()) drawer = Prs3d_Drawer() material = Graphic3d_NameOfMaterial(Graphic3d_NOM_DEFAULT) aspect_line = drawer.LineAspect().GetObject() aspect_face = drawer.ShadingAspect().GetObject() manip.Activate(aspect_line, aspect_face, material) # Refresh rendering after changes made above. display.FitAll() start_display() ``` 此脚本展示了怎样构建一个立方体形状，并为其分配可拖拽的手柄以改变位置或者姿态等功能。 #### 注意事项 当实际应用时需要注意性能优化问题；过多复杂的 geometries 可能会影响响应速度。因此建议仅针对必要的部分启用此类功能。