Terrain Macro Material 组件

Terrain Macro Material 组件将 Terrain Base Color 纹理应用于其体积内的所有 Terrain 区域。

提供者

Terrain Gem

依赖

Terrain World
Terrain World Renderer
Axis Aligned Box Shape

Terrain Macro Material 还依赖于其体积中至少存在的一个 Terrain Layer Spawner ，因为此组件增强了现有的地形数据。

属性

用法

Terrain Macro Material 组件为体积内的地形系统提供低保真颜色信息。颜色数据用作 Terrain World Renderer 组件上定义的 细节材质渲染距离 之外的地形的任何部分的唯一颜色源。在 Detail material render distance 内，颜色数据与 地形细节材质 混合，以便在细节纹理在表面上重复时提供颜色变化。

该组件还为地形系统提供可选的宏法线信息，以便远距离地形可以在较低多边形 LOD 上具有更高质量的法线。宏法线很难正确创作，因此不建议将其用于典型用途。宏法线必须位于世界空间中，并在所有维度上以与 O3DE 关卡中的地形相同的地形比例生成。如果 O3DE 中的地形在任何方向上调整大小不均匀，则法线将不再与地形几何体对齐，并且地形表面照明将不正确。

您可以通过调整实体上的 Axis Aligned Box Shape 组件来配置体积的尺寸。您可以通过将纹理资产拖动到 Color Texture 或 Normal Texture 字段，或者单击 来分配颜色纹理和可选的法线纹理。分配纹理后，您可以使用 Normal Flip X 和 Normal Flip Y 切换以及 Normal Factor 滑块来调整法线的方向和幅值。

如果方便，Terrain Macro Material 可以与 Terrain Layer Spawner 组件存在于同一实体上，但这不是必需的。此组件可用于任何世界区域，无论它与多个刷怪箱重叠、单个刷怪箱或根本没有刷怪箱。宏材质数据将应用于出现在其体积内的任何地形数据，并且不会在缺少地形的地方进行渲染。这种灵活性允许以与其他地形数据不同的大小和分辨率来创作、加载和卸载地形宏材质。

如果两个 Terrain Macro Material 体积重叠，则 Priority 字段指示将使用哪种宏材质数据。值越大，优先级越高。

创建新图像

要创建新映像，请按 Create New Image… 按钮。系统将提示您输入图像的宽度和高度（以像素为单位），然后输入保存图像的位置。如果图像保存到项目使用的 源资产目录中，则地形宏材质将自动使用保存的图像填充 Color Texture 字段。

编辑图像

要编辑现有颜色纹理，请按 Terrain Macro Material 组件上的 Edit 按钮，或在视区的 Component Switcher 中选择 Terrain Macro Material 组件的图标。这将进入 Paint Brush 模式。有关如何使用 Paint Brush 的更多详细信息，请参阅 Paint Brush文档。

编辑完成后，按 Esc、按 Terrain Macro Material 组件上的 Done 按钮或在视区的 Component Switcher 中选择其他组件的图标来结束 Paint Brush 模式。此时，图像更改将被保存，由 Asset Processor 重新处理，并在处理完成后重新加载。

Save Mode 确定图像的保存位置。

MacroMaterialData

此结构在发送有关宏材质设置的信息时使用。

TerrainMacroMaterialRequestBus

‘TerrainMacroMaterialRequestBus’ 是一个内部系统总线，仅用于地形渲染和编辑系统与 Terrain Macro Material 组件之间的通信。其他系统通常不需要使用此 EBus，因为 terrain 系统之外的任何内容都不需要来自各个组件实例的任何信息。但是，如果出现使用案例，可以使用“TerrainMacroMaterialRequestBus”事件总线接口上的以下请求函数来查询各个地形宏材质组件。

TerrainMacroMaterialNotificationBus

“TerrainMacroMaterialNotificationBus”是地形渲染和编辑系统使用的内部 EBus，用于监控地形宏材质的更改。其他系统通常不需要使用此 EBus，因为 terrain 系统之外的任何内容都不需要有关单个 Terrain Macro Materials 的任何信息。但是，如果出现使用案例，可以使用“TerrainMacroMaterialNotificationBus”事件总线接口上的以下通知函数来监控地形宏材质更改。

TerrainMacroColorModificationBus

‘TerrainMacroColorModificationBus’ 是地形编辑系统用于修改地形宏材质颜色纹理的内部事件总线。这是一个较低级别的 API，大多数系统应该使用更高级别的 Paint Brush绘画 API 来修改纹理。

TerrainMacroColorModificationNotificationBus

“TerrainMacroColorModificationNotificationBus”是地形编辑系统用于修改地形宏材质颜色纹理的内部事件总线。这是一个较低级别的 API，大多数系统应该使用更高级别的 Paint Brush绘画 API 来修改纹理。