科研自动驾驶物理引擎【免费下载链接】webotsWebots Robot Simulator项目地址https://gitcode.com/gh_mirrors/web/webots点击查看免费下载本篇文章围绕 Webots 官方参考文档中的完整 PROTO 示例展开以TwoColorChair的定义与ThreeChairs.wbt场景的实例化为主线系统讲解 PROTO 文件的接口声明、IS 语句、DEF/USE 复用、扩展槽extension slot等核心机制并结合仓库中实际存在的 SimpleChair.proto 工程化实现进行对比与深化。读完本文你将能够独立编写、复用与实例化自己的 PROTO 节点并理解其底层解析与保存行为。一、PROTO 机制概述PROTO 是 Webots 中扩展节点库的机制它允许用户以内置节点或其他 PROTO 节点为基础定义全新的节点类型并在场景树中像内置节点一样被实例化。PROTO 的接口interface定义了该节点的字段接口字段通过 IS 语句与主体body内部节点的字段建立关联从而让每个实例拥有独立的参数值。一个 PROTO 节点被实例化时可以视为该 PROTO 的完整副本包含其接口字段与主体节点参见 PROTO Instantiation。官方教程 Your First PROTO 提供了动手创建 PROTO 的逐步指引本文则聚焦于官方文档给出的完整示例并做纵深剖析。二、定义 PROTO文件结构与接口声明2.1 文件头与注释PROTO 定义存放在以.proto结尾的文本文件中。文件第一行是版本头#VRML_SIM {{ webots.version.major }} utf8其中{{ webots.version.major }}表示该 PROTO 所需的最低 Webots 主版本。头部之后通常跟随若干注释按约定格式书写以便 Webots 正确展示例如许可证、文档链接与描述# license: Creative Commons Attribution 4.0 International License. # license url: https://creativecommons.org/licenses/by/4.0/legalcode # documentation url: https://www.cyberbotics.com/doc/guide/object-chairs # A two-color chairlicense:与license url:用于声明 PROTO 的分发许可documentation url:链接到该 PROTO 的文档页面其余注释为自然语言描述会显示在 Add Node 对话框中详见 PROTO Design Guidelines。2.2 PROTO 总体结构与接口字段PROTO 定义的结构为PROTO protoName [ protoFields ] { protoBody }接口interface是字段声明的序列每条声明语法如下field fieldType fieldName defaultValue其中field是保留关键字fieldType取值包括SFNode, SFColor, SFFloat, SFInt32, SFString, SFVec2f, SFVec3f, SFRotation, SFBool, MFNode, MFColor, MFFloat, MFInt32, MFString, MFVec2f, MFVec3f, MFRotation, MFBoolSF 前缀为单值字段MF 前缀为多值字段fieldName可自由命名defaultValue是与字段类型匹配的字面量默认值。主体中根节点的类型称为该 PROTO 的base type它决定了 PROTO 实例在场景树中的放置位置。例如根节点是 Solid则实例可放置在 Solid 可用的任何位置若根节点是另一个 PROTO则该 PROTO 称为派生 PROTOderived PROTO。2.3 TwoColorChair 完整定义官方文档的TwoColorChair定义了带四条腿和座面的简单椅子。为保持示例简洁它不含 bounding object也没有 Physics 节点。完整定义如下出自 proto-example.md#VRML_SIM {{ webots.version.major }} utf8 # license: Creative Commons Attribution 4.0 International License. # license url: https://creativecommons.org/licenses/by/4.0/legalcode # documentation url: https://www.cyberbotics.com/doc/guide/object-chairs # A two-color chair PROTO TwoColorChair [ field SFVec3f translation 0 0 0.91 field SFRotation rotation 0 0 1 0 field SFString name two-color chair field SFColor legColor 1 1 0 field SFColor seatColor 1 0.65 0 field SFNode seatGeometry NULL field MFNode seatExtensionSlot [] ] { Solid { translation IS translation rotation IS rotation children [ Pose { translation 0.27 0 0 children IS seatExtensionSlot } Pose { translation 0 0 -0.35 children [ Shape { appearance Appearance { material Material { diffuseColor IS seatColor } } geometry IS seatGeometry } ] } Pose { translation 0.23 -0.25 -0.65 children [ DEF LEG_SHAPE Shape { appearance Appearance { material Material { diffuseColor IS legColor } } geometry Box { size 0.075 0.075 0.52 } } ] } Pose { translation 0.23 0.25 -0.65 children [ USE LEG_SHAPE ] } Pose { translation -0.2 -0.25 -0.65 children [ USE LEG_SHAPE ] } Pose { translation -0.2 0.25 -0.65 children [ USE LEG_SHAPE ] } ] name IS name } }接口共声明 7 个字段覆盖四类用途字段类型默认值作用translationSFVec3f0 0 0.91实例在场景中的位置关联 Solid 的同名字段rotationSFRotation0 0 1 0实例的朝向关联 Solid 的同名字段nameSFStringtwo-color chair实例名称关联 Solid 的name字段legColorSFColor1 1 0四条腿的颜色seatColorSFColor1 0.65 0座面的颜色seatGeometrySFNodeNULL座面的几何体默认无seatExtensionSlotMFNode[]扩展槽可挂接任意节点其中translation与rotation通过 IS 语句与 PROTO 根节点 Solid 的同名字段关联这使得每个实例的位置与朝向可以被保存并恢复——这正是 PROTO 在场景中可被自由摆放、复制的基础。三、主体剖析IS 语句与 DEF/USE 复用3.1 IS 语句接口字段与内部字段的绑定IS 语句的语法是内部字段名 IS 接口字段名可以出现在 PROTO 主体中任何允许出现字段的位置详见 PROTO Definition。TwoColorChair 中出现了 6 处 IS 绑定translation IS translation、rotation IS rotation、name IS name将三个接口字段透传给根节点 Solidchildren IS seatExtensionSlot将扩展槽多值字段直接作为 Pose 的 childrengeometry IS seatGeometry将接口的几何体节点绑定到座面 ShapediffuseColor IS seatColor绑定座面材质颜色diffuseColor IS legColor绑定椅子腿材质颜色。需要注意的规则同一接口字段可有多个 IS 语句。示例中seatColor出现在两处 IS 语句中只要类型匹配即完全合法。IS 引用不存在的接口字段属于错误被关联的字段与接口字段类型不匹配也属于错误例如SFColor不能关联SFVec3fSFColor不能与MFColor互相关联。主体中一个字段被多个接口字段关联时结果未定义应避免。若接口字段未通过 IS 与任何内部字段关联解析时会产生警告可使用unconnectedField关键字代替field来抑制警告。这适用于接口字段仅用于“存储”数据、供 Supervisor 控制器读取的场景例如保存某段道路的限速值或物体的放射性数值。3.2 在 DEF 节点内使用 IS再用 USE 复用TwoColorChair 展示了 IS 语句与 DEF/USE 结合的高效模式第一条椅子腿DEF LEG_SHAPE Shape内部写有diffuseColor IS legColor随后三条腿通过USE LEG_SHAPE直接复用该节点定义Pose { translation 0.23 -0.25 -0.65 children [ DEF LEG_SHAPE Shape { appearance Appearance { material Material { diffuseColor IS legColor } } geometry Box { size 0.075 0.075 0.52 } } ] } Pose { translation 0.23 0.25 -0.65 children [ USE LEG_SHAPE ] }这意味着四条腿共享同一个Shape节点实例颜色修改只需在接口层完成一次。同时要注意 DEF/USE 的作用域限制PROTO 文件内部建立的 DEF 名称作用域与场景树其余部分相互隔离PROTO 内部的 DEF 不能在 PROTO 外部被 USE反之亦然详见 PROTO Scoping Rules。此外递归 PROTO在自身定义内实例化自己是不允许的一个.proto文件只能包含一个 PROTO 定义。3.3 Pose 节点的布局作用主体中使用了四个 Pose 节点分别放置扩展槽、座面和三条腿第四条通过 USE 复用。Pose 是定义子坐标系的分组节点其translation相对父坐标系定位rotation定义任意旋转默认0 0 1 0表示绕 Z 轴 0 弧度。这里选择以 Solid 为根、内部用 Pose 做几何偏移是为了让接口的translation/rotation控制整体位姿而各部件坐标相对稳定。3.4 字段值限制Field Value Restriction若希望某字段仅接受有限取值可在 PROTO 声明中字段类型后直接给出限制集合PROTO MyProto [ field SFVec3f translation 0 0 0 field SFRotation rotation 0 0 1 0 field SFString name my proto field SFColor{0 0 0, 0.5 0.5 0.5, 1 1 1} color 0.5 0.5 0.5 field SFNode physics NULL field MFNode{Solid{}, Pose{}} extensionSlot [] ]标量/颜色类限制color字段只能取0 0 0、0.5 0.5 0.5或1 1 1之一。节点类限制MFNode{Solid{}, Pose{}}表示extensionSlot可接受 Pose 节点、基类型为 Pose 的 PROTO、Solid 节点、派生自 Solid 的节点以及相应派生 PROTO。注意Pose{}后没有因此不接受派生自 Pose 的节点如 Transform 或 Fluid而Solid{}中的表示接受 Solid 的全部后代因为 Solid 本身派生自 Pose用Pose{}会额外放行 Transform、Fluid 等节点。四、实例化 PROTOThreeChairs.wbt 完整解析4.1 EXTERNPROTO 声明PROTO 实例使用常规节点语法。在.wbt文件中使用 PROTO 前需要先用EXTERNPROTO声明其来源。官方示例ThreeChairs.wbt的开头声明了若干外部 PROTO 以及本地示例 PROTOEXTERNPROTO https://raw.githubusercontent.com/cyberbotics/webots/{{ webots.version.major }}/projects/appearances/protos/DamascusSteel.proto EXTERNPROTO https://raw.githubusercontent.com/cyberbotics/webots/{{ webots.version.major }}/projects/appearances/protos/VarnishedPine.proto EXTERNPROTO https://raw.githubusercontent.com/cyberbotics/webots/{{ webots.version.major }}/projects/objects/backgrounds/protos/TexturedBackground.proto EXTERNPROTO https://raw.githubusercontent.com/cyberbotics/webots/{{ webots.version.major }}/projects/objects/backgrounds/protos/TexturedBackgroundLight.proto EXTERNPROTO https://raw.githubusercontent.com/cyberbotics/webots/{{ webots.version.major }}/projects/objects/floors/protos/Floor.proto EXTERNPROTO ../protos/TwoColorChair.proto官方仓库中对应的真实 PROTO 文件分别位于 projects/appearances/protos/DamascusSteel.proto、projects/appearances/protos/VarnishedPine.proto、projects/objects/backgrounds/protos/TexturedBackground.proto、projects/objects/backgrounds/protos/TexturedBackgroundLight.proto 与 projects/objects/floors/protos/Floor.proto可用于核对真实参数。4.2 场景的公共部分ThreeChairs.wbt的其余场景设置包括WorldInfo { } Viewpoint { orientation -0.141 0.263 0.954 1.078 position -0.863 -3.489 1.757 } TexturedBackground { } TexturedBackgroundLight { luminosity 0.5 castShadows FALSE } PointLight { attenuation 0 0 1 intensity 20 location -4 -4 1 radius 10 castShadows TRUE } Floor { size 20 20 }4.3 四种实例化方式场景中摆放了 4 个 TwoColorChair 实例逐一体现了不同的字段定制方式。实例一GREEN_STOOL——自定义几何体与纯色DEF GREEN_STOOL TwoColorChair { translation 0 0 0.9 name two-color chair(2) legColor 0 0.666667 0 seatColor 0.235294 0.470588 0 seatGeometry Cylinder { height 0.1 radius 0.4 } }通过seatGeometry字段传入一个Cylinder节点把默认的矩形座面替换为圆柱座面——这正是SFNode seatGeometry字段的典型用法接口字段接受节点作为值主体中geometry IS seatGeometry完成透传。实例二YELLOW_CHAIR——利用扩展槽添加椅背DEF YELLOW_CHAIR TwoColorChair { translation 1 0 0.9 seatGeometry Box { size 0.6 0.6 0.1 } seatExtensionSlot [ Pose { translation -0.27 0.28 -0.014 children [ Shape { appearance PBRAppearance { baseColor 1 1 0 roughness 1 metalness 0 } geometry Box { size 0.6 0.03 0.7 } } ] } ] }实例三WOODEN_CHAIR——木纹背靠DEF WOODEN_CHAIR TwoColorChair { translation 2 0 0.9 name two-color chair(3) legColor 0.478431 0.239216 0 seatColor 0.666667 0.333333 0 seatGeometry Box { size 0.6 0.6 0.1 } seatExtensionSlot [ Pose { translation -0.27 0.25 0.05 children [ Shape { appearance VarnishedPine { } geometry Box { size 0.6 0.1 0.7 } } ] } ] }实例四DAMACUS_SPHERE——大马士革钢装饰球DEF DAMACUS_SPHERE TwoColorChair { translation 3 0 0.9 name two-color chair(1) legColor 0.678431 0.678431 0.678431 seatExtensionSlot [ Pose { translation -0.27 0 -0.29 children [ Shape { appearance DamascusSteel { } geometry Sphere { radius 0.4 subdivision 5 } } ] } ] }该实例未设置seatGeometry因此座面保持默认的NULL不渲染几何体仅通过seatExtensionSlot添加了一个装饰球。4.4 实例化要点总结字段省略规则与默认值相同的字段可以省略与默认值不同的字段必须显式给出。例如 GREEN_STOOL 省略了rotation保持默认0 0 1 0但显式给出了legColor、seatColor与seatGeometry。MFNode 字段seatExtensionSlot为MFNode多值字段其值用[ ... ]列表给出可包含任意多个节点。扩展槽的意义定义 MFNode 字段可以让同一个模型通过添加节点适配不同的对象或机器人。seatExtensionSlot这类扩展槽可用于在基础机器人上附加设备而无需复制整个机器人定义或新建 PROTO。在官方示例中它被用于添加椅背和装饰球将同一个椅子模型演化出三种不同的造型。加载后的ThreeChairs.wbt在 Webots 中的渲染效果如下图所示五、从教学示例到工程化仓库中的 SimpleChair官方文档指出仓库发行版中提供了名为SimpleChair的更完整版本位于 projects/objects/chairs/protos/SimpleChair.proto。它展示了 TwoColorChair 省略掉的两个关键工程要素——碰撞体boundingObject与物理属性Physics#VRML_SIM R2025a utf8 # license: Copyright Cyberbotics Ltd. Licensed for use only with Webots. # license url: https://cyberbotics.com/webots_assets_license # documentation url: https://webots.cloud/run?urlhttps://github.com/cyberbotics/webots/blob/released/projects/objects/chairs/protos/SimpleChair.proto # keywords: furniture/chair # A simple two-colors chair with a customizable mass, but a fixed height of 1.25 meter. # This object is physics-enabled so it can be pushed. PROTO SimpleChair [ field SFVec3f translation 0 0 0 field SFRotation rotation 0 0 1 0 field SFString name simple chair field SFColor legColor 1 1 0 # Defines the color of the legs of the chair. field SFColor seatColor 1 0.65 0 # Defines the color of the body of the chair. field SFFloat mass 5 # Defines the mass of the chair in kg. ] { Solid { translation IS translation rotation IS rotation children [ DEF CHAIRSEAT Pose { translation -0.24625 0 0.9225 children [ Shape { appearance DEF SEAT_APPEARANCE PBRAppearance { baseColor IS seatColor roughness 0.3 metalness 0 } geometry Box { size 0.0275 0.6 0.655 } } ] } DEF CHAIRSEAT2 Pose { translation 0 0 0.5575 children [ Shape { appearance USE SEAT_APPEARANCE geometry Box { size 0.52 0.6 0.075 } } ] } DEF LEG1 Pose { translation 0.2 0.25 0.26 children [ DEF LEG_SHAPE Shape { appearance DEF LEG_APPEARANCE PBRAppearance { baseColor IS legColor roughness 0.3 metalness 0 } geometry Box { size 0.075 0.075 0.52 } } ] } DEF LEG2 Pose { translation 0.2 -0.25 0.26 children [ USE LEG_SHAPE ] } DEF LEG3 Pose { translation -0.2225 0.2625 0.26 children [ USE LEG_SHAPE ] } DEF LEG4 Pose { translation -0.2225 -0.2625 0.26 children [ USE LEG_SHAPE ] } ] name IS name model simple chair boundingObject Group { children [ USE CHAIRSEAT USE CHAIRSEAT2 USE LEG1 USE LEG2 USE LEG3 USE LEG4 ] } physics Physics { mass IS mass density -1 } } }与 TwoColorChair 相比SimpleChair 展示了以下工程化差异头部元数据更完整包含keywords: furniture/chair分类关键字用于 webots.cloud 的分类documentation url也指向可在线运行演示的地址。材质升级为 PBRAppearance用baseColor IS seatColor、roughness 0.3、metalness 0替代旧的Material.diffuseColor并同样使用 DEF/USESEAT_APPEARANCE、LEG_APPEARANCE、LEG_SHAPE避免重复定义。boundingObject 复用既有 DEF 节点碰撞体直接USE CHAIRSEAT/CHAIRSEAT2/LEG1~LEG4无需重新建模保证碰撞形状与视觉形状一致。Physics 节点physics Physics { mass IS mass; density -1 }通过接口的mass字段默认 5 kg控制质量因此该椅子是“可被推动”的物理物体。遵循设计指南字段注释以动词开头# Defines the color of ...、使用描述性 Solid 名称、命名采用 Upper Camel Case且文件名的SimpleChair.proto与 PROTO 名SimpleChair完全一致参见 PROTO Design Guidelines 的命名与字段注释约定。六、底层机制源码视角的 PROTO 行为6.1 隐藏字段与位姿保存PROTO 的封装性意味着未通过接口字段暴露的内部字段值通常不会被保存。但 Webots 会在每个顶层 PROTO 的字段作用域内自动保存那些随仿真时间变化的隐藏字段详见 PROTO Hidden FieldsSolid 节点的translation、rotationJoint 节点的position物理子部件的初始线速度与角速度。每个隐藏字段的名字会追加一个索引该索引为所属 Solid 在 PROTO 子树中的深度优先前序遍历编号。例如在 projects/robots/pioneer3at 世界文件 中可以看到hidden translation_2、hidden rotation_2、hidden linearVelocity_2等字段。这一点解释了 TwoColorChair 示例中为何要刻意在接口暴露translation与rotation显式关联后这两个字段以普通字段而非隐藏字段的形式保存语义更清晰。在 Solid 合并implicit solid merging场景下隐藏的translation/rotation只针对装配体顶部的 Solid 保存。6.2 解析与作用域约束从源码结构看PROTO 的解析主要由 src/webots/vrml/WbProtoModel.cpp、src/webots/vrml/WbNodeReader.cpp 与 src/webots/vrml/WbProtoManager.cpp 负责WbProtoModel维护接口字段与主体结构WbNodeReader在读取实例时依据 IS 语句把接口值写入主体对应字段WbProtoManager负责 PROTO 的注册、查找与 EXTERNPROTO 加载。字段类型系统由 WbFieldModel.cpp 与各类WbSF*/WbMF*值类如 WbSFColor.cpp、WbSFNode.cpp实现接口字段值限制Field Value Restriction由 WbFieldValueRestriction.cpp 校验。作用域方面PROTO Scoping RulesPROTO 名称必须唯一不能与内置节点或其他 PROTO 重名一个.proto文件只能包含一个 PROTO 定义递归 PROTO在自身定义内实例化自己非法IS 语句只能引用同一文件中同一 PROTO 接口声明的字段DEF/USE 名称作用域在 PROTO 文件内自洽与外部场景树相互隔离派生 PROTO 中接口字段若与基 PROTO 字段同名则只能关联同名基字段。七、实战要点总结接口设计先行为可复用对象暴露translation、rotation、name等基础字段并用 IS 语句绑定到根节点保证实例可摆放、可保存。善用 SFNode/MFNode 字段SFNode如seatGeometry允许替换内部几何体MFNode如seatExtensionSlot允许扩展任意子节点让一个模型通过配置演化为多种形态。DEF/USE 与 IS 结合在 DEF 节点内部写 IS 语句再通过 USE 复用可显著精简主体代码并保证参数一致性。遵守类型匹配规则IS 语句两侧类型必须一致SFColor 只能关联 SFColor同一接口字段的多处 IS 绑定是合法的但含 Solid/Joint 节点的字段多处复用虽合法却不被推荐——系统假定字段所有实例状态一致而内部状态或控制器指令可能导致实例状态发散。字段省略规则实例化时与默认值相同的字段可省略不同的必须显式给出。工程化补全需要碰撞与物理行为时参照 SimpleChair.proto 补充 boundingObject直接 USE 既有部件与 Physics 节点需要限制取值时使用 Field Value Restriction 语法。元数据规范遵循 PROTO Design Guidelines 的头部注释、关键字、命名与字段注释约定让 PROTO 在 Add Node 对话框和 webots.cloud 上呈现良好。至此从TwoColorChair的接口声明、IS 绑定、DEF/USE 复用到ThreeChairs.wbt的四实例化场景再到工程化的SimpleChair与底层保存/解析机制你已经掌握了 Webots PROTO 定义与实例化的完整链路可以着手编写属于你自己的可复用 PROTO 节点。赞分享科研自动驾驶物理引擎【免费下载链接】webotsWebots Robot Simulator项目地址https://gitcode.com/gh_mirrors/web/webots点击查看免费下载相关推荐Webots 内置示例环境指南从公寓到工厂的可交互 PROTO 场景搭建Webots 内置示例环境指南从公寓到工厂的可交互 PROTO 场景搭建 导读 本文系统梳理 Webots 机器人模拟器中随仓库一同发布的 7 个标准示例环境科研自动驾驶物理引擎Webots IndexedLineSet 节点完全指南从字段语义到渲染实现与实战示例Webots IndexedLineSet 节点完全指南从字段语义到渲染实现与实战示例 IndexedLineSet 是 Webots 中用于构建三维折线P科研自动驾驶物理引擎Flink Protobuf Format 实战指南从 .proto 定义到 SQL 读写Flink Protobuf Format 实战指南从 .proto 定义到 SQL 读写 导读 本文围绕 Apache Flink 的 ProtobufP后端大数据流处理批处理上一篇Buildah容器构建工具全面教程指南下一篇Paperless项目核心工具详解从文档消费到加密管理创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考