Overview
The shape sampler allows you to sample geometric shapes such as spheres, capsules, cylinders, meshes, and generate points on their surface or volume, retrieve normal, UVs, and various other surface properties.
It can be used either through the shape sampler script functions, or using the template core-library nodes, such as ShapeSample
.
Property | Type | Description |
SampleDimensionality | enum | How the shape should be sampled.
|
ShapeType | enum | Type of shape being sampled.
|
TransformTranslate | bool | Translate the shape according to the specified position property. |
TransformRotate | bool | Rotate the shape according to the specified orientation property. |
Position | float3 | Local shape position. |
Orientation | float3 | Local shape rotation. Those values are euler angles (in degres). |
SPHERE | ||
Radius | float | Sphere radius. |
InnerRadius | float | Sphere inner radius. |
NormalizedInnerRadius | float | Normalized inner radius (InnerRadius / Radius ). |
ELLIPSOID | ||
Radius | float | Ellipsoid radius, same as the sphere radius. |
InnerRadius | float | Ellipsoid inner radius, same as the sphere radius. |
NormalizedInnerRadius | float | Ellipsoid normalized radius, same as the sphere normalized radius. |
Hemisphere | bool | Cut the sphere in half and only keep the top part. |
NonUniformScale | float3 | Scale the sphere on each axis. |
CYLINDER | ||
Radius | float | Cylinder radius. A cylinder with a radius of 0 is a line. |
InnerRadius | float | Cylinder inner radius. |
NormalizedInnerRadius | float | Normalized cylinder inner radius (InnerRadius / Radius ). |
Height | float | Cylinder height. A cylinder with a height of 0 is a disk. |
CAPSULE | ||
Radius | float | Capsule radius. A capsule with a radius of 0 is a line. |
InnerRadius | float | Capsule inner radius. |
NormalizedInnerRadius | float | Normalized capsule inner radius (InnerRadius / Radius ). |
Height | float | Capsule height. A capsule with a height of 0 is a sphere. |
CONE | ||
Radius | float | Cone radius. A cone with a radius of 0 is a line. |
Height | float | Cone height. A cone with a height of 0 is a disk. |
MESH | ||
MeshScale | float3 | Scales the mesh along each axis. |
MeshSamplingMode | enum | How the mesh should be sampled.
|
SubMeshIndex | int | If the mesh asset is composed of multiple submeshes, this property is used to specify which submesh should be sampled. |
DefaultUvStream | int | Index of the per-vertex UV stream that should be sampled by default if the mesh has multiple texture coordinates per-vertex. |
DefaultColorStream | int | Index of the color stream that should be sampled by default if the mesh has multiple colors per-vertex. |
DensityColorStream | int | Used when the MeshSamplingMode is set to Weighted . This is the index of the color stream that should be used as the density value if the mesh has multiple colors per-vertex. |
DensityChannel | enum | Used when the MeshSamplingMode is set to Weighted . This is the color channel that should be used as the density value for the sampling algorithm. |
Output pins | ||
DataGeometry | data | The geometry data that can be plugged in the mesh/shape sampling nodes. |
+ all sampler properties |