@aibee/owlly 1.0.26 → 1.0.29

package/lib/owlly/utils/events.js

@@ -0,0 +1,219 @@
+class Events {
+}
+/**
+ * @event element-selected 元素选中事件, 由 TransformController 抛出
+ * @eventParam element 被选中的元素对象
+ * @eventParam intersection 碰撞信息
+ * @eventParam button 鼠标按键
+ */
+Events.ELEMENT_SELECTED = 'element-selected';
+/**
+ * @event element-position-updated 元素位置更新, 由 TransformController 抛出
+ * @eventParam position 元素的位置
+ * @eventParam element 元素对象
+ * @eventParam uuid 若元素为相机, 相机的UUID, 否则为空
+ */
+Events.ELEMENT_POSITION_UPDATED = 'element-position-updated';
+/**
+ * @event element-pose-updated 元素姿态更新, 由 TransformController 抛出
+ * @eventParam quaternion 元素的姿态四元数(x, y, z, w)
+ * @eventParam element 元素对象
+ * @eventParam uuid 若元素为相机, 相机的UUID, 否则为空
+ */
+Events.ELEMENT_POSE_UPDATED = 'element-pose-updated';
+/**
+ * @event camera-changed 相机位移/朝向发生变化, 由 PanoramaController 抛出
+ * @eventParam position 相机位置
+ * @eventParam quaternion 相机的姿态四元数（x, y, z, w）
+ * @eventParam controller 产生事件的controller
+ */
+Events.CAMERA_CHANGED = 'camera-changed';
+/**
+ * @event camera-zoom 相机位移/朝向发生变化, 由 PanoramaController 抛出
+ * @eventParam typeMode 缩放模式
+ * @eventParam value 缩放值
+ * @eventParam controller 产生事件的controller
+ */
+Events.CAMERA_ZOOM = 'camera-zoom';
+/**
+ * @event panorama-camera-changed 全景图相机位移/朝向发生变化, 由 PanoramaController 抛出
+ * @eventParam position 相机位置
+ * @eventParam quaternion 相机的姿态四元数（x, y, z, w）
+ * @eventParam controller 产生事件的controller
+ */
+Events.PANORAMA_CAMERA_CHANGED = 'panorama-camera-changed';
+/**
+ * @event orbit-camera-changed ORBIT相机位移/朝向发生变化, 由 OrbitControl 抛出
+ * @eventParam position 相机位置
+ * @eventParam quaternion 相机的姿态四元数（x, y, z, w）
+ * @eventParam controller 产生事件的controller
+ */
+Events.ORBIT_CAMERA_CHANGED = 'orbit-camera-changed';
+/**
+ * @event panorama-presented 全景图被显示出来, 由 PanoramaGroup、TilePanoramaGroup 抛出
+ * @eventParam pid 全景点ID
+ */
+Events.PANORAMA_PRESENTED = 'panorama-presented';
+/**
+ * @event panorama-selected 全景图被选中, 由 PanoramaGroup、TilePanoramaGroup 抛出
+ * @eventParam pid 全景点ID
+ */
+Events.PANORAMA_SELECTED = 'panorama-selected';
+/**
+ * @event panorama-hover 全景目标点hover, 由 PanoramaGroup、TilePanoramaGroup 抛出
+ * @eventParam pid 全景点ID
+ * @eventParam indicatorPosition 点位位置
+ */
+Events.PANORAMA_HOVER = 'panorama-hover';
+/**
+ * @event element-loaded Element读取完成, 由 FloorModel、BlockSet 抛出
+ * @eventParam element{Element} 读取完成的Element
+ */
+Events.ELEMENT_LOADED = 'element-loaded';
+/**
+ * @event element-loaded-error Element读取错误
+ * @eventParam element{Element} 读取错误的Element
+ */
+Events.ELEMENT_LOADED_ERROR = 'o/element-loaded-error';
+/**
+ * @event click-panorama 点击到全景图
+ * @eventParam pid 全景点ID
+ */
+Events.CLICK_PANORAMA = 'click-panorama';
+/**
+ * @event move-to-panorama 漫游到全景图, 由 PanoramaController、TilePanoramaController 抛出
+ * @eventParam pid 全景点ID
+ */
+Events.MOVE_TO_PANORAMA = 'move-to-panorama';
+/**
+ * @event will-move-to-panorama 漫游到全景图, 由 PanoramaController、TilePanoramaController 抛出
+ * @eventParam pid 全景点ID
+ */
+Events.WILL_MOVE_TO_PANORAMA = 'will-move-to-panorama';
+/**
+ * @event path-movement-start 走完一条路径, 由 PanoramaController、TilePanoramaController 抛出
+ * @eventParam PIDs []number 路径的全景点ID数组
+ */
+Events.PATH_MOVEMENT_START = 'path-movement-start';
+/**
+ * @event path-movement-completed 走完一条路径, 由 PanoramaController、TilePanoramaController 抛出
+ * @eventParam PIDs []number 路径的全景点ID数组
+ */
+Events.PATH_MOVEMENT_COMPLETED = 'path-movement-completed';
+/**
+ * @event will-load-panorama 即将加载全景图资源, 由 Panorama、TilePanoramaController 抛出
+ * @eventParam pid 全景点ID
+ */
+Events.WILL_LOAD_PANORAMA = 'will-load-panorama';
+/**
+ * @event did-load-panorama 完成加载全景图资源, 由 Panorama、TilePanorama、TilePanoramaController 抛出
+ * @eventParam pid 全景点ID
+ */
+Events.DID_LOAD_PANORAMA = 'did-load-panorama';
+/**
+ * @event transform-activated 开始移动元素, 由 TransformController 抛出
+ */
+Events.TRANSFORM_ACTIVATED = 'transform-activated';
+/**
+ * @event transform-deactivated 结束移动元素, 由 TransformController 抛出
+ */
+Events.TRANSFORM_DEACTIVATED = 'transform-deactivated';
+/**
+ * @event fps-updated 计算得到当前帧率, 暂无
+ */
+Events.FPS_UPDATED = 'fps-updated';
+/**
+ * @event get-plane-intersect 元素姿态更新, 由 PlaneController 抛出
+ * @eventParam event touch事件 event
+ * @eventParam position 与平面相交的点(x, y, z)
+ */
+Events.GET_PLANE_INTERSECT = 'get-plane-intersect';
+/**
+ * @event poi-clicked poi点击事件, 由 PoiOverlay 抛出
+ * @eventParam poi 点击的poi对象
+ */
+Events.POI_CLICKED = 'poi-clicked';
+/**
+ * @event poi-down poi鼠标按下, 由 PoiOverlay 抛出
+ * @eventParam poi 点击的poi对象
+ */
+Events.POI_DOWN = 'poi-down';
+/**
+ * @event poi-up poi鼠标抬起, 由 PoiOverlay 抛出
+ * @eventParam poi 点击的poi对象
+ */
+Events.POI_UP = 'poi-up';
+/**
+ * @event canvas-vertex-clicked canvas-vertex点击事件, 由 CanvasOverlay 抛出
+ * @eventParam canvas-vertex 点击的canvas-vertex对象
+ */
+Events.CANVAS_VERTEX_CLICKED = 'canvas-vertex-clicked';
+/**
+ * @event canvas-vertex-down canvas-vertex鼠标按下, 由 CanvasOverlay 抛出
+ * @eventParam canvas-vertex 点击的canvas-vertex对象
+ */
+Events.CANVAS_VERTEX_DOWN = 'canvas-vertex-down';
+/**
+ * @event canvas-vertex-up canvas-vertex鼠标抬起, 由 CanvasOverlay 抛出
+ * @eventParam canvas-vertex 点击的canvas-vertex对象
+ */
+Events.CANVAS_VERTEX_UP = 'canvas-vertex-up';
+/**
+ * @event label-icons-position-updated LabelOverlay - Icon位置更新, 由 LabelOverlay 抛出
+ * @eventParam elements Icon元素数组
+ */
+Events.LABEL_ICONS_POSITION_UPDATED = 'label-icons-position-updated';
+/**
+ * @event label-down 标签鼠标按下, 由 DomLabel2D 抛出
+ * @eventParam label 点击的label
+ */
+Events.LABEL_DOWN = 'label-down';
+/**
+ * @event tick 帧渲染, 由 EventHub 抛出
+ */
+Events.TICK = 'tick';
+/**
+ * @event view-rendered 视图渲染完毕, 暂无
+ * @eventParam view 对应的视图
+ */
+Events.VIEW_RENDERED = 'view-rendered';
+/** @ignore */
+class OwllyEvents {
+}
+/**
+ * @event o/element-selected 元素被选中
+ * @eventParam element 被选中的元素
+ */
+OwllyEvents.ELEMENT_SELECTED = 'o/element-selected';
+/**
+ * @event o/rendering-view-changed 当前渲染目标View改变
+ * @eventParam view 正在渲染的View
+ */
+OwllyEvents.RENDERING_VIEW_CHANGED = 'o/rendering-view-changed';
+/**
+ * @event o/dispose-element 有Element销毁时发生
+ * @eventParam element{Element|Element[]} 销毁的Element
+ */
+OwllyEvents.DISPOSE_ELEMENT = 'o/dispose-element';
+/**
+ * @event o/element-loaded Element读取完成
+ * @eventParam element{Element} 读取完成的Element
+ */
+OwllyEvents.ELEMENT_LOADED = 'o/element-loaded';
+/**
+ * @event element-position-updated 元素位置更新
+ * @eventParam position 元素的位置
+ * @eventParam element 元素对象
+ * @eventParam view 变动位置所在View
+ */
+OwllyEvents.ELEMENT_POSITION_UPDATED = 'o/element-position-updated';
+OwllyEvents.MOUSE_DOWN = 'o/mouse-down';
+OwllyEvents.MOUSE_UP = 'o/mouse-up';
+OwllyEvents.MOUSE_MOVE = 'o/mouse-move';
+OwllyEvents.MOUSE_WHEEL = 'o/mouse-wheel';
+OwllyEvents.TOUCH_START = 'o/touch-start';
+OwllyEvents.TOUCH_MOVE = 'o/touch-move';
+OwllyEvents.TOUCH_END = 'o/touch-end';
+OwllyEvents.CONTEXT_MENU = 'o/context-menu';
+OwllyEvents.DBLCLICK = 'o/dblclick';
+export { Events, OwllyEvents };

