@metagl/sdk-render 1.0.12 → 1.0.14

package/cjs/lacdt.render.d.ts

@@ -1,6 +1,7 @@
-import * as Cesium from 'cesium';
+import * as Cesium$1 from 'cesium';
 import { Cartesian3, Color, Viewer, PostProcessStage, Cartesian4, Rectangle, Primitive, Cesium3DTileset, ClippingPolygonCollection } from 'cesium';
 import { Render as Render$1 } from '@/system/RenderCore';
+import { VectorTileset } from '@metagl/sdk-mbtiles';
 
 /**
  * RenderSystem
@@ -1480,7 +1481,7 @@ declare class LayerSystem implements RenderSystem {
 }
 
 interface ViewshedConfig {
-    position: Cesium.Cartesian3;
+    position: Cesium$1.Cartesian3;
     heading: number;
     pitch: number;
     distance: number;
@@ -1490,8 +1491,8 @@ interface ViewshedConfig {
     texelSnap?: boolean;
     minHeight?: number;
     near?: number;
-    visibleColor?: Cesium.Color;
-    hiddenColor?: Cesium.Color;
+    visibleColor?: Cesium$1.Color;
+    hiddenColor?: Cesium$1.Color;
 }
 /**
  * 视域分析系统 - 支持多视域实例和多视锥体模式
@@ -1559,7 +1560,7 @@ declare class ViewshedAnalysisSystem implements RenderSystem {
     /**
      * 使用 direction 和 up 向量更新视域方向（参考 DirectionCameraBinding）
      */
-    updateViewshedOrientation(id: string, position: Cesium.Cartesian3, direction: Cesium.Cartesian3, up: Cesium.Cartesian3): void;
+    updateViewshedOrientation(id: string, position: Cesium$1.Cartesian3, direction: Cesium$1.Cartesian3, up: Cesium$1.Cartesian3): void;
     /**
      * 更新可视距离
      */
