MDL SDK API nvidia_logo_transpbg.gif Up
mi::neuraylib::IMdle_serialization_callback Class Referenceabstract

Callback to map references to MDLE modules during serialization. More...

#include <imdl_impexp_api.h>

Inheritance diagram for mi::neuraylib::IMdle_serialization_callback:

Public Member Functions

virtual const IStringget_serialized_filename (const char *filename) const =0
 Returns a serialized filename for the given MDLE filename. More...
 
- Public Member Functions inherited from mi::base::IInterface
virtual Uint32 retain () const =0
 Increments the reference count. More...
 
virtual Uint32 release () const =0
 Decrements the reference count. More...
 
virtual const IInterfaceget_interface (const Uuid &interface_id) const =0
 Acquires a const interface from another. More...
 
template<class T>
const T * get_interface () const
 Acquires a const interface from another. More...
 
virtual IInterfaceget_interface (const Uuid &interface_id)=0
 Acquires a mutable interface from another. More...
 
template<class T>
T * get_interface ()
 Acquires a mutable interface from another. More...
 
virtual Uuid get_iid () const =0
 Returns the interface ID of the most derived interface. More...
 

Additional Inherited Members

- Public Types inherited from mi::base::Interface_declare< 0x5888652a, ... >
typedef Interface_declare< id1, ... > Self
 Own type. More...
 
typedef Uuid_t< id1, ... > IID
 Declares the interface ID (IID) of this interface. More...
 
- Public Types inherited from mi::base::IInterface
typedef Uuid_t<0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0> IID
 Declares the interface ID (IID) of this interface. More...
 
- Static Public Member Functions inherited from mi::base::Interface_declare< 0x5888652a, ... >
static bool compare_iid (const Uuid &iid)
 Compares the interface ID iid against the interface ID of this interface and of its ancestors. More...
 
- Static Public Member Functions inherited from mi::base::IInterface
static bool compare_iid (const Uuid &iid)
 Compares the interface ID iid against the interface ID of this interface. More...
 

Detailed Description

Callback to map references to MDLE modules during serialization.

The name of an MDLE module is the absolute filename of the module. This makes it difficult to move such modules around since that requires adjusting all references. This callback allows to rewrite such references during serialization. The reverse mapping should be implemented in an corresponding instance of mi::neuraylib::IMdle_deserialization_callback.

One possible solution is to choose a filename that is relative to a known reference point that will be moved together with the MDLE file, e.g., the main scene file.

See also
mi::neuraylib::IMdle_deserialization_callback, mi::neuraylib::IMdl_impexp_api::serialize_function_name()

Member Function Documentation

 get_serialized_filename()

virtual const IString * mi::neuraylib::IMdle_serialization_callback::get_serialized_filename ( const char *  filename) const
pure virtual

Returns a serialized filename for the given MDLE filename.

The implemented mapping should be reversible, otherwise you will run into problems implementing the corresponding instance of mi::neuraylib::IMdle_deserialization_callback.

The callback might get involved several times with the same argument. You might want to cache results if the computation is expensive.

Parameters
filenameThe current filename of an MDLE module.
Returns
The "serialized filename" of that MDLE module. Technically, this can be any string with ".mdle" suffix, it does not need to refer to an existing MDLE file on disk.