Foliage Editor
This article covers the main aspects of using the Foliage Tools
Last updated
This article covers the main aspects of using the Foliage Tools
Last updated
Foliage Tools is a Land Editor tool designed for automated placement of game entities. The Foliage brush allows for quick and easy creation of realistic and optimized landscape scenes. The brush parameters enable you to configure the brush composition as well as the density, scale, tilt angle, and other characteristics of the entities included in the brush, giving you full control over entity placement when filling a scene.
Main Menu [1]
Brush settings [2]
Foliage List [3]
Properties Window for the selected entity [4]
The Foliage Tools main menu [1] provides basic functions for working with brushes. You can load previously saved brushes, save current settings, or create new brushes based on existing ones.
Load
Load a previously saved brush.
Save
Save the current brush.
Save As
Save the current brush as a new file or create a new brush.
The brush settings [2] determine how the tool will operate when placing entities. You can adjust the brush size, entity placement density, and manage the checkboxes that control whether entities can be placed on various surfaces, providing flexibility and control over scene creation.
Brush File
The file name with a relative path to the brush.
Brush Size
Determines the brush size within the range [0.0-3000.0].
Paint Density
Entity placement density, a general multiplier for each active entity within the range [0.0-1.0].
Landscape
Checkbox controlling permission to place entities on the landscape.
Static Meshes
Checkbox controlling permission to place a foliage on static meshes (for example: grass on buildings)
Foliage
Checkbox controlling permission to place a foliage on other blocking foliage geometry.
The Landscape checkbox is enabled by default. The ability to toggle the Landscape, Static Meshes, and Foliage checkboxes is temporarily disabled.
The Foliage List window [3] contains a list of entities that can be placed in the scene using the loaded brush. The control buttons allow you to add new entities to the list, delete unnecessary ones, and clear the entire list to create a new selection of entities.
Add
Add a new entity to the list.
Delete
Remove an entity from the list.
Clear
Clear a foliage list.
Generate
Generate a foliage list from selected entities.
The Properties window for the selected entity [4] is designed to configure the parameters of the selected entity from the foliage list. These settings allow you to adjust the entity's activity and its behavior when placed in the scene.
This group of parameters controls the entity's activity and specifies the path to the entity file that will be used for placement.
Activate
Checkbox that determines whether the selected entity is active for painting.
Entity
The relative path to the entity file that will be used for painting.
The parameters in the Painting section define the density of entities, the minimum distance between them, and their scale. These parameters provide control over how entities will be placed in the scene.
Density
Determines the density of entity instances during painting.
Radius
The minimum distance between entity instances during painting.
Apply Radius to All
Enables applying the specified radius settings to all entities in the foliage list.
Scale
Determines the random scale of entities within a specified range.
The parameters in the Placement section control the placement of entities in the scene space, including offset, orientation to the surface normal, random rotation and tilt, as well as allowable angles and heights for placement.
Z Offset
Sets random offset along the Z-axis for each entity instance.
Align to Normal
Enables alignment of entity instances to the surface normal.
Align Max Angle
Sets the maximum deviation angle of the entity instance from the normal.
Random Yaw
Determines the random rotation of the entity instance around the vertical axis.
Random Pitch Angle
Determines the random tilt of the entity instance along the X-axis.
Ground Slope Angle
Restricts entity placement to surfaces with a specified slope angle.
Height
Determines the height range within which entities can be placed.
The View settings define the visual parameters of entity instances and are used for fine-tuning the appearance of entities in the scene.
Opacity
Controls the level of entity transparency.
Color
Sets the color of entities in the scene.
