Serialized how to#
Serialized manual#
Serialized code#

PxSerializationRegistry * registry = PxSerialization :: createSerializationRegistry ( PxGetPhysics ()) // Binary // Open file and get file size FILE * fp = fopen ( 'serialized.dat', 'rb' ) fseek ( fp, 0, SEEK_END ) unsigned fileSize = ftell ( fp ) fseek ( fp, 0, SEEK_SET ) // Allocate aligned memory, load data and deserialize void * memory = malloc ( fileSize + PX_SERIAL_FILE_ALIGN ) void * memory128 = ( void * )(( size_t ( memory ) + PX_SERIAL_FILE_ALIGN ) &~ ( PX_SERIAL_FILE_ALIGN - 1 )) fread ( memory128, 1, fileSize, fp ) fclose ( fp ) PxCollection * collection = PxSerialization :: createCollectionFromBinary ( memory128, * registry ) //~Binary // RepX // Load file and deserialize collection - needs cooking library PxDefaultFileInputData inputData ( 'serialized.dat' ) PxCollection * collection = PxSerialization :: createCollectionFromXml ( inputData, * cooking, * registry ) //~RepX scene -> addCollection ( * collection )

Serialized code#

The following code deserializes the rigid dynamic and adds it to a scene for simulation: PxSerialization::complete adds all the required objects to the collection. If an object has dependencies on other PhysX objects, they need to be serialized as well. In order to serialize a PhysX object, it needs to be added to a PxCollection.

Serialized how to#

Most operations related to serialization require an instance of PxSerializationRegistry, which provides information on how to serialize PhysX types. createShape ( geometry, * material ) PxTransform t = PxTransform ( PxIdentity ) PxRigidDynamic * dynamic = PxCreateDynamic ( PxGetPhysics (), t, geometry, * material, 1.0f ) PxSerializationRegistry * registry = PxSerialization :: createSerializationRegistry ( PxGetPhysics ()) // Create a collection and all objects for serialization PxCollection * collection = PxCreateCollection () collection -> add ( * dynamic ) PxSerialization :: complete ( * collection, * registry ) // Serialize either to binary or RepX PxDefaultFileOutputStream outStream ( 'serialized.dat' ) // Binary PxSerialization :: serializeCollectionToBinary ( outStream, * collection, * registry ) //~Binary // RepX PxSerialization :: serializeCollectionToXml ( outStream, * collection, * registry ) //~RepX createMaterial ( 0.0f, 0.0f, 0.0f ) PxShape * shape = PxGetPhysics (). Create a material, a shape and a rigid dynamic PxSphereGeometry geometry ( 1.0f ) PxMaterial * material = PxGetPhysics (). PhysX provides functionality to convert binary serialized data from authoring platforms to run-time platforms to ease the asset management. However, this approach is also less flexible as the binary format is specific to a given platform and PhysX SDK version. This in-place deserialization method is well suited for performance critical real time situations. The binary serialization approach on the other hand supports instantiation of PhysX objects directly from memory without copying data. API-level serialization is not expected to be used in performance critical situations. It offers platform independence and further supports loading data that was serialized with a previous PhysX SDK version.

Serialized manual#

It is therefore suitable for manual inspection and modification for debugging purposes. API-level serialization to RepX (an XML format)ĪPI-level serialization uses a human readable XML format - RepX - that directly corresponds to the PhysX API.

The maximum depth of properties to preserve when serializing/deserializing.PhysX 3 features two approaches to serialization: