@aibee/owlly 1.0.25 → 1.0.29

package/lib/owlly/element/panorama.d.ts

@@ -0,0 +1,132 @@
+import { NS_THREE } from '../stage/externals';
+import { Element, ElementFrameContext } from './element';
+import { View } from '../view/view';
+interface PanoramaViewConfiguration {
+    targetView: View;
+    showBorder?: boolean;
+    showSkyBox?: boolean;
+}
+/**
+ * 全景图对象
+ * @noInheritDoc
+ */
+declare class Panorama extends Element {
+    private initialized;
+    private needsUpdate;
+    private skyBox;
+    private sphereMesh;
+    private isPlayingVideo;
+    private video;
+    private skyBoxFaceGrids;
+    private wireFrame;
+    private material;
+    private faceGridsMaterials;
+    private uniforms;
+    private faceGridsUniformses;
+    private faceGridsStates;
+    private faceGridTextureCacheKeys;
+    private faceGridRows;
+    private faceGridCols;
+    private gridCenters;
+    pid: number;
+    seqID: number;
+    neighborPanoramaIDs: number[];
+    highTextureURLs: string[];
+    textureURLs: string[];
+    useLowTextureURLsOnly: boolean;
+    tiledTextureURLRoot: string | undefined;
+    private baseQuaternion;
+    private additionalQuaternion;
+    private panoramaLoaded;
+    private eventListeners;
+    private isSelected;
+    private viewConfigurations;
+    private panoViews;
+    private videoCanvas;
+    private mpegVideoPlayer;
+    private videoContentType;
+    legacyMode: boolean;
+    /**
+     * @param textureURLs 低清立方体贴图六张图的URL数组（本地相对路径或网络URL均可），按右左上下前后的顺序
+     * @param highTextureURLs 高清立方体贴图六张图的URL数组（本地相对路径或网络URL均可），按右左上下前后的顺序
+     * @param useLowTextureURLsOnly 可选，设置后则（如果没有提供瓦片贴图）只使用低清立方体贴图
+     * @param tiledTextureURLRoot 可选，瓦片贴图URL的前缀部分，若没有则用highTextureURLs和lowTextureURLs作为贴图源
+     */
+    constructor(pid: number, seqID: number, textureURLs: string[], faceGridsSize: number[], neighborPanoramaIDs?: number[], highTextureURLs?: string[], useLowTextureURLsOnly?: boolean, tiledTextureURLRoot?: string, position?: NS_THREE.Vector3, quaternion?: NS_THREE.Quaternion, legacyMode?: boolean);
+    /**
+     * 为全景图对象设置立方体贴图
+     * @param cubeTexture 立方体贴图对象
+     */
+    setTexture(cubeTexture: NS_THREE.CubeTexture): void;
+    /**
+     * 暂停视频播放
+     */
+    pauseVideo(): void;
+    /**
+     * 恢复视频播放
+     */
+    resumeVideo(): Promise<void>;
+    /**
+     * 停止视频播放，并释放视频相关资源
+     */
+    stopVideo(): void;
+    /**
+     * 开始视频播放
+     * @param videoURL 视频地址
+     * @param loop 是否循环播放
+     * @param callbacks 回调函数集合，可选
+     */
+    playVideo(videoURL: string, loop: boolean, callbacks?: {
+        onPrepareToPlay?: (video?: HTMLVideoElement) => void;
+        onReadyToPlay?: (video?: HTMLVideoElement) => void;
+        onEnded?: (video?: HTMLVideoElement) => void;
+    }, contentType?: 'mp4' | 'ts', canvasSize?: [number, number]): HTMLVideoElement | null;
+    getIntersectedTiles(camera: NS_THREE.Camera | undefined): {
+        hdTiles: number[][];
+        ldTiles: number[][];
+    };
+    private setFaceTexture;
+    updateTexture(textureURLs?: string[]): Promise<void>;
+    /**
+     * @param hdFaceGrids [][faceIndex, row, col]
+     */
+    private updateHDGridTextures;
+    private updateLDGridTextures;
+    /**
+     * 异步加载天空盒贴图，优先从cache中获取
+     * @param textureURLs 新的天空盒贴图六面图像URL（如果需要更新的话）
+     */
+    updateFaceGridsTextures(hdFaceGrids: number[][], ldFaceGrids: number[][]): Promise<void>;
+    /**
+     * 设置是否只使用低分辨率贴图
+     * @param useLowTexturesOnly 是否只使用低分辨率贴图
+     */
+    setUseLowTexturesOnly(useLowTexturesOnly: boolean): void;
+    isUseLowTexturesOnly(): boolean;
+    dispose(): void;
+    /**
+     * @ignore
+     */
+    update(): ElementFrameContext;
+    /**
+     * 使用欧拉角模式设置矫正
+     * @param roll 横滚角, 坐标轴为x
+     * @param pitch 俯仰角, 坐标轴为y
+     * @param yaw 偏航角, 坐标轴为z
+     */
+    setAdditionalRotationInEuler(roll: number, pitch: number, yaw: number): NS_THREE.Quaternion;
+    /**
+     * 使用四元数模式设置矫正
+     * @param x 四元数的x值
+     * @param y 四元数的y值
+     * @param z 四元数的y值
+     * @param w 四元数的w值
+     */
+    setAdditionalRotationInQuaternion(x: number, y: number, z: number, w: number): NS_THREE.Euler;
+    /**
+     * 配置全景图在不同view中的显示状态
+     * @param configuration 全景图配置
+     */
+    addViewConfiguration(configuration: PanoramaViewConfiguration): void;
+}
+export { Panorama, PanoramaViewConfiguration };