osg 拖拽器
漫游器中世界不动,观察者相机在动。再三维世界中需要对对象的平移、选择缩放操作,
注意:需要对三维物体设置一个父对象,对父节点操作很桥当
为了便于用户操作,引入Command设计模式,它属于一种对象行为模式。将一系列对象操作push到一个队列中。
包括:
- 接收者 Receiver
- 触发者 Invoker
- 命令本身 Command
在osgManipulator中,可以将Dragger本身定义为触发者 Invoker,它负责用户的平移、选择缩放灯。
接收者为Selection类,它是实际待操作对象的父节点;
控制命令使用 MotionCommand表达
并使用一个 CommandManager对所有操控命令以及拖拽器与接收者进行绑定关系。
osgManipulator::MotionCommand 类
MotionCommand() 默认构造函数
bool execute() 虚函数 执行/撤销一个命令
bool unexecute()
void applyConstraint(const Constraint *) 虚函数。添加命令的约束条件
void addSelection(Selection *) 添加/删除一个命令作用的备选对象
void removeSelection(Selection *)
osg::Matrix getMotionMatrix() const 虚函数。获取命令的结果的矩阵
void setStage(const Stage s) 设置/获取设置的执行阶段类型,包括START MOVE FINISH 3种
执行命令阶段包括 鼠标按下选中 START 、拖拽 MOVE 以至于FINISH 这一过程。不同执行阶段的输出结果不一样。
Constraint类表示约束条件,用户通过自定义来实现约束功能。
一个命令的执行可以作用在多个备选对象上。
osgManipulator::CommandManager 类
CommandManager() 默认构造函数
bool connect(Dragger& dragger,Selection& selection) 虚函数,绑定拖拽器与一个备选对象
bool connect(Dragger& dragger,Constraint& constrain) 虚函数,绑定拖拽器或一个约束对象
bool disconnect(Dragger & dragger) 虚函数 取消所有与当前拖拽器有关的备选对象和约束对象
void dispath(MotionCommand &) 虚函数 分发一个命令,即执行一个命令
void addSelectionsToCommand(MotionCommand& command,Dragger& dragger) 设置一个命令的发送者和接收者
注意:一个对象不能被多个多拽器影响。可以使用 CompositeDragger实现这一功能。
当命令执行的时候,接收者Selections负责接收和实现命令效果。由于Selection节点是作为被操控的物体的父节点催你在的。
osgManipulator::Selection 类
Selection() 默认构造函数
bool receive(const MotionCommand&) 对各种命令(MotionCommand及其派生类)的接收函数
osgManipulator::Dragger类
void setCommandManager(CommandManager*)
CommandManager * getCommandManager() 设置/获取命令管理器,用于分发命令
void setParentDragger(Dragger*) 设置/获取父拖拽器。对于一个单独的拖拽器,其父拖拽器就是它自己
bool handle(const PointerInfo&,const GUIEventAdapter&,GUIActionAdapter&) 虚函数,根据用户交互事件,触发操控命令
注意:PointerInfo表示鼠标选中待操控对象上的某个点,以及当前相机的观察矩阵和投影矩阵等,都需要及时反馈到这个输入参数种,以便
实例:、
PickModelHandler
//PickModelHandler.h
#pragma once
#include <windows.h>
#include <osg/Node>
#include <osgDB/ReadFile>
#include <osgViewer/Viewer>
#include <osgManipulator/CommandManager>
#include <osgManipulator/Dragger>
#include <osg/NodeVisitor>
#include <osgGA/GUIEventHandler>
#include <osgUtil/LineSegmentIntersector>
class PickModelHandler :public osgGA::GUIEventHandler
{
public:
PickModelHandler();
~PickModelHandler();
bool handle(const osgGA::GUIEventAdapter & ea,osgGA::GUIActionAdapter& aa,osg::Object*,osg::NodeVisitor*);
protected:
osgManipulator::Dragger* _activeDragger;
osgManipulator::PointerInfo* _pointer ;//拖拽器 输入的信息集合 Dragger类种的handler参数
};
PickModelHandler.cpp
#include "PickModelHandler.h"
PickModelHandler::PickModelHandler() :_activeDragger(0) {
_pointer = new osgManipulator::PointerInfo;
}
PickModelHandler::~PickModelHandler() {}
bool PickModelHandler::handle(const osgGA::GUIEventAdapter& ea, osgGA::GUIActionAdapter& aa, osg::Object*, osg::NodeVisitor*) {
osgViewer::View * view = dynamic_cast<osgViewer::View*>(&aa);
if (!view)return false;
switch (ea.getEventType())
{
case osgGA::GUIEventAdapter::PUSH: {
_pointer->reset();
//创建线条?
osgUtil::LineSegmentIntersector::Intersections hits;
if (view->osgViewer::View::computeIntersections(ea.getX(), ea.getY(), hits)) {
_pointer->setCamera(view->getCamera());
_pointer->setMousePosition(ea.getX(), ea.getY());
osgUtil::LineSegmentIntersector::Intersections::iterator hitr;//线段访问器
for (hitr = hits.begin(); hitr != hits.end(); ++hitr) {
_pointer->addIntersection(hitr->nodePath, hitr->getLocalIntersectPoint());//添加线段信息
}
osg::NodePath::iterator itr;
for (itr = _pointer->_hitList.front().first.begin();
itr != _pointer->_hitList.front().first.end();
++itr) {
osgManipulator::Dragger* dragger = dynamic_cast<osgManipulator::Dragger*>(*itr);//获取输入参数 Dragger
if (dragger) {
dragger->handle((*_pointer), ea, aa);
_activeDragger = dragger;
break;
}
}
}
break;
}
case osgGA::GUIEventAdapter::DRAG:
case osgGA::GUIEventAdapter::RELEASE: {
if (_activeDragger) {
_pointer->_hitIter = _pointer->_hitList.begin();
_pointer->setCamera(view->getCamera());
_pointer->setMousePosition(ea.getX(), ea.getY());
_activeDragger->handle((*_pointer),ea,aa);
}
if (ea.getEventType() == osgGA::GUIEventAdapter::RELEASE) {
_activeDragger = NULL;
_pointer->reset();
}
break;
}
default:
break;
}
return true;
}
main
/**
* 拖拽器示例 实现使用鼠标拖动物体上X Y轴箭头
* 继承 osgGA::GUIEventHandler 的 handler 方法
* 1 使用 view->computeIntersections 判断鼠标与场景中的对象交点
* 2 将交点位置传染 PointerInfo对象,作为拖拽器的对象参数
* 3 实现 handler 的 PUSH 鼠标按下 REALSE 鼠标释放事件
* 在main方法中
* 1 将对象放入 Selection 之下
* 2 定义 XYZ的拖拽器 TranslateAxisDragger (三个方向的箭头,可以相应事件的交点)
* 3 定义命令管理器 CommandManager 实现拖拽器和Selection关联
*/
int main(int argc, char** argv) {
osg::ArgumentParser arguments(&argc,argv);
osg::Node* model = osgDB::readNodeFiles(arguments);
if (!model) {
model = osgDB::readNodeFile("cow.osg");
}
//定义接收者
osg::ref_ptr<osgManipulator::Selection> selection = new osgManipulator::Selection;
//添加备用节点
selection->addChild(model);
//缩放比例
float scale = model->getBound().radius() * 1.6;
osg::ref_ptr<osgManipulator::TranslateAxisDragger> dragger = new osgManipulator::TranslateAxisDragger;
dragger->setupDefaultGeometry();
dragger->setMatrix(osg::Matrix::scale(scale, scale, scale) *
osg::Matrix::translate(model->getBound().center()));
osg::ref_ptr<osg::Group> root = new osg::Group;
root->addChild(dragger.get());
root->addChild(selection.get());
root->addChild(osgDB::readNodeFile("axes.osg"));
osg::ref_ptr<osgManipulator::CommandManager> manager = new osgManipulator::CommandManager;
manager->connect(*dragger,*selection);
osg::ref_ptr<osgViewer::Viewer> viewer = new osgViewer::Viewer();
viewer->addEventHandler(new PickModelHandler);
viewer->setSceneData(root.get());
return viewer->run();
}