Pannellum全景测量功能中离屏热点的坐标计算优化

背景介绍

Pannellum作为一款优秀的全景查看库，被广泛应用于各种虚拟现实场景中。在实际应用中，开发者经常需要实现全景场景中的测量功能，包括两点间的距离测量和可视化连线。Ephraim-Bryski在开发这一功能时遇到了一个典型问题：当两个测量点中有一个位于当前视角后方时，如何正确计算连线在屏幕边界处的截断位置。

问题分析

在Pannellum的默认实现中，热点的屏幕坐标计算基于针孔相机模型。当热点位于相机后方时，系统不会更新其屏幕坐标，这导致测量线无法正确显示。理想情况下，即使一个测量点位于视野外，测量线也应该延伸至屏幕边界，指向该点所在的方向。

技术解决方案

3D空间直线投影法

经过探索，发现可以采用3D空间中的直线投影方法来解决这个问题。具体思路如下：

1. 将两个测量点视为3D空间中的点
2. 计算两点间的直线在3D空间中的向量
3. 当其中一个点位于相机后方时，沿着这条直线找到与视野边界的交点
4. 将该交点投影到屏幕坐标，作为测量线的终点

这种方法相比沿着球面大圆的曲线计算更为简单直接，在实际应用中表现良好。

与"粘性热点"功能的对比

值得注意的是，这个问题与Pannellum中的"粘性热点"功能有相似之处。粘性热点功能尝试将视野外的热点显示在屏幕边缘，但采用的计算方法不同：

1. 计算相机中心到热点的直线
2. 将该直线与视野边界相交
3. 使用交点作为热点在屏幕上的位置

然而，这种方法在某些情况下会产生不直观的结果。例如，当热点几乎正对相机后方但略微偏上时，热点会出现在屏幕顶部，而不是更符合直觉的侧边位置。

实现建议

对于需要实现全景测量功能的开发者，建议：

1. 对于测量线显示，采用3D空间直线投影法
2. 计算时考虑全景图的深度信息，确保测量准确性
3. 在连线渲染时添加适当的视觉效果，如渐隐或箭头指示
4. 对于完全不可见的测量点，可以考虑在屏幕边缘添加标记提示

总结

Pannellum中的测量功能实现需要特别处理离屏热点的情况。通过3D空间直线投影法，可以有效地解决测量线在屏幕边界处的显示问题，为用户提供更完整的测量可视化体验。这一解决方案不仅适用于距离测量，也可扩展应用于其他需要连接视野内外点的全景应用场景。