更新 Cyber Effects 配置节点
新效应及其参数(如果有)必须添加到 Cyber Effects 配置节点中,这样才能使它们出现在供脚本使用的选择列表中。如果你为该效应创建了新类别,该类别也必须添加到配置节点中。你通过编辑 cyber_effects_attrib_definer 进程模型中的属性来添加这些项。
使用以下过程访问你需要编辑的属性。
过程 32:访问配置节点上的效应属性
-
打开
cyber_effects_attrib_definer进程模型。 -
选择 Interfaces > Model Attributes。
“Model Attributes: cyber_effects_attrib_definer”对话框随即打开。
-
选择 Cyber Effect Scripts 属性,然后单击 Edit Properties 按钮。
“(Cyber Effect Scripts) Properties Inherited Tags [ ]”对话框随即打开。
-
选择 Script 属性,然后单击 Edit Properties 按钮。
“(Script) Properties Inherited Tags [ ]”对话框随即打开。你可能需要编辑的属性(Category、Effect 和 Arguments)都显示在该对话框中。
图 125: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 属性符号映射

添加效应参数
如果你的自定义效应带有参数,你必须为它们添加子属性。访问 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(),使这些参数只出现在自定义效应中。