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 |
Instances |
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
|
|
|
Autodesk Softimage v7.5