osg.Geometry

osg.Geometry类是OpenSceneGraph中的重要类之一，用于描述三维图形中的几何体。

基本概念

osg.Geometry类的实例用于描述一个几何体的形状、颜色、纹理等信息。一个osg.Geometry实例可以包含多个osg.Draw对象，每个osg.Draw对象包含一组几何体的绘制索引，并指定绘制的类型（如点、线、三角形等）。

osg.Geometry实例可以被添加到osg.Node实例中，使得该几何体可以被渲染到场景中。

常用方法

一些常用的osg.Geometry类的方法如下：

osg::Geometry::setVertexArray(osg::Vec3Array *vertices)

设置几何体的顶点坐标数组。

osg::Geometry::setColorArray(osg::Vec4Array *colors)

设置几何体的颜色数组，每个元素代表一个顶点的颜色。

osg::Geometry::setNormalArray(osg::Vec3Array *normals)

设置几何体的法向量数组，每个元素代表一个顶点的法向量。

osg::Geometry::setTextureCoords(unsigned int unit, osg::Vec2Array *coords)

设置几何体的纹理坐标数组，unit表示第几个纹理单元。

osg::Geometry::addPrimitiveSet(osg::PrimitiveSet *primSet)

添加一个osg.PrimitiveSet对象，包含一组几何体的绘制索引以及绘制的方式。

osg::Geometry::setUseDisplayList(bool value)

设置是否将几何体的渲染命令封装为OpenGL显示列表来提高渲染性能。

示例代码

下面是一个利用osg.Geometry类构建一个立方体的示例代码：

osg::ref_ptr<osg::Vec3Array> vertices = new osg::Vec3Array();
vertices->push_back(osg::Vec3(-1.0,-1.0, 1.0)); // front bot left
// ... 省略一些顶点坐标的添加 ...
vertices->push_back(osg::Vec3( 1.0, 1.0, 1.0)); // back top right

osg::ref_ptr<osg::Vec4Array> colors = new osg::Vec4Array();
// ... 省略一些顶点颜色的添加 ...

osg::ref_ptr<osg::Vec3Array> normals = new osg::Vec3Array();
// ... 省略一些法向量的添加 ...

osg::ref_ptr<osg::DrawElementsUInt> indices = new osg::DrawElementsUInt(osg::PrimitiveSet::TRIANGLES);
indices->push_back(0); indices->push_back(1); indices->push_back(2);
// ... 省略一些绘制索引的添加 ...

osg::ref_ptr<osg::Geometry> geom = new osg::Geometry();
geom->setVertexArray(vertices.get());
geom->setColorArray(colors.get());
geom->setColorBinding(osg::Geometry::BIND_PER_VERTEX);
geom->setNormalArray(normals.get());
geom->setNormalBinding(osg::Geometry::BIND_PER_VERTEX);
geom->addPrimitiveSet(indices.get());

参考文献

• OpenSceneGraph 3.6.4 Documentation, https://www.openscenegraph.org/documentation/3.6.4/doc/tutorials/geometry.html