mCloth : Modifier

mCloth Simulation Rollout

<mCloth>.behavior  Integer default: 0; Cloth_behavior

Get/set the state of the "Cloth Behavior" drop-down list.

Possible values are:

0 - Dynamic

1 - Kinematic

<mCloth>.untilframeenable  Boolean default: False; until_frame

Get/set the state of the "Unit Frame" checkbox.

<mCloth>.kinematic_until_frame  Float default: 0

Get/set the value of the "Unit Frame" spinner

<mCloth>.inherit_velocity  Boolean default: False

Get/set the state of the "Inherit Velocity" checkbox.

<mCloth>.enablelivedrag  Boolean default: False; Enable_Live_Drag

Get/set the state of the "Live Drag" checkbutton.

Currently no effect.

Forces Rollout

<mCloth>.do_gravity  Boolean default: True

Get/set the state of the "Use Global Gravity" checkbox.

When set to True, the Gravity settings of the MassFX Dialog will be used.

When set to False, the global Gravity will be ignored.

<mCloth>.forceList  Array default: #()

Get/set the list of Scene Forces to apply to the Cloth simulation.

Capture States Rollout

<mCloth>.showCurrentState  Boolean default: False; Show_Current_State

<mCloth>.showTargetState  Boolean default: False; Show_Target_State

Physical Fabric Properties Rollout

<mCloth>.gravity  Float default: 1.0

Get/set the value of the "Gravity Scale" spinner.

<mCloth>.density  Float default: 50.0

Get/set the value of the "Density" spinner.

<mCloth>.stretchiness  Float default: 0.0; Stretching_Stiffness

Get/set the value of the "Stretchiness" spinner.

<mCloth>.bendiness  Float default: 0.0; Bend_Stiffness

Get/set the value of the "Bendiness" spinner.

<mCloth>.do_bending_ortho  Boolean default: True

Get/set the state of the "Use Ortho Bending" checkbox.

<mCloth>.damping_coefficient  Float default: 0.5; Damping

Get/set the value of the "Damping" spinner.

<mCloth>.friction  Float default: 0.5

Get/set the value of the "Friction" spinner.

<mCloth>.compressions_limit  Float default: 1.0; compression_limit

Get/set the value of the "Compression > Limit" spinner.

<mCloth>.compressions_stiffness  Float default: 1.0; compression_stiffness

Get/set the value of the "Compression > Stiffness" spinner.

Volume Properties Rollout

<mCloth>.do_pressure  Boolean default: False

<mCloth>.pressure  Float default: 0.0

Interaction Rollout

<mCloth>.self_collision  Boolean default: True; enable_self_collision

Get/set the state of the "Self Collisions" checkbox.

<mCloth>.self_thickness  Float default: 0.2; Self_Collision_Thickness

Get/set the value of the "Self Thickness spinner.

<mCloth>.enable_collision  Boolean default: True

Get/set the state of the "Collide To Rigid Objects" checkbox.

<mCloth>.thickness  Float default: 0.01

Get/set the value of the "Thickness" spinner.

<mCloth>.two_way_collision  Boolean default: True; do_two_way_collisions

Get/set the state of the "Push Rigid Objects" checkbox.

<mCloth>.attachToCollide  Boolean default: False; Attach_to_Collide

Get/set the state of the "Attach To Colliders" checkbox.

<mCloth>.attachment_response_coefficient  Float default: 0.2; attachment_response_coeff

Get/set the value of the "Influence" spinner.

<mCloth>.attachment_tear_factor  Float default: 1.5

Get/set the value of the "Detach Past" spinner.

Tearing Rollout

<mCloth>.tearable  Boolean default: False

Get/set the state of the "Allow Tearing" checkbox.

<mCloth>.tear_factor  Float default: 1.5

Get/set the value of the "Tear Past" spinner.

<mCloth>.weldMethod  Integer default: 1; Weld_Method

Get/set the state of the "Weld Prior To Tearing" radio buttons control.

Possible values are:

0 - Vertices

1 - Normals

2 - Don't Weld

Visualize Rollout

<mCloth>.showTension  Boolean default: False; Show_Tension

Get/set the state of the "Tension" checkbox.

