*CE_MarkSplitLink

Split group links into individual links.

Syntax

*CE_MarkSplitLink mark_id search_type search_rule search_string_array search_number_of_strings ?keep_realized?

HyperMesh Tcl Modify Command

Split group links into individual links.

mark_id: The ID of the mark of connectors to split. 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
search_string_array: A string array containing the list of of link IDs/names/UIDs in the group link, 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

To split the group link of 3 components consisting of component IDs: 1, 2 and 4 in connector ID 5:

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

Incorrect usage results in a Tcl error. To detect errors, you can use the catch command:

if { [ catch {command_name...} ] } {
   # Handle error
}

2019