Function physx_sys::PxSerialization_complete
source · pub unsafe extern "C" fn PxSerialization_complete(
collection: *mut PxCollection,
sr: *mut PxSerializationRegistry,
exceptFor: *const PxCollection,
followJoints: bool
)
Expand description
Adds to a collection all objects such that it can be successfully serialized.
A collection C is complete relative to an other collection D if every object required by C is either in C or D.
This function adds objects to a collection, such that it becomes complete with respect to the exceptFor collection.
Completeness is needed for serialization. See [PxSerialization::serializeCollectionToBinary
],
[PxSerialization::serializeCollectionToXml
].
Sdk objects require other sdk object according to the following rules:
- joints require their actors and constraint
- rigid actors require their shapes
- shapes require their material(s) and mesh (triangle mesh, convex mesh or height field), if any
- articulations require their links and joints
- aggregates require their actors
If followJoints is specified another rule is added:
- actors require their joints
Specifying followJoints will make whole jointed actor chains being added to the collection. Following chains is interrupted whenever a object in exceptFor is encountered.