osgUtil.StateGraph

osgUtil.StateGraph 是一个 OpenSceneGraph 中的工具类，用于收集和处理场景图的状态信息。

简介

在场景图中，每个节点都有一个状态 StateSet，它包含了节点的渲染状态信息，例如颜色、材质、纹理等。在渲染场景时，当遍历到一个节点时，需要把该节点的状态应用到渲染上下文中，以正确绘制这个节点。

在场景图中有可能存在继承关系，即子节点会从父节点中继承状态信息。当节点状态变更时，这个状态的变更也需要被向下传递，从而确保在渲染场景时，每个节点的状态都正确。

osgUtil.StateGraph 的作用就是收集场景图中所有节点的状态信息，并构建出一个状态图。状态图上的每个节点代表一个状态，而节点之间的连接代表状态之间的依赖关系。这样，可以很方便的从状态图中获取每个节点的继承关系，并根据需要快速更新状态。

使用方法

osgUtil.StateGraph 的使用非常简单，只需要在场景图遍历过程中，对每个节点调用 osgUtil::StateGraph::optimize 方法即可。其返回值是一个状态图根节点，即整个场景图所有节点状态对应的状态图。

osg::ref_ptr<osgUtil::StateGraph> stateGraph = new osgUtil::StateGraph;
osgUtil::StateGraph::optimize(node, stateGraph.get());

在获取到状态图后，可以通过状态图根节点的 getChild 方法遍历整个状态图。

osg::ref_ptr<osgUtil::StateSetAttributeList> states = stateGraph->getChild()->getPerAttributeList();
for (int i=0; i<states->size(); i++){
    osg::ref_ptr<osgUtil::StateSetAttributeList> list = (*states)[i];
    for (int j=0; j<list->size(); j++){
        osg::StateAttribute::Type type = osg::StateAttribute::Type(j);
        osg::ref_ptr<osgUtil::StateGraph::StateNodeList> nodeList = list->at(type);
        for (int k=0; k<nodeList->size(); k++){
            osgUtil::StateGraph::StateNode* stateNode = (*nodeList)[k];
            // do something with stateNode
        }
    }
}

其中，getPerAttributeList 方法返回的是一个 osgUtil::StateSetAttributeList，它包含了所有状态的信息。而 osgUtil::StateSetAttributeList 中的每个元素（osgUtil::PerAttributeList）代表一个状态（例如颜色、材质等），包含了这种状态的所有节点信息。

状态图的详细使用方法请参考源代码和官方文档。

其他

osgUtil.StateGraph 的源代码可以在 OpenSceneGraph 项目源码中找到。官方文档中也提供了关于 osgUtil.StateGraph 的详细说明。