In

Points to be prepared

Attribute Set

Optional attribute set to be used as a collection, if the node is set-up that way.

Out

Modified points, with added attributes

Related

• Asset Collection

Table of content

• Properties
  • Scale to Fit
  • Justification
    • From
    • To
  • Variations
  • Distribution Settings
    • Distribution
    • Index Settings
    • Index Safety
  • Output
• Modules
  • Available Asset Collections modules

The Asset Staging exists for many reasons, but primarily to “pre-spawn” assets from an Asset Collection, and modify points according to various rules, in relation to their associated asset.

This is especially useful if you want to have pruning control on overlaps, or require very tight placement rules no matter how the assets have been authored (pivot point location etc)

Properties

Property	Description
Source	Which type of source to use for the asset collection. Can be either Asset for an Asset Collection picker, or Attribute Set, which will reveal a new input pin that accepts an attribute set.
Asset Collection	If Asset is selected as a source, this is the Asset Collection that will be used for staging points. See Available Asset Collections.

When using the Attribute Set source, the node will create a temp, internal Asset Collection from the source attribute set.

While it’s a needed option, keep in mind that using an attribute set prevents access to any asset cached data. As such, all assets from the Attribute Set will be first loaded (asynchronously) in memory in order to compute their bounds; before the node execution can properly start.

Scale to Fit

Scale the spawned asset bounds in order to fit within the host point’ bounds.

Scale to Fit Mode	Which type of scale-to-fit mode is to be applied. None disables this section, Uniform applies the same rule to each individual component, while Individual lets you pick per-component rules.
Scale to Fit (value)	If Asset is selected as a source, this is the Asset Collection that will be used for staging points.

You can use the following rules:

Scale to Fit
	None Disable the scaling rule.
	Fill Scale the asset so it fills the point’ bounds.
	Min Scale the asset so it fits snuggly within the minimum point’ bounds.
	Max Scale the asset so it fits snuggly within the maximum point’ bounds.
	Average Scale the asset so it fits the average of the point’ bounds.

Justification

Offset the spawned asset bounds relative to the host point’ bounds.
Justification is done & tweaked per-component.

From

You can use the following rules for From:

Justify From
	Center Uses the asset bounds’ local center as reference point.
	Min Uses the asset bounds’ min as reference point.
	Max Uses the asset bounds’ max as reference point.
	Pivot Uses the asset pivot as reference point, ignoring bounds.
	Custom Uses a lerped reference point between the asset bounds’ min & max. Value is expected to be in the range 0-1 but isn’t clamped.

To

You can use the following rules for To:

Justify To
	Same Auto-selects the same justification as From, but computed against the point’ bounds.
	Center Uses the point bounds’ local center as reference point.
	Min Uses the point bounds’ min as reference point.
	Max Uses the point bounds’ max as reference point.
	Pivot Uses the point bounds’ pivot, ignoring bounds.
	Custom Uses a lerped reference point between the asset bounds’ min & max. Value is expected to be in the range 0-1 but isn’t clamped.

Variations

When to apply the asset’ variations, if any, as defined in the Source.

At the time of writing, this is not supported for Attribute Set source.

Distribution Settings

Distribution drives how assets are selected within the collection & assigned to points.

Distribution

Index Settings

Index settings offer granular controls over what the Index actually is, and how it is used.

Index Safety

The index safety property controls how invalid/out of bounds input values are handled.

Output

Lets you output the Weight of the selection to each node, using different post-processing methods.
This can be very handy to identify “rare” spawns and preserve them during self-pruning operations.

Modules

Available Asset Collections modules