PK_INSTANCE_replace_transf

PK_ERROR_code_t    PK_INSTANCE_replace_transf
(
--- received arguments ---
PK_INSTANCE_t      instance,    --- instance
PK_TRANSF_t        transf       --- replacement transform
                                ---     (may be PK_ENTITY_null)
)


This function replaces the transform of an instance by the given one. Either
(or both) of these transforms may be PK_ENTITY_null. The given transform must
be a rigid motion, a reflection or PK_ENTITY_null.


Specific Errors:
    PK_ERROR_wrong_transf               transform is not a rigid motion or
                                        reflection (MILD)
    PK_ERROR_has_parent                 transform is not an orphan (MILD)
    PK_ERROR_not_in_same_partition      'transf' is not in the same partition
                                        as 'instance' (MILD)


If the instance has a transform, it will become an orphan. If the given
transform is not PK_ENTITY_null, then it must be an orphan in the same
partition as the instance.