RESTORE_DEF
List of: Discussion Topic
Subjects: Entity, Extending ACIS
Contents: Application Development Manual

The restore_common method is called when reading from storage by any API whose name begins with "api_restore_entity_list".

Signature

void MY_ENTITY::restore_common()

Implementation

Implement RESTORE_DEF with functions declared in kernel/kernutil/fileio/fileio.hxx with names beginning with "read_". For entity pointers, use read_ptr, which is declared in kernel/kerndata/savres/savres.hxx.

Functions are provided for all the basic types and for some compound types, such as SPAvector and SPAtransf. Other compound types, including user defined structures, should be restored using several calls to restore the more basic types. Functions read_logical and read_enum allow the user to specify strings to be restored instead of simple numeric values. The strings must match what was specified in the save function. The strings are ignored for binary restores. Function read_ptr is used to restore entity pointers. The list is used to map the pointers to an index within the SAT file.

Versioning

ACIS allows an application to restore data in the format of any lower level ACIS version. The version being restored is stored in the global variable, restore_version_number (this can be set with an option). File kernel/kerndata/savres/versions.hxx defines the version when the SAT format changes for any Spatial supplied entities.
PDF/APPDEV/09ENT.PDF
HTM/DATA/ACIS/APPDEV/09ENT/0009.HTM