polySplitRing node

Go to: Related nodes. Attributes.

        This node handles splitting the polygon object in multiple ways.

Node name	Parents	MFn type	Compatible function sets
polySplitRing	polyModifierWorld	kPolySplitRing	kBase kNamedObject kDependencyNode kMidModifier kPolySplitRing

Attributes (17)

absoluteWeight, direction, divisions, enableProfileCurve, fixQuads, profileCurve, profileCurveInputOffset, profileCurveInputScale, profileCurve_FloatValue, profileCurve_Interp, profileCurve_Position, rootEdge, smoothingAngle, splitType, useEqualMultiplier, useFaceNormalsAtEnds, weight

Long name (short name) Type Default Flags

weight (wt) float 0.5

Weight value controlling the relative positioning of the new points on existing edges. Range is [0.0, 1.0]. Value of 0.1 indicates the new edges will be placed closer to the start vertex of the first edge of the sequence of edges.

absoluteWeight (ab) bool false

The split can either be relative or absolute. If this attribute is false then the weight attribute will be used on all edges in the sequence as the percentage along the edge to do the split. If this attribute is true then the weight attribute is used with the length of the shortest edge in the sequence to determine the distance that the split should occur on all other edges in the sequence.

direction (dr) bool true

This attribute is used when doing an absolute split. If true then the distance is taken from the start vertex of the root edge. If false the distance is taken from the end vertext of the root edge.

rootEdge (re) integer -1

The weight attribute uses the start vertex of this edge to determine where the new split occurs.

smoothingAngle (sma) angle (double) 180.0deg

Angle below which new edges will be smoothed

splitType (stp) enum 1

Format: 0 - Absolute, 1 - Relative, 2 - Multi

divisions (div) integer 2

Number of divisions.

enableProfileCurve (epc) bool true

Enables the use of the profile curve.

profileCurve (p) compound n/a

Curve which can control the profile of the new edges when doing a multisplit.

profileCurve_Position (pp) float 0.0

Position of ramp value on normalized 0-1 scale

profileCurve_FloatValue (pfv) float 0.0

Ramp value at the sibling position

profileCurve_Interp (pi) enum 0

Ramp Interpolation controls the way the intermediate values are calculated. The values are:

None

Linear: The values are interpolated linearly in RGB color space.

Smooth: The values are interpolated along a bell curve, so that each color on the ramp dominates the region around it, then blends quickly to the next color.

Spline: The values are interpolated with a spline curve, taking neighboring indices into account for greater smoothness.

profileCurveInputOffset (pio) float 0.0f

Changes the offset to the multisplit profile curve. eg. if the profile curve values go between 0 and 1 and this value is set to -1 then the profile curves values will be adjusted to go between -1 and 0.

profileCurveInputScale (pis) float 1.0f

Changes the range of values that the profile curve represents. eg. if the profile curve values go between 0 and 1 and this value is set to 2 then the profile curves values will be adjusted to go between 0 and 2.

useFaceNormalsAtEnds (fne) bool true

When doing a multisplit on a set of non-closed edge ring this will toggle the normals at the ends of the split to be calculated as the edge normal or the face normal.

useEqualMultiplier (uem) bool true

Changes how the profile curve effects the offset when doing a multisplit. If true then the verts will be offset the same distance based on the shortest edge being split. If false then each inserted edge loop will be offset a distance relative to the length of the edge that is being split.

fixQuads (fq) bool false

Fixes splits which go across a quad face leaving a 5 and 3 sided faces by splitting from the middle of the new edge to the vertex accross from the edge on the 5 sided face.