@aibee/owlly 1.0.26 → 1.0.29

package/lib/prod/src/owlly/element/camera.d.ts

@@ -0,0 +1,82 @@
+import { NS_THREE } from '../stage/externals';
+import { Element, ElementFrameContext } from './element';
+/**
+ * 相机内参
+ */
+interface CameraIntrinsic {
+    /** Field Of View */
+    fov: NS_THREE.Vector2;
+    /** 分辨率 */
+    resolution: NS_THREE.Vector2;
+    /** 焦距 */
+    f: NS_THREE.Vector2;
+    /** 中心偏移 */
+    c: NS_THREE.Vector2;
+}
+/**
+ * 相机元素
+ * @noInheritDoc
+ */
+declare class Camera extends Element {
+    private initialized;
+    private camera;
+    private yaw;
+    private pitch;
+    private lookAtPoint;
+    intrinsic: CameraIntrinsic;
+    private helpers;
+    private cameraHelper;
+    private updateLookAtThisFrame;
+    private eventListeners;
+    private visibleScope;
+    /** 可碰撞元素 */
+    intersectables: NS_THREE.Object3D[];
+    readonly isCamera: true;
+    constructor(yaw?: number, pitch?: number, visibleScope?: number);
+    load(yaw?: number, pitch?: number, visibleScope?: number): void;
+    dispose(): void;
+    private updatePitchYawFromLookVector;
+    private onRotationChange;
+    private onQuaternionChange;
+    /** @ignore */
+    update(): ElementFrameContext;
+    /** @ignore */
+    getThreeCamera(): NS_THREE.PerspectiveCamera;
+    /**
+     * 获取相机内参
+     * @returns 相机内参
+     */
+    getIntrinsic(): CameraIntrinsic;
+    /** 获取偏航角 */
+    getYaw(): number;
+    /** 获取俯仰角 */
+    getPitch(): number;
+    /** 获取相机Field Of View */
+    getFov(): number;
+    /** 获取相机图像比例 */
+    getAspect(): number;
+    /** 获取相机姿态四元数 */
+    getQuaternion(): NS_THREE.Quaternion;
+    /**
+     * 设定偏航角
+     * @param yaw 偏航角
+     */
+    setYaw(yaw: number): void;
+    /**
+     * 设定俯仰角
+     * @param pitch 俯仰角
+     */
+    setPitch(pitch: number): void;
+    /** @ignore */
+    setCameraHelperVisible(value: boolean, render?: boolean): void;
+    /** @ignore */
+    lookAt(vector: number | NS_THREE.Vector3, y?: number, z?: number, updatePitchYaw?: boolean): void;
+    /** @ignore */
+    updateLookAt(): void;
+    get quaternion(): NS_THREE.Quaternion;
+    getViewingFrustumMesh(): {
+        vertices: NS_THREE.Vector3[];
+        triangles: number[];
+    };
+}
+export { Camera, CameraIntrinsic };

package/lib/prod/src/owlly/element/dom-2d-element.d.ts

@@ -0,0 +1,35 @@
+import { CSS2DObject } from '../../external/renderers/css-2d-renderer';
+import { Element, ElementFrameContext } from './element';
+/**
+ * 2D DOM 元素, 可以添加 2D DOM到场景内, 没有透视以及近大远小, 仅进行位置投影
+ */
+declare class DOM2DElement extends Element {
+    /** @ignore */
+    protected initialzed: boolean;
+    /** @ignore */
+    protected cssObject: CSS2DObject;
+    /** @ignore */
+    protected wrapper: HTMLDivElement;
+    /** @ignore */
+    protected needUpdate: boolean;
+    /** 传入的 dom 元素 */
+    domElement: HTMLElement;
+    /** 可见范围, 默认为 Infinity */
+    visibleRadius: number;
+    /**
+     * @param domElement 要显示的DOM元素
+     */
+    constructor(domElement: HTMLElement);
+    /**
+     * 设置DOM容器的CSS类, 可用来制定CSS样式
+     * @param className 类名
+     */
+    setWrapperCSSClass(className: string): void;
+    /**
+     * 设置DOM的ID
+     * @param name id名称
+     */
+    setWrapperDomID(name: string): void;
+    update(): ElementFrameContext;
+}
+export { DOM2DElement };

