Chapter 3 · Modifier Properties

3.13Tnpix_Tear

Panel name Tnpix Tear · also reachable as TnpixTear

Tearing by painted region, by stretch or by pressure. On a shared Solver the Solver group's tearBy, threshold, ends and weakness range come from the first member, in creation (handle) order, that has an enabled Tear.

Property Type A Default Range Description

tnEnabled boolean true On/off. Off, the cloth simulates whole.

tearBy integer 0 0 – 2 0 = Map, 1 = Stretch, 2 = Pressure (needs a Tnpix Volume on the same stack).

channelName string "" The painted channel: where the cloth may tear (Map, Pressure) and where it is weaker (all three). Empty under Map or Pressure = nothing tears.

markedAbove float 0.5 0.0 – 1.0 Paint at or above this value belongs to the region.

ends integer 0 0 – 1 0 = both ends of an edge must be marked, 1 = either end is enough.

threshold float 10.0 0.0 – 1,000,000 Map: the pull an edge takes before it opens. Pressure: the bursting pressure. Not used by Stretch. Not converted by the scene's unit.

weakMin float 1.0 0.01 – 10.0 Weakness at the lightest marked paint (multiplies the pull or the stretch).

weakMax float 1.0 0.01 – 10.0 Weakness at full paint.

calibSubsteps integer 0 0 – 100,000 The Solver's Substeps (the panel's number) the threshold was typed at, written by the panel; 0 = not recorded. A label: nothing computes from it.

calibIterations integer 0 0 – 100,000 The Solver iterations the threshold was typed at (see calibSubsteps).

growRings integer 0 0 – 8 Points within this many edges of a painted point count as painted.

stretchRatio float 0.1 0.001 – 100.0 Stretch mode: how much longer an edge may get before it tears, as a part of its length (0.1 = 10 percent).

zoneOn boolean false Active Zone: a point may tear only where the zone reaches it (anywhere inside a helper's Far radius).

zoneHelpers node array empty The Influence Helpers that make the zone. Empty with zoneOn = nothing tears.

zoneStay boolean true Stays active once touched: a point the zone has reached stays able to tear after the zone moves on.

zoneTime boolean false true = the zone works only from zoneFrom to zoneTo.

zoneFrom integer 0 -100,000 – 100,000 First frame the zone works.

zoneTo integer 100 -100,000 – 100,000 Last frame the zone works.

zoneInvert boolean false Invert: a point may tear where the zone does NOT reach (beyond a helper's Near radius), inside the zone's time. With zoneStay, a point the helper has covered never tears. Empty zoneHelpers = every marked point may tear.

Property	Type	Default	Range	Description
`tnEnabled`	boolean	true		On/off. Off, the cloth simulates whole.
`tearBy`	integer	0	0 – 2	0 = Map, 1 = Stretch, 2 = Pressure (needs a Tnpix Volume on the same stack).
`channelName`	string	""		The painted channel: where the cloth may tear (Map, Pressure) and where it is weaker (all three). Empty under Map or Pressure = nothing tears.
`markedAbove`	float	0.5	0.0 – 1.0	Paint at or above this value belongs to the region.
`ends`	integer	0	0 – 1	0 = both ends of an edge must be marked, 1 = either end is enough.
`threshold`	float	10.0	0.0 – 1,000,000	Map: the pull an edge takes before it opens. Pressure: the bursting pressure. Not used by Stretch. Not converted by the scene's unit.
`weakMin`	float	1.0	0.01 – 10.0	Weakness at the lightest marked paint (multiplies the pull or the stretch).
`weakMax`	float	1.0	0.01 – 10.0	Weakness at full paint.
`calibSubsteps`	integer	0	0 – 100,000	The Solver's Substeps (the panel's number) the threshold was typed at, written by the panel; 0 = not recorded. A label: nothing computes from it.
`calibIterations`	integer	0	0 – 100,000	The Solver iterations the threshold was typed at (see `calibSubsteps`).
`growRings`	integer	0	0 – 8	Points within this many edges of a painted point count as painted.
`stretchRatio`	float	0.1	0.001 – 100.0	Stretch mode: how much longer an edge may get before it tears, as a part of its length (0.1 = 10 percent).
`zoneOn`	boolean	false		Active Zone: a point may tear only where the zone reaches it (anywhere inside a helper's Far radius).
`zoneHelpers`	node array	empty		The Influence Helpers that make the zone. Empty with `zoneOn` = nothing tears.
`zoneStay`	boolean	true		Stays active once touched: a point the zone has reached stays able to tear after the zone moves on.
`zoneTime`	boolean	false		true = the zone works only from `zoneFrom` to `zoneTo`.
`zoneFrom`	integer	0	-100,000 – 100,000	First frame the zone works.
`zoneTo`	integer	100	-100,000 – 100,000	Last frame the zone works.
`zoneInvert`	boolean	false		Invert: a point may tear where the zone does NOT reach (beyond a helper's Near radius), inside the zone's time. With `zoneStay`, a point the helper has covered never tears. Empty `zoneHelpers` = every marked point may tear.