restore_context

file.restore_context(p0: str) → int

Restore a context file.

If a context file is restored before data is read the data used to create the context file is also restored together with the parts that existed at the time the context file was saved.

If a context file is restored after data is read but before parts are created the same parts that existed in the context file will be restored.

If a context file is restored after data and parts have been loaded, the context content is applied towards the loaded parts. In this case the part names must match. If part names do not match the user must manually match up the parts via a pop-up dialog.

Args:

p0:

‘filename’ name of the context file to restore

Examples:

ensight.file.restore_context("/tmp/test.ctx")

Returns:

zero on success, non-zero on error