package/lib/prod/src/owlly/element/dom-3d-element.d.ts

@@ -0,0 +1,27 @@
+import { CSS3DObject } from '../../external/renderers/css-3d-renderer';
+import { Element, ElementFrameContext } from './element';
+/**
+ * 3D DOM 元素, 可以添加 3D DOM到场景内
+ */
+declare class DOM3DElement extends Element {
+    /** @ignore */
+    protected initialzed: boolean;
+    /** @ignore */
+    protected cssObject: CSS3DObject;
+    /** @ignore */
+    protected wrapper: HTMLDivElement;
+    /** 传入的 dom 元素 */
+    domElement: HTMLElement;
+    /** 是否始终面向相机 */
+    faceToCamera: boolean;
+    /** 是否面向相机时保持z方向不变 */
+    keepZOnFaceToCamera: boolean;
+    /** 可见范围, 默认为 Infinity */
+    visibleRadius: number;
+    /**
+     * @param domElement 要显示的DOM元素, 注意: 在3D DOM中, 请使用像素(px)作为长度单位, 每个像素对应场景中0.005个单位(正常情况下为5毫米)
+     */
+    constructor(domElement: HTMLElement);
+    update(): ElementFrameContext;
+}
+export { DOM3DElement };

package/lib/prod/src/owlly/element/dom-label-2d.d.ts

@@ -0,0 +1,116 @@
+import { NS_THREE } from '../stage/externals';
+import { DOM2DElement } from './dom-2d-element';
+import { ElementFrameContext } from './element';
+declare type AnchorPosition = 'center' | 'left' | 'right' | 'top' | 'bottom' | 'topleft' | 'topright' | 'bottomleft' | 'bottomright';
+declare type TextAttributes = {
+    content?: string;
+    visible?: boolean;
+    fontSize?: number;
+    color?: string;
+    padding?: {
+        left?: number;
+        right?: number;
+        top?: number;
+        bottom?: number;
+    };
+    anchor?: AnchorPosition;
+    offset?: {
+        x: number;
+        y: number;
+    };
+    align?: string;
+    borderWidth?: number;
+    borderColor?: string;
+    borderRadius?: number;
+    backgroundColor?: string;
+};
+declare type ImageAttributes = {
+    src?: string;
+    visible?: boolean;
+    size?: {
+        width: number;
+        height: number;
+    };
+    anchor?: AnchorPosition;
+    offset?: {
+        x: number;
+        y: number;
+    };
+};
+declare type LabelAttributes = {
+    position?: NS_THREE.Vector3;
+    visible?: boolean;
+    bBoxVisible?: boolean;
+    bBoxBorderWidth?: number;
+    bBoxBorderColor?: string;
+};
+/**
+ * 2D DOM 标签, 可展示文字与图片
+ */
+declare class DOMLabel2D extends DOM2DElement {
+    private static ANCHOR_MAP;
+    private boundingBox;
+    private textElement;
+    private textPositionInfo;
+    private imageElement;
+    private imagePositionInfo;
+    private calcBBoxNextFrame;
+    private needCalcBBox;
+    private listeners;
+    private status;
+    private mouseStart;
+    private mouseEnd;
+    labelID: number;
+    constructor();
+    private updateTextTransform;
+    private updateImageTransform;
+    private calcBBox;
+    private registerListeners;
+    private unregisterListeners;
+    private onImageLoaded;
+    private onMouseDown;
+    private onMouseMove;
+    private onMouseUp;
+    private onTouchStart;
+    private onTouchMove;
+    private onTouchEnd;
+    setAttributes({ labelAttrs, imageAttrs, textAttrs }: {
+        labelAttrs: LabelAttributes;
+        imageAttrs: ImageAttributes;
+        textAttrs: TextAttributes;
+    }): void;
+    setLabelAttrs(attrs: LabelAttributes): void;
+    setPosition(position: NS_THREE.Vector3): void;
+    setVisible(visible: boolean): void;
+    setBBoxVisible(visible: boolean): void;
+    setBBoxBorderWidth(width: number): void;
+    setBBoxBorderColor(color: string): void;
+    setImageAttrs(attrs: ImageAttributes): void;
+    setImageVisible(visible: boolean): void;
+    setImageSource(src: string): void;
+    setImageSize(width: number, height: number): void;
+    setImageAnchor(anchor: AnchorPosition): void;
+    setImageOffset(offsetX: number, offsetY: number): void;
+    setTextAttrs(attrs: TextAttributes): void;
+    setTextVisible(visible: boolean): void;
+    setTextContent(text: string): void;
+    setTextFontSize(size: number): void;
+    setTextColor(color: string): void;
+    setTextPadding(padding: {
+        left?: number;
+        right?: number;
+        top?: number;
+        bottom?: number;
+    }): void;
+    setTextAnchor(anchor: AnchorPosition): void;
+    setTextOffset(offsetX: number, offsetY: number): void;
+    setTextBorderWidth(width: number): void;
+    setTextAlign(align: string): void;
+    setTextBorderColor(color: string): void;
+    setTextBorderRadius(radius: number): void;
+    setTextBackgroundColor(color: string): void;
+    setLabelID(labelID: number): void;
+    update(): ElementFrameContext;
+    dispose(): void;
+}
+export { DOMLabel2D };

