scatter points#

Scatters points on the input geometry with optional curve regions

Installation#

To use this Node, you must enable omni.genproc.core in the Extension Manager.

Inputs#

Name

Type

Description

Default

active

bool

Is the Scatter Points node currently active?

True

exclusive

bool

If this is true, it outputs the point cloud prim and the input bundles, otherwise only the point cloud prim

True

rotations

bool

If this is true, it output the rotations.

True

rotation

float[3]

Rotate the point in x,y,z.

[0, 0, 0]

rotationRandom

float[3]

Randomly rotate the particle in x,y,z along a range.

[0, 0, 0]

scales

bool

If this is true, it output the scales.

True

scale

float[3]

Change the size of the point in x,y,z.

[5, 5, 5]

scaleRandom

float

Randomly change the size of the point in x,y,z.

0.0

objectIndices

bool

If this is true, it output the object indices.

True

objectIndex

int

Object index is valid if you have multiple sources to output. this number corresponds with the order you imported your sources.

0

objectIndexRandom

int

Randomly pick an ‘Object Index’ source in a range.

0

normals

bool

If this is true, it output the object indices.

True

tangents

bool

If this is true, it output the object indices.

True

binormals

bool

If this is true, it output the object indices.

True

debugDraw

bool

False

debugDrawCurveTriangulation

bool

False

playbackEvaluation

bool

If this is true, time for the simulation is from the timeline, not real time.

False

filterUsingCamera

bool

If true, scattered points will be discarded if they are occluded by scattering geometry or are outside the viewing frustum of the provided camera prim.

False

useScatterGeometryAsOcclusionGeometry

bool

If true, prims connected to the ‘prim’ input of this node will also be used to occlude points when filtering using a camera. Otherwise, prims connected to the ‘occlusionPrim’ input will be used.

True

playbackStartFrame

int

If ‘playbackEvaluation’ is true, this is the frame after which the simulation will start.

0

usdTimecode

double

The USD timecode at the current playback point (timeline time ‘*’ timecodes/sec)

0

time

double

Either the running clock or the timeline time or timeline time, depending on playbackEvaluation

0

randomSeed

uint64

0

scatterOnSurface

bool

If this is true, points will be generated on the surface of the input mesh(es).

True

scatterInsideVolume

bool

If this is true, points will be generated inside the input mesh(es).

True

scatterAcrossPoints

bool

If this is true, points will be generated at the vertices of the input mesh(es).

True

numDesiredPoints

int

The number of generated points desired.

100

curveTessellation

int

curve tessellation factor

10

prim

bundle

Mesh geometry to use for point scattering

occlusionPrim

bundle

Geometry to use for occlusion test

cameraPrim

bundle

Camera prim

curvesBundle

bundle

Input curve data

Outputs#

Name

Type

Description

Default

projectedPoints

float[2][]

If a camera prim is provided, this collection will be populated with points projected into the camera’s screen space in the range [-1, 1]. If no camera prim is provided, this will be empty.

[]

bundle

bundle

output bundle of points data