*CE_MarkCombineLink

Combine the individual/group links into a single group link.

Syntax

*CE_MarkCombineLink mark_id search_type search_rule update_state search_string_array search_number_of_strings ?keep_realized?

Type

HyperMesh Tcl Modify

Description

Combine the individual/group links into a single group link.

Inputs

mark_id
The ID of the mark of connectors to combine. Valid values are 1 and 2.
search_type
The specific link type to search in the connector.
search_rule
The rule by which the link entity was added to the connector:
0 - Undefined
1 - None
2 - Use ID
3 - Use Name
4 - Proximity
5 - Use UID
update_state
The update state of the links desired to be grouped:
0 - Undefined
1 - Elems
2 - Geom
search_string_array
A string array containing the list of of link IDs/names/UIDs need to be combined into a group, created using*createstringarray. This must be set to 1.
The strings are generally IDs/names/UIDs based on the search_rule.
search_number_of_strings
Integer indicating the size (number of strings) in the search_string_array created using *createstringarray.
keep_realized
Option to keep the current connector state after the update operation:
0 - Unrealize if needed (default)
1 - Keep current state

Examples

To combine the component link IDs 1,2,3 and 4 of the connector IDs 2 and 5 into a group link:

*createmark connectors 1 2 5
*createstringarray 4 1 2 3 4
*CE_MarkCombineLink 1 comps 1 2 4 0

Errors

Incorrect usage results in a Tcl error. To detect errors, you can use the catch command:
if { [ catch {command_name...} ] } {
   # Handle error
}

Version History

2019