package/lib/prod/src/owlly/element/element.d.ts

@@ -0,0 +1,53 @@
+import { NS_THREE } from '../stage/externals';
+/** @ignore */
+declare class ElementFrameContext {
+    element: Element;
+    needUpdate: boolean;
+    shouldPlaceElement: boolean;
+    constructor(element: Element, needsUpdate?: boolean);
+}
+/** 元素类 */
+declare abstract class Element extends NS_THREE.Object3D {
+    /** @ignore */
+    abstract update(): ElementFrameContext;
+    private universalId?;
+    private elementListeners;
+    protected eventMap: Map<string, Set<Function>>;
+    constructor();
+    private onElementSelected;
+    /**
+     * 获取元素的uuid
+     */
+    getUUID(): string | undefined;
+    /**
+     * 设置元素的uuid
+     * @param uuid 配置的uuid
+     */
+    setUUID(uuid: string): void;
+    dispose(): void;
+    /**
+     * 注册事件监听
+     * @param event 事件名
+     * @param callback 回调函数
+     */
+    on(event: string, callback: Function): void;
+    protected emit(event: string, ...args: unknown[]): void;
+    /**
+     * 注销事件监听
+     * @param event 事件名
+     * @param callback 回调函数
+     */
+    off(event: string, callback: Function): void;
+}
+interface Element {
+    /** 可碰撞成员元素 */
+    intersectables?: NS_THREE.Object3D[];
+    /**
+     * 加载数据
+     * @param args 加载数据所需要的参数
+     */
+    load?(...args: unknown[]): unknown;
+    resize?(width: number, height: number): void;
+    render?(): void;
+}
+export { Element, ElementFrameContext };

package/lib/prod/src/owlly/element/floor-model.d.ts

