osg::Drawable类通过setDrawCallback函数设置回调函数的说明

news2024/9/30 17:35:55

osg::Drawable类可以通过该类的setDrawCallback函数设置回调函数类对象。被设置的回调类对象必须从osg::Drawable::DrawCallback类派生，并重写drawImplementation函数，以实现自己特定的需求。这个回调函数每次在帧事件中都会被调用(如：在帧的更新遍历事件), 可以在该类的drawImplementation函数对可绘制对象进行属性的更改，这样可绘制对象就好像时刻在变化一样，osgViewer::StatsHandler类实现实时帧率统计就是这么实现的。osg::Drawable::DrawCallback类定义如下：

struct DrawCallback : public virtual osg::Object
{
   DrawCallback() {}
   DrawCallback(const DrawCallback& org,const CopyOp& copyop):
                Object(org, copyop) {}

   META_Object(osg,DrawCallback);

  /** do customized draw code.*/
   virtual void drawImplementation(osg::RenderInfo& /*renderInfo*/,const osg::Drawable* /*drawable*/) const {}
};

这个类中最重要的就是虚函数drawImplementation，该函数参数说明如下：

第1个参数是类型为osg::RenderInfo的引用。osg::RenderInfo是渲染信息类。这个类负责保存和管理与场景绘制息相关的几个重要数据：当前场景的视景器、当前场景对应的所有摄像机、以及当前osg::State对象。这些数据将在场景筛选和渲染时为 OSG 系统后台的工作提供重要依据，并从中取出跟踪此图形上下文的当前OpenGL状态的State对象。可以说，需要涉及绘制有关的视景器、场景类、状态类、摄像机类都可以从渲染信息类对象获取到。
第2个参数就是指向被绘制对象的指针。

下面举例说明，如下代码：

#include<osgViewer/Viewer>
#include<osg/ArgumentParser>
#include<osg/ShapeDrawable>
#include<osgText/Text3D>
#include<osg/Timer>
class CUpdateTextValue : public osg::Drawable::DrawCallback
{
public:
    CUpdateTextValue()
    {
        _lastTimer_t = osg::Timer::instance()->tick();
    }
    virtual void drawImplementation(osg::RenderInfo& renderInfo, const osg::Drawable* drawable) const
    {
        auto pText3D = (osgText::Text3D*)(drawable);

        osg::Timer_t tCurTick = osg::Timer::instance()->tick();
        double delta = osg::Timer::instance()->delta_m(_lastTimer_t, tCurTick);
       
        char szValue[10]{0};
        itoa(_value, szValue, 10);
        if (delta > 20)
        {
            ++_value;
        }
        else
        {
            --_value;
        }

        // 防止越界、溢出
        if (_value >= INT_MAX)
        {
            _value = INT_MAX;
        }
        if (_value <= INT_MIN)
        {
            _value = INT_MIN;
        }

        pText3D->setText(szValue);
        pText3D->drawImplementation(renderInfo);
        _lastTimer_t = tCurTick;
    }
private:

// 注意用mutable修饰符，因为函数是const函数，否则不能对该值修改，下同。
    mutable  osg::Timer_t _lastTimer_t{ 0 };
    mutable  int _value{0};  
};

int main(int argc, char *argv[])
{
    osg::ArgumentParser arg(&argc, argv);
    osgViewer::Viewer viewer(arg);

    auto spRoot = new osg::Group;
    auto pGeode = new osg::Geode;
    
    auto pText3D = new osgText::Text3D;  
    pGeode->addDrawable(pText3D);

    pText3D->setFont("Verdana\\verdana.ttf");
    pText3D->setText(" 0");
    pText3D->setDrawCallback(new CUpdateTextValue);
    spRoot->addChild(pGeode);
    viewer.setSceneData(spRoot);

    return viewer.run();
}

上面的例子，绘制了一个三维的字符串，最开始的时候，字符串是“0”，然后调用三维字符对象的setDrawCallback方法，安装了一个CUpdateTextValue绘制回调类对象，在回调类中的drawImplementation函数，根据两帧之间的时间间隔是否大于20ms，从而绘制不同值，效果如下：