osgViewer.CompositeViewer

osgViewer.CompositeViewer是OpenSceneGraph中的一个类，用于支持多窗口视图和多线程操作，可以将多个osgViewer.Viewer对象组合为一个窗口，从而实现多个场景的同时渲染。

继承关系

osgViewer.CompositeViewer继承自osgViewer.ViewerBase类。

头文件

#include <osgViewer/CompositeViewer>

成员函数

CompositeViewer()

构造函数，创建一个osgViewer.CompositeViewer对象。

virtual void addView(osgViewer::View* view)

添加一个osgViewer.Viewer对象到CompositeViewer中。

参数：

• view：要添加到CompositeViewer中的osgViewer.Viewer对象，必须为有效指针。

virtual void setThreadingModel(osgViewer::ViewerBase::ThreadingModel threadingModel)

设置OSG场景图的线程模型。

参数：

• threadingModel：场景图线程模型，可选值为osgViewer::ViewerBase::SingleThreaded、osgViewer::ViewerBase::CullDrawThreadPerContext、osgViewer::ViewerBase::DrawThreadPerContext和osgViewer::ViewerBase::CullThreadPerCameraDrawThreadPerContext。

virtual void realize()

实现所有的添加视图，然后调用真正的realize() ，如果渲染器已经realized，则该函数只是调用所有视图的realize()。

virtual void frame()

更新所有视图，并将结果渲染到所有窗口中。

virtual void run()

启动渲染循环，并且在渲染完成后退出。

virtual void quit()

停止渲染循环，并在渲染完成后退出。

virtual void setKeyEventSetsDone(int value)

设置键盘事件是否停止循环。

参数：

• value：一个整数值，用于指示是否通过键盘事件来停止渲染循环，如果value为非零，则可以使用Esc键来停止循环。

virtual void useCursor(bool cursorOn)

设置是否使用鼠标指针。

参数：

• cursorOn：一个布尔值，为true时使用鼠标指针，否则不使用鼠标指针。

virtual void setViewerFrameRate(float framesPerSecond)

设置用户希望场景渲染的帧率。

参数：

• framesPerSecond：渲染帧率，单位为每秒帧数。

virtual void setSceneData(osg::Node* scene)

设置要显示的场景图。

参数：

• scene：要显示的场景图，必须为有效指针。

void setCompositeViewerThreads(unsigned int numThreads)

设置CompositeViewer对象的线程数。

参数：

• numThreads：线程数，必须为非负整数。

示例

#include <osgViewer/Viewer>
#include <osgViewer/CompositeViewer>

int main()
{
    osg::ref_ptr<osgViewer::Viewer> viewer1 = new osgViewer::Viewer;
    osg::ref_ptr<osgViewer::Viewer> viewer2 = new osgViewer::Viewer;

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

    viewer1->setSceneData(model);
    viewer2->setSceneData(model);

    osg::ref_ptr<osgViewer::CompositeViewer> compositeViewer = new osgViewer::CompositeViewer;
    compositeViewer->addView(viewer1.get());
    compositeViewer->addView(viewer2.get());

    compositeViewer->realize();

    while (!compositeViewer->done())
    {
        compositeViewer->frame();
    }

    return 0;
}

参考资料

• OpenSceneGraph 3.6.5 Documentation - osgViewer.CompositeViewer (https://www.openscenegraph.org/documentation/OpenSceneGraphReferenceDocs/a00473.html)