更新 Cyber Effects 配置节点

新效应及其参数(如果有)必须添加到 Cyber Effects 配置节点中,这样才能使它们出现在供脚本使用的选择列表中。如果你为该效应创建了新类别,该类别也必须添加到配置节点中。你通过编辑 cyber_effects_attrib_definer 进程模型中的属性来添加这些项。

使用以下过程访问你需要编辑的属性。

过程 32:访问配置节点上的效应属性

  1. 打开 cyber_effects_attrib_definer 进程模型。

  2. 选择 Interfaces > Model Attributes。

    “Model Attributes: cyber_effects_attrib_definer”对话框随即打开。

  3. 选择 Cyber Effect Scripts 属性,然后单击 Edit Properties 按钮。

    “(Cyber Effect Scripts) Properties Inherited Tags [ ]”对话框随即打开。

  4. 选择 Script 属性,然后单击 Edit Properties 按钮。

    “(Script) Properties Inherited Tags [ ]”对话框随即打开。你可能需要编辑的属性(Category、Effect 和 Arguments)都显示在该对话框中。

图 125:Script 属性对话框

Script 属性对话框

要访问 Category、Effect 或 Arguments 属性进行编辑,请选择该属性并单击 Edit Properties 按钮。各属性的编辑细节见以下各节。

过程 32 结束

添加类别

如果你的自定义效应不适合任何现有类别(如 General 或 IP),你可以为它创建新类别。访问 Category 属性(过程 32),在符号映射中为新类别添加一个符号。该值可以是任何未使用的整数,但必须与 cyber_effects.h 中 CyberT_Effect_Category 枚举类型所使用的索引一致。我们建议你的自定义编号从 100 开始,以避免与将来的内置类别冲突。

图 126:效应类别符号映射

效应类别符号映射

例如,如果你添加一个名为 My_Category 的新类别并在符号映射中给它赋值 100,则应按下述方式将其添加到 CyberT_Effect_Category 枚举类型中(添加的内容以粗体显示):

typedef enum CyberT_Effect_Category
{
   CyberC_General,
   CyberC_IP,
   CyberC_My_Category = 100,
   CyberC_Categories_Count = 3
} CyberT_Effect_Category;

请注意,你必须将 CyberC_Categories_Count 项显式设置为该枚举类型中类别的总数。

添加效应

访问 Effect 属性(过程 32),在符号映射中为新效应添加一个符号。注意,符号按类别分组,且编号在每个类别内重新开始。你为效应分配的值可以是其所属类别内任何未使用的整数,但必须与 cyber_effects.h 中该类别的效应枚举类型结构(例如 CyberT_Effects_General)所使用的索引一致。我们建议在每个类别中自定义编号都从 100 开始,以避免与将来的内置效应冲突(参见添加类别中的示例)。如果新效应属于你正在添加的新类别,你还需要在 cyber_effects.h 中为该类别定义新的枚举类型结构。

图 127:Effect 属性符号映射

Effect 属性符号映射

添加效应参数

如果你的自定义效应带有参数,你必须为它们添加子属性。访问 Arguments 属性(过程 32),为新效应使用的每个参数添加一个子属性。

你还必须修改 cyber_effect_args_attribute_parse() 函数(位于 cyber_effects_attrib_definer 功能块中)。该函数需要为新增参数分配内存并设置值的 case 语句。如果你创建了新类别,它可能还需要为新类别添加一个 case。

注: 你添加到配置节点的参数会出现在每个效应的参数选择列表中,尽管只有你的自定义效应会使用它们。如果你拥有 OPNET Development Kit 的许可证,可以通过修改 cyber_effects_active_attr_handlers.ets.c 中的 display_cyber_effect_args_hide_handler(),使这些参数只出现在自定义效应中。

本站文档由 北京智网畅联科技有限公司 整理、翻译并提供 · Documentation compiled and provided by Beijing ZNetLink Technology Co., Ltd.

交流群 · QQ Group:OPNET/智网妙算网络仿真交流群(群号 486383494)

原文档 © 2017 Riverbed Technology · 本站为公益翻译,由 AI 辅助完成,请仔细甄别

Original documentation © 2017 Riverbed Technology. Community translation, AI-assisted. Contact: jiazequn@znetlink.com