OpenSceneGraph API

osgGA.CameraManipulator

osgGA.CameraManipulator是OpenSceneGraph中的一个类，用于控制相机的移动、旋转、缩放等操作。在场景中使用该类能够方便地实现视角的切换和镜头的调整。

使用方法

将osgGA.CameraManipulator包含进你的代码中。

#include <osgGA/CameraManipulator>

使用osgViewer::Viewer创建场景，并设置CameraManipulator。

osgViewer::Viewer viewer;
viewer.setCameraManipulator(new osgGA::CameraManipulator);

在事件循环中检测鼠标和键盘事件，并调用CameraManipulator的函数来进行相机的调整。

while (!viewer.done())
{
    // 处理事件
    viewer.frame();
}

成员函数

setTransformation(const osg::Vec3d& eye,const osg::Vec3d& center,const osg::Vec3d& up)

该函数用于设置相机的位置、观察点和朝上方向。

osg::Vec3d eye(0, 0, 5);
osg::Vec3d center(0, 0, 0);
osg::Vec3d up(0, 1, 0);

// 设置相机的位置、观察点和朝上方向
viewer.getCameraManipulator()->setTransformation(eye, center, up);

getInverseMatrix() const

该函数返回相机的逆矩阵，可用于将世界坐标系下的点转换为相机坐标系下的点。

osg::Matrixd inverse_matrix = viewer.getCameraManipulator()->getInverseMatrix();
osg::Vec3d point(1, 1, 1);
osg::Vec3d point_in_camera_space = point * inverse_matrix;

setByMatrix(const osg::Matrixd& matrix)

该函数用于通过矩阵来设置相机的位置、观察点和朝上方向。

osg::Matrixd matrix;
matrix.makeLookAt(osg::Vec3d(0, 0, 5), osg::Vec3d(0, 0, 0), osg::Vec3d(0, 1, 0));

// 通过矩阵来设置相机的位置、观察点和朝上方向
viewer.getCameraManipulator()->setByMatrix(matrix);

setByInverseMatrix(const osg::Matrixd& matrix)

该函数用于通过相机的逆矩阵来设置相机的位置、观察点和朝上方向。

osg::Matrixd matrix;
matrix.makeLookAt(osg::Vec3d(0, 0, 5), osg::Vec3d(0, 0, 0), osg::Vec3d(0, 1, 0));
matrix.invert(matrix);

// 通过相机的逆矩阵来设置相机的位置、观察点和朝上方向
viewer.getCameraManipulator()->setByInverseMatrix(matrix);

setHomePosition(const osg::Vec3d& eye,const osg::Vec3d& center,const osg::Vec3d& up,bool autoComputeHomePosition=true)

该函数用于设置相机的初始位置、观察点和朝上方向，并自动计算Home位置。调用该函数后，可以通过按下Home键来返回相机的初始位置。

osg::Vec3d eye(0, 0, 5);
osg::Vec3d center(0, 0, 0);
osg::Vec3d up(0, 1, 0);

// 设置相机的初始位置、观察点和朝上方向，并自动计算Home位置
viewer.getCameraManipulator()->setHomePosition(eye, center, up);

home(double currentTime)

该函数将相机的位置和方向重置为初始位置和方向。

double current_time = viewer.elapsedTime();
viewer.getCameraManipulator()->home(current_time);

setAutoComputeHomePosition(bool flag)

该函数用于设置是否自动计算Home位置。

// 设置是否自动计算Home位置
viewer.getCameraManipulator()->setAutoComputeHomePosition(false);

computeHomePosition(const osg::Camera* camera = nullptr, bool useBoundingBox = false)

该函数用于计算Home位置。

viewer.getCameraManipulator()->computeHomePosition();

isMouseMoving() const

该函数用于判断鼠标是否正在移动。

bool is_mouse_moving = viewer.getCameraManipulator()->isMouseMoving();

setAllowThrow(bool allowThrow)

该函数用于设置是否允许抛出相机。

// 设置是否允许抛出相机
viewer.getCameraManipulator()->setAllowThrow(false);

setAnimationTime(double time)

该函数用于设置相机移动的动画时间。

// 设置相机移动的动画时间
viewer.getCameraManipulator()->setAnimationTime(0.5);

getAnimationTime() const

该函数用于获取相机移动的动画时间。

double animation_time = viewer.getCameraManipulator()->getAnimationTime();

setNode(osg::Node* node)

该函数用于设置相机要观察的节点。

osg::ref_ptr<osg::Node> node = osgDB::readNodeFile("cow.osg");

// 设置相机要观察的节点
viewer.getCameraManipulator()->setNode(node.get());

结论

osgGA.CameraManipulator是OpenSceneGraph中的一个类，用于控制相机的移动、旋转、缩放等操作。在场景中使用该类能够方便地实现视角的切换和镜头的调整。