编辑 lgrConfig.xml
lgrConfig.xml 文件包含在你启动 Logger 时运行的命令。默认配置文件使用初始化命令启动 Logger,以加载插件并连接到 HLA 网络。
每个 ./bin 目录都有一个 lgrConfig.xml 版本,针对该目录中 Logger 版本所使用的协议进行了定制。lgrConfig.xml 的默认版本位于 ./data/backups 中。这些文件按协议命名,因此如果你需要将某个特定的 lgrConfig.xml 恢复为默认值,你知道该使用哪一个。你也可以通过 --configFile 命令行选项指定某个默认版本来使用它。
该文件使用 XML 语法编写。它本质上包含两个部分——变量定义和命令。变量定义在 <defaults> 块中指定。命令在两个 <commands> 块之一中以一系列 <command> 条目指定。你可以在配置文件中使用任何 Logger 命令。(有关命令列表,请参阅“Command Descriptions“(第 470 页)。
**注意:**某些命令行选项在配置文件的 defaults 部分中有一个与之匹配的变量名。如果你更改或删除默认配置文件中的某个变量名,将会破坏与之关联的命令行选项。
此外,如果你添加一个新变量并给它一个与现有命令行参数匹配的名称,你将得到不可预期的行为。注意新变量的命名方式应能消除发生这种错误的任何风险。
以下是一个针对 HLA 的配置文件的深度编辑版本,展示了主要组成部分:
<lgrConfig>
<!-- Variable formatting -->
<defaults>
<var name="messageLevel" type="int" value="2"/>
<!-- HLA Settings -->
<var name="execName" type="string" value="VR-Link"/>
<var name="federateName" type="string" value="Logger"/>
<var name="fedFileName" type="string" value="VR-Link.fed"/>
<var name="fomMapperLib" type="string" value=""/>
<var name="fomMapperInitData" type="string" value=""/>
<var name="rprFomVersion" type="double" value="1.0"/>
<var name="rprFomRevision" type="int" value="1"/>
<var name="ignoreAdvisoriesValue" type="bool" value="false"/>
<var name="useEmptyFomMapperValue" type="bool" value="false"/>
</defaults>
<!-- Initialize commands executed after the command line is parsed -->
<!-- Parameter variables must be defined in the defaults group -->
<commands name="init">
<command domain="System" protocol="None" command="SetNotifyLevel">
<param name="lgrLevel" var="messageLevel"></param>
</command>
</commands>
<commands name="startup">
<command domain="Simulation" protocol="HLA 13"
command="SetConnectionParameters">
<param name="federateName" var="federateName"></param>
<param name="federationName" var="execName"></param>
<param name="fedFile" var="fedFileName"></param>
<param name="fomVersion" var="rprFomVersion"></param>
<param name="fomRevision" var="rprFomRevision"></param>
<param name="fomMapper" var="fomMapperLib"></param>
<param name="fomMapperData" var="fomMapperInitData"></param>
<param name="ignoreAdvisories" var="ignoreAdvisoriesValue"></param>
<param name="useEmptyFomMapper" var="useEmptyFomMapperValue"></param>
</command>
<command domain="Simulation" protocol="None" command="Connect"/>
</commands>
</lgrConfig>
命令语法
不带参数的命令采用如下格式:
<command domain="domain" protocol="protocol" command="command"/>
其中:
- domain 是 System、Player、Recorder、Editor 或 Simulation。有关按域列出的命令列表,请参阅“Command Descriptions“(第 470 页)。
- protocol 是 None、HLA 13 或 HLA 1516。
- command 是你想要运行的命令,取自“使用用于 3DNV 的 Multi-Federate Logger 命令”(第 467 页)中支持的命令列表。
以下是一个不带参数的命令示例:
<command domain="Simulation" protocol="None" command="Connect"/>
带参数的命令采用如下格式:
<command domain="domain" protocol="protocol" command="command">
<param name="name" var="variableName"></param>
</command>
其中:
- name 是命令参数的名称,如“Command Descriptions“(第 470 页)中的命令说明所列。
- variableName 是由用户定义的变量名,该变量将在配置文件的
<defaults>部分中定义。
以下是一个带参数的命令示例:
<command domain="System" protocol="None" command="SetNotifyLevel">
<param name="lgrLevel" var="messageLevel"></param>
</command>
变量语法
变量条目采用如下格式:
<var name="variableName" type="type" value="value"/>
其中:
- variableName 是由配置文件 commands 部分中的命令指定的变量。
- type 是该变量的参数类型,如“Command Descriptions“(第 470 页)中为每个命令参数所定义。
- value 是你想赋给该变量的值。
例如:
<var name="messageLevel" type="int" value="2"/>
向 lgrConfig.xml 添加命令
向配置文件添加命令时,你通常会将命令添加到 startup 命令部分。只有在要添加一个用于加载插件的命令时,才会将命令添加到 init 部分。
假设你想向 lgrConfig.xml 添加 NewFile 命令。该命令创建一个用于记录的新文件。如果你将它添加到配置文件中,那么每次启动 Logger 时,它都会创建一个具有指定名称的新文件。
过程 146:示例:向 lgrConfig.xml 添加命令
-
在
<commands name="startup">部分中添加一个新命令,类似于以下内容:<commands name="startup"> <command domain="Recorder" protocol="None" command="NewFile"> <param name="filename" var="newfile"></param> </command> </commands>在该命令定义中,域是 Recorder,你之所以知道这一点,是因为 NewFile 列在“Command Descriptions“(第 470 页)中 Recorder 域的命令之中。Protocol 是 None,因为该命令与协议无关。该命令是
NewFile。命令定义表明
NewFile带有一个类型为 string 的参数 filename。因此,向该命令添加一个参数定义。名称是 filename,它必须与定义中的拼写完全一致。变量名是由用户定义的名称,将在变量定义中定义。 -
为变量 newfile 添加一个变量定义,类似于以下内容:
<var name="newfile" type="string" value="newfilename.lgr"/>名称 newfile 与命令条目中的变量名相匹配。类型是命令定义中列出的类型。值是你想赋的任何值,在本例中,就是你想赋予将在启动时创建的 Logger 文件的名称。
向 lgrConfig.xml 添加字符串列表
某些命令需要指定多个字符串。与其他命令一样,你指定一个变量来接收数据,然后以 listitem 列表的形式提供这些字符串。例如,下面是为 HLA 指定订阅列表的方式:
过程 147:示例:为 HLA 指定订阅列表
-
在配置文件的命令部分中,为
SetSubscriptionLists命令添加一个条目,如下所示:<!-- To Disable auto-connection remove this command --> <command domain="Simulation" protocol="None" command="Connect"/> </commands><command domain="Simulation" protocol="HLA 13" command="SetSubscriptionLists"> <param name="objectClasses" var="objectSubscriptionList"></param> <param name="interactionClasses" var="interactionSubscriptionList"> </param> </command>由于
SetSubscriptionLists命令带有两个参数,我们为其定义两个参数。**注意:**我们包含了
Connect命令(它位于默认配置文件中),因为在发出SetSubscriptionLists命令之前,Logger 必须已经连接。使用 Logger 命令时,你必须考虑它们所具有的任何前置条件。 -
为命令中定义的每个参数添加一个变量定义。在每个变量定义中,为你想包含在列表中的每个字符串包含一个 listitem。
<var name="objectSubscriptionList" type="list" listtype="string"> <listitem>ObjectRoot.BaseEntity.PhysicalEntity.Platform.Aircraft </listitem> <listitem>ObjectRoot.BaseEntity.PhysicalEntity.Radio</listitem> </var><var name="InteractionSubscriptionList" type="list" listtype="string"> <listitem>InteractionRoot.WeaponFire</listitem> </var>**注意:**此示例创建的订阅列表与“在命令行上使用 Logger 命令”(第 468 页)和“在文本界面中使用 Logger 命令”(第 469 页)中的示例命令所创建的订阅列表完全相同。