 |
PK_PARTITION_copy |
|
PK_ERROR_code_t PK_PARTITION_copy
(
--- received arguments ---
PK_PARTITION_t partition, --- partition
const PK_PARTITION_copy_o_t *options, --- copy options
--- returned arguments ---
PK_PARTITION_t *const partition_copy --- copy of partition
)
This function produces a new 'partition_copy' which is a copy of the given
'partition'.
Specific Errors:
PK_ERROR_rollback_not_started Partitioned rollback is not active (MILD)
PK_ERROR_bad_mark Partition is at its initial pmark (MILD)
PK_ERROR_not_at_pmark Partition is not at a pmark (MILD)
PK_ERROR_frustrum_failure The frustrum returned an error (MILD)
All model data from the 'partition' is copied into a new 'partition_copy'.
The 'partition' must not be at its initial pmark. If the 'copy_deltas' option
is not PK_PARTITION_copy_deltas_none_c then the pmarks and deltas are copied.
In this case the 'partition' must be at a pmark.
If the 'copy_deltas' option is PK_PARTITION_copy_deltas_curr_c then the
'partition_copy' will only have an initial and a current pmark.
If the partition allows partial pmarks, the 'partition_copy' will also allow
partial pmarks.
This function should only be called when partitioned rollback has been started
by calling PK_DELTA_register_callbacks.
For more information, see Copying partitions.
Note: You are advised to consult with Parasolid Support before using partitions
that allow partial pmarks.