@realsee/dnalogel 2.1.0-alpha.3 → 2.1.0-alpha.5

package/dist/Object3DHelperPlugin/index.js

@@ -2,6 +2,7 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
+var five = require('@realsee/five');
 var THREE = require('three');
 var CSS3DRenderer = require('three/examples/jsm/renderers/CSS3DRenderer');
 
@@ -25,8 +26,39 @@ function _interopNamespace(e) {
 
 var THREE__namespace = /*#__PURE__*/_interopNamespace(THREE);
 
+/**
+ * plugin 的基本控制器
+ */
+class Controller {
+    constructor(five$1) {
+        Object.defineProperty(this, "five", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        /**
+         * 插件事件钩子
+         */
+        Object.defineProperty(this, "hooks", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new five.Subscribe()
+        });
+        this.five = five$1;
+    }
+    /**
+     * 获取当前的插件状态，如果当初插件内存在需要通过动画变更的 state 值，则通过此方法可以得到中间状态
+     */
+    getCurrentState() {
+        return this.state;
+    }
+}
+
 class BaseHelper extends THREE.Object3D {
-    constructor(originObject3D) {
+    constructor(originObject3D, config) {
+        var _a;
         super();
         Object.defineProperty(this, "originObject3D", {
             enumerable: true,
@@ -34,24 +66,42 @@ class BaseHelper extends THREE.Object3D {
             writable: true,
             value: void 0
         });
+        Object.defineProperty(this, "needsRender", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
         this.originObject3D = originObject3D;
+        this.needsRender = (_a = config === null || config === void 0 ? void 0 : config.needsRender) !== null && _a !== void 0 ? _a : (() => { });
     }
     get helperObject() {
         return this;
     }
+    show() {
+        this.visible = true;
+        this.needsRender();
+    }
+    hide() {
+        this.visible = false;
+        this.needsRender();
+    }
     updatePosition() {
         this.position.copy(this.originObject3D.position);
     }
-    setPosition(position) {
-        this.position.copy(position);
+    updateQuaternion() {
+        this.quaternion.copy(this.originObject3D.quaternion);
     }
+    // public setPosition(position: Vector3) {
+    //   this.position.copy(position)
+    // }
     updateMatrix4(matrix, origin) {
         this.applyMatrix4(matrix);
     }
-    setHelperScaleMatrix4(matrix, params) {
+    applyHelperScaleMatrix4(matrix, params) {
         this.scale.applyMatrix4(matrix);
     }
-    updateQuaternion(quaternion, origin) {
+    applyHelperQuaternion(quaternion, origin) {
         this.applyQuaternion(quaternion);
     }
 }
@@ -261,29 +311,16 @@ class MoveHelper extends MoveHelperAbstract {
         this.add(this.yArrow);
         this.add(this.zArrow);
     }
-    hide(...directions) {
-        if (directions.length === 0) {
-            this.xArrow.visible = false;
-            this.yArrow.visible = false;
-            this.zArrow.visible = false;
-        }
-        else {
-            directions.forEach((direction) => {
-                const arrow = [this.xArrow, this.yArrow, this.zArrow].find((arrow) => arrow.direction === direction);
-                arrow && (arrow.visible = false);
-            });
-        }
+    show() {
+        super.show();
+        this.xArrow.visible = true;
+        this.yArrow.visible = true;
+        this.zArrow.visible = true;
     }
-    show(direction) {
-        if (!direction) {
-            this.xArrow.visible = true;
-            this.yArrow.visible = true;
-            this.zArrow.visible = true;
-        }
-        else {
-            const arrow = [this.xArrow, this.yArrow, this.zArrow].find((arrow) => arrow.direction === direction);
-            arrow && (arrow.visible = true);
-        }
+    showDraggingHelper(directions) {
+        this.xArrow.visible = directions.includes('x');
+        this.yArrow.visible = directions.includes('y');
+        this.zArrow.visible = directions.includes('z');
     }
     dispose() {
         this.remove(this.xArrow, this.yArrow, this.zArrow);
@@ -412,7 +449,7 @@ class RotateHelper extends RotateHelperAbstract {
         this.yRingHelper.quaternion.copy(this.xzCircle.quaternion);
         this.zRingHelper.quaternion.copy(this.xyCircle.quaternion);
     }
-    updateQuaternion(quaternion, origin) {
+    applyHelperQuaternion(quaternion, origin) {
         this.yzCircle.applyQuaternion(quaternion);
         this.xzCircle.applyQuaternion(quaternion);
         this.xyCircle.applyQuaternion(quaternion);
@@ -421,21 +458,21 @@ class RotateHelper extends RotateHelperAbstract {
         this.zAngleHelper.baseAxes.applyQuaternion(quaternion);
     }
     hide() {
+        // 改为remove而不是设置visible，是因为会影响其他helper的碰撞检测
         this.remove(this.yzCircle, this.xzCircle, this.xyCircle, this.xRingHelper, this.yRingHelper, this.zRingHelper, this.xAngleHelper, this.yAngleHelper, this.zAngleHelper);
     }
-    show(direction) {
-        var _a, _b;
-        if (direction) {
-            this.hide();
-            this.add(...this.filterRingHelper(direction));
-            this.add(...this.filterAngleHelper(direction));
-            (_a = this.angleTips) === null || _a === void 0 ? void 0 : _a.show();
-        }
-        else {
-            this.add(this.xyCircle, this.xzCircle, this.yzCircle);
-            this.remove(this.xRingHelper, this.yRingHelper, this.zRingHelper, this.xAngleHelper, this.yAngleHelper, this.zAngleHelper);
-            (_b = this.angleTips) === null || _b === void 0 ? void 0 : _b.hide();
-        }
+    show() {
+        var _a;
+        this.add(this.xyCircle, this.xzCircle, this.yzCircle);
+        this.remove(this.xRingHelper, this.yRingHelper, this.zRingHelper, this.xAngleHelper, this.yAngleHelper, this.zAngleHelper);
+        (_a = this.angleTips) === null || _a === void 0 ? void 0 : _a.hide();
+    }
+    showDraggingHelper(directions) {
+        var _a;
+        this.hide();
+        this.add(...this.filterRingHelper(directions));
+        this.add(...this.filterAngleHelper(directions));
+        (_a = this.angleTips) === null || _a === void 0 ? void 0 : _a.show();
     }
     dispose() {
         var _a, _b;
@@ -443,11 +480,11 @@ class RotateHelper extends RotateHelperAbstract {
         if ((_a = this.angleTips) === null || _a === void 0 ? void 0 : _a.element)
             (_b = this.container) === null || _b === void 0 ? void 0 : _b.removeChild(this.angleTips.element);
     }
-    filterRingHelper(direction) {
-        return [this.xRingHelper, this.yRingHelper, this.zRingHelper].filter((helper) => helper.direction === direction);
+    filterRingHelper(directions) {
+        return [this.xRingHelper, this.yRingHelper, this.zRingHelper].filter((helper) => directions.includes(helper.direction));
     }
-    filterAngleHelper(direction) {
-        return [this.xAngleHelper, this.yAngleHelper, this.zAngleHelper].filter((helper) => helper.direction === direction);
+    filterAngleHelper(directions) {
+        return [this.xAngleHelper, this.yAngleHelper, this.zAngleHelper].filter((helper) => directions.includes(helper.direction));
     }
 }
 class Circle extends THREE__namespace.Mesh {
@@ -1412,18 +1449,20 @@ class RectangleScaleHelper extends RectangleScaleHelperAbstract {
         (_a = this.css3DInstance) === null || _a === void 0 ? void 0 : _a.css3DObject.position.copy(this.originObject3D.position);
         (_b = this.plane) === null || _b === void 0 ? void 0 : _b.position.copy(this.originObject3D.position);
     }
-    setPosition(position) {
-        var _a, _b;
-        (_a = this.css3DInstance) === null || _a === void 0 ? void 0 : _a.css3DObject.position.copy(position);
-        (_b = this.plane) === null || _b === void 0 ? void 0 : _b.position.copy(position);
-    }
+    // public setPosition(position: Vector3) {
+    //   this.css3DInstance?.css3DObject.position.copy(position)
+    //   this.plane?.position.copy(position)
+    // }
     updateMatrix4(matrix) {
         var _a, _b;
         (_a = this.css3DInstance) === null || _a === void 0 ? void 0 : _a.css3DObject.applyMatrix4(matrix);
         (_b = this.plane) === null || _b === void 0 ? void 0 : _b.applyMatrix4(matrix);
         this.cornerPositions.forEach((cornerPosition) => cornerPosition.applyMatrix4(matrix));
     }
-    setHelperScaleMatrix4(matrix, params) {
+    showDraggingHelper() {
+        // nothing to do
+    }
+    applyHelperScaleMatrix4(matrix, params) {
         var _a, _b;
         (_a = this.css3DInstance) === null || _a === void 0 ? void 0 : _a.css3DObject.scale.applyMatrix4(matrix);
         (_b = this.plane) === null || _b === void 0 ? void 0 : _b.scale.applyMatrix4(matrix);
@@ -1441,7 +1480,7 @@ class RectangleScaleHelper extends RectangleScaleHelperAbstract {
             point.position.copy(position8[index]);
         });
     }
-    updateQuaternion(quaternion, origin) {
+    applyHelperQuaternion(quaternion, origin) {
         var _a;
         const css3DObject = (_a = this.css3DInstance) === null || _a === void 0 ? void 0 : _a.css3DObject;
         if (css3DObject) {
@@ -2049,6 +2088,7 @@ class BaseController {
         this.scene = scene;
         this.domEvents = new DomEvents(camera, container);
         this.needsRender = needsRender !== null && needsRender !== void 0 ? needsRender : (() => { });
+        this.updateHelperQuaternion();
         this.updateHelperPosition();
         this.enable();
     }
@@ -2067,31 +2107,35 @@ class BaseController {
         this.needsRender();
     }
     show() {
-        this.helperObject3D.visible = true;
+        this.helperObject3D.show();
         this.needsRender();
     }
     hide() {
-        this.helperObject3D.visible = false;
+        this.helperObject3D.hide();
         this.needsRender();
     }
     dispose() {
-        this.scene.remove(this.helperObject3D);
         this.helperObject3D.dispose();
+        this.scene.remove(this.helperObject3D);
+        this.needsRender();
     }
     updateHelperPosition() {
         this.helperObject3D.updatePosition();
     }
-    setHelperPosition(position) {
-        this.helperObject3D.setPosition(position);
+    updateHelperQuaternion() {
+        this.helperObject3D.updateQuaternion();
     }
+    // public setHelperPosition(position: THREE.Vector3) {
+    //   this.helperObject3D.setPosition(position)
+    // }
     setHelperMatrix4(matrix4, origin) {
         this.helperObject3D.updateMatrix4(matrix4, origin);
     }
     setHelperQuaternion(quaternion, origin) {
-        this.helperObject3D.updateQuaternion(quaternion, origin);
+        this.helperObject3D.applyHelperQuaternion(quaternion, origin);
     }
-    setHelperScaleMatrix4(matrix4, params) {
-        this.helperObject3D.setHelperScaleMatrix4(matrix4, params);
+    applyHelperScaleMatrix4(matrix4, params) {
+        this.helperObject3D.applyHelperScaleMatrix4(matrix4, params);
     }
     onWantsGesture(type, pointers, final) {
         if (this.isDragging)
@@ -2233,7 +2277,7 @@ class MoveController extends BaseController {
         plane.setFromNormalAndCoplanarPoint(planeNormal, startIntersect);
         this.startInfo = { startVectorProject: startIntersect.clone().projectOnVector(directionVector), directionVector, plane };
         // 隐藏其他箭头
-        this.helperObject3D.hide(...['x', 'y', 'z'].filter((direction) => direction !== draggingDirection));
+        this.helperObject3D.showDraggingHelper([draggingDirection]);
         this.hooks.emit('moveStart');
         this.isDragging = true;
         console.log('%c MoveController dragStart', 'color: #e5af2e');
@@ -2338,13 +2382,13 @@ class ControllerWrapper {
 const VERSION$1 = 'v1.0.0';
 const NAME = 'Object3DHelper';
 const NAMEVERSION = `${NAME}@${VERSION$1}`;
-const disposedErrorLog = () => {
+const disposedErrorLog$1 = () => {
     console.error(`${NAMEVERSION} is disposed`);
 };
-const disableWarnLog = () => {
+const disableWarnLog$1 = () => {
     console.warn(`${NAMEVERSION} is disabled`);
 };
-const disableErrorLog = () => {
+const disableErrorLog$1 = () => {
     console.error(`${NAMEVERSION} is disabled`);
 };
 class Object3DHelper {
@@ -2388,7 +2432,7 @@ class Object3DHelper {
             configurable: true,
             writable: true,
             value: (controller, ...positionParams) => {
-                var _a, _b, _c, _d, _e, _f, _g, _h;
+                var _a, _b, _c, _d;
                 const [position] = positionParams;
                 const matrix4 = position === null || position === void 0 ? void 0 : position.matrix4;
                 if (matrix4) {
@@ -2399,14 +2443,12 @@ class Object3DHelper {
                     (_c = this.controllers.scaleController) === null || _c === void 0 ? void 0 : _c.setHelperMatrix4(matrix4);
                     (_d = this.helpers.outlineHelper) === null || _d === void 0 ? void 0 : _d.applyMatrix4(matrix4);
                 }
-                if (position === null || position === void 0 ? void 0 : position.position) {
-                    if (controller !== this.controllers.moveController)
-                        (_e = this.controllers.moveController) === null || _e === void 0 ? void 0 : _e.setHelperPosition(position.position);
-                    if (controller !== this.controllers.rotateController)
-                        (_f = this.controllers.rotateController) === null || _f === void 0 ? void 0 : _f.setHelperPosition(position.position);
-                    (_g = this.controllers.scaleController) === null || _g === void 0 ? void 0 : _g.setHelperPosition(position.position);
-                    (_h = this.helpers.outlineHelper) === null || _h === void 0 ? void 0 : _h.position.copy(position.position);
-                }
+                // if (position?.position) {
+                //   if (controller !== this.controllers.moveController) this.controllers.moveController?.setHelperPosition(position.position)
+                //   if (controller !== this.controllers.rotateController) this.controllers.rotateController?.setHelperPosition(position.position)
+                //   this.controllers.scaleController?.setHelperPosition(position.position)
+                //   this.helpers.outlineHelper?.position.copy(position.position)
+                // }
             }
         });
         Object.defineProperty(this, "handleScaleUpdate", {
@@ -2418,7 +2460,7 @@ class Object3DHelper {
                 const [params] = positionParams;
                 const matrix4 = params === null || params === void 0 ? void 0 : params.matrix4;
                 if (matrix4) {
-                    (_a = this.controllers.scaleController) === null || _a === void 0 ? void 0 : _a.setHelperScaleMatrix4(matrix4, params);
+                    (_a = this.controllers.scaleController) === null || _a === void 0 ? void 0 : _a.applyHelperScaleMatrix4(matrix4, params);
                     (_b = this.helpers.outlineHelper) === null || _b === void 0 ? void 0 : _b.scale.applyMatrix4(matrix4);
                 }
             }
@@ -2479,11 +2521,11 @@ class Object3DHelper {
     }
     setState(state, options) {
         if (this.state.disposed)
-            return disposedErrorLog();
+            return disposedErrorLog$1();
         if (!this.state.enabled) {
             // when plugin is disabled, only can change enabled or disposed to true
             if (state.enabled !== true && state.disposed !== true)
-                return disableErrorLog();
+                return disableErrorLog$1();
         }
         const prevState = Object.assign({}, this.state);
         this.state = Object.assign(Object.assign({}, this.state), state);
@@ -2571,7 +2613,6 @@ class Object3DHelper {
         }
     }
     handleEnable(enabled, userAction = true) {
-        console.log({ enabled });
         if (enabled) {
             this.everyControllerDo((controller) => controller.enable());
             this.hooks.emit('enable', { userAction });
@@ -2583,7 +2624,6 @@ class Object3DHelper {
         this.state.enabled = enabled;
     }
     handleVisible(visible, userAction = true) {
-        console.log({ visible });
         if (visible) {
             this.everyControllerDo((controller) => controller.show());
             this.actionIfStateIsEnabled(() => this.hooks.emit('show', { userAction }));
@@ -2610,7 +2650,7 @@ class Object3DHelper {
             return func();
         else {
             if (options === null || options === void 0 ? void 0 : options.warnLog)
-                disableWarnLog();
+                disableWarnLog$1();
         }
     }
 }
@@ -2713,7 +2753,7 @@ class RotateController extends BaseController {
         // this.a = new THREE.PlaneHelper(plane, 10, 0xffff00)
         // this.scene.add(this.a)
         this.startInfo = { direction, startVector, staticStartVector, plane, angleHelper };
-        this.helperObject3D.show(direction);
+        this.helperObject3D.showDraggingHelper([direction]);
         this.hooks.emit('rotateStart');
         this.isDragging = true;
         console.log(`%c RotateController dragStart ${direction}`, 'color: #e5af2e');
@@ -2803,7 +2843,7 @@ class RotateController extends BaseController {
         // end
         const quaternion = new THREE__namespace.Quaternion().setFromUnitVectors(startVector.clone().normalize(), currentVector.clone().normalize());
         object.applyQuaternion(quaternion);
-        this.helperObject3D.updateQuaternion(quaternion);
+        this.helperObject3D.applyHelperQuaternion(quaternion);
         this.helperObject3DQuaternion.premultiply(quaternion);
         this.hooks.emit('rotateUpdate', { quaternion, origin: rotateCenter });
         this.startInfo.startVector = currentVector;
@@ -3087,9 +3127,18 @@ class CSS3DScaleController extends RectangleScaleController {
 const VERSION = 'v1.0.0';
 const PLUGIN_NAME = 'Object3DHelperPlugin';
 const PLUGIN = `${PLUGIN_NAME}@${VERSION}`;
-class Object3DHelperController extends Object3DHelper {
+const disposedErrorLog = () => {
+    console.error(`${PLUGIN} is disposed`);
+};
+const disableWarnLog = () => {
+    console.warn(`${PLUGIN} is disabled`);
+};
+const disableErrorLog = () => {
+    console.error(`${PLUGIN} is disabled`);
+};
+class Object3DHelperController extends Controller {
     constructor(five) {
-        super();
+        super(five);
         Object.defineProperty(this, "version", {
             enumerable: true,
             configurable: true,
@@ -3102,15 +3151,80 @@ class Object3DHelperController extends Object3DHelper {
             writable: true,
             value: PLUGIN_NAME
         });
-        Object.defineProperty(this, "five", {
+        Object.defineProperty(this, "state", {
             enumerable: true,
             configurable: true,
             writable: true,
-            value: void 0
+            value: {
+                visible: true,
+                enabled: true,
+                disposed: false,
+            }
+        });
+        Object.defineProperty(this, "objectHelperMap", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new Map()
         });
         this.five = five;
         Object.assign(window, { [`__${PLUGIN_NAME.toUpperCase()}_DEBUG__`]: this });
     }
+    /**
+     * @description Show guide line
+     */
+    async show(options) {
+        this.setState({ visible: true }, options);
+    }
+    /**
+     * @description Hide guide line
+     */
+    async hide(options) {
+        this.setState({ visible: false }, options);
+    }
+    /**
+     * @description Enable
+     */
+    enable(options) {
+        this.setState({ enabled: true }, options);
+    }
+    /**
+     * @description Disable
+     */
+    disable(options) {
+        this.setState({ enabled: false }, options);
+    }
+    /**
+     * @description Dispose
+     */
+    dispose() {
+        this.setState({ disposed: true });
+    }
+    setState(state, options) {
+        if (this.state.disposed)
+            return disposedErrorLog();
+        if (!this.state.enabled) {
+            // when plugin is disabled, only can change enabled or disposed to true
+            if (state.enabled !== true && state.disposed !== true)
+                return disableErrorLog();
+        }
+        const prevState = Object.assign({}, this.state);
+        this.state = Object.assign(Object.assign({}, this.state), state);
+        if (state.disposed !== undefined && state.disposed !== prevState.disposed) {
+            if (state.disposed)
+                this.handleDispose();
+        }
+        if (state.visible !== undefined && state.visible !== prevState.visible) {
+            this.handleVisible(state.visible);
+        }
+        if (state.enabled !== undefined && state.enabled !== prevState.enabled) {
+            this.handleEnable(state.enabled);
+        }
+        this.hooks.emit('stateChange', { state: this.state, prevState });
+    }
+    getObject3DHelper(object3D) {
+        return this.objectHelperMap.get(object3D);
+    }
     /**
      * @description 添加 helper
      * @param { THREE.Object3D } object3D       要添加helper的物体
@@ -3120,6 +3234,12 @@ class Object3DHelperController extends Object3DHelper {
      */
     addObject3DHelper(object3D, config = {}) {
         var _a;
+        if (this.objectHelperMap.has(object3D)) {
+            console.warn(`Object3DHelperPlugin: object3D ${object3D.name} already has helper`);
+            return;
+        }
+        const helper = new Object3DHelper();
+        this.objectHelperMap.set(object3D, helper);
         const container = (_a = this.five.getElement()) === null || _a === void 0 ? void 0 : _a.parentElement;
         const camera = this.five.camera;
         // 创建空的helperGroup
@@ -3129,7 +3249,7 @@ class Object3DHelperController extends Object3DHelper {
         if (moveHelper) {
             const moveHelper = new MoveHelper(object3D);
             const controllerWrapper = new ControllerWrapper(this.five, MoveController, object3D, moveHelper);
-            this.addControllers({ moveController: controllerWrapper.helperController });
+            helper.addControllers({ moveController: controllerWrapper.helperController });
         }
         if (rotateHelper) {
             let angleTipsParams;
@@ -3137,13 +3257,13 @@ class Object3DHelperController extends Object3DHelper {
                 angleTipsParams = { container };
             const rotateHelper = new RotateHelper(object3D, angleTipsParams);
             const controllerWrapper = new ControllerWrapper(this.five, RotateController, object3D, rotateHelper);
-            this.addControllers({ rotateController: controllerWrapper.helperController });
+            helper.addControllers({ rotateController: controllerWrapper.helperController });
         }
         if (scaleHelper) {
             if (container) {
                 const scaleHelper = new RectangleScaleHelper(object3D, container, camera, this.five.scene);
                 const controllerWrapper = new ControllerWrapper(this.five, CSS3DScaleController, object3D, scaleHelper);
-                this.addControllers({ scaleController: controllerWrapper.helperController });
+                helper.addControllers({ scaleController: controllerWrapper.helperController });
             }
         }
         // if (mergeConfig.outlineHelper) {
@@ -3153,6 +3273,54 @@ class Object3DHelperController extends Object3DHelper {
         // }
         // this.five.scene.add(helperGroup)
     }
+    removeObject3DHelper(object3D) {
+        const helper = this.objectHelperMap.get(object3D);
+        if (!helper)
+            return;
+        this.objectHelperMap.delete(object3D);
+        helper.dispose();
+    }
+    handleEnable(enabled, userAction = true) {
+        console.log({ enabled });
+        if (enabled) {
+            this.everyHelperDo((helper) => helper.enable());
+            this.hooks.emit('enable', { userAction });
+        }
+        else {
+            this.everyHelperDo((helper) => helper.disable());
+            this.hooks.emit('disable', { userAction });
+        }
+        this.state.enabled = enabled;
+    }
+    handleVisible(visible, userAction = true) {
+        console.log({ visible });
+        if (visible) {
+            this.everyHelperDo((helper) => helper.show());
+            this.actionIfStateIsEnabled(() => this.hooks.emit('show', { userAction }));
+        }
+        else {
+            this.everyHelperDo((helper) => helper.hide());
+            this.actionIfStateIsEnabled(() => this.hooks.emit('hide', { userAction }));
+        }
+        this.state.visible = visible;
+    }
+    handleDispose() {
+        this.everyHelperDo((helper) => helper.dispose());
+    }
+    everyHelperDo(func) {
+        this.objectHelperMap.forEach((helper) => {
+            if (helper)
+                func(helper);
+        });
+    }
+    actionIfStateIsEnabled(func, options) {
+        if (this.state.enabled)
+            return func();
+        else {
+            if (options === null || options === void 0 ? void 0 : options.warnLog)
+                disableWarnLog();
+        }
+    }
 }
 
 const Object3DHelperPlugin = (five) => new Object3DHelperController(five);

package/dist/Object3DHelperPlugin/shared-utils/Object3DHelper/Base/BaseController.d.ts

@@ -22,10 +22,10 @@ export declare abstract class BaseController<T extends BaseHelper = BaseHelper,
     hide(): void;
     dispose(): void;
     updateHelperPosition(): void;
-    setHelperPosition(position: THREE.Vector3): void;
+    updateHelperQuaternion(): void;
     setHelperMatrix4(matrix4: THREE.Matrix4, origin?: THREE.Vector3): void;
     setHelperQuaternion(quaternion: THREE.Quaternion, origin: THREE.Vector3): void;
-    setHelperScaleMatrix4(matrix4: THREE.Matrix4, params?: {
+    applyHelperScaleMatrix4(matrix4: THREE.Matrix4, params?: {
         origin?: THREE.Vector3;
         helperOrigin?: THREE.Vector3;
     }): void;

package/dist/Object3DHelperPlugin/shared-utils/Object3DHelper/Base/BaseHelper.d.ts

@@ -5,18 +5,22 @@ import type { Direction, Direction4 } from '../typings';
 import type { tipsDom } from '../Helper/HTML/tipsDom';
 export declare abstract class BaseHelper<OriginObject3D extends Object3D = Object3D> extends Object3D {
     protected originObject3D: OriginObject3D;
+    protected needsRender: () => any;
     get helperObject(): Object3D;
-    constructor(originObject3D: OriginObject3D);
+    constructor(originObject3D: OriginObject3D, config?: {
+        needsRender?: () => any;
+    });
+    show(): void;
+    hide(): void;
     updatePosition(): void;
-    setPosition(position: Vector3): void;
+    updateQuaternion(): void;
     updateMatrix4(matrix: THREE.Matrix4, origin?: THREE.Vector3): void;
-    setHelperScaleMatrix4(matrix: THREE.Matrix4, params?: {
+    applyHelperScaleMatrix4(matrix: THREE.Matrix4, params?: {
         origin?: THREE.Vector3;
         helperOrigin?: THREE.Vector3;
     }): void;
-    updateQuaternion(quaternion: THREE.Quaternion, origin?: THREE.Vector3): void;
-    abstract hide(...args: any[]): void;
-    abstract show(...args: any[]): void;
+    applyHelperQuaternion(quaternion: THREE.Quaternion, origin?: THREE.Vector3): void;
+    abstract showDraggingHelper(directions?: Direction[]): void;
     abstract dispose(): void;
 }
 export declare abstract class MoveHelperAbstract<OriginObject3D extends Object3D = Object3D> extends BaseHelper<OriginObject3D> {
@@ -35,8 +39,6 @@ export declare abstract class MoveHelperAbstract<OriginObject3D extends Object3D
         line?: Object3D;
         direction: Direction;
     };
-    abstract hide(...directions: Direction[]): void;
-    abstract show(...directions: Direction[]): void;
 }
 export declare abstract class RotateHelperAbstract<OriginObject3D extends Object3D = Object3D> extends BaseHelper<OriginObject3D> {
     abstract xyCircle: Mesh & {
@@ -64,8 +66,7 @@ export declare abstract class RotateHelperAbstract<OriginObject3D extends Object
         direction: Direction;
     };
     abstract angleTips?: ReturnType<typeof tipsDom>;
-    abstract hide(): void;
-    abstract show(direction?: Direction): void;
+    abstract showDraggingHelper(directions: Direction[]): void;
     abstract updateAngleHelperQuaternion(): void;
 }
 export declare abstract class ScaleHelperAbstract<OriginObject3D extends Object3D = Object3D> extends BaseHelper<OriginObject3D> {

package/dist/Object3DHelperPlugin/shared-utils/Object3DHelper/Helper/MoveHelper.d.ts

@@ -7,7 +7,7 @@ export declare class MoveHelper extends MoveHelperAbstract {
     yArrow: ArrowGroup;
     zArrow: ArrowGroup;
     constructor(originObject3D: Object3D);
-    hide(...directions: Direction[]): void;
-    show(direction?: Direction): void;
+    show(): void;
+    showDraggingHelper(directions: Direction[]): void;
     dispose(): void;
 }