<mCloth>.tensionScale  Float default: 1.0; Tension_Scale

Get/set the value of the "Tension" spinner.

Advanced Rollout

<mCloth>.do_hard_stretch_limitation  Boolean default: False

Get/set the state of the "Anti-Stretch" checkbox.

<mCloth>.hard_stretch_limitation  Float default: 1.0

Get/set the value of the "Limit" spinner.

<mCloth>.com_damping  Boolean default: False; do_com_damping

Get/set the state of the "Use COM Damping" checkbox.

<mCloth>.hardware  Boolean default: False; do_hardware_simulation

Get/set the state of the "Hardware Acceleration" checkbox.

<mCloth>.solver_iterations  Integer default: 5

Get/set the value of the "Solver Iter." spinner.

<mCloth>.Hierarchical_Solver_Iterations  Integer default: 2

Get/set the value of the "Hier. Sol. Iter." spinner.

<mCloth>.hierarchical_Levels  Integer default: 0

Get/set the value of the "Hier. Levels" spinner.

Not Exposed To The UI

<mCloth>.cacheFile  String default: undefined; Cache_File

Get/set the cache file name.

<mCloth>.simOnRender  Boolean default: False; Simulate_on_Render

Get/set the simulate on render option. Default is False. When set to True, mCloth simulation can be performed before rendering if necessary.

<mCloth>.do_bending  Boolean default: True

Get/set the state of the Do Bending option. Default is True. When set to False, no bending will be simulated.

<mCloth>.do_damping  Boolean default: True

Get/set the state of the Do Damping option. Default is True. When set to False, no damping will be performed.

<mCloth>.do_untangling  Boolean default: False

Get/set whether to perform untangling. Default is False. When set to True, the mCloth will attempt to untangle.

<mCloth>.do_inter_collision  Boolean default: False

Get/set whether to perform inter-collisions. Default is False. When set to True, the mCloth will calculate inter-collisions.

<mCloth>.do_adhere  Boolean default: False

Get/set the enabled state of the Adhere option. Default is False. When set to True, the cloth will adhere to rigid bodies it collided with.

<mCloth>.min_adhere_velocity  Float default: 1.0

Get/set the minimum adhere velocity.

<mCloth>.do_fluid_collision  Boolean default: False

Get/set the state of the Fluid Collision option. Default is False. When set to True, fluid collisions will be calculated.

<mCloth>.disable_dynamic_ccd  Boolean default: True

Get/set the disabled state of Dynamic Continuous Collision Detection option. Default is True. When set to False, dynamic CCD will be performed.

<mCloth>.collision_response_coefficient  Float default: 1.0

Get/set the Collision Response coefficient. This can be used to scale up and down the response to collisions.

<mCloth>.to_fluid_response_coefficient  Float default: 1.0; to_fluid_response_coeff

Get/set the Collision Response To Fluid coefficient.

<mCloth>.from_fluid_response_coefficient  Float default: 1.0; from_fluid_response_coeff

Get/set the Collision Response From Fluid coefficient.

<mCloth>.is_static  Boolean default: False

Get/set the Static state of the mCloth. Default is false.

<mCloth>.visualization  Boolean default: False

Get/set the enabled state of the Visualization.

<mCloth>.validbounds  Boolean default: False; do_valid_bounds

Get/set whether to validate bounds.

Default Group Properties

<mClothGroup>.useSoftSelection Boolean default: False; Use_Soft_Selection

Get/set the state of the Soft-Selection "Use Soft-Selection" checkbox.

<mClothGroup>.softselUseEdgeDistance Boolean default: False; Use_Edge_Distance

Get/set the state of the Soft-Selection "Edge Distance" checkbox.

<mClothGroup>.softselEdgeDist Integer default: 1; Edge_Distance

Get/set the value of the Soft-Selection "Edge Distance" spinner.

<mClothGroup>.softselAffectBackfacing Boolean default: True; Affect_Backfacing

Get/set the state of the Soft-Selection "Edge Distance" checkbox.

<mClothGroup>.softselFalloff Float default: 20.0; Falloff

Get/set the value of the Soft-Selection "Falloff" spinner.

<mClothGroup>.softselPinch Float default: 0.0; Pinch