@@ -0,0 +1,83 @@
+import { NS_THREE } from '../stage/externals';
+import { Element, ElementFrameContext } from './element';
+import { View } from '../view/view';
+import { BVHTree, IntersectResult } from '../utils/bvh-tree';
+interface FloorModelViewConfiguration {
+    targetView: View;
+    visible: boolean;
+    meshMaterial?: NS_THREE.Material | NS_THREE.Material[];
+}
+/**
+ * 地面参数
+ */
+interface GroundParameters {
+    /** 铅垂方向向量(必须) */
+    downDirection: NS_THREE.Vector3;
+    /** 地面平面系数(可选): a * x + b * y + c * z + d = 0 */
+    groundPlane?: {
+        a: number;
+        b: number;
+        c: number;
+        d: number;
+    };
+}
+/**
+ * 楼层模型元素
+ * @noInheritDoc
+ */
+declare class FloorModel extends Element {
+    private modelInitialized;
+    private modelLoaded;
+    private mesh;
+    private bvh;
+    private raycaster;
+    private groundParams;
+    private meshMaterial;
+    private viewConfigurations;
+    private globalScale;
+    boundingBoxMesh: NS_THREE.Mesh;
+    private reloadTimes;
+    /**
+     * @param url Mesh模型地址
+     */
+    constructor(url: string, useBVH?: boolean, globalScale?: number);
+    /**
+     * 设置地面参数
+     * @param params 地面参数
+     */
+    setGroundParameters(params: GroundParameters): void;
+    /**
+     * 读取Mesh模型
+     * @param url Mesh模型地址
+     */
+    load(url: string, useBVH?: boolean, index?: number): void;
+    isModelLoaded(): boolean;
+    /** @ignore */
+    update(): ElementFrameContext;
+    render(): void;
+    /**
+     * 配置在不同view中的显示状态
+     * @param configuration 配置
+     */
+    addViewConfiguration(configuration: FloorModelViewConfiguration): void;
+    addMeshMaterial(meshMaterial: NS_THREE.Material | NS_THREE.Material[]): void;
+    dispose(): void;
+    getBVHTree(): BVHTree;
+    /**
+     * 给定射线与模型的相交测试结果
+     * @param rayOrigin 射线起点
+     * @param rayDirection 射线方向
+     * @param backfaceCulling 是否忽略背面
+     */
+    intersectRay(rayOrigin: NS_THREE.Vector3, rayDirection: NS_THREE.Vector3, backfaceCulling: boolean): IntersectResult[] | null;
+    static intersectWithGroundPlane(p: NS_THREE.Vector3, groundParams: GroundParameters): NS_THREE.Vector3 | null;
+    private nearestIntersectionWithRaycaster;
+    /**
+     * 给定参考点处对应的模型地面上的点
+     * 如果有地面参数则进行简化计算，否则使用射线求交点
+     * @param p 参考点
+     */
+    intersectGround(p: NS_THREE.Vector3): NS_THREE.Vector3 | null;
+    getMeshMaterial(): NS_THREE.Material | NS_THREE.Material[];
+}
+export { FloorModel, FloorModelViewConfiguration, GroundParameters };

package/lib/prod/src/owlly/element/gif-kit/Gif.d.ts

@@ -0,0 +1,96 @@
+/*!
+ gifken
+ Copyright (c) 2013 aaharu
+ This software is released under the MIT License.
+ https://raw.github.com/aaharu/gifken/master/LICENSE
+
+ This product includes following software:
+ * GifWriter.js
+ - Copyright (c) 2013 NOBUOKA Yu
+ - https://github.com/nobuoka/GifWriter.js
+ - https://raw.github.com/nobuoka/GifWriter.js/master/LICENSE.txt
+ */
+import { GifFrame } from './GifFrame';
+import { GifVersion } from './GifVersion';
+import { GifImage } from './GifImage';
+export declare class Gif implements GifImage {
+    /**
+     * GIF Header block.
+     */
+    private _version;
+    /**
+     * GIF image width.
+     */
+    private _width;
+    /**
+     * GIF image height.
+     */
+    private _height;
+    /**
+     * The number of color in the Global Color Table.
+     */
+    private _globalTableSize;
+    colorResolution: number;
+    sortFlag: boolean;
+    bgColorIndex: number;
+    pixelAspectRatio: number;
+    /**
+     * The Global Color Table array.
+     */
+    private _globalColorTable;
+    frames: GifFrame[];
+    isLoop: boolean;
+    /**
+     * The number of animation iteration count.
+     * if this is 0, it is infinite.
+     */
+    private _loopCount;
+    frameIndex1: number;
+    frameIndex2: number;
+    /**
+     * Gif
+     */
+    constructor(skipDefault?: boolean);
+    /**
+     * Parse Gif image from ArrayBuffer.
+     *
+     * @return {Gif} parsed gif object
+     */
+    static parse(buffer: ArrayBuffer): Gif;
+    versionName(): string;
+    get version(): GifVersion;
+    set version(v: GifVersion);
+    get width(): number;
+    set width(width: number);
+    get height(): number;
+    set height(height: number);
+    get globalColorTable(): Uint8Array;
+    set globalColorTable(bytes: Uint8Array);
+    get globalTableSize(): number;
+    get loopCount(): number;
+    set loopCount(loopCount: number);
+    writeToArrayBuffer(): Uint8Array[];
+    /**
+     * Convert Gif to Uint8Array[].
+     *
+     * @return {Uint8Array[]} array of Uint8Array
+     */
+    static writeToArrayBuffer(gif: Gif): Uint8Array[];
+    /**
+     * TODO
+     **/
+    writeToArray(): number[];
+    /**
+     * Split the animated GIF image.
+     *
+     * @return {Gif[]} array of Gif object
+     */
+    split(overwrite: boolean): Gif[];
+    /**
+     * Playback the animated GIF image.
+     *
+     * @return {Gif} Gif object
+     */
+    playback(overwrite: boolean): Gif;
+    static compressWithLZW(actualCodes: Uint8Array, numBits: number): number[];
+}

