Bitbybit Docs
    Preparing search index...

    Class BabylonGizmoManager

    Gizmo 管理器一次拥有一个已附加网格的屏幕操纵器,默认情况下会将它们附加到指针点击的任何对象上。使用你想启用的 Gizmo 创建它,然后从中读取各个位置、旋转、缩放和边界框 Gizmo 进行调整。

    Index

    Constructors

    create

    • 创建一个启用了所选 Gizmo 的 Gizmo 管理器:位置箭头、旋转环、缩放手柄和包围盒。

      usePointerToAttachGizmos 为 true 时,Gizmo 附加到用户点击的网格上,给出 attachableMeshes 列表时仅限于该列表;clearGizmoOnEmptyPointerEvent 在点击空白处时将其分离。

      Parameters

      • inputs: CreateGizmoDto

        要启用的 Gizmo、可附加的网格、指针行为和缩放比例

      Returns GizmoManager

      Gizmo 管理器

      const manager = bitbybit.babylon.gizmo.manager.createGizmoManager({ positionGizmoEnabled: true, rotationGizmoEnabled: true, scaleGizmoEnabled: false, boundingBoxGizmoEnabled: false, attachableMeshes: [], usePointerToAttachGizmos: false, clearGizmoOnEmptyPointerEvent: false, scaleRatio: 1 });
      bitbybit.babylon.gizmo.manager.attachToMesh({ gizmoManager: manager, mesh });

    get

    • 读取管理器的位置 Gizmo,即沿轴拖动网格的箭头,用于调整其吸附和平面;仅当位置 Gizmo 启用时存在。

      Parameters

      Returns IPositionGizmo

      位置 Gizmo

      const positionGizmo = bitbybit.babylon.gizmo.manager.getPositionGizmo({ gizmoManager: manager });
      bitbybit.babylon.gizmo.positionGizmo.snapDistance({ positionGizmo, snapDistance: 1 });
    • 读取管理器的旋转 Gizmo,即绕轴转动网格的环,用于调整其吸附和灵敏度;仅当旋转 Gizmo 启用时存在。

      Parameters

      Returns IRotationGizmo

      旋转 Gizmo

      const rotationGizmo = bitbybit.babylon.gizmo.manager.getRotationGizmo({ gizmoManager: manager });
      bitbybit.babylon.gizmo.rotationGizmo.snapDistance({ rotationGizmo, snapDistance: 0.2 });
    • 读取管理器的缩放 Gizmo,即沿轴拉伸网格的手柄,用于调整其吸附和灵敏度;仅当缩放 Gizmo 启用时存在。

      Parameters

      Returns IScaleGizmo

      缩放 Gizmo

    • 读取管理器的包围盒 Gizmo,即带角手柄、用于缩放和旋转的框架,用于调整其手柄和吸附;仅当包围盒 Gizmo 启用时存在。

      Parameters

      Returns IBoundingBoxGizmo

      边界框 Gizmo

    update

    • 在网格上显示管理器已启用的 Gizmo,以便用户操作它;之前附加的任何网格都被释放。

      Parameters

      Returns GizmoManager

      同一个 Gizmo 管理器

      bitbybit.babylon.gizmo.manager.attachToMesh({ gizmoManager: manager, mesh });
      
    • 通过释放 Gizmo 所附加的网格来隐藏管理器的 Gizmo。

      Parameters

      Returns GizmoManager

      同一个 Gizmo 管理器

      bitbybit.babylon.gizmo.manager.detachMesh({ gizmoManager: manager });