osg.TemplatePrimitiveIndexFunctor

osg::TemplatePrimitiveIndexFunctor是一个模板类，用于将场景图中的几何体索引与实际的数据进行绑定，成为一种可供访问的数据结构。在OpenSceneGraph中，一个几何体的索引是一个从零开始的整数序列，而实际的数据可以是任何用户定义的结构体或类。

该类的定义如下：

template<typename T> class TemplatePrimitiveIndexFunctor;

其中，T指代用户定义的结构体或类。需要注意的是，T需要实现()运算符，并且其返回值类型必须是void。

构造函数

TemplatePrimitiveIndexFunctor(T& data);

该构造函数用于创建一个新的对象，并将用户数据data传递进去。

操作符

void operator()(unsigned int /*primitiveIndex*/, T& /*hit*/, const float /*ratio*/);

该操作符是T中()运算符的实现。当使用osg::Geometry::accept()方法时，OpenSceneGraph会调用该操作符，将每个几何体的索引以及比例值传递进来。在用户定义的函数体内，通过索引可以访问实际的数据，并进行相应的操作。

范例

下面是一个简单的示例，展示如何使用osg::TemplatePrimitiveIndexFunctor来将索引与实际的数据进行绑定。

// 定义一个用户自定义的结构体
struct MyData
{
   std::string name;
   int year;
};

// 定义一个用于将索引与MyData数据绑定的函数对象
struct MyFunctor
{
   MyData& data;
   MyFunctor(MyData& d) : data(d) {}
   
   void operator()(unsigned int primitiveIndex, void* /*hit*/, const float /*ratio*/)
   {
      std::cout << "Primitive " << primitiveIndex << " is associated with \"" << data.name << "\", which was produced in " << data.year << "." << std::endl;
   }
};

// 创建一个MyData对象，并将其绑定到osg::TemplatePrimitiveIndexFunctor上
MyData d = {"Monet's Water Lilies", 1916};
osg::TemplatePrimitiveIndexFunctor<MyFunctor> functor(MyFunctor(d));

// 创建一个osg::Geometry对象，并使用accept方法来触发对functor的调用
osg::Vec3Array* vertices = new osg::Vec3Array();
vertices->push_back(osg::Vec3(0, 0, 0));
vertices->push_back(osg::Vec3(1, 0, 0));
vertices->push_back(osg::Vec3(0, 1, 0));

osg::DrawElementsUByte* indices = new osg::DrawElementsUByte(osg::PrimitiveSet::TRIANGLES, 0);
indices->push_back(0);
indices->push_back(1);
indices->push_back(2);

osg::Geometry* geom = new osg::Geometry();
geom->setVertexArray(vertices);
geom->addPrimitiveSet(indices);
geom->accept(functor);

输出结果如下：

Primitive 0 is associated with "Monet's Water Lilies", which was produced in 1916.

可以看到，索引为0的几何体与用户定义的数据经过了绑定。在这个例子中，我们将“Monet's Water Lilies”与一个三角面片绑定了起来，当该三角面片被访问时，输出了该数据的信息。