Click or drag to resize
DigitalRuneSimulationIsland Class
Describes a collection of rigid bodies and constraints that can be simulated independently.
Inheritance Hierarchy
SystemObject
  DigitalRune.PhysicsSimulationIsland

Namespace: DigitalRune.Physics
Assembly: DigitalRune.Physics (in DigitalRune.Physics.dll) Version: 1.10.0.0 (1.10.0.14427)
Syntax
public sealed class SimulationIsland

The SimulationIsland type exposes the following members.

Methods
  NameDescription
Public methodEquals
Determines whether the specified Object is equal to the current Object.
(Inherited from Object.)
Public methodGetHashCode
Serves as a hash function for a particular type.
(Inherited from Object.)
Public methodGetType
Gets the Type of the current instance.
(Inherited from Object.)
Public methodToString
Returns a string that represents the current object.
(Inherited from Object.)
Top
Properties
  NameDescription
Public propertyConstraints
Gets the constraints of this island.
Public propertyContactConstraints
Gets the contact constraints of this island.
Public propertyRigidBodies
Gets the rigid bodies of this island.
Top
Remarks

In general, it is not needed to deal with simulation islands directly and users can safely ignore this simulation detail.

In each frame the simulation creates different batches of bodies and constraints that can be simulated independently. Such a batch is called simulation island. If rigid bodies can influence each other via constraints (contacts or joints), they are sorted into the same island.

Sleeping: Islands can only sleep as a whole. It is not possible that some bodies in an island are sleeping and others are awake. If one object is awake all objects are awake because the movement of the awake body can propagate to the other bodies. In unfortunate configurations a jittering body can keep a whole island awake.

Static and Kinematic Bodies:Static or Kinematic rigid bodies are not managed in islands. They are not part of another island and they are not in their own island. Islands do only contain Dynamic rigid bodies. (But constraints between dynamic and non-dynamic bodies are managed in the islands.)

See Also