osgGA.KeySwitchMatrixManipulator

osgGA.KeySwitchMatrixManipulator是OpenSceneGraph中的一个键盘控制相机位置的类。它可以在不同的相机模式之间切换，包括TrackballManipulator、FlightManipulator和DriveManipulator等模式，以实现不同的相机移动。

构造函数

osgGA::KeySwitchMatrixManipulator(osg::ref_ptr<osgGA::MatrixManipulator> defaultMM = NULL);

方法

void setHomePosition(const osg::Vec3d& eye,const osg::Vec3d& center,const osg::Vec3d& up, bool auto_compute_home = true);

设置相机的home位置，即相机起始位置。默认情况下，KeySwitchMatrixManipulator会在以下情况下调用此函数：

1. 第一次使用KeySwitchMatrixManipulator
2. 按下“h”键时

void addMatrixManipulator(int key, const std::string& name, osg::ref_ptrosgGA::MatrixManipulator mm);

向KeySwitchMatrixManipulator添加一个MatrixManipulator，以便在不同的相机模式下进行切换。传入参数为：

• key: 激活此相机模式的键位
• name: 相机模式的名称
• mm: 相应的MatrixManipulator

void selectMatrixManipulator(int index);

根据索引选择MatrixManipulator，激活相应的相机模式。

osgGA::MatrixManipulator* getMatrixManipulator(int index);

获取指定索引的MatrixManipulator。

osg::Matrixd getMatrix() const;

获取当前相机的视图矩阵。

osg::Matrixd getInverseMatrix() const;

获取当前相机的逆矩阵。

bool handle(const osgGA::GUIEventAdapter& ea,osgGA::GUIActionAdapter& aa);

处理键盘事件的回调函数，用于激活不同的相机模式。用户可以通过修改此函数的实现来自定义相机控制方式。

示例代码

#include <osgGA/KeySwitchMatrixManipulator>
#include <osgGA/TrackballManipulator>
#include <osgGA/FlightManipulator>
#include <osgGA/DriveManipulator>

int main()
{
    //创建默认的TrackballManipulator
    osg::ref_ptr<osgGA::MatrixManipulator> defaultMM = new osgGA::TrackballManipulator;

    //创建KeySwitchMatrixManipulator
    osg::ref_ptr<osgGA::KeySwitchMatrixManipulator> switcher = new osgGA::KeySwitchMatrixManipulator(defaultMM);

    //设置相机的home位置
    switcher->setHomePosition(osg::Vec3d(0,0,5), osg::Vec3d(), osg::Vec3d(0,1,0), false);

    //添加FlightManipulator
    osg::ref_ptr<osgGA::FlightManipulator> flightManipulator = new osgGA::FlightManipulator;
    switcher->addMatrixManipulator('f', "Flight", flightManipulator);

    //添加DriveManipulator
    osg::ref_ptr<osgGA::DriveManipulator> driveManipulator = new osgGA::DriveManipulator;
    switcher->addMatrixManipulator('d', "Drive", driveManipulator);

    //创建viewer并设置默认矩阵
    osgViewer::Viewer viewer;
    viewer.setCameraManipulator(switcher);

    //运行viewer
    return viewer.run();
}

以上示例代码演示了如何创建KeySwitchMatrixManipulator，并向其添加不同的相机模式。用户可以通过按下键位来切换相机模式。