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

package/dist/ModelViewPlugin/Object3DHelperPlugin/Controller.d.ts

@@ -1,15 +1,49 @@
 import type { Five } from '@realsee/five';
-import type * as BasePlugin from '../base/BasePlugin';
+import * as BasePlugin from '../base/BasePlugin';
 import type * as THREE from 'three';
 import { Object3DHelper } from '../shared-utils/Object3DHelper';
-import type { Object3DHelperState, Object3DHelperEventMap } from '../shared-utils/Object3DHelper/typings';
+import type { Object3DHelperState } from '../shared-utils/Object3DHelper/typings';
+import type { Object3DHelperPluginEventMap, Object3DHelperPluginState } from './typings';
 export declare const VERSION = "v1.0.0";
 export declare const PLUGIN: string;
-export declare class Object3DHelperController extends Object3DHelper implements BasePlugin.Controller<Object3DHelperState, Object3DHelperEventMap> {
+export declare class Object3DHelperController extends BasePlugin.Controller<Object3DHelperPluginState, Object3DHelperPluginEventMap> {
     version: string;
     name: string;
-    five: Five;
+    state: Object3DHelperState;
+    objectHelperMap: Map<THREE.Object3D, Object3DHelper>;
     constructor(five: Five);
+    /**
+     * @description Show guide line
+     */
+    show(options?: {
+        userAction?: boolean;
+    }): Promise<void>;
+    /**
+     * @description Hide guide line
+     */
+    hide(options?: {
+        userAction?: boolean;
+    }): Promise<void>;
+    /**
+     * @description Enable
+     */
+    enable(options?: {
+        userAction?: boolean;
+    }): void;
+    /**
+     * @description Disable
+     */
+    disable(options?: {
+        userAction?: boolean;
+    }): void;
+    /**
+     * @description Dispose
+     */
+    dispose(): void;
+    setState(state: Partial<Object3DHelperState>, options?: {
+        userAction?: boolean;
+    } & Record<string, any>): void;
+    getObject3DHelper(object3D: THREE.Object3D): Object3DHelper;
     /**
      * @description 添加 helper
      * @param { THREE.Object3D } object3D       要添加helper的物体
@@ -22,4 +56,10 @@ export declare class Object3DHelperController extends Object3DHelper implements
         rotateHelper?: boolean;
         scaleHelper?: boolean;
     }): void;
+    removeObject3DHelper(object3D: THREE.Object3D): void;
+    private handleEnable;
+    private handleVisible;
+    private handleDispose;
+    private everyHelperDo;
+    private actionIfStateIsEnabled;
 }

package/dist/ModelViewPlugin/Object3DHelperPlugin/typings.d.ts

@@ -0,0 +1,24 @@
+export interface Object3DHelperPluginState {
+    enabled: boolean;
+    visible: boolean;
+    disposed: boolean;
+}
+export declare type Object3DHelperPluginEventMap = {
+    show: (options?: {
+        userAction?: boolean;
+    }) => void;
+    hide: (options?: {
+        userAction?: boolean;
+    }) => void;
+    enable: (options?: {
+        userAction?: boolean;
+    }) => void;
+    disable: (options?: {
+        userAction?: boolean;
+    }) => void;
+    dispose: () => void;
+    stateChange: (params: {
+        state: Object3DHelperPluginState;
+        prevState?: Object3DHelperPluginState;
+    }) => void;
+};

package/dist/ModelViewPlugin/PanoTagPlugin/index.d.ts

@@ -1,6 +1,7 @@
 import type { FivePlugin } from '@realsee/five';
 import PanoTagPluginController from './controller';
 export * from './controller';
+export * from './typings/tag';
 export declare type PanoTagPluginExportInterface = InstanceType<typeof PanoTagPluginController>;
 export declare type PanoTagPluginParamsInterface = ConstructorParameters<typeof PanoTagPluginController>[1];
 export declare const PanoTagPlugin: FivePlugin<PanoTagPluginParamsInterface, PanoTagPluginExportInterface>;

package/dist/ModelViewPlugin/PanoTagPlugin/typings/controller.d.ts

@@ -74,6 +74,7 @@ export declare type TagElement<C extends ContentType = ContentType, P extends Po
         leftPercent: number;
         topPercent: number;
     };
+    clickable: boolean;
     state: {
         visible?: boolean;
         unfolded: boolean;

package/dist/ModelViewPlugin/PanoTagPlugin/typings/tag.d.ts

@@ -31,7 +31,7 @@ export declare enum ContentType {
     /** 营销标签 */
     Marketing = "Marketing",
     /** 图片视频贴片 */
-    MediaPanel = "MediaPanel",
+    MediaPlane = "MediaPlane",
     /** 其他/自定义标签 */
     Custom = "Custom"
 }
@@ -146,6 +146,7 @@ export interface TagConfig<C extends ContentType = ContentType, T extends PointT
         unfolded?: boolean;
     };
     tag3DConfig?: Create3DDomContainerParamsType['config'];
