Separate visual mesh

Give an imported Soft Body a detailed visual while physics stays simple. Both models need matching origin, axes, size and readable buffers before freeze(). The visual may have open/decorative parts. Binding uses rest geometry and follows current deformation even when assigned later. Initial physics scale/rotation also applies to the visual.

Example#

if (!soft.set_visual_model(model_visual)) {
    show_debug_message(jolt_get_error());
}
soft.set_renderer(o_control_bbmod_renderer.renderer);

Usage and limits#

set_visual_model(model,max_distance) binds visual points to nearby physics triangles with fixed weights and surface offsets. Default maximum distance is a quarter of the physics bounds diagonal. Invalid binding returns false and preserves the prior visual. set_visual_model(undefined) restores the physics mesh. Imported closed models and imported cloth support this feature.

Visual limits are 32768 split vertices and 32768 triangles; physics remains 4096/8192. UV, material groups and normal splits are retained; normals/tangents are recalculated. Skinning, vertex colors, UV2 and batch IDs are unsupported. Extra visual detail has no extra collision. Binding and native CPU deformation have a cost: do not rebind every Step. Source geometry is unchanged and shared materials must remain valid.

API reference#

Public function and method signatures. Call methods on the returned instance; parameters with defaults are optional.

Related guides#

• Migrating existing code›
• Choosing a Soft Body›
• Soft sphere›
• Volumetric soft box›
• Closed model import›
• Cloth model and named anchors›
• Spatial attachments›
• Local force and impulse›
• Wind›
• Carrying Soft Bodies›

Verified operation contracts#

These contracts distinguish units, return values, errors and lifetime according to the current implementation. Check results: false, 0 and undefined can mean different things for different methods.