@metagl/sdk-render 1.0.4 → 1.0.6

package/README.md

@@ -166,20 +166,60 @@ SDK渲染引擎采用模块化架构，包含以下系统：
 - **测量系统**：用于在三维场景中进行各种测量操作
 - **3DTiles搜索系统**：处理3D Tiles模型搜索和信息展示
 
-##  更新日志：
+## 更新日志
+
+### V1.0.6 (2026-03-25)
+
+#### 问题修复
+- **SunLight direction 初始化修复**
+  - 修复 Cesium SunLight 在某些情况下 direction 属性未正确初始化的问题
+  - 添加 direction 属性检查，若不存在则手动设置默认太阳方向
+  - 使用 `Cartesian3(0, 0, 1)` 作为默认方向（正午时分的大致方向）
+
+### V1.0.5 (2026-03-24)
+
+#### 视域分析功能优化
+- **拾取交互优化**
+  - 修复拾取模式下第一个点过早显示的问题
+  - 拾取开始前不显示可视化元素，只有在地图上点击后才创建
+  - 添加详细的调试日志用于诊断拾取问题
+  - 鼠标移动不再过早设置拾取位置，等待第一次点击
+
+- **视域面板样式优化**
+  - 视域面板水平居中（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+ 兼容性修复**
-  - 问题原因：`VertexArray.fromGeometry` 不再支持对象字面量作为默认几何属性
+  - 根本原因：`VertexArray.fromGeometry` 不再支持对象字面量作为默认几何属性
   - 解决方案：使用实际的 `Cesium.GeometryAttribute` 实例和正确的 `values` 数组
-  - 修改文件：`XbsjCustomPrimitive.js` 中的 `createVertexArray` 函数
-  - 将 `normalAttribute`、`colorAttribute`、`textureCoordinate` 改为使用 `new Cesium.GeometryAttribute(...)`
+  - 修改 `CustomPrimitive.js` 中的 `createVertexArray` 函数
+  - 将 `normalAttribute`、`colorAttribute`、`textureCoordinate` 改为使用 `new Cesium.GeometryAttribute(...)` 而不是对象字面量
 
 - **空气质量监测面板科技风格更新**
-  - 深蓝色渐变背景配发光边框效果
-  - 动态扫描线和角落装饰
-  - 大号发光数值配状态指示器
-  - 改进的排版布局
+  - 深蓝色渐变背景配合发光边框效果
+  - 动画扫描线和角落装饰
+  - 大型发光数据值配合状态指示器
+  - 改进排版和布局
+
+### V1.0.0 (2026-03-04)
+- **URL相机定位功能 (CameraUrlManager)**
+  - 从URL参数读取相机位置
+  - 相机移动时自动更新URL参数（带防抖优化）
+  - 支持自定义默认相机角度
+  - 支持相机位置变化回调
 
 ## 联系方式
 

package/README_EN.md

@@ -166,21 +166,61 @@ The SDK rendering engine adopts a modular architecture, including the following
 - **Measurement System**: Performs various measurement operations in 3D scenes
 - **3DTiles Search System**: Handles 3D Tiles model search and information display
 
-## Changelog 
-- Release Date: 2026-03-23
+## Changelog
+
+### 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)
+
+#### 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)
 
 ### 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 `XbsjCustomPrimitive.js`
+  - 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/