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, or PK_ENTITY_null.


Specific Errors:
    PK_ERROR_wrong_transf        transform is not a rigid motion
    PK_ERROR_has_parent          transform is not an orphan


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.