OSG教程:场景保存基类ViewerBase

选自《OSG程序设计教程》第二章第四节

    osgViewer::ViewerBase

    类描述：是view的基本类，同时也是osgViewer::CompositeViewer和osgViewer::Viewer的父类。 类继承图：由于是osgViewer::Viewer的父类，所以它的方法一般都会提供给osgVIewer::Viewer使用，而且非常重要。

    类中方法：

     ViewerBase () ViewerBase (const ViewerBase &vb)

    说明：构造函数。第二个构造函数为从一个已知的ViewerBase中创建新ViewerBase.

    参数

    void setStats (osg::Stats *stats)

    说明：设置状态事件，包含一些事件的响应，状态这里要注意与StateSet的区别，这里是指响应的状态。以及渲染时的一些状态设置。

    参数

    osg::Stats * getStats () const osg::Stats * getStats () const

    说明：为得到已经设置的状态类，返回值即为状态类指针。

    virtual bool readConfiguration (const std::string &filename)=0 virtual bool isRealized () const =0 virtual void realize ()=0

    说明：以上三个为纯虚函数，会在子类中实现，这是C++的机制决定的，具体些会在osgViewer::Viewer类以及osgViewer::CompositViewer子类中加以实现。

    virtual void setThreadingModel (ThreadingModel threadingModel)

    说明：设置线程模式。

    参数

    ThreadingModel getThreadingModel () const

    说明：得到线程模式，返回值为当前的线程模式。

    virtual ThreadingModel suggestBestThreadingModel ()

    说明：根据当前场景的特点，得到一个最好的建议线程模式。返回值为该线程模式。

    virtual void setUpThreading () 说明：为每个线程建立相对应的线程模式。

    bool areThreadsRunning () const 说明：线程是否全部运行。如果全部运行则返回真，否则返回假。

    virtual void stopThreading ()

    说明：停止线程运行。

    virtual void startThreading ()

    说明：开始线程运行。

    void setEndBarrierPosition (BarrierPosition bp)

    说明：选择结束时是在交换Buffer之前还是在交换Buffer之后。

     参数

    BarrierPosition getEndBarrierPosition () const

    说明：得到最后结束时的位置，一般为个人设置的值。返回值为位置值，为BeforeSwapBuffers 或者 AfterSwapBuffers。 void setDone (bool done) 说明：设置是否渲染完毕。如果设置为true则程序会结束。

    参数

    bool done () const

    说明：返回当前渲染状态，如果没有退出则返回真。

    void setEventVisitor (osgGA::EventVisitor *eventVisitor)

    说明：设置事件遍历器。事件遍历器可以访问事件。

    参数

    osgGA::EventVisitor * getEventVisitor () const

    说明：得到事件访问器。返回值为事件访问器。

    void setKeyEventSetsDone (int key)

    说明：设置一个键，点击该键时会setDone(true)，这也就是说程序会退出。注意：设置后，再按ESC键程序不会像以前一样退出。

   参数

    int getKeyEventSetsDone () const

    说明：得到已经设置的按下就会退出的热键。默认是ESC键。返回值为该键的编译，比如空格为0x20.

    void setQuitEventSetsDone (bool flag)

    说明：当设置为真时，当程序收到QUIT_APPLICATION消息时会退出。否则会忽略。

     参数

    bool getQuitEventSetsDone () const

    说明：是否设置了程序退出标识。

    void setUpdateVisitor (osgUtil::UpdateVisitor *updateVisitor)

    说明：设置更新访问器。访问器[visitor]是个很重要的概念。

    参数

    osgUtil::UpdateVisitor * getUpdateVisitor () const

    说明：得到更新访问器。返回值为指向其的指针。

    void setUpdateOperations (osg::OperationQueue *operations)

    说明：设置一个操作序列。

    参数

    osg::OperationQueue * getUpdateOperations () const

    说明：得到一个操作序列，返回值为指向该操作序列的指针。

    void addUpdateOperation (osg::Operation *operation)

    说明：添加一个更新操作。

    参数

    void removeUpdateOperation (osg::Operation *operation)

    说明：移除一个更新操作。

    参数

    void setRealizeOperation (osg::Operation *op)

    说明：设置一个实现操作。

    参数

    osg::Operation * getRealizeOperation ()

    说明：得到一个实现操作。返回值为该操作的指针。

    void checkWindowStatus ()

    说明：检查窗口状态，是一系列的内部检查操作。比如查看窗口的尺寸是否为0，若为0退出等等。

    virtual void frame (double simulationTime=USE_REFERENCE_TIME) 说明：绘制帧。

    参数

    virtual int run ()=0 virtual

    void advance (double simulationTime=USE_REFERENCE_TIME)=0

    virtual void eventTraversal ()=0

    virtual void updateTraversal ()=0

    virtual void renderingTraversals ()

    virtual void getCameras (Cameras &cameras, bool onlyActive=true)=0

    virtual void getContexts (Contexts &contexts, bool onlyValid=true)=0
   
    virtual void getWindows (Windows &windows, bool onlyValid=true)=0

    virtual void getAllThreads (Threads &threads, bool onlyActive=true)=0

    virtual void getOperationThreads (OperationThreads &threads, bool onlyActive=true)=0

    virtual void getScenes (Scenes &scenes, bool onlyValid=true)=0

    virtual void getViews (Views &views, bool onlyValid=true)=0
   
    virtual double elapsedTime ()=0 virtual osg::FrameStamp * getViewerFrameStamp ()=0

    virtual void getUsage (osg::ApplicationUsage &usage) const =0

    说明：以上为虚函数，在子类中会有实现，具体一些为osgViewer::Viewer和osgViewer::CompositeViewer类。