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


This function transforms an instance by transforming its transform. The given
transform must be a rigid motion. The null transform is treated as the
identity.


Specific Errors:
    PK_ERROR_wrong_transf         transform is not a rigid motion


The given transform is not affected - it does not become the transform of the
instance, even if the transform of the instance was PK_ENTITY_null.