Adds an instance of a part to a parent part. If the part is not loaded,
it is loaded into the current session. The instance is added to the parts
list according to the setting of the parts_list switch (see
UF_ASSEM_ask_assem_options and UF_ASSEM_options_s). The user allocated
structure error_status is filled with the names and associated error codes
of the loaded parts. The allocated arrays must be freed with UF_free and
UF_free_string_array.
If refset_name is a NULL pointer or a zero-length string, the entire part is
used. If instance_name is a NULL pointer or a zero-length string, the instance
is unnamed.
See Also
The following table of parameter values for this function is
based on the automobile example
See table
tag_t parent_part Input tag of part to add instance to
const char * part Input name of part to instance. The part name can
include a directory path. This can not
exceed UF_CFI_MAX_PATH_NAME_LEN characters.
const char * refset_name Input Name of reference set to use from component
parts. The refset_name cannot exceed 30
characters, cannot include a directory path,
and should not have a file extension.
const char * instance_name Input Name of new instance The instance_name cannot
exceed 30 characters, cannot include a
directory path, and should not have a file
extension.
double origin[ 3 ] Input Position in <parent_part> where the instance
is to be created
double csys_matrix[ 6 ] Input Orientation of the instance
int layer Input -1 Means use the original layers.
0 Means use the work layer
1-255 Means use the specified layer.
tag_t * instance Output Tag of the new instance in the work part
UF_PART_load_status_t * error_status Output to be freed User allocted structure consisting of
names and associated error codes. The
allocated arrays must be freed with
UF_free_string_array and UF_free.
See the description of the
UF_PART_load_status_t structure for
details on freeing this structure.
