resample_strands

Resamples the input strands based on a spatial distance (distance between resampled points) or a constant count (total number of resampled points along the strand). The compound supports spatial distance arrays of per-strand data (2d arrays), arrays of data (1d array), single floats and fields. The compound will also transfer some or all of the properties from the incoming strands to the resmpled strands.

Inputs

strands

The strands you wish to resample.

transfer_properties

This is an expression based list of properties you wish to transfer, for specific properties use a space-separated list:

point_size point_color point_ratio.



To transfer every incoming property, use *.



To exclude a specific property, use !:

* !point_color.



By default this is "*" meaning all supported incoming properties will be transferred. This currently supports float and float3 properties.

resample_mode

The type of resampling to perform:

• Linear performs linear interpolation between points in the original strands.
• Catmull-Rom performs Catmull-Rom interpolation between points in the original strands.

spatial_resample

When this is checked, the strands will be resampled based on distance. Otherwise the strands will be based on a constant count. If the strand length is zero, a 2-point strand will be returned.

Spatial Resample

spatial_distance

The distance between points you with to resample to

distance_per_strand

An interpreted_auto_port that allows the inputting of arrays, per-strand arrays (2d), floats, strings and fields to control your distances.

minimum_resample_distance

This is included as a limit to the distance that can be resampled to. If this value is too small, it may cause processing slow downs and heavier graphs.

Constant Count Resample

constant_count

The number of points in the output strands

count_per_strand

An array of long integers, allowing you to specify a constant count per strand.

Catmull-Rom Resample

end_point_mode

This setting controls the shape of the strands near the endpoints of strands.

• Straight The strands will take a straight line path through the endpoints.
• Curved The strands will follow the curve of the input strands through the endpoints.

tension

Controls the shape of the interpolated curve. Larger values will fit the interpolated points more closely to the input strands.

alpha

Controls the parameterization of the curve. A value of 0 will produce a uniform parameterization. A value of 0.5 will produce a centripetal parameterization. A value of 1 will produce a chordal parameterization.

Outputs

resampled_strands

The resampled strands.