osgUI.FrameSettings

osgUI.FrameSettings是OpenSceneGraph的一个可视化用户界面（UI）控件，用于调整场景中图像帧（frame）的一些设置参数，如背景颜色、延迟帧绘制等。本文档将介绍osgUI.FrameSettings的各种属性及使用方法。

属性

1. osg::Vec4f backgroundColor: 设置场景的背景颜色，四个分量分别对应红、绿、蓝和透明度值，取值范围为0-1的浮点数。默认为白色（1, 1, 1, 1）。

2. int numFrames: 设置绘制的帧数，即每次绘制要执行的帧数。默认为1。

3. bool delayDraw: 设置是否启用延迟帧绘制。若为True，则绘制操作将在呈现操作前被缓存，以减少渲染时的延迟。默认为False。

4. int maxBufferObjectPoolSize: 设置缓冲区对象池（BufferObject pool）的最大大小。缓冲区对象池是用于重复使用缓存区资源的内部数据结构。默认为10000。

5. bool useGeometryCulling: 设置是否启用几何图形剔除。若为True，则会在绘制前利用渲染平台对任务中几何图形进行剔除。默认为False。

6. bool useDisplayListCompaction: 设置是否启用显示列表压缩。若为True，则会尝试通过压缩OpenGL显示列表大小以减少带宽和GPU时间。默认为False。

7. DisplaySettings settings: 设置与渲染相关的显示设置，包括渲染质量、场景视口等。具体属性详见osg::DisplaySettings。默认为系统默认设置。

方法

1. void setBackgroundColor(float r, float g, float b, float a): 设置场景背景颜色。

2. void setNumFrames(int numFrames): 设置绘制的帧数。

3. void setDelayDraw(bool delayDraw): 设置是否启用延迟帧绘制。

4. void setMaxBufferObjectPoolSize(int maxBufferObjectPoolSize): 设置缓冲区对象池的最大大小。

5. void setUseGeometryCulling(bool useGeometryCulling): 设置是否启用几何图形剔除。

6. void setUseDisplayListCompaction(bool useDisplayListCompaction): 设置是否启用显示列表压缩。

7. void setDisplaySettings(const DisplaySettings& settings): 设置与渲染相关的显示设置。

示例

以下示例代码将创建一个osgUI.FrameSettings控件，并把背景色、帧数、延迟绘制等属性设置为指定值：

#include <osgViewer/Viewer>
#include <osgUI/FrameSettings>

int main(int argc, char** argv)
{
    osg::ref_ptr<osgViewer::Viewer> viewer = new osgViewer::Viewer;

    osg::ref_ptr<osgUI::FrameSettings> frameSettings = new osgUI::FrameSettings;
    frameSettings->setBackgroundColor(0.7f, 0.7f, 0.7f, 1.0f);
    frameSettings->setNumFrames(2);
    frameSettings->setDelayDraw(true);

    viewer->addEventHandler(frameSettings.get());

    return viewer->run();
}

参考资料

1. OpenSceneGraph官方文档：http://www.openscenegraph.org/documentation/index.html