cesium-mars-op-cog 0.1.3 → 0.1.4

package/dist/adapters/mars3d.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Mars3D COG 图层适配器
+ *
+ * 提供 mars3d.layer.BaseLayer 子类，可通过 map.addLayer() 添加、
+ * map.removeLayer() 移除、layer.show / layer.alpha 等原生 API 控制。
+ *
+ * 用法:
+ *   import { CogMarsLayer } from 'cesium-mars-op-cog'
+ *
+ *   const layer = new CogMarsLayer({
+ *     url: 'http://.../image.tif',
+ *     name: 'COG 影像',
+ *     alpha: 0.8,
+ *   })
+ *   map.addLayer(layer)
+ *
+ *   // 原生 Mars3D API 控制
+ *   layer.alpha = 0.5
+ *   layer.show = false
+ *   map.removeLayer(layer)
+ */
+import * as mars3d from 'mars3d';
+import { CogImageryProvider } from '../core/provider';
+import type { CogProviderOptions } from '../core/provider';
+export interface CogMarsLayerOptions extends CogProviderOptions {
+    /** COG 文件 URL */
+    url: string;
+    /** 图层名称 */
+    name?: string;
+    /** 图层 ID */
+    id?: string | number;
+    /** 是否显示 */
+    show?: boolean;
+    /** 透明度 0-1（默认 1） */
+    alpha?: number;
+}
+export declare class CogMarsLayer extends mars3d.layer.BaseLayer {
+    /** 图层类型标识 */
+    readonly type = "cog";
+    /** 是否为瓦片图层 */
+    readonly isTile = true;
+    /** 是否支持透明度 */
+    readonly hasOpacity = true;
+    private _cogUrl;
+    private _cogOptions;
+    private _cogAlpha;
+    private _imageryLayer;
+    private _cogProvider;
+    private _initPromise;
+    constructor(options: CogMarsLayerOptions);
+    /**
+     * 图层被添加到地图时自动调用
+     */
+    _mountedHook(): void;
+    /**
+     * 图层从地图移除时自动调用
+     */
+    _removedHook(): void;
+    /**
+     * 异步初始化 COG Provider 并添加到地图影像图层
+     */
+    private _initAsync;
+    /**
+     * 移除影像图层
+     */
+    private _removeImageryLayer;
+    /** 透明度 */
+    get alpha(): number;
+    set alpha(v: number);
+    /** 亮度 */
+    get brightness(): number;
+    set brightness(v: number);
+    /** 对比度 */
+    get contrast(): number;
+    set contrast(v: number);
+    /** 饱和度 */
+    get saturation(): number;
+    set saturation(v: number);
+    /** 伽马校正 */
+    get gamma(): number;
+    set gamma(v: number);
+    /** 获取对应的 Cesium ImageryLayer 对象 */
+    get imageryLayer(): any;
+    /**
+     * 获取 COG Provider（初始化完成后可用）
+     */
+    get cogProvider(): CogImageryProvider | null;
+    /** 销毁 */
+    destroy(noDel?: boolean): void;
+}

package/dist/index.d.ts

@@ -21,6 +21,8 @@ export { createCogProvider, addCogLayerToMap } from './cog';
 export type { AddLayerOptions } from './cog';
 export { addCogLayerToOpenLayers } from './adapters/openlayers';
 export type { OpenLayersLayerOptions } from './adapters/openlayers';
+export { CogMarsLayer } from './adapters/mars3d';
+export type { CogMarsLayerOptions } from './adapters/mars3d';
 export type { CogInitResult, CogLayerOptions, TileRect, TileResult } from './core/types';
 export { LRUCache } from './utils/cache';
 export { expandRectangle } from './utils/geo';