@@ -1659,7 +1660,7 @@ declare class ViewshedAnalysisSystem implements RenderSystem {
 }
 
 interface SingleViewshedConfig {
-    position: Cesium.Cartesian3;
+    position: Cesium$1.Cartesian3;
     heading: number;
     pitch: number;
     distance: number;
@@ -2473,6 +2474,7 @@ interface RenderConfig {
     machineCode?: string;
     lic?: string;
     rsaPubKey?: string;
+    assetsBasePath?: string;
     directionalLight?: DirectionalLightConfig;
     shadow?: ShadowConfig;
     volumetricClouds?: VolumetricCloudsConfig;
@@ -2679,6 +2681,54 @@ declare class Render {
     destroy(): void;
 }
 
+/**
+ * 版本信息工具类
+ * 用于在运行时获取 SDK 的版本信息
+ */
+interface VersionInfo {
+    version: string;
+    buildTime: string;
+    buildMode: string;
+}
+/**
+ * 获取 SDK 版本信息
+ * @returns 版本信息对象
+ */
+declare function getVersionInfo(): VersionInfo;
+/**
+ * 在控制台打印版本信息
+ */
+declare function printVersion(): void;
+/**
+ * 版本信息类
+ */
+declare class Version {
+    /**
+     * 获取版本号
+     */
+    static get version(): string;
+    /**
+     * 获取构建时间
+     */
+    static get buildTime(): string;
+    /**
+     * 获取构建模式
+     */
+    static get buildMode(): string;
+    /**
+     * 获取完整版本信息
+     */
+    static get info(): VersionInfo;
+    /**
+     * 打印版本信息到控制台
+     */
+    static print(): void;
+    /**
+     * 转换为字符串
+     */
+    static toString(): string;
+}
+
 declare class RenderControl {
     private viewer;
     private render;
@@ -4618,6 +4668,122 @@ declare class RainSystem {
     private _getParticleSystemMatrix;
 }
 
+interface VectorTileSystemConfig {
+    enabled?: boolean;
+    style?: string | object;
+    showTileColor?: boolean;
+    workerUrl?: string;
+    maximumActiveTasks?: number;
+    useBillboard?: boolean;
+}
+/**
+ * 矢量瓦片系统类
+ * 用于加载和显示Mapbox矢量瓦片
+ * 参考: sdk-mbtiles/examples/index.js
+ */
+declare class VectorTileSystem {
+    private viewer;
+    private isEnabled;
+    private config;
+    private tileset;
+    private style;
+    constructor(viewer: Cesium.Viewer, config?: VectorTileSystemConfig);
+    /**
+     * 初始化系统
+     */
+    private init;
+    /**
+     * 设置样式并重新加载
+     * @param style Mapbox样式URL或样式对象
+     */
+    setStyle(style: string | object): Promise<void>;
+    /**
+     * 获取当前样式
+     */
+    getStyle(): string | object | null;
+    /**
+     * 设置图层布局属性
+     * @param layerId 图层ID
+     * @param name 属性名
+     * @param value 属性值
+     */
+    setLayoutProperty(layerId: string, name: string, value: any): boolean;
+    /**
+     * 设置图层绘制属性
+     * @param layerId 图层ID
+     * @param name 属性名
+     * @param value 属性值
+     */
+    setPaintProperty(layerId: string, name: string, value: any): boolean;
+    /**
+     * 设置图层过滤器
+     * @param layerId 图层ID
+     * @param filter 过滤器
+     */
+    setFilter(layerId: string, filter: any): boolean;
+    /**
+     * 获取矢量瓦片集实例
+     */
+    getTileset(): VectorTileset | null;
+    /**
+     * 获取就绪状态
+     */
+    isReady(): boolean;
+    /**
+     * 设置显示状态
+     */
+    setVisible(visible: boolean): void;
+    /**
+     * 获取显示状态
+     */
+    getVisible(): boolean;
+    /**
+     * 启用系统
+     */
+    enable(): Promise<void>;
+    /**
+     * 禁用系统
+     */
+    disable(): Promise<void>;
+    /**
+     * 获取启用状态
+     */
+    getStatus(): boolean;
+    /**
+     * 切换启用状态
+     */
+    toggle(): Promise<boolean>;
+    /**
+     * 更新配置
+     */
+    update(newConfig: Partial<VectorTileSystemConfig>): Promise<void>;
+    /**
+     * 获取当前配置
+     */
+    getConfig(): VectorTileSystemConfig;
+    /**
+     * 移除矢量瓦片集
+     */
+    private removeTileset;
+    /**
+     * 销毁系统
+     */
+    destroy(): Promise<void>;
+}
+
+/**
+ * 设置全局基础路径（供用户手动配置）
+ */
+declare function setSdkBasePath(path: string): void;
+/**
+ * 获取当前基础路径
+ */
+declare function getSdkBasePath(): string;
+/**
+ * 解析资源路径
+ */
+declare function resolveAssetPath(relativePath: string): string;
+
 declare global {
     interface Window {
         LACDT?: Record<string, any>;
@@ -4626,6 +4792,8 @@ declare global {
 }
 
 declare const render: {
+    /** 版本信息 */
+    Version: typeof Version;
     /** 渲染类 */
     Render: typeof Render;
     /** 渲染控制面板 */
@@ -4662,6 +4830,14 @@ declare const render: {
     RainSystem: typeof RainSystem;
     /** 海洋系统 */
     SeaSystem: typeof SeaSystem;
+    /** 矢量瓦片系统 */
+    VectorTileSystem: typeof VectorTileSystem;
+    /** 设置资源基础路径 */
+    setSdkBasePath: typeof setSdkBasePath;
+    /** 获取当前资源基础路径 */
+    getSdkBasePath: typeof getSdkBasePath;
+    /** 解析资源路径 */
+    resolveAssetPath: typeof resolveAssetPath;
 };
 
-export { AtmosphereControl, type AtmosphereScatteringConfig, AtmosphereScatteringSystem, BuildingControl, BuildingSystem, CameraListener, type CameraListenerConfig, CameraListenerSystem, type CameraListenerSystemConfig, type CameraParams, CameraUrlManager, type CameraUrlManagerConfig, type DirectionalLightConfig, type DistanceFogConfig, DistanceFogSystem, EnvironmentControl, FogControl, type HeightFogConfig, HeightFogSystem, LayerControl, LayerSystem, LightingControl, LightingSystem, PlottingControl, type PostProcessingConfig, PostProcessingControl, PostProcessingSystem, RainSystem, Render, type RenderConfig, RenderControl, type SeaConfig, SeaSystem, type ShadowConfig, ShadowControl, ShadowSystem, SidebarControl, TilesetManager, TilesetSearchControl, ToolboxControl, ToolboxSystem, VolumetricCloudControl, type VolumetricCloudsConfig, VolumetricCloudsSystem, type WaterConfig, WaterControl, WaterSystem, type WeatherAreaData, render };
+export { AtmosphereControl, type AtmosphereScatteringConfig, AtmosphereScatteringSystem, BuildingControl, BuildingSystem, CameraListener, type CameraListenerConfig, CameraListenerSystem, type CameraListenerSystemConfig, type CameraParams, CameraUrlManager, type CameraUrlManagerConfig, type DirectionalLightConfig, type DistanceFogConfig, DistanceFogSystem, EnvironmentControl, FogControl, type HeightFogConfig, HeightFogSystem, LayerControl, LayerSystem, LightingControl, LightingSystem, PlottingControl, type PostProcessingConfig, PostProcessingControl, PostProcessingSystem, RainSystem, Render, type RenderConfig, RenderControl, type SeaConfig, SeaSystem, type ShadowConfig, ShadowControl, ShadowSystem, SidebarControl, TilesetManager, TilesetSearchControl, ToolboxControl, ToolboxSystem, VectorTileSystem, Version, type VersionInfo, VolumetricCloudControl, type VolumetricCloudsConfig, VolumetricCloudsSystem, type WaterConfig, WaterControl, WaterSystem, type WeatherAreaData, getSdkBasePath, getVersionInfo, printVersion, render, resolveAssetPath, setSdkBasePath };

package/esm/lacdt.render.d.ts

@@ -1,6 +1,7 @@
-import * as Cesium from 'cesium';
+import * as Cesium$1 from 'cesium';
 import { Cartesian3, Color, Viewer, PostProcessStage, Cartesian4, Rectangle, Primitive, Cesium3DTileset, ClippingPolygonCollection } from 'cesium';
 import { Render as Render$1 } from '@/system/RenderCore';
+import { VectorTileset } from '@metagl/sdk-mbtiles';
 
 /**
  * RenderSystem
@@ -1480,7 +1481,7 @@ declare class LayerSystem implements RenderSystem {
 }
 
 interface ViewshedConfig {
-    position: Cesium.Cartesian3;
+    position: Cesium$1.Cartesian3;
     heading: number;
     pitch: number;
     distance: number;
@@ -1490,8 +1491,8 @@ interface ViewshedConfig {
     texelSnap?: boolean;
     minHeight?: number;
     near?: number;
-    visibleColor?: Cesium.Color;
-    hiddenColor?: Cesium.Color;
+    visibleColor?: Cesium$1.Color;
+    hiddenColor?: Cesium$1.Color;
 }
 /**
  * 视域分析系统 - 支持多视域实例和多视锥体模式
@@ -1559,7 +1560,7 @@ declare class ViewshedAnalysisSystem implements RenderSystem {
     /**
      * 使用 direction 和 up 向量更新视域方向（参考 DirectionCameraBinding）
      */
-    updateViewshedOrientation(id: string, position: Cesium.Cartesian3, direction: Cesium.Cartesian3, up: Cesium.Cartesian3): void;
+    updateViewshedOrientation(id: string, position: Cesium$1.Cartesian3, direction: Cesium$1.Cartesian3, up: Cesium$1.Cartesian3): void;
     /**
      * 更新可视距离
      */
@@ -1659,7 +1660,7 @@ declare class ViewshedAnalysisSystem implements RenderSystem {
 }
 
 interface SingleViewshedConfig {
-    position: Cesium.Cartesian3;
+    position: Cesium$1.Cartesian3;
     heading: number;
     pitch: number;
     distance: number;
@@ -2473,6 +2474,7 @@ interface RenderConfig {
     machineCode?: string;
     lic?: string;
     rsaPubKey?: string;
+    assetsBasePath?: string;
     directionalLight?: DirectionalLightConfig;
     shadow?: ShadowConfig;
     volumetricClouds?: VolumetricCloudsConfig;
@@ -2679,6 +2681,54 @@ declare class Render {
     destroy(): void;
 }
 
+/**
+ * 版本信息工具类
+ * 用于在运行时获取 SDK 的版本信息
+ */
+interface VersionInfo {
+    version: string;
+    buildTime: string;
+    buildMode: string;
+}
+/**
+ * 获取 SDK 版本信息
+ * @returns 版本信息对象
+ */
+declare function getVersionInfo(): VersionInfo;
+/**
+ * 在控制台打印版本信息
+ */
+declare function printVersion(): void;
+/**
+ * 版本信息类
+ */
+declare class Version {
+    /**
+     * 获取版本号
+     */
+    static get version(): string;
+    /**
+     * 获取构建时间
+     */
+    static get buildTime(): string;
+    /**
+     * 获取构建模式
+     */
+    static get buildMode(): string;
+    /**
+     * 获取完整版本信息
+     */
+    static get info(): VersionInfo;
+    /**
+     * 打印版本信息到控制台
+     */
+    static print(): void;
+    /**
+     * 转换为字符串
+     */
+    static toString(): string;
+}
+
 declare class RenderControl {
     private viewer;
     private render;
@@ -4618,6 +4668,122 @@ declare class RainSystem {
     private _getParticleSystemMatrix;
 }
 
+interface VectorTileSystemConfig {
+    enabled?: boolean;
+    style?: string | object;
+    showTileColor?: boolean;
+    workerUrl?: string;
+    maximumActiveTasks?: number;
+    useBillboard?: boolean;
+}
+/**
+ * 矢量瓦片系统类
+ * 用于加载和显示Mapbox矢量瓦片
+ * 参考: sdk-mbtiles/examples/index.js
+ */
+declare class VectorTileSystem {
+    private viewer;
+    private isEnabled;
+    private config;
+    private tileset;
+    private style;
+    constructor(viewer: Cesium.Viewer, config?: VectorTileSystemConfig);
+    /**
+     * 初始化系统
+     */
+    private init;
+    /**
+     * 设置样式并重新加载
+     * @param style Mapbox样式URL或样式对象
+     */
+    setStyle(style: string | object): Promise<void>;
+    /**
+     * 获取当前样式
+     */
+    getStyle(): string | object | null;
+    /**
+     * 设置图层布局属性
+     * @param layerId 图层ID
+     * @param name 属性名
+     * @param value 属性值
+     */
+    setLayoutProperty(layerId: string, name: string, value: any): boolean;
+    /**
+     * 设置图层绘制属性
+     * @param layerId 图层ID
+     * @param name 属性名
+     * @param value 属性值
+     */
+    setPaintProperty(layerId: string, name: string, value: any): boolean;
+    /**
+     * 设置图层过滤器
+     * @param layerId 图层ID
+     * @param filter 过滤器
+     */
+    setFilter(layerId: string, filter: any): boolean;
+    /**
+     * 获取矢量瓦片集实例
+     */
+    getTileset(): VectorTileset | null;
+    /**
+     * 获取就绪状态
+     */
+    isReady(): boolean;
+    /**
+     * 设置显示状态
+     */
+    setVisible(visible: boolean): void;
+    /**
+     * 获取显示状态
+     */
+    getVisible(): boolean;
+    /**
+     * 启用系统
+     */
+    enable(): Promise<void>;
+    /**
+     * 禁用系统
+     */
+    disable(): Promise<void>;
+    /**
+     * 获取启用状态
+     */
+    getStatus(): boolean;
+    /**
+     * 切换启用状态
+     */
+    toggle(): Promise<boolean>;
+    /**
+     * 更新配置
+     */
+    update(newConfig: Partial<VectorTileSystemConfig>): Promise<void>;
+    /**
+     * 获取当前配置
+     */
+    getConfig(): VectorTileSystemConfig;
+    /**
+     * 移除矢量瓦片集
+     */
+    private removeTileset;
+    /**
+     * 销毁系统
+     */
+    destroy(): Promise<void>;
+}
+
+/**
+ * 设置全局基础路径（供用户手动配置）
+ */
+declare function setSdkBasePath(path: string): void;
+/**
+ * 获取当前基础路径
+ */
+declare function getSdkBasePath(): string;
+/**
+ * 解析资源路径
+ */
+declare function resolveAssetPath(relativePath: string): string;
+
 declare global {
     interface Window {
         LACDT?: Record<string, any>;
@@ -4626,6 +4792,8 @@ declare global {
 }
 
 declare const render: {
+    /** 版本信息 */
+    Version: typeof Version;
     /** 渲染类 */
     Render: typeof Render;
     /** 渲染控制面板 */
@@ -4662,6 +4830,14 @@ declare const render: {
     RainSystem: typeof RainSystem;
     /** 海洋系统 */
     SeaSystem: typeof SeaSystem;
+    /** 矢量瓦片系统 */
+    VectorTileSystem: typeof VectorTileSystem;
+    /** 设置资源基础路径 */
+    setSdkBasePath: typeof setSdkBasePath;
+    /** 获取当前资源基础路径 */
+    getSdkBasePath: typeof getSdkBasePath;
+    /** 解析资源路径 */
+    resolveAssetPath: typeof resolveAssetPath;
 };
 
-export { AtmosphereControl, type AtmosphereScatteringConfig, AtmosphereScatteringSystem, BuildingControl, BuildingSystem, CameraListener, type CameraListenerConfig, CameraListenerSystem, type CameraListenerSystemConfig, type CameraParams, CameraUrlManager, type CameraUrlManagerConfig, type DirectionalLightConfig, type DistanceFogConfig, DistanceFogSystem, EnvironmentControl, FogControl, type HeightFogConfig, HeightFogSystem, LayerControl, LayerSystem, LightingControl, LightingSystem, PlottingControl, type PostProcessingConfig, PostProcessingControl, PostProcessingSystem, RainSystem, Render, type RenderConfig, RenderControl, type SeaConfig, SeaSystem, type ShadowConfig, ShadowControl, ShadowSystem, SidebarControl, TilesetManager, TilesetSearchControl, ToolboxControl, ToolboxSystem, VolumetricCloudControl, type VolumetricCloudsConfig, VolumetricCloudsSystem, type WaterConfig, WaterControl, WaterSystem, type WeatherAreaData, render };
+export { AtmosphereControl, type AtmosphereScatteringConfig, AtmosphereScatteringSystem, BuildingControl, BuildingSystem, CameraListener, type CameraListenerConfig, CameraListenerSystem, type CameraListenerSystemConfig, type CameraParams, CameraUrlManager, type CameraUrlManagerConfig, type DirectionalLightConfig, type DistanceFogConfig, DistanceFogSystem, EnvironmentControl, FogControl, type HeightFogConfig, HeightFogSystem, LayerControl, LayerSystem, LightingControl, LightingSystem, PlottingControl, type PostProcessingConfig, PostProcessingControl, PostProcessingSystem, RainSystem, Render, type RenderConfig, RenderControl, type SeaConfig, SeaSystem, type ShadowConfig, ShadowControl, ShadowSystem, SidebarControl, TilesetManager, TilesetSearchControl, ToolboxControl, ToolboxSystem, VectorTileSystem, Version, type VersionInfo, VolumetricCloudControl, type VolumetricCloudsConfig, VolumetricCloudsSystem, type WaterConfig, WaterControl, WaterSystem, type WeatherAreaData, getSdkBasePath, getVersionInfo, printVersion, render, resolveAssetPath, setSdkBasePath };