Chapter 3 · Modifier Properties

3.16Tnpix_Soft_Body

Panel name Tnpix Soft Body · also reachable as TnpixSoftBody

Experimental. Turns a closed object into soft flesh, solved in the Solver's own steps; with fibres, a simple muscle. Only activation and tensionPoint take keys. Setting material to 0 - 3 writes that material's numbers, as the panel does.

Property Type A Default Range Description

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

softChannel string "" The painted channel this Soft Body's material covers; "" = the whole object, which lets no pin's point go. Above a Tnpix_Pin or Tnpix_Preserve on the stack, its painted points are let go from them. The panel's Region list writes it.

keepVolume boolean true true = it keeps its volume as it wobbles; false = it squashes like a sponge.

resolution integer 40 8 – 200 Tetrahedra across the object's longest side. Several Soft Bodies on one object: the finest wins.

material integer 1 0 Fat, 1 Jelly, 2 Muscle, 3 Rubber, 4 Custom. 0 - 3 write that material's numbers; a number changed afterwards makes it 4.

stiffness float 5.0 0.01 – 100,000 How firm it is, in kPa: fat 1.5, jelly 5, relaxed muscle 10, rubber 500.

density float 1.02 0.01 – 20.0 How heavy it is for its size, g/cm³ (water is 1).

damping float 0.08 0.0 – 1.0 How fast its wobble dies: 0 never, 1 settles without a wobble.

fibres boolean false true = fibres along the fibre line that pull when it is activated.

fibreStart node undefined The object at the fibre line's start. With fibreEnd both undefined, the line runs along the object's own length; set both or neither. The soft body itself is refused.

fibreEnd node undefined The object at the fibre line's end (see fibreStart).

strength float 300.0 0.0 – 100,000 How hard the fibres pull at full activation, kPa.

maxContraction float 45.0 0.0 – 90.0 How short the fibres can get at full activation, percent of their length.

tendons float 10.0 0.0 – 45.0 How much of each end is tendon, percent of the fibre line.

tendonStiffness float 30.0 1.0 – 1000.0 How many times stiffer the tendons are than the body.

activation float A 0.0 0.0 – 1.0 How hard the fibres work, 0 to 1. Key it to flex the muscle.

autoTension boolean true true = the fibres tense by themselves as the fibre line's ends come closer.

tone float 5.0 0.0 – 50.0 Auto tension: the tension it keeps, percent.

tensionPoint float A 0.5 0.0 – 1.0 Where along the fibre line it tenses most, and bulges: 0 at its start, 1 at its end.

tensionSpread float 0.2 0.0 – 1.0 How wide the tense area is, as a share of the fibre line; 0 = the whole body evenly.

junction float 0.1 0.001 – 0.45 The share of the fibre line over which a tendon turns into the body. No panel control.

relaxedFibre float 0.05 0.0 – 1.0 A relaxed body's own fibres against stretch past their rest, as a share of the fibres' stiffness. No panel control.

Property	Type	A	Default	Range	Description
`tnEnabled`	boolean		true		On/off. Off, the object simulates as cloth.
`softChannel`	string		""		The painted channel this Soft Body's material covers; `""` = the whole object, which lets no pin's point go. Above a `Tnpix_Pin` or `Tnpix_Preserve` on the stack, its painted points are let go from them. The panel's Region list writes it.
`keepVolume`	boolean		true		true = it keeps its volume as it wobbles; false = it squashes like a sponge.
`resolution`	integer		40	8 – 200	Tetrahedra across the object's longest side. Several Soft Bodies on one object: the finest wins.
`material`	integer		1		0 Fat, 1 Jelly, 2 Muscle, 3 Rubber, 4 Custom. 0 - 3 write that material's numbers; a number changed afterwards makes it 4.
`stiffness`	float		5.0	0.01 – 100,000	How firm it is, in kPa: fat 1.5, jelly 5, relaxed muscle 10, rubber 500.
`density`	float		1.02	0.01 – 20.0	How heavy it is for its size, g/cm³ (water is 1).
`damping`	float		0.08	0.0 – 1.0	How fast its wobble dies: 0 never, 1 settles without a wobble.
`fibres`	boolean		false		true = fibres along the fibre line that pull when it is activated.
`fibreStart`	node		undefined		The object at the fibre line's start. With `fibreEnd` both `undefined`, the line runs along the object's own length; set both or neither. The soft body itself is refused.
`fibreEnd`	node		undefined		The object at the fibre line's end (see `fibreStart`).
`strength`	float		300.0	0.0 – 100,000	How hard the fibres pull at full activation, kPa.
`maxContraction`	float		45.0	0.0 – 90.0	How short the fibres can get at full activation, percent of their length.
`tendons`	float		10.0	0.0 – 45.0	How much of each end is tendon, percent of the fibre line.
`tendonStiffness`	float		30.0	1.0 – 1000.0	How many times stiffer the tendons are than the body.
`activation`	float	A	0.0	0.0 – 1.0	How hard the fibres work, 0 to 1. Key it to flex the muscle.
`autoTension`	boolean		true		true = the fibres tense by themselves as the fibre line's ends come closer.
`tone`	float		5.0	0.0 – 50.0	Auto tension: the tension it keeps, percent.
`tensionPoint`	float	A	0.5	0.0 – 1.0	Where along the fibre line it tenses most, and bulges: 0 at its start, 1 at its end.
`tensionSpread`	float		0.2	0.0 – 1.0	How wide the tense area is, as a share of the fibre line; 0 = the whole body evenly.
`junction`	float		0.1	0.001 – 0.45	The share of the fibre line over which a tendon turns into the body. No panel control.
`relaxedFibre`	float		0.05	0.0 – 1.0	A relaxed body's own fibres against stretch past their rest, as a share of the fibres' stiffness. No panel control.