Language:
Share
此中文页面内容对应的英文页面有后续更新,如需浏览最新文档可切换至英文页面浏览。

蓝图宏库

概述

Blueprint Macro Library(蓝图宏库) 是一个存放了一组 的容器,或者是可以像节点那样 放置到其他 蓝图 中的自包含图表。这些蓝图宏库非常节约时间,因为它们存放了常用的节点序列、 及针对执行和数据变换的输入和输出。

会在所有引用它们的图表间共享,但是如果它们在编译过程中是合并的节点,那么它们会自动地 展开为图表。这意味着 蓝图宏库 不需要进行编译, 但是对 所做的修改,仅当重新编译了包含引用该 的图表的蓝图时,这些修改才会反应在 图表中。

创建蓝图宏库

Blueprint Macro Libraries(蓝图宏库) 存储在包中,可以像创建任何其他资源一样通过内容浏览器来创建蓝图宏库。

  1. 在内容浏览器中,点击 New Asset button

  2. 从出现的菜单中,选择 New Asset(新建资源) 下的 Miscellaneous(其他) > Blueprint Macro Library(蓝图宏库)

    new_asset_macrolib.png

  3. 选择您的 蓝图宏库Parent Class(父类)

    Choose a Parent Class

  4. 您的 蓝图宏库 将会立即出现在内容浏览器中。在内容浏览器中您的 蓝图宏库 图标的下面输入它的名称。

    name_macro_library.png

    当您第一次创建 蓝图宏库 或者当您在 蓝图编辑器 中修改它时,在内容浏览器中的 蓝图宏库 的图标上将会添加一个星号。这意味着没有保存该 蓝图宏库

    unsaved_macro_library.png

  5. 要想从内容浏览器中直接保存 Blueprint Macro Library(蓝图宏库) ,请点击内容浏览器导航条中的 Save(保存)... 按钮。

    save_macrolib_content_browser.png

  6. 在出现的 Save Content(保存内容) 窗口中,请确保选中了您的新 蓝图宏库 的复选框,然后点击Save Selected 按钮。

    save_selected_macrolib.png

  7. 双击 蓝图宏库 的图表来在 蓝图编辑器 中打开它。

还有两种可以从内容浏览器中访问 蓝图宏库 创建菜单的其他方法。

  1. 右击内容浏览器的Asset View(资源视图)面板(右侧)。

  2. 从出现的菜单中,选择 New Asset(新建资源) 下的 Miscellaneous(其他) > Blueprint Macro Library(蓝图宏库)

    rt_click_content_browser_macrolib.png

  3. Pick Parent Class(选择父类) 窗口将会出现,从这里开始, 蓝图宏库 的创建过程就和您使用 新建资源 按钮创建时一样了。

另一种方法:

  1. Asset Tree(资源树) 中的一个文件夹上右击鼠标,该资源树位于内容浏览器的左侧。

  2. 在出现的菜单中,将鼠标移动到 New Asset(新建资源) 项。

    rtclick_content_browser_asset_tree.png

  3. 在出现的子菜单中,选择 New Asset(新建资源) 下的 Miscellaneous(其他) > Blueprint Macro Library(蓝图宏库)

    rtclick_content_browser_asset_tree_macrolib.png

  4. Pick Parent Class(选择父类) 窗口将会出现,从这里开始, 蓝图宏库 的创建过程就和您使用 新建资源 按钮创建时一样了。

蓝图宏

蓝图宏 从本质上讲和合并的节点图表一样。它们具有由通道节点指定的一个入口点和一个出口点 。每个通道可以具有多个执行引脚或数据引脚,当在其他 蓝图 及图表中使用该宏节点时这些引脚会呈现在宏节点上。

创建蓝图宏

蓝图宏库 中创建的 蓝图宏 可以用于您的项目中的任何 蓝图 内。

要想在 蓝图宏库 中创建一个 蓝图宏

  1. Graph(图表) 模式,从 My Blueprint(我的蓝图) 选卡下,点击New Macro (新建宏)按钮。

    library_new_macro.png

  2. 输入您的 Blueprint Macro(蓝图宏) 的名称。

    library_name_macro.png

将会在蓝图编辑器的 Graph (图表) 面板的一个新选卡中打开您的 蓝图宏

您也可以在 我的蓝图 面板中右击并选择 Macro(宏) 来创建一个 蓝图宏

library_macro_rtclick.png

构建蓝图宏

当您第一次创建一个 蓝图宏 时,将会打开一个新图表,该图表包含一个 Inputs(输入) 通道节点和一个 Outputs(输出) 通道节点。

input_output_macro.png

在您的 蓝图宏Details(详细信息) 面板中,您可以添加输入和输出执行引脚及数据引脚。您也可以设置您的 蓝图宏Description(描述)Category(类别)Instance Color(实例颜色)

new_macro_details.png

要想添加输入或输出参数:

  1. 点击 详细信息 面板的 Inputs(输入)Outputs(输出) 部分的 New(新建) 按钮。

  2. 命名该新参数并使用下拉菜单设置其类型。在这个示例中,有一个 整型 数据输入参数 Score 、一个输入执行引脚 Test 及两个输出执行引脚 WinLose

    macro_details.png

    蓝图宏 图表中的通道节点将会自动地更新为正确的引脚。

    macro_tunnels_with_pins.png

  3. 您也可以通过展开参数项来设置一个默认值。

    macro_details_expanded.png

要想改变节点边缘上的这个参数的引脚的位置,请使用展开的 详细信息 面板项的向下和向上箭头。

要想给您的 蓝图宏 设置一些功能,请把数据引脚及执行引脚连接到您的 InputsOutputs 通道节点,并在它们之间创建一个节点网络。

score_comparison_example_macro.png

这个示例 蓝图宏 判断输入到 中的分数是否大于获胜的必要分数,然后根据比较结果触发不同的输出执行流程 。注意,这里通过使用 详细信息 面板中的向上和向下箭头翻转了 TestScore 引脚,以避免在 蓝图宏 图表中出现交叉连线。

move_pin_arrows.png

函数不同 可以具有多个输出执行引脚,所以您可以具有类似这样的执行流程,可以根据图表逻辑的结果 执行不同的输出执行引脚。同时,只要 中的节点不是执行节点,您也可以具有没有执行引脚的 ,这样的宏仅简单地操作数据。

data_macro.png

应用存储在蓝图宏库中的宏

蓝图宏库 中存储宏,使得您可以在整个项目中的 类蓝图关卡蓝图 中访问它们。

有很多种把 节点添加到另一个 蓝图 图表中的方法。和 Function(函数) 节点及 Custom Event(自定义事件) 调用节点一样,您也可以在您的 蓝图 中添加多个 节点的副本。

要想添加一个 ,只需右击图表并在弹出的关联菜单中选择 Macro(宏) 即可。

right_click_add_macro.png

您可以从另一个节点的引脚出拖拽并释放鼠标,如果该节点具有相应的变量类型和流程方向,那么该 将出现在关联菜单中。

pin_macro_summon.png

一旦将 节点添加到了图表中,它的处理就和其他任何节点一样,输入和输出引脚可以相应地进行连接。在任何 蓝图 图表中 双击 一个 节点 将打开该 的图表。