Positions Provider

Mesh2D

Generates a mesh of random points on a 2D plane. You can set the points’ Y value.

Parameters:

PointGenerator

Generates a random point distribution in space.

Parameters:

Mesh3D

Generates a mesh of random points in 3D space.

Parameters:

List

Allows you to manually define a static list of positions in world coordinates.

Parameters:

Anchor

Anchors the origin of the child Positions field to the contextual Anchor, if one exists. For a contextual Anchor to exist, a parent of this node must produce an Anchor.

You can also reverse the effect later down the line to move the origin back to the world’s origin like in the screenshot below.

Parameters:

Sphere

Masks out the positions that are farther than the provided range from its origin.

Parameters:

FieldFunction

Enables masking out positions using Density. The delimiters determine the regions of the Density field where positions are kept.

Parameters:

Occurrence

Discards a percentage of input positions based on a Density field. The value of the Density field at each position determines the chance that position has to be kept.;

• Positions where the Density value is below or equal to 0.0 have a 0% chance of being kept.
• Positions where the Density value is above or equal to 1.0 have a 100% chance of being kept.
• Positions where the Density value is between 0.0 and 1.0 have a proportional percentage chance of being kept. Example: 0.4 -> 40%.

Below is a picture that shows a simple noise field used to create regions with rare oak trees and regions with dense oak trees.

Parameters:

Offset

Offsets the positions by the provided vector.

Parameters:

BaseHeight

Vertically offsets the Positions inside the configured vertical region by the amount of blocks determined by the BaseHeight . All Positions outside the region are discarded.

A typical application of this would be to grab Positions at Y:0, and offset them up by the BaseHeight to come closer to a terrain feature. Further adjustments can then be made using an Offset PositionsProvider. The diagram below illustrates that.

Parameters:

Union

Combines all the positions into a single Positioins field.

Parameters:

SimpleHoritontal

Keeps only the positions that are within the provided range.

Parameters:

Cache

Caches the output provided by the Positions slot to improve performance in certain situations. This asset can be useful to improve performance when a Positions asset is expensive and queried numerous times.

How effective this Cache is depended heavily on the use case, the provided child Positions asset and the order in which it is queried. You can get the best performance out of this Cache asset by trial and error. An example of a good use-case for this asset is at the root of an expensive Positions tree used by a Positions2D/Positions3D Density node.

I recommend that you don’t use this cache everywhere in your Positions trees but rather choose a great place at (or close to) the root of your Positions asset tree. That said, feel free to experiment.

This cache functions by saving 3D sections of space containing the Positions (points) generated by the child slot. The sections are cubes, and their size is determined by the asset’s SectionSize parameter. The number of sections allowed to be saved in the cache is determined by the CacheSize asset parameter. A safe starting value for the SectionSize parameter would be 32, and a safe starting value for the CacheSize would be 50.

Parameters:

Imported

Imports an exported PositionProvider.