osgSim.OverlayNode

osgSim.OverlayNode是OpenSceneGraph中的一个类，它可用于创建一个平面层，该层覆盖在场景中的其他对象上方，并使用RGBA颜色来调整层的透明度。

构造函数

osgSim.OverlayNode类有2个构造函数：

• OverlayNode()
• OverlayNode(const OverlayNode& overlay, const osg::CopyOp& copyop = osg::CopyOp::SHALLOW_COPY)

第一个构造函数创建一个新的OverlayNode对象，而第二个构造函数根据给定的OverlayNode对象创建一个新的对象。

方法

osgSim.OverlayNode类有以下方法：

• void setColor(const osg::Vec4& color)

  设置层的颜色（RGBA格式）。

• const osg::Vec4& getColor() const

  获取层的颜色。

• void setTextureSize(unsigned int width, unsigned int height)

  设置层的纹理尺寸。

• void setTextureSize(const osg::Vec2& size)

  设置层的纹理尺寸（使用Vec2格式）。

• const osg::Vec2& getTextureSize() const

  获取层的纹理尺寸。

• void setTexture(osg::Texture2D* texture)

  设置覆盖层的纹理。指定的纹理必须已加载，并且必须是二维纹理。

• osg::Texture2D* getTexture() const

  获取当前覆盖层的纹理。

• void setOverlaySubgraph(osg::Node* node)

  指定要放置在此覆盖层上的场景子图。

• osg::Node* getOverlaySubgraph() const

  获取此覆盖层上的场景子图。如果未指定子图，则返回nullptr。

• void setOverlayTransform(const osg::Matrixd& matrix)

  设置覆盖层的变换矩阵。

• const osg::Matrixd& getOverlayTransform() const

  获取当前覆盖层的变换矩阵。

• void setOverlayPosition(const osg::Vec3& position)

  设置覆盖层的位置，在局部坐标系中表示。

• const osg::Vec3& getOverlayPosition() const

  获取覆盖层的位置。

• void setOverlayRotation(const osg::Quat& quat)

  设置覆盖层的欧拉角度。

• const osg::Quat& getOverlayRotation() const

  获取覆盖层的欧拉角度。

• void setOverlayScale(const osg::Vec3& scale)

  设置覆盖层的放缩系数。

• const osg::Vec3& getOverlayScale() const

  获取覆盖层的放缩系数。

示例

以下代码行创建一个红色半透明层，将其置于已加载模型场景的顶部，并设置半透明层的大小为1024x1024像素：

osg::ref_ptr<osgSim::OverlayNode> overlay = new osgSim::OverlayNode;
overlay->setColor(osg::Vec4(1.0, 0.0, 0.0, 0.5));
overlay->setTextureSize(osg::Vec2(1024, 1024));
overlay->setOverlaySubgraph(scene); // scene为已加载的场景Subgraph

摘要

osgSim.OverlayNode是OpenSceneGraph中的一个类，用于创建一个透明层，并将其置于已加载的场景之上，以增加对场景的覆盖力。它可用于添加标记，设计用户界面元素，以及为增强场景视觉效果而创建遮挡层。