package/lib/owlly/utils/geometry-utils.d.ts

@@ -0,0 +1,119 @@
+import { NS_THREE } from '../stage/externals';
+interface Cell {
+    x: number;
+    y: number;
+    h: number;
+    d: number;
+    max: number;
+}
+declare type Pair = [number, number];
+declare type Ring = Pair[];
+declare type Polygon = Ring[];
+declare type MultiPolygon = Polygon[];
+declare type Geom = Polygon | MultiPolygon;
+/**
+ * 图形相关的工具函数
+ * @ignore
+ */
+declare class GeometryUtils {
+    static Epsilon: number;
+    /**
+     * 计算环多边形面积
+     * @param polygon 二维顶点数组
+     * 借鉴area-polygon的实现
+     */
+    static RingPolygonArea(points: [number, number][], signed: boolean): number;
+    /**
+       * 求多边形质心
+       * https://jingsam.github.io/2016/10/05/centroid.html
+       * @param polygon 按逆时针排列的二维顶点数组
+       */
+    static Centroid(polygon: [number, number][]): [number, number];
+    /**
+       * 求点到线段的距离
+       * https://jingsam.github.io/2016/09/26/polydist.html
+       * @param p 求到线段距离的点
+       * @param a 线段端点1
+       * @param b 线段端点2
+       */
+    static PointToSegmentDistance(p: [number, number], a: [number, number], b: [number, number]): number;
+    /**
+       * 判断点是否在多边形内部
+       * @param p 二维点
+       * @param polygonLoops 二维多边形顶点环数组，至少有一个环，第二个及以后的环代表内部孔
+       */
+    static PointInPolygon(p: [number, number], polygonLoops: [number, number][][]): boolean;
+    /**
+       * 不考虑点是否在多边形内部，求最小距离
+       * https://jingsam.github.io/2016/09/26/polydist.html
+       * @param p 二维点
+       * @param polygonLoops 二维多边形顶点环数组，至少有一个环，第二个及以后的环代表内部孔
+       */
+    static MinDistanceFromPointToPolygon(p: [number, number], polygonLoops: [number, number][][]): number;
+    /**
+       * 考虑点是否在多边形内部，求最小距离。若在多边形外部，距离为负值
+       * https://jingsam.github.io/2016/09/26/polydist.html
+       * @param p 二维点
+       * @param polygonLoops 二维多边形顶点环数组，至少有一个环，第二个及以后的环代表内部孔
+       */
+    static PointDistanceToPolygon(p: [number, number], polygonLoops: [number, number][][]): number;
+    static CellOfPolygon(x: number, y: number, h: number, polygon: [number, number][][]): Cell;
+    /**
+       * 得到多边形标注中心
+       * https://jingsam.github.io/2016/09/26/polylabel2.html
+       * @param polygonLoops 多边形
+       */
+    static CentroidForPOI(polygonLoops: [number, number][][]): [number, number];
+    static LinePlaneIntersection(lineP0: NS_THREE.Vector3, lineP1: NS_THREE.Vector3, planeP: NS_THREE.Vector3, planeNormal: NS_THREE.Vector3): NS_THREE.Vector3;
+    static SegmentPlaneIntersection(lineP0: NS_THREE.Vector3, lineP1: NS_THREE.Vector3, planeP: NS_THREE.Vector3, planeNormal: NS_THREE.Vector3): NS_THREE.Vector3 | undefined;
+    static MapPointOnPlane(v: NS_THREE.Vector3, planeP: NS_THREE.Vector3, planeNormal: NS_THREE.Vector3): NS_THREE.Vector3;
+    static ParameterToPlane(a: number, b: number, c: number, d: number): {
+        normal: NS_THREE.Vector3;
+        constant: number;
+    };
+    static PlaneCutMeshPolygon(p: NS_THREE.Vector3, n: NS_THREE.Vector3, meshVertices: NS_THREE.Vector3[], meshTriangles: number[]): {
+        vertices: NS_THREE.Vector3[];
+        holeIndices: number[];
+        vertices2D: [number, number][];
+    };
+    static TriangulatePolygon2D(vertices: [number, number][], holeIndices: number[]): number[];
+    static TriangulatePolygonLoops2D(polygonLoops: [number, number][][]): {
+        vertices: [number, number][];
+        triangles: number[];
+    };
+    static LookAtMatrix(eye: NS_THREE.Vector3, target: NS_THREE.Vector3, up: NS_THREE.Vector3): NS_THREE.Matrix4;
+    static FrustumMesh(eye: NS_THREE.Vector3, target: NS_THREE.Vector3, up: NS_THREE.Vector3, fovYDegrees: number, aspectRatio: number, near: number, far: number): {
+        vertices: NS_THREE.Vector3[];
+        triangles: number[];
+    };
+    static PolygonIntersection(geom: Geom, ...geoms: Geom[]): MultiPolygon;
+    static PolygonDiff(geom: Geom, ...geoms: Geom[]): MultiPolygon;
+    static PolygonUnion(geom: Geom, ...geoms: Geom[]): MultiPolygon;
+    static PolygonXOR(geom: Geom, ...geoms: Geom[]): MultiPolygon;
+    /**
+     * 计算路径每个路径点与初始点在路径上的距离
+     * @param pathPoints 路径点数组
+     * @returns 距离数组
+     */
+    static GetPathDistances(pathPoints: [number, number][] | [number, number, number][]): number[];
+    /**
+     * 获取路径上某个距离上的点
+     * @param path 路径
+     * @param distances 距离数组
+     * @param targetDistance 目标距离
+     */
+    static GetPointOnDistance(path: [number, number][] | [number, number, number][], distances: number[], targetDistance: number): [number, number] | [number, number, number];
+    /**
+     * 获取路径上距离某位置最近的点
+     * @param position 目标点
+     * @param path 路径
+     * @param distances 距离数组
+     * @param targetPrecision 计算精度, 默认为0.1
+     * @param stepLength 搜索步长距离, 默认为8
+     */
+    static GetNearestPoint(position: [number, number] | [number, number, number], path: [number, number][] | [number, number, number][], distances: number[], targetPrecision?: number, stepLength?: number): {
+        point: [number, number] | [number, number, number];
+        distance: number;
+    };
+}
+export { GeometryUtils, };