Utilities

MN_utils_curve_resample

Inputs

Name Type Description Default
Geometry Geometry None
Offset Float 2.3
Length Float 0.36
Field Float Float 0.0
Field Int Int None
Field Vec Vector [0.0, 0.0, 0.0]

Outputs

Name Type Description Default
Geometry Geometry None
Position Vector [0.0, 0.0, 0.0]
Tangent Vector [0.0, 0.0, 0.0]
Normal Vector [0.0, 0.0, 0.0]
Field Float Float 0.0
Field Int Int None
Field Vec Vector [0.0, 0.0, 0.0]

Attribute Remap

Sample an attribute from the mesh and remap from the minimum to the maximum to the specified values

Maps the range of values of the attribute on from the target atoms, to the range from min to max

Inputs

Name Type Description Default
Sample Atoms Geometry None
Attribute String b_factor
Value Min Float 0.2
Value Max Float 3.0

Outputs

Name Type Description Default
Value Float 0.0

Field Remap

Sample a field from the mesh and remap from the minimum to the maximum to the specified values

Maps the range of values of the attribute on from the target atoms, to the range from min to max

Inputs

Name Type Description Default
Sample Atoms Geometry None
Field Float 0.0
Value Min Float 0.2
Value Max Float 3.0

Outputs

Name Type Description Default
Value Float 0.0

Between Integer

Test if an integer is between (and including) the upper and lower bounds

Inputs

Name Type Description Default
Value Int The value to test if it exists within the bounds None
Lower Int The lower bounds for the test None
Upper Int The upper bounds for the test None

Outputs

Name Type Description Default
Boolean Bool Whether the input Value is between (and including) the lower and upper bounds False

Between Float

Test if a float is between the upper and lower bounds

Inputs

Name Type Description Default
Value Float The value to test if it is between the lower and upper bounds 0.0
Lower Float Test if the Value is greater than or equal to this 0.0
Upper Float Test if the Value is less than or equal to this 0.0

Outputs

Name Type Description Default
Boolean Bool Whether the input Value is between (and including) the lower and upper bounds False

Between Vector

Test if a vector is element-wise between the upper and lower bounds.

Inputs

Name Type Description Default
Value Vector [0.0, 0.0, 0.0]
Lower Vector [0.0, 0.0, 0.0]
Upper Vector [0.0, 0.0, 0.0]

Outputs

Name Type Description Default
Boolean Bool False

Vector from Point

Calculate the vector from the current point’s position to the input vector

Inputs

Name Type Description Default
Position Vector Position of the current point Position
Vector Vector Vector that is the target [0.0, 0.0, 0.0]

Outputs

Name Type Description Default
Vector Vector Vector from the current point’s position to the given vector [0.0, 0.0, 0.0]
Normalized Vector Normalized output vector [0.0, 0.0, 0.0]
Length Float Length of the output vector 0.0

Mix Position

Mix the current point’s Position with the input vector. A convenience wrapper around a Mix Vector using Position as the first attribute

Inputs

Name Type Description Default
Position Vector The position vector to mix from Position
Factor Float The amount to mix between the Position (0) and the input vector B (1) 0.5
B Vector The vector to mix to [0.0, 0.0, 0.0]

Outputs

Name Type Description Default
Result Vector The resulting mixed vector, based on the factor [0.0, 0.0, 0.0]

Fractionate Float

Test if a vector is element-wise between the upper and lower bounds.

Inputs

Name Type Description Default
Value Float The value to fractionate 0.0

Outputs

Name Type Description Default
Fraction Float Fractional component of the value, between 0 and 1 0.0
Floor Int The floor of the value; the integer rounded down None
Ceiling Int The ceiling of the value, the integer rounded up None

Scale Transform

Scale the components of a transform individually with between 0 and their value

Inputs

Name Type Description Default
Transform Matrix The Transform to split and scale None
Translation Float Mix the Translation component of the transform with 0 1.0
Rotation Float Mix the Rotation component of the transform with 0 1.0
Scale Float Mix the Scale component of the transform with 0 1.0

Outputs

Name Type Description Default
Transform Matrix The scaled Transform None

Relative Transform

The transform to get from B to A, relative to the CB axis

Inputs

Name Type Description Default
A Vector The final position [0.0, 0.0, 0.0]
B Vector The position moving from [0.0, 0.0, 0.0]
C Vector The position defining the axis of CB [0.0, 0.0, 0.0]

Outputs

