利用者:Sculptorjim/Game Engine/Physics/Objects/Soft Bodyのソースを表示

{{Page/Header|}}

= Soft Body Physics Object Type =

The most advanced type of object in the [[Doc:2.6/Manual/Game_Engine|Game Engine]]. Also, it is the most finicky. If you are used to the fun experimentation that comes from playing around with the non-BGE Soft Body sims (such as Cloth), you will probably find a frustrating lack of options and exciting results. Do not despair, we are here to help you get some reasonable settings.

Your setup will involve making sure you have sufficient geometry in the Soft Body's mesh to support the deformation, as well as tweaking the options.

In the example game demo, [[Doc:2.6/Tutorials/Frijoles|Frijoles]], the Soft Body type is represented by the decorative checkered flag at the top of the level.

For more documentation, see the [[User:Sculptorjim/Game_Engine/Physics|Top BGE Physics page]].

= Options =

{{User:Sculptorjim/Game_Engine/Physics/CommonOptions}}
{{User:Sculptorjim/Game_Engine/Physics/MassOption}}

* {{Literal|Shape Match}} - Upon starting the Game Engine this will record the starting shape of the mesh as the "lowest energy" state. This means that the edges will have tension whenever they are flexed to some other form. This is set to on by default, and in this configuration turns the object into more of a thin sheet of metal rather than a cloth.
** Demo: [[Media:BGE-Physics-Objects-SoftBodies_ShapeMatchAndLinearStiffness.blend|BGE-Physics-Objects-SoftBodies_ShapeMatchAndLinearStiffness.blend]]
** Default: On.
** Code effect: When on, it will call <code>[http://www.continuousphysics.com/Bullet/BulletFull/btSoftBody_8cpp_source.html#l00626 btSoftBody::setPose(false,true)]</code>
** Python property: <code>obj.game.soft_body.use_shape_match</code>
** Suboption: {{Literal|Threshold}} - [http://www.continuousphysics.com/Bullet/BulletFull/btSoftBody_8cpp_source.html#l01566 Linearly scales the pose match] 
*** A threshold of 1.0 makes it behave like {{Literal|Shape Match}} on with a {{Literal|Linear Stiffness}} of 1.0. 
*** A threshold of 0.0 makes it behave like {{Literal|Shape Match}} off with a {{Literal|Linear Stiffness}} of 0.0.
*** Range: 0-1.
*** Default: 0.5.
*** Code effect: Sets [http://www.continuousphysics.com/Bullet/BulletFull/structbtSoftBody_1_1Config.html#a8e9d39cceaf15fd8697b2f8831b2fee1 btSoftBody::Config::kMT].
*** Python property: <code>obj.game.soft_body.shape_threshold</code>
* {{Literal|Welding}} - <span style="color: #E7007A">[Note: Seems to not be hooked up. Blender will tell Bullet to weld any time you enable Soft Body. Look at [https://svn.blender.org/svnroot/bf-blender/trunk/blender/source/gameengine/Converter/BL_BlenderDataConversion.cpp BL_BlenderDataConversion.cpp] where <code>objprop.m_soft_welding</code>is hard-coded to 0.0f]
* {{Literal|Position Iteration}} - Increase the accuracy at a linearly-increasing expense of time. The effect is visible especially with Soft Bodies that fall on sharp corners, though this can slow down even very simple scenes.
** Demo: A situation where only the max setting of 10 works correctly: [[Media:BGE-Physics-Objects-SoftBodies_PositionIterations.blend|BGE-Physics-Objects-SoftBodies_PositionIterations.blend]].
** Range: 0-10.
** Default: 2.
** Code effect: Represents the number of times [http://www.continuousphysics.com/Bullet/BulletFull/btSoftBody_8cpp_source.html#l01627 this loop] is run.
** Python property: <code>obj.game.soft_body.location_iterations</code>
* {{Literal|Linear Stiffness}} - Linear stiffness of the soft body links. This is most evident when you have {{Literal|Shape Match}} off, but it is also evident with it on.
** Demo: [[Media:BGE-Physics-Objects-SoftBodies_ShapeMatchAndLinearStiffness.blend|BGE-Physics-Objects-SoftBodies_ShapeMatchAndLinearStiffness.blend]]
** Range: 0-1.
** Default: 0.5.
** Python property: <code>obj.game.soft_body.linear_stiffness</code>
* {{Literal|Friction}} - Dynamic friction coefficient. <span style="color: #E7007A">TODO: Learn/demo/explain.</span>
** Code effect: Sets [http://www.continuousphysics.com/Bullet/BulletFull/btSoftBodyInternals_8h.html btSoftBody::Config::kMT], which, for Soft Bodies, defines the minimum friction versus the Material Friction (which in turn defaults to 0.5). 
** Range: 0-1.
** Default: 0.2.
** Python property: <code>obj.game.soft_body.dynamic_friction</code>
* {{Literal|Margin}} - Small value makes the algorithm unstable. <span style="color: #E7007A">TODO: Learn/demo/explain.</span>
** Range: 0.01-1.
** Default: 0.01.
** Python property: <code>obj.game.soft_body.collision_margin</code>
* {{Literal|Bending Constraint}} - Enable Bending Constraints <span style="color: #E7007A">TODO: Learn/demo/explain.</span>
** Default: On.
** Python property: <code>obj.game.soft_body.use_bending_constraints</code>
* {{Literal|Cluster Collision}} - Affects Collision sensors as well as physics.
** Demo: [[Media:BGE-Physics-Objects-SoftBodies_ClusterRigidToSoftBody.blend|BGE-Physics-Objects-SoftBodies_ClusterRigidToSoftBody.blend]] for a demonstration of the effect on the [[User:Sculptorjim/Game_Engine/Logic/Sensors/Collision|Collision Sensor]]. There you will observe the "Rigid to Soft Body" off, then on with Iterations of 1, 64, and 128. The Off and Iterations: 1 cases do not register collisions, and the other two do (though they send their poor Cubes flying into space).
** Demo of badness: [[Media:Manual-BGE-Physics-SoftBody_BadClusterCollisions.blend‎|Manual-BGE-Physics-SoftBody_BadClusterCollisions.blend‎]] - four different ways of making misconfigured Soft Body objects. 
** Suboption: {{Literal|Rigid to Soft Body}} - Enable cluster collisions between Rigid and Soft Bodies.
*** Default: Off.
*** Python property: <code>obj.game.soft_body.use_cluster_rigid_to_softbody</code>
** Suboption: {{Literal|Soft to Soft Body}} - Enable cluster collisions among Soft Bodies.
*** Default: Off.
*** Python property: <code>obj.game.soft_body.use_cluster_soft_to_softbody</code>
** Suboption: {{Literal|Iterations}} - Number of cluster iterations.
*** Range: 1-128.
*** Default: 64.
*** Python property: <code>obj.game.soft_body.cluster_iterations</code>

= Hints =

* A very important configurable in the case of Soft Body interactions is {{Menu|[[User:Sculptorjim/Game_Engine/Physics/World|World properties]]|Physics|Physics Steps|Substeps}}. In the test .blend here: [[Media:Manual-BGE-Physics-SoftBody_PhysicsSteps.blend|Manual-BGE-Physics-SoftBody_PhysicsSteps.blend]], you can see the behavior at various Substep levels:
*# The default level. The Grid object goes straight through the cube, hardly slowing down at all.
*# The Grid slows upon hitting the Cube's top face, and stops fully on the bottom face.
*# The Grid stops at the top face, but two opposite Cube corners are visible.
*# ...no perceptible difference.
*# Finally a working sim. This is good, because it is the maximum step level.
* Surprisingly, the more vertices you have in your hit object, the less likely the Soft Body is to react with it. If you try letting it hit a Plane, it might stop, but a subdivided Grid might fail.

= Goal Weights =

TODO: http://www.blender.org/documentation/blender_python_api_2_62_release/bpy.ops.curve.html#bpy.ops.curve.spline_weight_set

= Force Fields =

A common practice within the non-BGE Cloth simulator is to employ [[Doc:2.6/Manual/Physics/Force_Fields|Force Fields]] to animate the cloth.

These do not work in the BGE, so you will have to figure out a way to use Python (or perhaps plain Logic Bricks) to apply forces to the Soft Body objects.

= All Types =

{{User:Sculptorjim/Game_Engine/Physics/AllTypes}}


[[Category:Game_Engine]]
[[Category:Physics]]

{{Page/Footer|}}