GetGeometrySampl eNode

Associated Parameters: GetGeometrySampleNode

Introduced

7.0

UI Location

• Geometry Queries

Description

Outputs one random location on a geometry for each element in the set. This node is similar to GenerateSampleSetNode, which generates a set of random locations based on its rate value and typically connects to an AddPointNode. However, this node generates exactly one location for each set element. For example, if we're storing the location generated on each point of a point cloud, the number of locations generated will be the number of points in the point cloud.

In addition, you can also narrow from where the locations on polygon mesh geometries will be emitted by using the Filter attribute. If the emission type is set to "Surface", you can specify a portion of the surface; if the emission type is set to "Point", you can specify the points.

The syntax of this filter is the same as that of the GetDataNode when you use it to evaluate attributes at some locations. The current types supported for the attribute are: boolean, integer and scalar.

Integer and scalar values are clamped to a minimum of 0 and a maximum of 1. A value of 0 (or false for boolean) means the corresponding vertex or triangle is discarded from the definition of the area of emission. Scalar values between 0 and 1 are used as weights when the emission type is set to Surface: a triangle will emit N% of the locations it would normally emit where N is equal to the weight of the triangle multiply by 100.

The current attribute contexts supported when emitting from a surface are:

- vertex: in the case of surface emission the weight of a triangle is the average of the weights of its three vertices.

- polygon: in the case of surface emission the weight of a triangle is the value of the attribute at the center of the triangle.

- polynode: in the case of surface emission the weight of a triangle is the average of the weights of its three polynodes.

There is another parameter that can be used with the Filter attribute:

- Invert ("invertfilter"): when this parameter is set the actual filter will be 1 - the value of the attribute.

Parameters

Parameter Name | Scripting Name | Type | Description
Emission Type | emissiontype | Integer | Possible Values: • 0: Point • 1: Surface • 2: Volume
Reference | reference | String | Full Name
Invert | invertfilter | Bool |

Port Description

Inputs

Group ID | Instance s | Port Name | Connection Info | Description
0 | 1 | seed | • Type: siICENodeDataLong • Structure: siICENodeStructureSingle • Context: siICENodeContextSingleton | Identifies the random number sequence used for generating the locations. The seed allows two Generate Sample Set nodes to return different sets of locations by setting a different seed on each.
timevarying | • Type: siICENodeDataBool • Structure: siICENodeStructureSingle • Context: siICENodeContextSingleton | Determines if we want to generate a different locations at each frame.
geometry | • Type: siICENodeDataGeometry • Structure: siICENodeStructureSingle • Context: siICENodeContextSingleton | The geometry on which the locations are generated. Note: The Emission Type ("emissiontype") parameter allows you to specify whether the locations are on the surface, in the volume or on each point.

Outputs

Port Name | Connection Info | Description
samples | • Type: siICENodeDataLocation • Structure: siICENodeStructureSingle • Context: siICENodeContextAny | The locations generated.

See Also

BasicCollideNode | GenerateSampleSetNode | GetClosestLocationNode | GetClosestPointsNode
GroupGeometryNode | IsOnGeometryNode | PointInVolumeNode | RaycastNode
UndefinedLocationNode | UVToLocationNode |  |

Autodesk Softimage v7.5