OpenSceneGraph API

osgGA.CameraViewSwitchManipulator

OpenSceneGraph中的osgGA.CameraViewSwitchManipulator为相机视角切换提供了一种交互方式。

继承关系

osg::Object -> osgGA::CameraManipulator -> osgGA::CameraViewSwitchManipulator

类型定义

osgGA::CameraViewSwitchManipulator::Views：类型为std::map<int, osg::Matrixd>，用于存储多个视角的矩阵和对应的编号。

构造函数

CameraViewSwitchManipulator()：默认构造函数，创建一个相机视角切换器。
CameraViewSwitchManipulator(const CameraViewSwitchManipulator& cvsm, const osg::CopyOp& copyop = osg::CopyOp::SHALLOW_COPY)：拷贝构造函数。

成员函数

void setView(int viewNum, const osg::Matrixd& matrix)：设置视角。参数viewNum为视角的编号，matrix为相应的矩阵。
const osgGA::CameraViewSwitchManipulator::Views& getViews() const：获取所有视角的矩阵和编号。
int getNumViews() const：获取视角数目。
void setByMatrix(const osg::Matrixd& matrix)：设置相机矩阵。
void setByInverseMatrix(const osg::Matrixd& matrix)：设置相机矩阵的逆矩阵。
osg::Matrixd getMatrix() const：获取相机矩阵。
osg::Matrixd getInverseMatrix() const：获取相机矩阵的逆矩阵。
void setTransformation(const osg::Vec3d& eye,const osg::Vec3d& center,const osg::Vec3d& up)：设置相机矩阵。
void setTransformation(const osg::Vec3d& eye,const osg::Quat& rotation)：设置相机矩阵。
void setTransformation(const osg::Vec3d& eye,const osg::Vec3d& center,const osg::Vec3d& up,const osg::Quat& rotation)：设置相机矩阵。
osg::Quat getRotation() const：获取相机矩阵的旋转部分。
osg::Vec3d getUp() const：获取相机矩阵的上向量。
osg::Vec3d getSide() const：获取相机矩阵的侧向量。
osg::Vec3d getLookVector() const：获取相机矩阵的观察向量。

用法

通过调用setView()函数设置视角，在应用中实现视角切换。

例如，首先创建一个osgViewer::Viewer对象，并为其添加场景图和相机：

osg::ref_ptr<osgViewer::Viewer> viewer = new osgViewer::Viewer;
osg::ref_ptr<osg::Group> root = new osg::Group;
osg::ref_ptr<osg::Geode> geode = new osg::Geode;
osg::ref_ptr<osg::ShapeDrawable> drawable = new osg::ShapeDrawable(new osg::Box(osg::Vec3(), 1.0));
geode->addDrawable(drawable.get());
root->addChild(geode.get());
viewer->setSceneData(root.get());

osg::ref_ptr<osg::Camera> camera = new osg::Camera;
camera->setClearColor(osg::Vec4(0.2f, 0.2f, 0.6f, 1.0f));
camera->setViewport(new osg::Viewport(0, 0, 800, 600));
camera->setProjectionMatrixAsPerspective(40.0, 800.0 / 600.0, 0.1, 1000.0);
root->addChild(camera.get());

然后创建一个osgGA::CameraViewSwitchManipulator对象：

osg::ref_ptr<osgGA::CameraViewSwitchManipulator> cvsmanipulator = new osgGA::CameraViewSwitchManipulator;

使用setView()函数设置四个不同的视角矩阵：

const osg::Vec3d center(0.0, 0.0, 0.0);
const osg::Vec3d eye1(0.0, 0.0, 5.0);
const osg::Vec3d eye2(0.0, 5.0, 0.0);
const osg::Vec3d eye3(5.0, 0.0, 0.0);
const osg::Vec3d up(0.0, 1.0, 0.0);
osg::Vec3d center1 = center, center2 = center, center3 = center;
osg::Matrix eye1matrix = osg::Matrix::lookAt(eye1, center1, up);
osg::Matrix eye2matrix = osg::Matrix::lookAt(eye2, center2, up);
osg::Matrix eye3matrix = osg::Matrix::lookAt(eye3, center3, up);
cvsmanipulator->setView(0, osg::Matrixd::identity());
cvsmanipulator->setView(1, eye1matrix);
cvsmanipulator->setView(2, eye2matrix);
cvsmanipulator->setView(3, eye3matrix);

最后通过调用setCameraManipulator()函数将CameraViewSwitchManipulator对象作为相机的交互器：

camera->setAllowEventFocus(false);
viewer->setCameraManipulator(cvsmanipulator.get());

效果如下：

视角切换

参考资料

CameraViewSwitchManipulator的官方文档