Version:

Vegetation Layer Spawner 组件

使用 Vegetation Layer Spawner 组件来定义区域和规则,以便在 Open 3D Engine (O3DE) 关卡中程序化地放置动态植被或其他静态网格。

使用 Vegetation Layer Spawner (植被图层生成器) 组件,您可以执行以下操作:

有关如何使用 Vegetation Layer Spawner 的信息,请参阅 动态植被

提供者

Vegetation Gem

依赖

在使用 Vegetation Layer Spawner 组件时,添加以下必需的组件:

Vegetation Layer Spawner 属性

Vegetation Layer Spawner component properties

属性说明默认值
Override Preview Settings如果 EnabledPreview Settings 属性确定植被图层预览的形状。 如果 Disabled, 植被图层预览的边界由附加的 Shape 组件设置。BooleanDisabled
Pin Preview to Shape如果 Constrain to ShapeEnabled,则使用具有兼容形状组件的实体作为植被图层预览的边界。

仅当 Override Preview SettingsEnabled 时,此字段才可用。*
EntityIdCurrent Entity
Preview Position设置植被图层预览的世界位置。

仅当 Override Preview SettingsEnabled 并且未在 Pin Preview to Shape 中选择任何实体时,此字段才可用。
Vector3: -Infinity to InfinityX:0.0, Y:0.0, Z:0.0
Preview Size如果 Constrain to Shape 为 ‘Disabled’,则设置植被图层预览的尺寸。

仅当 Override Preview SettingsEnabled时,此字段才可用。
Vector3: 0.0 to InfinityX:1.0, Y:1.0, Z:1.0
Constrain to Shape如果Enabled’,则植被图层预览将使用在 Pin Preview to Shape 中选择的实体的边界。
<br仅当 Override Preview SettingsEnabled 并且在 Pin Preview to Shape 中选择了实体时,此字段才可用。
BooleanDisabled
Layer Priority定义应用植被区域的高级顺序。Background or ForegroundForeground
Sub Priority定义植被区域在图层中的应用顺序。数字越大,优先级越高。0-100000
Inherit Behavior允许父实体的形状、修饰符和过滤器影响此植被图层。BooleanEnabled
Allow Empty Assets允许未指定的资产占用空间并阻止其他植被。BooleanEnabled
Filter Stage定义是在修饰符之前还是之后应用滤镜。PreProcess or PostProcessPreProcess

VegetationSpawnerRequestBus

将以下请求函数与 ‘VegetationSpawnerRequestBus’ 事件总线接口结合使用,以便与游戏中的 Vegetation Layer Spawner 组件进行通信。

方法名称说明参数返回值可脚本化
GetAllowEmptyMeshes如果 Allow Empty Assets 为 ‘Enabled’,则返回 ‘True’。NoneBooleanYes
GetAreaLayer返回植被图层的 Layer PriorityNoneLayer Priority: StringYes
GetAreaPriority返回植被图层的 Sub PriorityNoneSub Priority: IntegerYes
GetAreaProductCount返回在植被图层中生成的植被实例数。NoneCount: IntegerYes
GetFilterStage返回植被图层的 Filter StageNoneFilter Stage: StringYes
GetInheritBehavior如果 Inherit Behavior 为 ‘Enabled’,则返回 ‘True’。NoneBooleanYes
SetAllowEmptyMeshes设置 Allow Empty Assets 属性的值。BooleanNoneYes
SetAreaLayer设置 Layer Priority 属性的值。Layer Priority: StringNoneYes
SetAreaPriority设置 Sub Priority 属性的值。Sub Priority: IntegerNoneYes
SetFilterStage设置 Filter 属性的值。Filter Stage: StringNoneYes
SetInheritBehavior设置 Inherit Behavior 属性的值。BooleanNoneYes