Get/set the value of the Soft-Selection "Pinch" spinner.

<mClothGroup>.softselBubble Float default: 0.0; Bubble

Get/set the value of the Soft-Selection "Bubble" spinner.

<mClothGroup>.useTextureMap Boolean default: False; Use_Texture_Map

Get/set the state of the Soft-Selection "Use Texture Map" checkbox.

<mClothGroup>.texture Map default: undefined; TextureMap

Get/set the texture map of the Soft-Selection .

<mClothGroup>.map Integer default: 0; Map_Channel_Type

Get/set the state of the Soft-Selection "Mapping Channel" radio buttons.

Possible values are:

0 - Map

1 - Vertex Color

<mClothGroup>.mapChannel Integer default: 1; Map_Channel

Get/set the value of the Soft-Selection "Map" spinner.

Named Point Group Properties

When a named Point Group is created in the mCloth modifier, it will appear as a property of the mCloth with the same name as the group definition, e.g Group001.

Alternatively, you can use the mClothOps Interface's method <mCloth>.getGroupParamBlock <GroupName> to get the Parameter Block of the Group by name and access its properties.

A Group exposes the following properties:

Interface: mclothOps

Methods:

<paramBlock2><mCloth>.getObjectParamBlock <node>node

<paramBlock2><mCloth>.getGroupParamBlock <string>groupname

<integer><mCloth>.numberVertices <node>node

<void><mCloth>.selectVertices <bitArray>sel <node>node

<bitArray><mCloth>.getSelectedVertices <node>node

<integer><mCloth>.makePointGroup <bitArray>vertex_sel <node>node <string>name

<void><mCloth>.makeConstraint <string>groupname <string>type <node>target_node

<void><mCloth>.initPointgroup <string>groupname

<void><mCloth>.detachPointgroup <string>groupname

<void><mCloth>.deletePointgroup <string>groupname

<void><mCloth>.makeGroupConstraint <string>groupname <string>target_group

<void><mCloth>.simulate <boolean>show_dialog

<void><mCloth>.simulateLocal <integer>stop_condition <float>param <boolean>damped

<void><mCloth>.stopLocalSimulation()

<void><mCloth>.eraseSimulation()

<void><mCloth>.truncateSimulation()

<void><mCloth>.setInitialState <node>node

<void><mCloth>.resetState <node>node

<void><mCloth>.grabState <node>node

<void><mCloth>.delObjectCache <node>node

<void><mCloth>.exportCache <node>node <string>filename

<void><mCloth>.importCache <node>node <string>filename

<void><mCloth>.loadCache <node>node

<void><mCloth>.loadAllCaches()

<void><mCloth>.saveCache <node>node

<void><mCloth>.saveExtraCache <node>node

<void><mCloth>.saveAllCaches()

<void><mCloth>.saveAllExtraCaches()

<fpvalue><mCloth>.getObjectProperty <node>node <string>property

Returns the given node's property value. The second argument specifies the property name as string.

<void><mCloth>.createKeys()

Bakes the simulation to keys.

Future Methods - Currently Missing Implementation

<void><mCloth>.setObjectType <node>node <integer>type <boolean>updateSim

Set the Object Type of the specified node to the integer passed as second argument. If the third argument is True, the simulation will be updated.

<integer><mCloth>.getObjectType <node>node

Get the Object Type as Integer.

<void><mCloth>.setObjectProperty <node>node <string>property <fpvalue by value>value

Set the Object Property with name specified by the second argument in the node given by the first argument to the value provided by the third argument.

<TSTR array><mCloth>.showObjectProperties()

Show the Object Properties of the specified node.

<void><mCloth>.addForceField <node>node

Add Force Field to the specified node.

<void><mCloth>.removeForceField <node>node

Remove Force Field from the specified node.

<void><mCloth>.flagParticles <bitArray>sel

Flag the particles specified by the vertex selection bitarray.

<integer><mCloth>.makeTear <bitArray>vertex_sel <node>node <string>name

Create a Tear using the specified vertex selection bitarray in the node given by the second argument and name the tear using the third argument.   

<void><mCloth>.clearTears <node>node

Clear the Tears definitions in the specified node.