osg.AttributeFunctorArrayVisitor

osg.AttributeFunctorArrayVisitor是一个访问器类，用于在当前渲染状态中的顶点/模型属性数组中遍历数据，并通过函数对象的回调将这些数据应用到渲染状态中。

在使用 osg.AttributeFunctorArrayVisitor 之前，需要先准备好一个函数对象（一个继承了 osg::ArrayVisitor 的子类实例）。该函数对象在遍历属性数组时会被调用，可以根据需要在其重载的 applyXXX() 方法中对遍历到的数据进行处理，例如计算/修改某个属性值，或者将数据直接传递给其他组件使用。

使用方法

使用 osg.AttributeFunctorArrayVisitor 的步骤如下：

1. 准备好函数对象，使其继承自 osg::ArrayVisitor 。实现需要的回调函数，在其内部对遍历到的 osg::Array 数据进行处理；
2. 根据需要创建 osg.AttributeFunctorArrayVisitor 实例，传递函数对象的指针作为参数；
3. 调用 osg.AttributeFunctorArrayVisitor 的 apply() 方法，传递需要遍历的 osg::Array 数据。

class MyArrayVisitor : public osg::ArrayVisitor
{
public:
    virtual void apply(osg::Vec3Array& array)
    {
        for (auto& v : array)
        {
            v += osg::Vec3(1, 1, 1); //给每个顶点加上 (1, 1, 1)
        }
    }
};

osg::ref_ptr<MyArrayVisitor> myVisitor = new MyArrayVisitor();
osg::ref_ptr<osg::Vec3Array> myVertexArray = new osg::Vec3Array();
myVertexArray->push_back(osg::Vec3(0, 0, 0));
myVertexArray->push_back(osg::Vec3(1, 0, 0));
myVertexArray->push_back(osg::Vec3(0, 1, 0));

osg::AttributeFunctorArrayVisitor visitor(myVisitor.get());
visitor.apply(*myVertexArray);

在上述示例中，我们定义了一个回调函数对象 MyArrayVisitor，并在其 apply() 方法中将顶点坐标加上了 (1, 1, 1)。然后我们将该回调函数对象传递给 osg.AttributeFunctorArrayVisitor 实例，实现了对 myVertexArray 数组的遍历，并在该过程中使用 MyArrayVisitor 对象处理每个数组元素。

相关知识

osg::ArrayVisitor 是一个模板类，定义了对 osg::Array 数据结构的遍历方法。该模板类可以被继承，用于实现不同的应用逻辑，例如 osg::DrawableVisitor（遍历所有 Drawable 对象）。

osg::Array 是OpenSceneGraph中用于表示模型属性数据的基础数据结构。它可以表示各种类型的数据（例如顶点坐标、法向量、纹理坐标等），并提供了一组接口用于读写操作。

参考文献

• OpenSceneGraph Programmer's Guide: ArrayVisitor