Foliage Editor

This article covers the main aspects of using the Foliage Tools

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.

Foliage editor interface elements

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.

Brush settings

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.

ParameterDescription

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.

Foliage List

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.

Control ButtonDescription

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.

Properties Window

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.

Base properties

This group of parameters controls the entity's activity and specifies the path to the entity file that will be used for placement.

ParameterDescription

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.

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.

ParameterDescription

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.

Placement

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.

ParameterDescription

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.

View

The View settings define the visual parameters of entity instances and are used for fine-tuning the appearance of entities in the scene.

ParameterDescription

Opacity

Controls the level of entity transparency.

Color

Sets the color of entities in the scene.

Last updated