By default the plugin will not write to locked Edit Layers and leaves modified Edit Layers unlocked after cooking and baking.

If the attribute unreal_landscape_write_locked_layer is present and set to 1 then the plugin will write to locked layers.

If the attribute unreal_landscape_lock_layer is present and set to 1 then the plugin with lock edited layers after pocessing.

Both attributes can be specified for a single layer.

By default, the Houdini Engine plugin will treat each Output in an HDA is a unique Landscape which will be created. The plugin can also modify existing landscapes. This is controlled by an attribute on each primitive in the HDA Output:

If you set the unreal_landscape_output_mode to 0, it generates a new landscape. Set it to 1 to modify an edit layer on an existing landscape.

The name of the target landscape actor in both modes can be specified with unreal_output_name. When modifying existing landscapes the special name Input<N> can be used to specify that the output will be the <N>th input sent to the HDA; this is particularly useful when using Houdini to modify existing landscapes. The default name is Landscape.

As Unreal uses 16-bits integers for Landscapes and Houdini uses 32-bits floats to represent the height values, the data needs to be converted. This results in a small precision loss when creating Landscape from a Heightfield.

By default, Landscapes generated by Houdini Engine uses 3/4 of the available 16 bits range for conversion. This allows you to sculpt the landscape past its min/max values afterwards in Unreal.

If you would rather use maximum precision for the data conversion, activate the Marshalling Landscapes Use Full Resolution setting in the Geometry Marshalling section. For example, a 4km high landscape will have a precision (on the Z axis) of 8.13 cm by default, or 6.10 cm if that option is activated.

You can also use the default unreal conversion values in the plugin settings, by enabling the Use default Unreal Scaling option in Geometry Marshalling. This likely results in a precision loss during the conversion and may clip the heightfield values if they are too high. This creates a landscape that has a “standard” scale factor on the Z axis.

When converting heightfield data to landscapes, you can specify the min and max values used for the conversion by adding the unreal_landscape_layer_min and unreal_landscape_layer_max float attributes. This works on the height data, but also on any masks that converts to a landscape layer. This is useful when outputing tiled landscapes to ensure that all tiles are converted in the same manner.

Target Layers are converted from Houdini’s 32-bits float to Unreal 8-bits unsigned int. Values are converted from Houdini’s (min, max) to (0, 255) in UE.

By default, Height Field masks converts to weight-blended landscape layers. If you want some of the Height Field masks to be exported to Unreal as non weight-blended layers, you must add a Primitive String attribute to your heightfield named unreal_landscape_layer_nonweightblended. Set this attribute values to the names of the masks separated by spaces (ie: mask water debris).

Alternatively, each heightfield mask can have a Primitive Int attribute named unreal_landscape_layer_noweightblend which can be used to explicitly set the No Weight Blend property to unchecked (0) or checked (1).

Unreal stores target (paint and visibility) layers as 8-bit unsigned values. Houdini Volume layers (masks) are automatically converted to the range Unreal expects and should be in the range 0 to 1.

By default, values outside the range 0 to 1 are clamped. However, setting the attribute unreal_landscape_layer_normalize to 1 on a layer inside Houdini will cause the plugin to normalize the values in the layer to fit in the expected range. Negative values are set to 0.

Unreal Engine requires specific sizes for its landscapes, as they are broken up in sections and components for LOD / optimisation purposes. The recommanded sizes are:

• 8129 x 8129

• 4033 x 4033

• 2017 x 2017

• 1009 x1009

• 505 x 505

• 253 x 253

• 127 x 127

If your heightfield data doesn’t match one of these recommended size, Houdini Engine automatically resamples the data so that the generated landscapes fit the size requirements.

This will likely causes issues due to the unwanted conversion and happens when splitting Height Fields to tiles. Also, using non-standard size results in an excessive amount of components used and causes severe performance degradation. It’s recommended you ensure the generated tiles’s volume size match the sizes recommended by Epic in their Landscape Technical Guide.

Upon cook, the generated landscape’s transform will be automatically set up so that its dimension, altitude, scale and position in Unreal are the same as in Houdini.

When importing a Landscape into Unreal the plugin will automatically choose values for Section Size and Setions Per Component. However these can also be set by using the attributes unreal_landscape_section_size and unreal_landscape_sections_per_component. Both attributes must be set; if only one is set, it will be ignored. If both are set the plugin will not attempt to resize the landscape, the landscape size will be used exactly.

Landscapes can be transformed in Houdini and the Unreal Editor. Landscape actors are transformed relative to their parent actors.

Splitting Height Fields into tiles in Houdini using the Height Field Tile Split SOP node. By default, each Landscape tile imports into UE as a standalone Landscape. Unlike previous versions of the plugin the target of a tile must be a Landscape Actor, not a Landscape Streaming Proxy.

Refer to Output Attributes for more information.