tySplineMesher Modifier

The tySplineMesher modifier can quickly convert huge numbers of splines into geometry, much faster than 3ds Max’s default renderable spline modifier. It is ideal for tySplines objects, but can be assigned to shape objects of any type.

Variation parameters are seeded by both the seed spinner values, and the material ID of the subspline. In order to apply variation between subsplines, ensure the subsplines have different material ID values.


Spline Mesher Rollout

Geometry mode

  • Extrude: extrudes the splines in a specific direction.

  • Mesh: deforms meshes along the length of splines.

  • Straight skeleton: extrudes the splines inward toward their straight skeleton.

  • Trails: creates motion trails behind moving splines.

The number of knots and subsplines in your spline object must not change over time in order for trails mode to generate trail meshes. If the number of sub-elements does change over time, no mesh will be generated.

  • Tube: converts splines into cylindrical meshes.

  • Use raw tySplineCaches: when enabled, if this modifier is directly above a tySplineCache modifier (because it’s on a tyCache object which is loading cached splines), it will efficiently and directly access loaded spline data (ignoring optimization/interpolation values in the tySplineCache modifier.

In order to obey optimization/interpolation settings of an underlying tySplineCache modifier (at the cost of performance), disable this setting.


Extrude Rollout

  • Per-Spline: extrusions will happen on a per-spline basis. No boolean operations will be performed and overlapping splines will have overlapping extrusion geometry.

  • Multi-Spline: prior to any extrusions, splines will be combined using boolean operations and split into non-overlapping groups. No overlapping extrusion geometry should be generated in the result, and nested splines will create holes in the resulting extrusions.

  • Odd, Non-Zero, Positive, Negative: winding order rules which determine which parts of overlapping splines are considered interiors, and how to deal with them.

Settings

  • Amount: the distance to extrude the splines.

  • Multiply by knot radius: controls whether the distance of spline extrusions is affected by knot radius. Knot radius is a custom value passed up the modifier stack by tySplines objects, based on originating particle radii. This option will not work if this modifier is assigned to a default 3ds Max shape.

  • X/Y/Z: the radius of the knot along the given axis will be the multiplier.

  • XYZ: the radius of the longest knot axis will be the multiplier.

  • Multiply by curve along spline: when enabled, spline extrusions will be multiplied by the specified curve value, mapped to the length of each subspline.

  • Segments: the number of segments to generate along the extrusion.

  • Cap start: faces will be generated on the bottom of closed extruded splines.

  • Cap end: faces will be generated at the top of closed extruded splines.

  • Smooth: extruded faces will be assigned smoothing groups.

  • Real-world map size: assigned UVW coordinates will be relative to the size of the extruded mesh.

Direction

  • Shape normal: the direction of the extrusion will be a vector perpendicular to the spline’s flattened knots.

Shape normal mode uses a fast normal calculation method that may not be accurate for splines whose knots do not all lie on a common plane.

  • Vector: the direction of the extrusion will be a user-specified vector.

  • Nearest surface normal: the direction of the extrusion will be the nearest surface normal on the nearest mesh to each input spline knot.

  • Objects: the list of input objects whose distance to spline knots will be measured.

Capping options are not available when “nearest surface normal” direction mode is activated.


Mesh Rollout

  • Mesh list: the list of input meshes that will be randomly selected and extruded along input splines.

Mesh distribution

  • Random (mat ID is seed): when this mode is selected, meshes will be chosen for a spline at random, by using the material ID assigned to the spline as the random seed.

  • Uniform (mat ID is index): when this mode is selected, meshes will be chosen for a spline in order, using the material ID assigned to the spline as the specified index. For example, a spline with a material ID of 3 will be assigned the 3rd mesh in the list. Index values will wrap around if they are greater than the total number of meshes in the list.

Stretch mode

  • Mesh bounds: the “stretch” parameter in the Spline Mesher rollout will act as a multiplier on the bounds of the input mesh. A value of 100 will stretch the input mesh to its default length.

  • Spline length: the “stretch” parameter in the Spline Mesher rollout will act as a multiplier on the length of the input spline. A value of 100 will stretch the input mesh to the length of the spline.

Mesh repeater
  • No repetition: mesh will be stretched along spline a single time.

  • Repeat to fit: mesh will be stretched along spline the optimal number of times, given the spline’s length divided by its length.

  • Repeat N times: mesh will be stretched the specified number of times along spline.

Offset along spline

Applies an offset to the input mesh’s position along the length of the spline.

  • Percent: the mesh will be offset by a percentage of the spline’s overall length.

  • Distance: the mesh will be offset by an absolute value along the spline’s overall length.

  • Variation %: the per-particle percentage of variation to apply.

Axis

  • X/Y/Z: the axis used to orient the input mesh along the spline.

  • Flip: flips the orientation axis.

  • Center pivot: input meshes will be deformed along their center, rather than their default pivot.

Material ID

  • Inherit Material ID: input meshes will inherit the material ID of their spline.

Uniqueness

  • Seed: the seed value for all varied parameters.


Straight Skeleton Settings Rollout

  • Limit inset: when enabled, the distance the spline will be extruded towards its straight skeleton will be limited to this value.

  • Variation %: the per-particle percentage of variation to apply.
  • Height: the distance along the spline’s normal to extrude faces towards the straight skeleton.

  • Slope %: the extrusion height for any given vertex will be equal to the distance between it and its originating spline edge, multiplied by this value.

  • Variation %: the per-particle percentage of variation to apply.
  • Mat ID: the material ID to assign to generated faces.

  • UVW scale: a scale multiplier to apply to generated UVW coordinates.

Uniqueness

  • Seed: the seed value for all varied parameters.

Gables

  • Preserve gables: when enabled, edges matching the specified gable thresholds will be extruded upwards, rather than along their slope.

  • Min/Max length: edges will be marked for gable extrusions when their length is between these threshold values.

  • Corner thresh: edges adjacent to candidate gable edges must be angled 90 degrees (+/- this corner threshold value) to be marked for gable extrusions.

  • Mat ID: the material ID to assign to the front of gable faces.


Mesh/Tube Settings Rollout

  • Stretch %: controls the maximum percent along splines to stretch geometry. Animating this value allows you to animate the length of an extrusion along the spline.

  • Squash: squashes the extrusion along a vector that is perpendicular to each spline segment.

  • Offset: offsets the extrusion along a vector that is perpendicular to each spline segment.

  • Rotation: rotates the extrusion along each spline segment’s local axis.

  • Rotation offset: controls the starting point along the spline after which rotation values will take effect.

  • Twist: controls the amount of twist that will be applied to successive geometry cross sections along the length of the spline.

  • Twist offset: controls the starting point along the spline after which twist values will take effect.

  • Normalize twist: controls whether the amount of twist applied is dependent on the length of the spline.

  • Reverse: controls whether the ordering of knots along a spline is reversed.

Orientation

  • From spline: the orientation of geometry cross sections along the spline will be dynamically determined by the spline’s topology.

  • Sharp mitering: the corners of spline segments will be mitered in a way that attempts to maintain the angle between the segments.

  • From knots: the orientation of geometry cross sections along the spline will be determined by its knots. This option will not work if this modifier is assigned to a default 3ds max shape.

  • Forward X/Y/Z: controls which axis of the source TM will be the forward vector of the orientation matrix.

  • Up enabled/X/Y/Z: controls whether the up axis of the orientation matrix will be overridden with a specified axis of the source TM.

Radius Rollout

  • Radius: controls the overall radius of spline extrusions.

  • Multiply by knot radius: controls whether the radius of spline extrusions is affected by knot radius. Knot radius is a custom value passed up the modifier stack by tySplines objects, based on originating particle radii. This option will not work if this modifier is assigned to a default 3ds Max shape.

Knot Radius
  • X/Y/Z: the radius of the knot along the given axis will be the multiplier.

  • XYZ: the radius of the longest knot axis will be the multiplier.

Variable radius

  • Multiply radius by length: controls whether the radius of spline extrusions will be affected by the overall length of each spline.

  • Length threshold: controls the reference length that each spline length will be compared against, when determining how to multiply its extrusion radii.

  • Min mult: the minimum multiplier value for extrusion radii. Increase this value to prevent variable-radius spline extrusions from becoming too thin.

  • Max mult: the maximum multiplier value for extrusion radii. Decrease this value to prevent variable-radius spline extrusions from becoming too thick.

  • Invert: inverts the variable-radius operation.

Taper

  • Taper by overall length: the overall length of the spline will determine the taper interpolation.

  • Taper from start: the taper will start from the specified min distance from the start of the spline, and be interpolated up to the specified max distance from the start of the spline.

  • Taper from end: the taper will start from the specified min distance from the end of the spline, and be interpolated up to the specified max distance from the end of the spline.

  • Min/max: the minimum/maximum length along the spline along which the taper will be interpolated.

  • Taper by age: the age of the knots will determine the taper interpolation.

  • Linear: linear taper is a radius multiplier applied evenly along the spline.

  • Curve: curve taper is a radius multiplier applied by projecting a curve along the spline.

  • Amount: the amount of linear taper to apply.

  • X/Y/XY: controls the taper axis.

  • Symmetrical taper: enabling this option tapers splines from the center outwards, instead of from end-to-end.

  • Taper closed splines: when enabled, closed splines will be tapered. When disabled, only open splines will be tapered.


Trails Rollout

  • Duration: the number of frames that the trails will lag behind the splines.

  • Steps: the number of times to sample the splines each frame. Higher values increase the smoothless of the trail.

  • Vel. cutoff: the minimum velocity a spline must have in order to generate a trail over a particular frame interval.

  • Vel. thresh: trail lengths will be multiplied by their spline’s velocity (after cutoff is applied) divided by this value. Increasing this value means splines will have to move faster in order to generate longer trails.

  • Cull static samples: when enabled, mesh samples with no velocity will not contribute to the overall trail mesh. Disable this settings to prevent topology changes between static and dynamic frames on a mesh with static topology.

  • UVW channel: the map channel where trail UVWs will be saved. Mapping coordinates taken from source splines in other channels will be preserved.

  • Anchor UVWs: when selected, the length of trail UVW U-values will be independent of trail length (instead, relative to a specified length threshold).

  • Thresh: the explicit length that trail UVW U-values will be relative to.

  • Stretch UVWs: when selected, trail UVW U-values will span the relative length of the trail.

  • Normalize: when enabled, trail UVW values will be evenly spread along the length/width of the trail. When disabled, trail UVW values will be relative to the placement of the spline knots and time samples of the trail, resulting in more distortion/stretching.


Tube Rollout

Sides

  • Default: the default number of side faces created around a spline extrusion. Increasing this value increases the resulting mesh resolution.

  • Render: enabling this override allows you to control the number of side faces created around a spline extrusion at render time.

Materials

  • Override side matID: controls whether side faces will receive a custom material ID.

  • Side ID: controls the material ID value for side faces.

  • Override cap matID: controls whether cap faces will receive a custom material ID.

  • Cap ID: controls the material ID value for cap faces.


  • Cap ends: controls whether the ends of an extrusion are capped with faces.

UV Coordinates Rollout

  • Assign UVs: (mesh mode only) controls whether UV overrides will be applied.

  • Normalize UVs: controls whether UVW coordinates assigned to a vertex are relative to that vertex’s location along the spline.

If “normalize UVs” is enabled, texture vertex V-coordinates will have a value between 0.0 and 1.0, depending on how far along each spline they are. If “normalize UVs” is disabled, texture vertex V-coordinates will have a value relative to the number of edge segments along the subspline they are. For example, in “Tube” mode a vertex placed along the spline at the 6th edge segment will have a V-coordinate value of 6.0.

  • Map channel: (mesh mode only) controls the mapping channel that UV overrides will be applied to.

U Coordinates

U Coordinate settings are only available in “Tube” mode.

  • Multiplier: a multiplier applied to U coordinate values.

  • Variation %: the per-particle percentage of variation to apply.
  • Offset: an overall offset applied to U coordinate values.

  • Variation %: the per-particle percentage of variation to apply.

V Coordinates

  • Multiplier: a multiplier applied to V coordinate values.

  • Variation %: the per-particle percentage of variation to apply.
  • Offset: an overall offset applied to V coordinate values.

  • Variation %: the per-particle percentage of variation to apply.
  • Seed: the value which will seed the various randomization functions.