*CE_AddLinkEntitiesWithDetails

Update connectors at the specified locations with rules and other details.

Syntax

*CE_AddLinkEntitiesWithDetails connector_mark_id entity_type entity_mark_id entity_state ce_rules ce_le_rule tolerance_flag tolerance num_ents string_array number_of_strings

Type

HyperMesh Tcl Modify Command

Description

This command updates connectors at the specified locations with rules and other details.

Inputs

connector_mark_id
The ID of the mark containing the connectors to update. Valid values are 1 and 2.
entity_type
Type of entity to be added to the connectors as links.
entity_mark_id
The ID of the mark containing the entities to use as links. Valid values are 1 and 2.
entity_state
The state of the link entities. Valid values are:
0 - Geometry.
1 - Elements.
ce_rules
Flag indicating when to make the links. Valid values are:
0 - Now.
1 - At realize.
ce_le_rule
Flag indicating how to make the links. Valid values are:
0 - None.
1 - Use ID.
2 - Use name.
tolerance_flag
Flag indicating whether to use the default tolerance. Valid values are:
0 - Use default.
1 - Use specified value.
tolerance
Used to add entities only within the given tolerance from the specified connector.
num_ents
Number of entities to add/update connector (connectors thickness (2T, 3T, etc.) value).
string_array
The ID of the string array that contains the additional input parameters. The string array is created using the *createstringarray command. This should always be set to 1. Valid strings are:
ce_delete_links=1
Delete existing connector links.
ce_spot_extralinknum=1
The number of extra links for spot connectors.
ce_seam_extralinknum=0
The number of extra links for seam connectors.
number_of_strings
Integer indicating the size (number of strings) in the string array created using *createstringarray.

Examples

Update links for spot connector 1 and seam connector 2 by deleting existing links first:
*createmark connectors 1 1 2
*createmark comps 1 21 23 24 27
*createstringarray 3 "ce_delete_links=1" "ce_spot_extralinknum=1" "ce_seam_extralinknum=0"
*CE_AddLinkEntitiesWithDetails 1 comps 1 1 1 0 0 0 2 1 3

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

12.0