Surface Instancer#

Overview#

The Surface Instancer extension allows users to replicate mesh prims over the surface of another mesh prim. This can be useful for creating water droplets on a surface, grass, hair, or any number of other examples where you need a variety of randomly placed objects on the surface of another object.

Enable Surface Instancer#

The surface Instancer is an extension and can be loaded by any supported Kit based App in Omniverse.

To enable the extension… #. Locate the Extensions Manager in your app #. Search for Surface Instancer #. Enable the Extension.

Using the Surface Instancer#

_images/ext_surface-instancer_overview.png

Ref#

Option

Result

1

Create Instances
Creates the point instances using the settings designated in the Surface Instancer window.

2

Base Path for Output
Creates Xform(s) in your scene used in your scene to store data used by Surface Instancer.

3

Move Prototype Prims under Instancer
Moves assets used in Instance Operation to the Path described by Base Path for Output

4

Align Z With Normal
Changes the replication orientation to Z up. Unchecked is Y up.

5

Align Orientation to Worldspace Up
Forces alignment to the “world” up rather than the surface normal when instancing.

6

Instances / Mesh
Number of instances created in total by the Instance Operation.

7

Min Distance between Instances
Forces a minimum distance between instances.

8

Distribution Map
Uses the greyscale values of an image to determine density of placement.

9

Add/Remove Instance Mesh
Adds (+) or Removes (-) the selected mesh from Instancing Operation.

10

Prim Path
Show a path to the prim selected.

11

Weight
Distribution Ratio, Higher values increase the chance for selection in Instance Operation.
If the value is shared by 2 or more assets, they are equally likely to be selected during replication.

12

N Min
Denotes minimum surface offset to be used during replication.

13

N Max
Denotes maximum surface offset to be used during replication.

14

Angle Min
Denotes the minimum angle to use as an offset during replication.

15

Angle Max
Denotes the maximum angle to use as an offset during replication.

16

Scale X Min
Denotes the minimum value to use in scaling on the X axis.

17

Scale X Max
Denotes the maximum value to use in scaling on the X axis.

18

Scale Y Min
Denotes the minimum value to use in scaling on the Y axis.

19

Scale Y Max
Denotes the maximum value to use in scaling on the Y axis.

20

Scale Z Min
Denotes the minimum value to use in scaling on the Z axis.

21

Scale Z Max
Denotes the maximum value to use in scaling on the Z axis.

Typical Usage#

Using the Instancer is rather straight forwards.

  1. Enable the extension

  2. In the Stage or Viewport select a prim you wish to replicate.

  3. In the Surface Instancer Panel, Select the Add Instance Mesh.

    • This will add the item to the distribution list.

  4. Optional: Repeat steps 2 and 3 to replicate a variety of assets.

  5. Set the values desired for your replication procedure.

  6. Select the object you want to replicate assets on in either the viewport or the stage.

  7. Press “Create Instances”

The surface should now be adorned with the assets denoted in the distribution list.

Note

Be sure to Zero out the transforms (0,0,0 pos, 0,0,0 rot, 1,1,1 scale) of replicated assets for best results. If objects are not centered/oriented on the world, the offset will be carried through in the replication.

On this page