Breakable bonds

From The DarkMod Wiki
Jump to navigationJump to search

Things to remember:

This article represents work-in-progress and does not necessarily reflect the current working state of the code!

Introduction

This article deals with details in regarding of breaking the connection between bound objects in the physics simulation. For breaking/destroying single objects, please see the article about breakable objects.

Breaking Bonds (Unbinding)

It is possible to bind entities together via the spawnarg bind.

The bound entity is called "slave" (or bindslave), while the entity it is bound to is usually called "master (or "bindmaster").

Binding means that the relative position of the slave to the master will stay the same. Forces that act on either the slave or the master are relayed to the other entity, making them act as if they were one unit.

When the force acting on one of the bind-members becomes to strong, the bind should break up.

TODO

This is currently never the case.

Forces acting on bound entities

To simplify the explanations, we consider here only 2D-forces. The third dimension can then be easily added by using an impulse 3D vector.

Note: Any 2D vector (f.i. a force) can be represented by 2 (related) vectors (forces) acting along the X and Y-axis.

In the following scenario, a bar (slave) is bound to a plate (master). The force F (blue) is here show as two forces FX and FY, acting on this slave. Depending on the strength of the attachment and the force, the two objects would then become unbound.

Attachment Strength

In reality, the attachment can be of variable strength, depending on how exactly the objects are attached to each other. This can be glue of varying strengths, or one ore more nails etc.

There are two extreme cases:

  1. The first case is no attachment at all, this means the bar is just standing on the plate. This scenario is already implemented in the normal physics engine.
  2. The other extreme is an unlimited strength of the attachment, this is currently the default case for objects that are bound to each other. In this scenary, the two objects never become seperated.


Let's first consider the scenario of a free-standing body. The force F that is needed to topple a body is defined as shown on the right:

Notes:

  • We assume here objects of equally-distributed mass, e.g. the density of each of the parts is the same for the entire part. This is the default in Doom3, anyway. If really necessary, we could always simulate a part with unequally distributed density by binding two different objects together.
  • Only the force acting along the X axis is considered. Any force along the Y axis would make the bind either stronger or weaker, depending on it's direction (up or downwards in this drawing).
  • A higher F translates thus into a more stable object.


We can consider two bound objects by simple assuming that there is an additional force FB that binds the two objects together. The stronger this force becomes, the higher F needs to be to "topple" the object over, e.g. break the bond.

Since the gravity always acts in the same direction, the bind strength becomes dependend on the orientation of the two objects as shown on the right. If the binding force FB is smaller than G, the lower object would simply fall off.

The force that binds two objects does not only depend on the mass (due to gravity), but on the size of the contact face, and on the strength of the contact (consider glue vs. nails). We simulate this by setting different bind_force arguments for each joint:

Torque

Forces acting on a joint also create torsion. If the torsion is bigger than a certain amount, the bind should also break up. This simulates shearing off the bound entity.

Compression

When the force acting on the joint lies actually in the direction of the binding force, the bond would not break up, as the acting force will just reinforce the joint. However, in reality there is a limit on how much force the connection can carry, and this is more or less related to the strength of the component carrying the load. In the image to the right, the compression force is acting on the part between the ground and the upper part.

TODO

  • Define a maximum force that the part can carry, before it gets destroyed.

Pivotpoints/Joints

The bind_force applies at a certain point, the pivot point. Here is an example showing different situations and the different pivot points:

In these cases it would be possible to automatically calculate the position of the pivot point, namely if the bind slave and the bind master have one common contact face.


However, in the following cases there is either no contact face (the entities are not touching each other) or more than one contact face. This means the pivot point would have to be set manually:

Multiple joints

It is not enough to have one possible bind/joint per object, as the following graphic shows:

In the first case on the left, there are four objects and four joints, such that each object can be bound to exactly on other object.

But by adding one more object, we need now more joints than we have objects, making it nec. that at least one object has more than one bind-partner.

Relaying forces

Forces/impulses acting on one object need to relayed to each bind partner, through the pivot points. At this point the force needs to be dampened (to simulate stiff joints and friction).

TODO

Currently, the impulse is always relayed to the single bind master.

The incoming forces/impulses need also be relayed back from the bind master to the bind slave.

TODO

Currently, the impulse is only relayed in one direction.

Sumary

To evaluate whether two bound objects should separate, we need to consider the following forces:

  • G - Depends on the mass of the slave
  • FA - the acting force on the slave
  • FB - the force that binds the two objects together

To define the bind strength in all three dimensions, it must be a vector. This allows us to enforce a stronger bind in one direction than in the others.

We then simple add together G and FA and check that each component of FA is smaller than the respective component of FB. If any component is bigger, we consider the bound to be broken and unbind the objects:

  • Unbind if G + FA < FB

See also