Class TCSG

subtractCutter

• subtractCutter(
      target:
          | Object3D<Object3DEventMap>
          | BufferGeometry<NormalBufferAttributes, BufferGeometryEventMap>,
      cutter:
          | Object3D<Object3DEventMap>
          | BufferGeometry<NormalBufferAttributes, BufferGeometryEventMap>,
      cutterPose: CutterWorldPose,
  ): BufferGeometry

  对被切模型与剪刀模型做差集（目标 − 剪刀），剪刀由 cutterPose 指定在世界中的切割位姿。

  • target：被切体，支持含多 Mesh 的 Object3D（内部合并到世界空间），或直接传入已合并的 BufferGeometry（视为已在世界空间）。
  • cutter：BufferGeometry 视为局部空间网格，位姿作用在 Brush 上；Object3D 会先 clone(true) 再按 cutterPose 设根变换后合并烘焙（不修改场景中原对象）。
  • 返回值：新的 BufferGeometry；赋给展示 Mesh 后请自行 dispose 旧几何。

  Parameters

  • target:
        | Object3D<Object3DEventMap>
        | BufferGeometry<NormalBufferAttributes, BufferGeometryEventMap>
  • cutter:
        | Object3D<Object3DEventMap>
        | BufferGeometry<NormalBufferAttributes, BufferGeometryEventMap>
  • cutterPose: CutterWorldPose

  Returns BufferGeometry