@metagl/sdk-render 1.0.5 → 1.0.6

package/README.md

@@ -166,47 +166,62 @@ SDK渲染引擎采用模块化架构，包含以下系统：
 - **测量系统**：用于在三维场景中进行各种测量操作
 - **3DTiles搜索系统**：处理3D Tiles模型搜索和信息展示
 
-## Changelog
+## 更新日志
+
+### V1.0.6 (2026-03-25)
+
+#### 问题修复
+- **SunLight direction 初始化修复**
+  - 修复 Cesium SunLight 在某些情况下 direction 属性未正确初始化的问题
+  - 添加 direction 属性检查，若不存在则手动设置默认太阳方向
+  - 使用 `Cartesian3(0, 0, 1)` 作为默认方向（正午时分的大致方向）
 
 ### V1.0.5 (2026-03-24)
 
-#### Viewshed Analysis Feature Optimization
-- **Picking Interaction Optimization**
-  - Fixed issue where first point was displayed prematurely in picking mode
-  - No visualization elements shown before picking starts, only created after clicking on map
-  - Added detailed debug logs for diagnosing picking issues
-  - Mouse move no longer sets picking position prematurely, waiting for first click
-
-- **Viewshed Panel Style Optimization**
-  - Viewshed panel centered horizontally (left: 50% + transform: translateX(-50%))
-  - Maintains vertical position at top (top: 18px)
-
-- **Multi-Viewshed Analysis System (ViewshedAnalysisSystem)**
-  - Supports LACDT.Obj.ViewshedAnalysis multi-frustum mode
-  - Implemented startPicking/stopPicking methods
-  - Added picking visualization Entity (green start point, yellow end point, arrow line)
-  - Real-time update of arrow line and frustum direction during mouse move
-  - Added right-click to cancel picking
-  - Hide ViewshedAnalysis during picking, show again after completion
-
-#### Bug Fixes
-- Fixed ShadowMap creation missing context parameter issue
-- Fixed MouseEventSource missing animationFrameScheduler import (RxJS scheduler bug)
+#### 视域分析功能优化
+- **拾取交互优化**
+  - 修复拾取模式下第一个点过早显示的问题
+  - 拾取开始前不显示可视化元素，只有在地图上点击后才创建
+  - 添加详细的调试日志用于诊断拾取问题
+  - 鼠标移动不再过早设置拾取位置，等待第一次点击
+
+- **视域面板样式优化**
+  - 视域面板水平居中（left: 50% + transform: translateX(-50%)）
+  - 保持垂直位置在顶部（top: 18px）
+
+- **多视域分析系统 (ViewshedAnalysisSystem)**
+  - 支持 LACDT.Obj.ViewshedAnalysis 多视锥体模式
+  - 实现 startPicking/stopPicking 方法
+  - 添加拾取可视化 Entity（绿色起点、黄色终点、箭头线）
+  - 鼠标移动时实时更新箭头线和视锥体方向
+  - 添加右键取消拾取功能
+  - 拾取期间隐藏 ViewshedAnalysis，完成后重新显示
+
+#### 问题修复
+- 修复 ShadowMap 创建缺少 context 参数的问题
+- 修复 MouseEventSource 缺少 animationFrameScheduler 导入的问题（RxJS scheduler bug）
 
 ### V1.0.4 (2026-03-23)
-- **CustomPrimitive Cesium 1.132+ Compatibility Fix**
-  - Root cause: `VertexArray.fromGeometry` no longer supports object literals for default geometry attributes
-  - Solution: Use actual `Cesium.GeometryAttribute` instances with proper `values` arrays
-  - Modified `createVertexArray` function in `CustomPrimitive.js`
-  - Changed `normalAttribute`, `colorAttribute`, `textureCoordinate` to use `new Cesium.GeometryAttribute(...)` instead of object literals
-
-- **Air Quality Monitoring Panel Tech Style Update**
-  - Deep blue gradient background with glowing border effects
-  - Animated scan line and corner decorations
-  - Large glowing data values with status indicators
-  - Improved typography and layout
-
-## Contact Information
+- **CustomPrimitive Cesium 1.132+ 兼容性修复**
+  - 根本原因：`VertexArray.fromGeometry` 不再支持对象字面量作为默认几何属性
+  - 解决方案：使用实际的 `Cesium.GeometryAttribute` 实例和正确的 `values` 数组
+  - 修改 `CustomPrimitive.js` 中的 `createVertexArray` 函数
+  - 将 `normalAttribute`、`colorAttribute`、`textureCoordinate` 改为使用 `new Cesium.GeometryAttribute(...)` 而不是对象字面量
+
+- **空气质量监测面板科技风格更新**
+  - 深蓝色渐变背景配合发光边框效果
+  - 动画扫描线和角落装饰
+  - 大型发光数据值配合状态指示器
+  - 改进排版和布局
+
+### V1.0.0 (2026-03-04)
+- **URL相机定位功能 (CameraUrlManager)**
+  - 从URL参数读取相机位置
+  - 相机移动时自动更新URL参数（带防抖优化）
+  - 支持自定义默认相机角度
+  - 支持相机位置变化回调
+
+## 联系方式
 
 - **官方文档**：https://sdk.geovisearth.com/
 - **邮箱支持**：sunyc@geovis.com.cn

package/README_EN.md

@@ -167,7 +167,14 @@ The SDK rendering engine adopts a modular architecture, including the following
 - **3DTiles Search System**: Handles 3D Tiles model search and information display
 
 ## Changelog
-- Release Date: 2026-03-24
+
+### V1.0.6 (2026-03-25)
+
+#### Bug Fixes
+- **SunLight direction initialization fix**
+  - Fixed issue where Cesium SunLight direction property was not properly initialized in some cases
+  - Added direction property check, manually setting default sun direction if not present
+  - Using `Cartesian3(0, 0, 1)` as default direction (approximate noon sun direction)
 
 ### V1.0.5 (2026-03-24)
 
@@ -195,17 +202,25 @@ The SDK rendering engine adopts a modular architecture, including the following
 - Fixed MouseEventSource missing animationFrameScheduler import (RxJS scheduler bug)
 
 ### V1.0.4 (2026-03-23)
-- Fixed CustomPrimitive rendering issue with Cesium 1.132+
+- **CustomPrimitive Cesium 1.132+ Compatibility Fix**
   - Root cause: `VertexArray.fromGeometry` no longer supports object literals for default geometry attributes
   - Solution: Use actual `Cesium.GeometryAttribute` instances with proper `values` arrays
   - Modified `createVertexArray` function in `CustomPrimitive.js`
   - Changed `normalAttribute`, `colorAttribute`, `textureCoordinate` to use `new Cesium.GeometryAttribute(...)` instead of object literals
-- Updated air quality monitoring panel with modern tech-style design
+
+- **Air Quality Monitoring Panel Tech Style Update**
   - Deep blue gradient background with glowing border effects
   - Animated scan line and corner decorations
   - Large glowing data values with status indicators
   - Improved typography and layout
 
+### V1.0.0 (2026-03-04)
+- **URL Camera Positioning Feature (CameraUrlManager)**
+  - Read camera position from URL parameters
+  - Automatically update URL parameters when camera moves (with debounce optimization)
+  - Support for custom default camera angles
+  - Callback support for camera position changes
+
 ## Contact Information
 
 - **Official Documentation**: https://sdk.geovisearth.com/

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@metagl/sdk-render",
-  "version": "1.0.5",
+  "version": "1.0.6",
   "description": "Earth SDK Render",
   "main": "lacdt.render.js",
   "module": "./esm/lacdt.render.js",