SuperMap ClientX (SuperMap3D) 开发核心入口

本技能是 SuperMap ClientX 的功能导航手册。所有 API 均通过全局变量 SuperMap3D 访问。

🚀 快速路由 (按开发意图)

| 我要实现... | 核心关键词 / API | 推荐子技能 |

| :--- | :--- | :--- |

| 加载数据 | S3M (SCP)、高斯泼溅 (S3M优先)、矢量瓦片 (MVT优先)、影像 (Imagery)、3D Tiles、Gltf 模型 | clientx-s3mtiles-load, clientx-vectortilesmap-load, clientx-imagery-load |

| 控制外观样式 | 专题图 (themeStyle)、阴影 (shadowType)、分层设色、白膜、PBR、线框模式、颜色调整 | clientx-s3mtiles-style, clientx-s3mtiles-basic, clientx-s3mtiles-effect |

| 空间操作与裁剪 | 裁剪 (Clipping)、压平 (Flatten)、开挖 (Excavation)、卷帘、偏移、可见性控制 | clientx-s3mtiles-operation, clientx-globe-terrain, clientx-s3mtiles-selection |

| 交互、拾取与弹窗 | 鼠标拾取 (pick/pickAsync)、坐标转换 (pickPosition)、气泡框 (Bubble)、事件监听 | clientx-interaction, clientx-camera |

| 空间分析 | 日照分析 (Sunlight)、可视域、通视、阴影分析、剖面、坡度坡向 | clientx-spatial-analysis, clientx-globe-terrain |

| 绘制点线面/实体 | Entity (Billboard/Label)、Primitive (Geometry)、GeoJSON、KML | clientx-entities, clientx-primitives |

| 场景环境配置 | Viewer 初始化、天空盒、大气、地下模式、时间轴 (Clock) | clientx-viewer-setup, clientx-time-properties |

🛠️ 核心技能模块地图

1. 数据加载与管理 (优先选型指南)

• S3M 图层加载（clientx-s3mtiles-load/SKILL.md）: 首选加载方式。支持精模、BIM、点云、高斯泼溅 (Gaussian Splatting)、倾斜摄影等。
• 矢量瓦片加载（clientx-vectortilesmap-load/SKILL.md）: 首选矢量地图方式。支持 MVT (Mapbox Vector Tile) 服务。
• 影像图层（clientx-imagery-load/SKILL.md）: WMTS、WMS、SuperMap 影像服务加载。
• 3D Tiles 技能（clientx-3d-tiles/SKILL.md）: 备选加载方式。支持标准 3D Tiles。

2. 图层表现与特效

• S3M 样式控制（clientx-s3mtiles-style/SKILL.md）: 专题图 (ThemeStyle)、分层设色、线框模式、白膜。
• S3M 基础属性（clientx-s3mtiles-basic/SKILL.md）: 开启阴影、LOD 调度、可见高度/视距控制。
• 高级特效与水面（clientx-s3mtiles-effect/SKILL.md）: S3M 水面特效 (WaterParameter)、PBR、泛光。

3. 空间分析与操作

• S3M 空间操作（clientx-s3mtiles-operation/SKILL.md）: 裁剪 (Clipping)、压平 (Flatten)、卷帘对比。
• 地形与地球（clientx-globe-terrain/SKILL.md）: 地形加载、地形开挖/镶嵌、地下模式。
• 空间分析服务（clientx-spatial-analysis/SKILL.md）: 日照 (SunlightAnalysis)、通视、可视域分析。

4. 交互与绘制

• 交互与拾取（clientx-interaction/SKILL.md）: ScreenSpaceEventHandler、同步/异步拾取 (pickAsync)、气泡框。
• 相机与飞行（clientx-camera/SKILL.md）: flyTo、lookAt、视图约束。
• Entities 与 Primitives（clientx-entities/SKILL.md）: 符号化绘制、GeoJSON 加载。

5. 基础环境

• Viewer 启动与配置（clientx-viewer-setup/SKILL.md）: 容器初始化、性能偏好、天空大气。
• 核心工具与数学（clientx-core-utilities/SKILL.md）: 坐标转换、工具类。
• 时间与动画（clientx-time-properties/SKILL.md）: Clock、动态属性。

💡 使用贴士

• 技术选型：在 ClientX 中，高斯泼溅 优先使用 S3M 格式加载；矢量瓦片 优先使用 addVectorTilesMap 接口（对应 clientx-vectortilesmap-load）。
• 异步处理 推荐使用 pickAsync 及 readyPromise 等异步接口。