冠军资讯
代码一只喵在图形引擎迁移或跨平台开发中，经常遇到需要将 OpenSceneGraph (OSG) 的相机矩阵转换到 VulkanSceneGraph (VSG) 的场景。由于两者底层数学库的差异，直接赋值往往会导致场景渲染异常。本文将深入剖析 OSG 和 VSG 相机矩阵的差异，并提供一套完整的转换方案，确保视角正确呈现。
问题场景重现：视角错乱
假设我们有一个使用 OSG 构建的场景，其中相机位置和方向已经通过 osg::Matrixd 精确设置。现在，我们需要将这个场景迁移到 VSG 上，并保持相同的视角。最直接的想法是直接将 osg::Matrixd 的值赋给 vsg::MatrixTransform，如下所示：
// OSG 相机矩阵
osg::Matrixd osgCameraMatrix = camera->getViewMatrix();
// VSG MatrixTransform
vsg::ref_ptr<vsg::MatrixTransform> vsgTransform = vsg::MatrixTransform::create();
// 错误的做法：直接赋值
vsgTransform->matrix = vsg::Matrix::create(osgCameraMatrix.ptr());
//将转换添加到场景图中
node->addChild(vsgTransform);
然而，运行这段代码后，你会发现 VSG 场景的视角与 OSG 场景完全不同，甚至可能出现颠倒、偏移等问题。这就是因为 OSG 和 VSG 使用的坐标系和矩阵存储方式存在差异。
底层原理深度剖析：坐标系与矩阵差异
OSG 和 VSG 采用不同的坐标系和矩阵存储方式，这是导致直接赋值失败的根本原因。具体来说：
- 坐标系: OSG 默认使用右手坐标系，而 VSG 也使用右手坐标系，但两者可能在模型导入导出时因为使用的建模软件或格式不同，造成需要转换。比如 Blender 默认使用左手坐标系，导出时需要进行坐标系转换。这种转换可能涉及到绕某个轴旋转180度，或者改变某个轴的符号。
- 矩阵存储: 两者使用的矩阵库可能存在差异，即使都是 4x4 矩阵，内部元素的排列方式也可能不同。比如行优先(row-major)和列优先(column-major)的差异。
此外，还需要考虑到相机自身的坐标系。OSG 中相机的 getViewMatrix() 返回的是世界坐标系到相机坐标系的变换矩阵，而 VSG 中 vsg::MatrixTransform 通常用于表示局部坐标系到世界坐标系的变换。因此，直接赋值会导致坐标系变换错误。
代码解决方案：矩阵转换函数
为了解决这个问题，我们需要编写一个矩阵转换函数，将 OSG 的相机矩阵转换成 VSG 能够正确使用的矩阵。这个函数需要考虑到坐标系、矩阵存储方式等差异。
#include <osg/Matrixd>
#include <vsg/core/matrix.h>
vsg::Matrix osgToVsgMatrix(const osg::Matrixd& osgMatrix) {
vsg::Matrix vsgMatrix;
// 将 OSG 矩阵的数据复制到 VSG 矩阵
for (int i = 0; i < 4; ++i) {
for (int j = 0; j < 4; ++j) {
vsgMatrix(i, j) = osgMatrix(i, j); // 注意这里，VSG 也是列优先，不需要转置，如果确定要转置，使用 osgMatrix(j, i)
}
}
return vsgMatrix;
}
// 用法示例
osg::Matrixd osgCameraMatrix = camera->getViewMatrix();
vsg::ref_ptr<vsg::MatrixTransform> vsgTransform = vsg::MatrixTransform::create();
//使用转换函数
vsgTransform->matrix = osgToVsgMatrix(osgCameraMatrix);
node->addChild(vsgTransform);
这个 osgToVsgMatrix 函数将 OSG 的矩阵数据复制到 VSG 的矩阵中。对于复杂的场景，可能还需要进行额外的坐标系变换。要根据具体情况调整转换逻辑。
实战避坑经验总结
- 坐标系对齐: 确保 OSG 和 VSG 使用相同的坐标系。如果两者坐标系不同，需要在矩阵转换过程中进行相应的旋转或镜像操作。
- 矩阵存储方式: 仔细检查 OSG 和 VSG 的矩阵存储方式（行优先或列优先）。如果两者不同，需要进行矩阵转置。
- 相机坐标系: 理解 OSG 相机返回的矩阵的含义（世界坐标系到相机坐标系的变换）。在 VSG 中，通常需要使用局部坐标系到世界坐标系的变换矩阵。因此，可能需要对矩阵进行求逆操作。
- 调试工具: 使用图形调试工具，如 RenderDoc, 可以帮助你可视化矩阵变换，更好地理解坐标系和矩阵的转换过程。
- 最小复现: 当遇到问题时，尝试创建一个最小的可复现示例。这可以帮助你快速定位问题，并减少调试时间。
通过以上步骤，你就可以成功将 OSG 的相机矩阵转换到 VSG 中，避免视角错乱等问题，保证场景的正确渲染。 在实际的项目迁移中，除了相机矩阵，材质、纹理、shader 等都需要考虑迁移的问题，这需要对 OSG 和 VSG 的渲染管线都有深入的理解。
关于 osg 中相机矩阵到 vsg 相机矩阵的转换的补充说明
以上方法提供了一个通用的解决方案，但实际情况可能更复杂。例如，如果你的 OSG 场景使用了自定义的相机控制方式，那么在 VSG 中也需要进行相应的调整。此外，还需要考虑到 VSG 的渲染管线与 OSG 的差异，以便更好地优化场景的渲染性能。 如果您的项目使用了 Nginx 作为反向代理服务器，在迁移到 VSG 后，需要重新配置 Nginx，确保 VSG 应用能够正确地接收和处理客户端请求。同时，还需要关注 Nginx 的负载均衡策略，以便更好地分配服务器资源，提高应用的并发连接数。