package/lib/prod/src/owlly/element/gif-kit/GifColor.d.ts

@@ -0,0 +1,21 @@
+/*!
+ gifken
+ Copyright (c) 2013 aaharu
+ This software is released under the MIT License.
+ https://raw.github.com/aaharu/gifken/master/LICENSE
+ */
+export declare class GifColor {
+    r: number;
+    g: number;
+    b: number;
+    /**
+     * GifColor
+     */
+    constructor(r: number, g: number, b: number);
+    /**
+     * TODO:
+    static valueOf(color:string) {
+    }
+     */
+    static createColorTable(colors: GifColor[]): Uint8Array;
+}

package/lib/prod/src/owlly/element/gif-kit/GifCompressedCodesToByteArrayConverter.d.ts

@@ -0,0 +1,20 @@
+/*!
+ gifken
+ Copyright (c) 2013 aaharu
+ This software is released under the MIT License.
+ https://raw.github.com/aaharu/gifken/master/LICENSE
+
+ This product includes following software:
+ * GifWriter.js
+ - Copyright (c) 2013 NOBUOKA Yu
+ - https://github.com/nobuoka/GifWriter.js
+ - https://raw.github.com/nobuoka/GifWriter.js/master/LICENSE.txt
+ */
+export declare class GifCompressedCodesToByteArrayConverter {
+    private __out;
+    private __remNumBits;
+    private __remVal;
+    constructor();
+    push(code: number, numBits: number): void;
+    flush(): number[];
+}

package/lib/prod/src/owlly/element/gif-kit/GifFrame.d.ts

@@ -0,0 +1,31 @@
+/*!
+ gifken
+ Copyright (c) 2013 aaharu
+ This software is released under the MIT License.
+ https://raw.github.com/aaharu/gifken/master/LICENSE
+
+ This product includes following software:
+ * jsgif
+ - Copyright (c) 2011 Shachaf Ben-Kiki
+ - https://github.com/shachaf/jsgif
+ - https://raw.github.com/shachaf/jsgif/master/LICENSE
+ */
+export declare class GifFrame {
+    transparentFlag: boolean;
+    delayCentiSeconds: number;
+    transparentColorIndex: number;
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    localTableSize: number;
+    lzwCode: number;
+    localColorTable: Uint8Array;
+    compressedData: Uint8Array;
+    pixelData: Uint8Array;
+    orgpixelData: any;
+    pixels: Array<any>;
+    static init(width: number, height: number): GifFrame;
+    decompress(): void;
+    private lzwDecode;
+}

package/lib/prod/src/owlly/element/gif-kit/GifImage.d.ts

