PK_ASSEMBLY_make_level_assembly

PK_ERROR_code_t      PK_ASSEMBLY_make_level_assembly
(
--- received arguments ---
PK_ASSEMBLY_t        assembly,        --- assembly

--- returned arguments ---
PK_ASSEMBLY_t *const level_assembly   --- level assembly
)


This function creates a new assembly which contains, for each path from
the given assembly to a body contained in it, an instance of that body with a
transform equal to the product of the transforms attached to instances along
the path.


It will always create a new assembly, even if the given assembly is already
level, or empty. The given assembly is unchanged.