Name Type Description Default
Transform Matrix The Transform to move from B to A, relative to the axis of C to B None

Mix Transform

Mix between two transforms, controlling the translation, rotation and scale independently

Inputs

Name Type Description Default
A Matrix None
B Matrix None
Translation Float 0.5
Rotation Float 0.5
Scale Float 0.5

Outputs

Name Type Description Default
Transform Matrix None

Centroid

Calculate the centroid point for the selection for each group in the Group ID. The centroid is the average position of all points in each Group ID. If a selection is given, then only the selected points contribute towards the overall centroid calculation, but the result is still available on the other points in the Group ID

Inputs

Name Type Description Default
Position Vector The Position vector to use for the centroid calculation Position
Selection Bool Selected points contribute to the computation of the centroid, unselected points do not contribute but still return the centroid for their Group ID True
Group ID Int Compute the centroid on for each unique Group ID None

Outputs

Name Type Description Default
Centroid Vector The computed average vector for each Group ID [0.0, 0.0, 0.0]

Vector Angle

Compute the angle in radians between two vectors.

The angle between two vectors, in radians

Inputs

Name Type Description Default
A Vector The first vector for angle calculation [0.0, 0.0, 0.0]
B Vector The second vector for the angle calculation [0.0, 0.0, 0.0]

Outputs

Name Type Description Default
Angle Float The angle between the two vectors in radians 0.0

Dihedral Angle

Computes the angle between two vectors, AB & CD around around the axis of BC. The first vector AB is treated as the “12 O’clock” up position, looking down the axis towards C, with angles being return in the range of (-Pi, Pi). Clockwise angles are positive and anti-clockwise angles are negative.

Inputs

Name Type Description Default
A Vector First vector for the calculation, which draws a line to B [0.0, 0.0, 0.0]
B Vector Second vector for the calculation, which receives a line from A and draws a line to C [0.0, 0.0, 0.0]
C Vector Third vector for the calculation, which receives a line from B and draws a line to D [0.0, 0.0, 0.0]
D Vector Last vector for the calculation, which is the end point of the line from D [0.0, 0.0, 0.0]

Outputs

Name Type Description Default
Angle Float The angle between the vectors AB and CD, when made perpendicular to BC. 0.0
BA⟂(BC) Vector The vector BA when made perpendicular to the axis BC [0.0, 0.0, 0.0]
CD⟂(BC) Vector The Vector CD when makde perpendicular to the axis BC [0.0, 0.0, 0.0]
BC Vector The axis vector BC [0.0, 0.0, 0.0]

3 Point Angle

Calculate the angle between 3 different points. These points are selected based on their index in the point domain, with Index B being the centre of the calculation.

In the video example, the same calculation that is occurring internally inside of the MN_topo_edge_angle node, is being handled explicity by this node. If the Index is being used as Index B then the current point that is being evaluated is the centre of the angle calculation. If this value is changed, then the point at the corresponding index is used, which results in a smaller angle in the example video.

Inputs

Name Type Description Default
Index A Int First of the points for the angle calculation None
Index B Int The middle point for the angle calculation None
Index C Int Last of the points for the angle calculation None

Outputs

Name Type Description Default
Angle Float Angle between the points around Index B in radians 0.0

2 Point Angle

Calculate the angle that two points make, relative to the current point being evaluated. Points are selected based on their index, with the centre of the angle calculation being the current point’s position. Equivalent to using 3-Point angle and using Index as the Index B.

In the example video, the angle calculation is similar to that of the 3-Point Angle node, but the middle point is always the current point.

Inputs

Name Type Description Default
Position Vector The Position vectors to use for the angle calculation Position
Index A Int First end point for the angle calculation around the current point None
Index B Int The Index for the middle point in the angle calculation, defaulting to the current point Index
Index C Int Last end point for the angle calculation around the current point None

Outputs

Name Type Description Default
Angle Float Angle of the line A -> Self -> C in radians 0.0

Point Distance

Calculate the distance and the vector between the evaluating point and the point selected via the Index.

In the example video, each point is calculating a vector and a distance between itself and the indexed point. When the Point Mask node is used, this index is then on a per-group basis, so each point in the group points to just the group’s corresponding point.

Inputs

Name Type Description Default
Index Int Index for the selected point to measure to None

Outputs

Name Type Description Default
Vector Vector Vector from the current point to the indexed point [0.0, 0.0, 0.0]
Distance Float Distance from the current point to the indexed point 0.0