osgGA.TerrainManipulator

osgGA.TerrainManipulator是OpenSceneGraph中的一个事件处理器，用于控制相机在地形上的移动和旋转。其继承自osgGA::CameraManipulator，并提供了与地形相关的特殊功能，例如摄像机高度的限制，基于地形高度的移动等。

使用方法

可以通过以下代码使用osgGA.TerrainManipulator：

#include <osgGA/TerrainManipulator>
#include <osgViewer/Viewer>

int main()
{
    osgViewer::Viewer viewer;

    osgGA::TerrainManipulator* manipulator = new osgGA::TerrainManipulator();
    viewer.setCameraManipulator(manipulator);

    // .... 加载场景

    return viewer.run();
}

主要方法

setVerticalAxisFixed(bool b)

• b - true表示强制相机垂直于地面定位，false表示相机可以自由旋转（默认为true）。

该方法设置相机是否强制垂直于地面定位。如果设置为true，则相机的旋转将相对于地面的法线进行变化。如果设置为false，则相机可以自由旋转，不受地面法线的限制。

setMinimumDistance(double d)

• d - 相机与地面的最小距离（默认为0.0）。

该方法设置相机与地面之间的最小距离。当相机与地面之间的距离小于该距离时，相机将不再向下移动。

setMaximumDistance(double d)

• d - 相机与地面的最大距离（默认为FLT_MAX）。

该方法设置相机与地面之间的最大距离。当相机与地面之间的距离大于该距离时，相机将不再向上移动。

setCoordinateFrameCallback(CoordinateFrameCallback *cb)

• cb - 用于计算相机的坐标系的回调函数。

该方法设置一个回调函数，用于计算相机在地面上的坐标系。该回调函数的原型为：

class CoordinateFrameCallback : public osg::Referenced
{
public:
    virtual osg::CoordinateFrame operator()(const osg::Vec3d& /*worldCoords*/) const = 0;
};

在回调函数中，需要根据当前相机位置计算出相机坐标系，并返回一个osg::CoordinateFrame对象，用于设置相机在场景中的姿态。

事件处理器

osgGA.TerrainManipulator继承自osgGA::CameraManipulator，支持以下事件：

• 滚轮缩放 - 滚动鼠标滚轮将相机在垂直方向上移动。
• 拖拽旋转 - 按住鼠标左键并拖拽相机可在地面上旋转。
• 拖拽移动 - 按住鼠标右键并拖拽相机可在地面上移动。

示例

以下是使用osgGA.TerrainManipulator的完整示例：

#include <osgViewer/Viewer>
#include <osgDB/ReadFile>
#include <osgGA/TerrainManipulator>

int main()
{
    osgViewer::Viewer viewer;

    osg::ref_ptr<osgGA::TerrainManipulator> manipulator = new osgGA::TerrainManipulator();
    manipulator->setMinimumDistance(10.0);
    manipulator->setVerticalAxisFixed(true);
    viewer.setCameraManipulator(manipulator.get());

    osg::ref_ptr<osg::Node> model = osgDB::readNodeFile("terrain.osg");
    if (!model)
        return -1;

    viewer.setSceneData(model.get());
    viewer.run();

    return 0;
}

该示例加载了一个地形模型，并使用osgGA.TerrainManipulator控制相机在地形上的移动和旋转。在运行时，可使用鼠标滚轮缩放相机，使用鼠标左键旋转相机，使用鼠标右键移动相机。同时，由于setMinimumDistance()方法设置了相机与地面的最小距离为10.0，因此相机不会越过地面表面，并始终保持一定的高度。