 | Miscellaneous |
This topic contains the following sections:
Multithreading and thread-safetyGeneral notes on thread-safety in the DigitalRune Engine
-
While an update of a "service" is in progress (e.g.
CollisionDomainUpdate,
SimulationUpdate,
GraphicsManagerUpdate,
etc.), the service state must not be read or modified. For example:
- While CollisionDomainUpdate is running, do not use CollisionDomainGetContacts.
- While SimulationUpdate is running, do not add new rigid bodies to SimulationRigidBodies.
- Etc.
- Adding/removing objects to/from collections (e.g. CollisionDomainCollisionObjects, SimulationRigidBodies, IGraphicsServiceScreens, etc.) is not thread-safe and must be synchronized manually.
When in doubt about thread-safety, ask in our Forum. As we learn more about how the DigitalRune users use the API, we will try to improve our documentation.
Thread-safety in DigitalRune Geometry
- Querying ISpatialPartitionTs in parallel is safe (e.g. AabbTreeTGetOverlaps).
- Calling CollisionAlgorithms in parallel is safe (e.g. GetContacts).