+    clickable?: false;
 }
 export declare enum LinkType {
     VrLink = "vr",
@@ -201,9 +202,12 @@ interface ContentTypeMap {
         };
         extraData?: Object;
     };
-    [ContentType.MediaPanel]: {
+    [ContentType.MediaPlane]: {
         enableCarousel?: boolean;
-        /** @deprecated replaced by objectFit */
+        /**
+         * @description stretch: 拉伸适配, proportional: 等比适配，默认值 'proportional'
+         * @deprecated replaced by objectFit
+         */
         adaptationMode?: 'stretch' | 'proportional';
         /** object-fit doc {@link https://developer.mozilla.org/zh-CN/docs/Web/CSS/object-fit} */
         objectFit?: ObjectFit;

package/dist/ModelViewPlugin/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/ModelViewPlugin/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/ModelViewPlugin/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;
 }

package/dist/ModelViewPlugin/shared-utils/Object3DHelper/Helper/RectangleScaleHelper.d.ts

@@ -19,14 +19,14 @@ export declare class RectangleScaleHelper<T extends OriginObjectType = OriginObj
     private enabled;
     constructor(originObject3D: T, container: Element, camera: THREE.Camera, scene: THREE.Scene);
     updatePosition(): void;
-    setPosition(position: Vector3): void;
     updateMatrix4(matrix: THREE.Matrix4): void;
-    setHelperScaleMatrix4(matrix: THREE.Matrix4, params?: {
+    showDraggingHelper(): void;
+    applyHelperScaleMatrix4(matrix: THREE.Matrix4, params?: {
         origin?: Vector3;
         helperOrigin?: Vector3;
     }): void;
     updatePoints(): void;
-    updateQuaternion(quaternion: THREE.Quaternion, origin: THREE.Vector3): void;
+    applyHelperQuaternion(quaternion: THREE.Quaternion, origin: THREE.Vector3): void;
     enable(): void;
     disable(): void;
     show(): void;

package/dist/ModelViewPlugin/shared-utils/Object3DHelper/Helper/RotateHelper.d.ts

@@ -19,9 +19,10 @@ export declare class RotateHelper extends RotateHelperAbstract {
         container: HTMLElement;
     });
     updateAngleHelperQuaternion(): void;
-    updateQuaternion(quaternion: THREE.Quaternion, origin?: THREE.Vector3): void;
+    applyHelperQuaternion(quaternion: THREE.Quaternion, origin?: THREE.Vector3): void;
     hide(): void;
-    show(direction?: Direction): void;
+    show(): void;
+    showDraggingHelper(directions: Direction[]): void;
     dispose(): void;
     private filterRingHelper;
     private filterAngleHelper;

package/dist/ModelViewPlugin/shared-utils/Object3DHelper/typings/Hooks.d.ts

@@ -5,7 +5,6 @@ export declare type HelperEventMap = {
     scaleStart: () => void;
     positionUpdate: (position: {
         matrix4?: THREE.Matrix4;
-        position?: THREE.Vector3;
     } | undefined) => void;
     rotateUpdate: (rotate: {
         quaternion?: THREE.Quaternion;

package/dist/Object3DHelperPlugin/Controller.d.ts

@@ -1,15 +1,49 @@
 import type { Five } from '@realsee/five';
-import type * as BasePlugin from '../base/BasePlugin';
+import * as BasePlugin from '../base/BasePlugin';
 import type * as THREE from 'three';
 import { Object3DHelper } from '../shared-utils/Object3DHelper';
-import type { Object3DHelperState, Object3DHelperEventMap } from '../shared-utils/Object3DHelper/typings';
+import type { Object3DHelperState } from '../shared-utils/Object3DHelper/typings';
+import type { Object3DHelperPluginEventMap, Object3DHelperPluginState } from './typings';
 export declare const VERSION = "v1.0.0";
 export declare const PLUGIN: string;
-export declare class Object3DHelperController extends Object3DHelper implements BasePlugin.Controller<Object3DHelperState, Object3DHelperEventMap> {
+export declare class Object3DHelperController extends BasePlugin.Controller<Object3DHelperPluginState, Object3DHelperPluginEventMap> {
     version: string;
     name: string;
-    five: Five;
+    state: Object3DHelperState;
+    objectHelperMap: Map<THREE.Object3D, Object3DHelper>;
     constructor(five: Five);
+    /**
+     * @description Show guide line
+     */
+    show(options?: {
+        userAction?: boolean;
+    }): Promise<void>;
+    /**
+     * @description Hide guide line
+     */
+    hide(options?: {
+        userAction?: boolean;
+    }): Promise<void>;
+    /**
+     * @description Enable
+     */
+    enable(options?: {
+        userAction?: boolean;
+    }): void;
+    /**
+     * @description Disable
+     */
+    disable(options?: {
+        userAction?: boolean;
+    }): void;
+    /**
+     * @description Dispose
+     */
+    dispose(): void;
+    setState(state: Partial<Object3DHelperState>, options?: {
+        userAction?: boolean;
+    } & Record<string, any>): void;
+    getObject3DHelper(object3D: THREE.Object3D): Object3DHelper;
     /**
      * @description 添加 helper
      * @param { THREE.Object3D } object3D       要添加helper的物体
@@ -22,4 +56,10 @@ export declare class Object3DHelperController extends Object3DHelper implements
         rotateHelper?: boolean;
         scaleHelper?: boolean;
     }): void;
+    removeObject3DHelper(object3D: THREE.Object3D): void;
+    private handleEnable;
+    private handleVisible;
+    private handleDispose;
+    private everyHelperDo;
+    private actionIfStateIsEnabled;
 }

package/dist/Object3DHelperPlugin/Object3DHelperPlugin/Controller.d.ts

@@ -1,15 +1,49 @@
 import type { Five } from '@realsee/five';
-import type * as BasePlugin from '../base/BasePlugin';
+import * as BasePlugin from '../base/BasePlugin';
 import type * as THREE from 'three';
 import { Object3DHelper } from '../shared-utils/Object3DHelper';
-import type { Object3DHelperState, Object3DHelperEventMap } from '../shared-utils/Object3DHelper/typings';
+import type { Object3DHelperState } from '../shared-utils/Object3DHelper/typings';
+import type { Object3DHelperPluginEventMap, Object3DHelperPluginState } from './typings';
 export declare const VERSION = "v1.0.0";
 export declare const PLUGIN: string;
-export declare class Object3DHelperController extends Object3DHelper implements BasePlugin.Controller<Object3DHelperState, Object3DHelperEventMap> {
+export declare class Object3DHelperController extends BasePlugin.Controller<Object3DHelperPluginState, Object3DHelperPluginEventMap> {
     version: string;
     name: string;
-    five: Five;
+    state: Object3DHelperState;
+    objectHelperMap: Map<THREE.Object3D, Object3DHelper>;
     constructor(five: Five);
+    /**
+     * @description Show guide line
+     */
+    show(options?: {
+        userAction?: boolean;
+    }): Promise<void>;
+    /**
+     * @description Hide guide line
+     */
+    hide(options?: {
+        userAction?: boolean;
+    }): Promise<void>;
+    /**
+     * @description Enable
+     */
+    enable(options?: {
+        userAction?: boolean;
+    }): void;
+    /**
+     * @description Disable
+     */
+    disable(options?: {
+        userAction?: boolean;
+    }): void;
+    /**
+     * @description Dispose
+     */
+    dispose(): void;
+    setState(state: Partial<Object3DHelperState>, options?: {
+        userAction?: boolean;
+    } & Record<string, any>): void;
+    getObject3DHelper(object3D: THREE.Object3D): Object3DHelper;
     /**
      * @description 添加 helper
      * @param { THREE.Object3D } object3D       要添加helper的物体
@@ -22,4 +56,10 @@ export declare class Object3DHelperController extends Object3DHelper implements
         rotateHelper?: boolean;
         scaleHelper?: boolean;
     }): void;
+    removeObject3DHelper(object3D: THREE.Object3D): void;
+    private handleEnable;
+    private handleVisible;
+    private handleDispose;
+    private everyHelperDo;
+    private actionIfStateIsEnabled;
 }

package/dist/Object3DHelperPlugin/Object3DHelperPlugin/typings.d.ts

@@ -0,0 +1,24 @@
+export interface Object3DHelperPluginState {
+    enabled: boolean;
+    visible: boolean;
+    disposed: boolean;
+}
+export declare type Object3DHelperPluginEventMap = {
+    show: (options?: {
+        userAction?: boolean;
+    }) => void;
+    hide: (options?: {
+        userAction?: boolean;
+    }) => void;
+    enable: (options?: {
+        userAction?: boolean;
+    }) => void;
+    disable: (options?: {
+        userAction?: boolean;
+    }) => void;
+    dispose: () => void;
+    stateChange: (params: {
+        state: Object3DHelperPluginState;
+        prevState?: Object3DHelperPluginState;
+    }) => void;
+};

package/dist/Object3DHelperPlugin/PanoTagPlugin/index.d.ts

@@ -1,6 +1,7 @@
 import type { FivePlugin } from '@realsee/five';
 import PanoTagPluginController from './controller';
 export * from './controller';
+export * from './typings/tag';
 export declare type PanoTagPluginExportInterface = InstanceType<typeof PanoTagPluginController>;
 export declare type PanoTagPluginParamsInterface = ConstructorParameters<typeof PanoTagPluginController>[1];
 export declare const PanoTagPlugin: FivePlugin<PanoTagPluginParamsInterface, PanoTagPluginExportInterface>;

package/dist/Object3DHelperPlugin/PanoTagPlugin/typings/controller.d.ts

@@ -74,6 +74,7 @@ export declare type TagElement<C extends ContentType = ContentType, P extends Po
         leftPercent: number;
         topPercent: number;
     };
+    clickable: boolean;
     state: {
         visible?: boolean;
         unfolded: boolean;

package/dist/Object3DHelperPlugin/PanoTagPlugin/typings/tag.d.ts

@@ -31,7 +31,7 @@ export declare enum ContentType {
     /** 营销标签 */
     Marketing = "Marketing",
     /** 图片视频贴片 */
-    MediaPanel = "MediaPanel",
+    MediaPlane = "MediaPlane",
     /** 其他/自定义标签 */
     Custom = "Custom"
 }
@@ -146,6 +146,7 @@ export interface TagConfig<C extends ContentType = ContentType, T extends PointT
         unfolded?: boolean;
     };
     tag3DConfig?: Create3DDomContainerParamsType['config'];
+    clickable?: false;
 }
 export declare enum LinkType {
     VrLink = "vr",
@@ -201,9 +202,12 @@ interface ContentTypeMap {
         };
         extraData?: Object;
     };
-    [ContentType.MediaPanel]: {
+    [ContentType.MediaPlane]: {
         enableCarousel?: boolean;
-        /** @deprecated replaced by objectFit */
+        /**
+         * @description stretch: 拉伸适配, proportional: 等比适配，默认值 'proportional'
+         * @deprecated replaced by objectFit
+         */
         adaptationMode?: 'stretch' | 'proportional';
         /** object-fit doc {@link https://developer.mozilla.org/zh-CN/docs/Web/CSS/object-fit} */
         objectFit?: ObjectFit;