@@ -0,0 +1,23 @@
+/*!
+ gifken
+ Copyright (c) 2013 aaharu
+ This software is released under the MIT License.
+ https://raw.github.com/aaharu/gifken/master/LICENSE
+ */
+import { GifFrame } from './GifFrame';
+import { GifVersion } from './GifVersion';
+export interface GifImage {
+    colorResolution: number;
+    sortFlag: boolean;
+    bgColorIndex: number;
+    pixelAspectRatio: number;
+    frames: GifFrame[];
+    isLoop: boolean;
+    frameIndex1: number;
+    frameIndex2: number;
+    version: GifVersion;
+    width: number;
+    height: number;
+    globalColorTable: Uint8Array;
+    loopCount: number;
+}

package/lib/prod/src/owlly/element/gif-kit/GifParser.d.ts

@@ -0,0 +1,17 @@
+/*!
+ gifken
+ Copyright (c) 2013 aaharu
+ This software is released under the MIT License.
+ https://raw.github.com/aaharu/gifken/master/LICENSE
+ */
+import { GifImage } from './GifImage';
+import { GifFrame } from './GifFrame';
+export declare class GifParser {
+    static readHeader(gif: GifImage, data: DataView): number;
+    static readBlock(gif: GifImage, data: DataView, offset: number): number;
+    static readImageBlock(frame: GifFrame, data: DataView, offset: number): number;
+    static readApplicationExtensionBlock(gif: GifImage, data: DataView, offset: number): number;
+    static readCommentExtensionBlock(data: DataView, offset: number): number;
+    static readGraphicControlExtensionBlock(frame: GifFrame, data: DataView, offset: number): number;
+    static readPlainTextExtensionBlock(data: DataView, offset: number): number;
+}

package/lib/prod/src/owlly/element/gif-kit/GifPresenter.d.ts

@@ -0,0 +1,20 @@
+/*!
+ gifken
+ Copyright (c) 2013 aaharu
+ This software is released under the MIT License.
+ https://raw.github.com/aaharu/gifken/master/LICENSE
+ */
+export declare class GifPresenter {
+    /**
+     * Convert Gif to Blob.
+     *
+     * @return {Blob} BLOB
+     */
+    static writeToBlob(bytes: Uint8Array[]): Blob;
+    /**
+     * Convert Gif to Data-URL string.
+     *
+     * @return {string} Data-URL string
+     */
+    static writeToDataUrl(bytes: Uint8Array[]): string;
+}

package/lib/prod/src/owlly/element/gif-kit/GifVersion.d.ts

@@ -0,0 +1,10 @@
+/*!
+ gifken
+ Copyright (c) 2013 aaharu
+ This software is released under the MIT License.
+ https://raw.github.com/aaharu/gifken/master/LICENSE
+ */
+export declare enum GifVersion {
+    GIF89a = "GIF89a",
+    GIF87a = "GIF87a"
+}

package/lib/prod/src/owlly/element/gltf-mesh-element.d.ts

@@ -0,0 +1,31 @@
+import { NS_THREE } from '../stage/externals';
+import { Element, ElementFrameContext } from './element';
+import { View } from '../view/view';
+declare class GLTFMeshElement extends Element {
+    private initialized;
+    private loaded;
+    private needUpdate;
+    private meshes;
+    private meshMaterials;
+    private group;
+    private reloadTimes;
+    private options;
+    private eventListeners;
+    constructor(modelUrl: string, optionalParams?: {
+        fillColor?: NS_THREE.Color | string | number;
+        transparent?: boolean;
+        depthTest?: boolean;
+        renderOrder?: number;
+    }, meshoptDecoder?: any);
+    /**
+   * 读取Mesh模型
+   * @param url NS_THREE.Mesh模型地址
+   */
+    load(url: string, index?: number, meshoptDecoder?: any): void;
+    private setOptions;
+    setSacle(scale: number): void;
+    setOnCurrentViewChanged(func: (view: View) => void): void;
+    update(): ElementFrameContext;
+    dispose(): void;
+}
+export { GLTFMeshElement };

package/lib/prod/src/owlly/element/index.d.ts

@@ -0,0 +1,6 @@
+export * from './map-kit';
+export * from './element';
+export * from './placeable-2d';
+export * from './mesh-line-2d';
+export * from './ring-element';
+export * from './bottom-nav-element';