osg.UserDataContainer

osg.UserDataContainer 是 OpenSceneGraph 中的一个类，用于在场景图节点中存储自定义数据。该类是从 osg::Object 类继承而来，因此可以使用引用计数和多线程安全。

构造函数

osg::UserDataContainer::UserDataContainer()

方法

void setUserData(osg::Referenced *obj)

将任意类型的数据附加到节点上。

参数

• obj：指向任意类型数据的指针。

osg::Referenced* getUserData()

获取节点上附加的数据。

返回值

返回一个指向被附加数据的指针。

void setName(const std::string& name)

设置节点的名字，用于识别该节点。

参数

• name：节点的名称。

const std::string& getName() const

获取节点的名字。

返回值

返回节点的名称。

virtual bool getDescriptions(std::vectorstd::string& descriptions) const

获取附加在节点上的用户数据的信息。

参数

• descriptions：存储用户数据信息的字符串向量。

返回值

返回是否成功获取用户数据信息。

virtual bool getUserObject(const std::string& name, osg::Referenced *& obj)

通过名称获取节点上附加的用户数据。

参数

• name：附加数据的名称。
• obj：存储附加对象的指针。

返回值

返回是否成功获取用户数据。

virtual bool setUserObject(const std::string& name, osg::Referenced *obj)

向节点中添加一个用户数据对象。

参数

• name：附加数据的名称。
• obj：指向附加对象的指针。

返回值

返回是否成功添加用户数据对象。

virtual bool removeUserObject(const std::string& name)

移除节点上指定名称的用户数据对象。

参数

• name：附加数据的名称。

返回值

返回是否成功移除用户数据对象。

virtual bool containsUserObject(const std::string& name) const

判断节点上是否存在指定名称的用户数据对象。

参数

• name：附加数据的名称。

返回值

返回是否存在指定名称的用户数据对象。

示例代码

osg::ref_ptr<osg::Node> node = new osg::Node;
node->setName("My Node");
node->setUserData(new std::string("Some data to attach"));

std::vector<std::string> descriptions;
node->getDescription(descriptions);

int i = 0;
for (std::vector<std::string>::const_iterator description = descriptions.begin();
     description != descriptions.end();
     ++description, ++i)
{
    std::cout << i << ": " << *description << std::endl;
}

osg::ref_ptr<osg::Referenced> obj;
node->getUserData("Some data to attach", obj);
std::string *str = dynamic_cast<std::string*>(obj.get());
if (str)
{
    std::cout << "The attached data is " << *str << std::endl;
}

node->removeUserObject("Some data to attach");