OpenSceneGraph API

osg.buffered_object

osg.buffered_object是OpenSceneGraph中的一个类，用于创建带缓冲区的对象。它是osg::Drawable的派生类，可用于创建顶点、索引等缓冲区对象。

继承关系

osg::Object <br> └── osg::Drawable <br> └── osg::buffered_object

类定义

class OSG_EXPORT buffered_object : public Drawable

构造函数

buffered_object()

参数

无。

描述

构造一个空的buffered_object对象。

成员函数

virtual void addBufferData(BufferData *bd)

virtual void removeBufferData(BufferData *bd)

virtual void removeBufferData(unsigned int index)

virtual void modifyBufferData(unsigned int index,BufferData *bd)

virtual void drawImplementation(RenderInfo &renderInfo) const

virtual osg::Object *cloneType() const

virtual osg::Object *clone(const osg::CopyOp &) const

virtual bool isSameKindAs(const osg::Object *) const

virtual const char* className() const

virtual const char* libraryName() const

addBufferData

virtual void addBufferData(BufferData *bd)

参数

bd：需要加入对象的BufferData

描述

向对象中添加一个BufferData对象。

removeBufferData

virtual void removeBufferData(BufferData *bd)

参数

bd：需要从对象中移除的BufferData

描述

从对象中移除指定的BufferData对象。

removeBufferData

virtual void removeBufferData(unsigned int index)

参数

index：需要从对象中移除的BufferData对象的索引

描述

从对象中移除指定索引的BufferData对象。

modifyBufferData

virtual void modifyBufferData(unsigned int index,BufferData *bd)

参数

index：需要修改的BufferData对象的索引
bd：待修改为的BufferData对象

描述

修改对象中的指定BufferData对象。

drawImplementation

virtual void drawImplementation(RenderInfo &renderInfo) const

参数

renderInfo：渲染相关信息

描述

绘制函数，实现Drawable接口。

cloneType

virtual osg::Object *cloneType() const

返回值

返回值为osg::buffered_object类型指针。

描述

用于克隆。

clone

virtual osg::Object *clone(const osg::CopyOp &) const

返回值

返回值为osg::buffered_object类型指针。

描述

用于克隆。

isSameKindAs

virtual bool isSameKindAs(const osg::Object *) const

参数

obj：待比较对象指针

返回值

相同返回true，否则返回false。

描述

用于类型比较。

className

virtual const char* className() const

返回值

返回值为"buffered_object"。

描述

获取类名。

libraryName

virtual const char* libraryName() const

返回值

返回值为"osg"。

描述

获取库名。

例子

#include <osg/Drawable>
#include <osg/Geode>
#include <osg/Geometry>
#include <osg/BufferObject>
#include <osgViewer/Viewer>

int main(int argc, char **argv)
{
    // create geode and buffered geometry
    osg::ref_ptr<osg::Geode> geode = new osg::Geode();
    osg::ref_ptr<osg::Geometry> geom = new osg::Geometry();
    osg::ref_ptr<osg::buffered_object> bo = new osg::buffered_object();

    // define vertex and color arrays
    osg::ref_ptr<osg::FloatArray> vertices = new osg::FloatArray();
    vertices->push_back(0.f); vertices->push_back(0.f); vertices->push_back(0.f);
    vertices->push_back(1.f); vertices->push_back(0.f); vertices->push_back(0.f);
    vertices->push_back(0.f); vertices->push_back(1.f); vertices->push_back(0.f);
    osg::ref_ptr<osg::Vec4Array> colors = new osg::Vec4Array();
    colors->push_back(osg::Vec4(1.f,0.f,0.f,1.f));
    colors->push_back(osg::Vec4(0.f,1.f,0.f,1.f));
    colors->push_back(osg::Vec4(0.f,0.f,1.f,1.f));

    // define buffer data
    osg::ref_ptr<osg::BufferData> vertexBufferData = new osg::BufferData();
    vertexBufferData->setArray(vertices.get());
    osg::ref_ptr<osg::BufferData> colorBufferData = new osg::BufferData();
    colorBufferData->setArray(colors.get());

    // set buffer data to buffered object
    bo->addBufferData(vertexBufferData.get());
    bo->addBufferData(colorBufferData.get());
    geom->setVertexBufferObject(bo.get());

    // set geometry primitive
    osg::ref_ptr<osg::DrawArrays> da = new osg::DrawArrays(osg::PrimitiveSet::TRIANGLES, 0, 3);
    geom->addPrimitiveSet(da);

    // add geometry to geode and scene graph
    geode->addDrawable(geom.get());
    osg::ref_ptr<osg::Group> root = new osg::Group();
    root->addChild(geode.get());

    // create viewer and run
    osgViewer::Viewer viewer;
    viewer.setSceneData(root.get());
    return viewer.run();
}

参考文献

OpenSceneGraph 3.4.1 Documentation: osg::buffered_object Class Reference